@tikkhun/version 2025.7.7 → 2026.4.13

package/dist/lib/store/JsonStore.js

@@ -1,5 +1,6 @@
-'use strict';var fsExtra=require('fs-extra');/**
+'use strict';var fsExtra=require('fs-extra'),fastXmlParser=require('fast-xml-parser'),S=require('js-yaml'),lodash=require('lodash'),smolToml=require('smol-toml');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var S__default=/*#__PURE__*/_interopDefault(S);/**
   @tikkhun/version
-  2025.7.7
+  2026.4.13
 */
-var J=Object.defineProperty,g=Object.defineProperties;var h=Object.getOwnPropertyDescriptors;var a=Object.getOwnPropertySymbols;var u=Object.prototype.hasOwnProperty,k=Object.prototype.propertyIsEnumerable;var p=(o,t,s)=>t in o?J(o,t,{enumerable:true,configurable:true,writable:true,value:s}):o[t]=s,c=(o,t)=>{for(var s in t||(t={}))u.call(t,s)&&p(o,s,t[s]);if(a)for(var s of a(t))k.call(t,s)&&p(o,s,t[s]);return o},f=(o,t)=>g(o,h(t));var l=(o,t,s)=>new Promise((S,n)=>{var m=e=>{try{r(s.next(e));}catch(i){n(i);}},y=e=>{try{r(s.throw(e));}catch(i){n(i);}},r=e=>e.done?S(e.value):Promise.resolve(e.value).then(m,y);r((s=s.apply(o,t)).next());});var T={file:"package.json",key:"version"},O=class{constructor(t){this.opts=Object.assign({},T,t);}update(t){return l(this,null,function*(){try{let s=yield fsExtra.readJson(this.opts.file);return yield fsExtra.writeJson(this.opts.file,f(c({},s),{[this.opts.key]:t}),{spaces:2}),!0}catch(s){return  false}})}};exports.DEFAULT_JSON_STORE_OPTIONS=T;exports.JsonStore=O;
+var V=Object.defineProperty,x=Object.defineProperties;var O=Object.getOwnPropertyDescriptors;var p=Object.getOwnPropertySymbols;var C=Object.prototype.hasOwnProperty,k=Object.prototype.propertyIsEnumerable;var h=(n,t,e)=>t in n?V(n,t,{enumerable:true,configurable:true,writable:true,value:e}):n[t]=e,d=(n,t)=>{for(var e in t||(t={}))C.call(t,e)&&h(n,e,t[e]);if(p)for(var e of p(t))k.call(t,e)&&h(n,e,t[e]);return n},y=(n,t)=>x(n,O(t));var u=(n,t,e)=>new Promise((r,s)=>{var i=o=>{try{c(e.next(o));}catch(l){s(l);}},a=o=>{try{c(e.throw(o));}catch(l){s(l);}},c=o=>o.done?r(o.value):Promise.resolve(o.value).then(i,a);c((e=e.apply(n,t)).next());});var f=class{constructor(t){this.target=t;}get(){return u(this,null,function*(){var t;try{if(!(yield fsExtra.pathExists(this.target.file)))return this.createGetError(`file is not found: ${this.target.file}`);let e=yield this.loadStructuredConfig(),r=this.target.path?lodash.get(e,this.target.path):e;return r===void 0?this.createGetError(`path is not found: ${(t=this.target.path)!=null?t:"<root>"}`):typeof r!="string"&&typeof r!="number"?this.createGetError(`value is not string or number: ${JSON.stringify(r)}`):{action:"get",success:!0,file:this.target.file,type:this.target.type,value:r}}catch(e){return this.createGetError(this.getErrorMessage(e))}})}set(t){return u(this,null,function*(){try{let e=yield this.get(),r=e.success?e.value:void 0,s=yield fsExtra.pathExists(this.target.file);if(!s){if(!this.target.createIfNotExists)return this.createSetError(t,`file is not found: ${this.target.file}`,r,"set");yield fsExtra.ensureFile(this.target.file);}let i=s?yield this.loadStructuredConfig():{};if(this.target.path)lodash.set(i,this.target.path,t),yield this.saveStructuredConfig(i);else {if(typeof i=="object"&&i!==null&&!Array.isArray(i))return this.createSetError(t,"path is required for structured target",r,"set");yield this.saveStructuredConfig(t);}return {action:"set",success:!0,file:this.target.file,type:this.target.type,oldValue:r,newValue:t}}catch(e){return this.createSetError(t,this.getErrorMessage(e),void 0,"set")}})}update(t){return u(this,null,function*(){let e=yield this.set(t);return y(d({},e),{action:"update"})})}createGetError(t){return {action:"get",success:false,file:this.target.file,type:this.target.type,message:t}}createSetError(t,e,r,s="set"){return {action:s,success:false,file:this.target.file,type:this.target.type,oldValue:r,newValue:t,message:e}}getErrorMessage(t){return t instanceof Error?t.message:String(t)}loadStructuredConfig(){return u(this,null,function*(){var e;let t=yield fsExtra.readFile(this.target.file,(e=this.target.encoding)!=null?e:"utf8");switch(this.target.type){case "json":return JSON.parse(t);case "yaml":return S__default.default.load(t);case "toml":return smolToml.parse(t);case "xml":return new fastXmlParser.XMLParser({ignoreAttributes:true}).parse(t);case "env":return this.parseEnvContent(t);default:throw new Error(`unsupported structured target type: ${this.target.type}`)}})}saveStructuredConfig(t){return u(this,null,function*(){var r;let e=(r=this.target.encoding)!=null?r:"utf8";switch(this.target.type){case "json":yield fsExtra.writeFile(this.target.file,JSON.stringify(t,null,2),e);return;case "yaml":yield fsExtra.writeFile(this.target.file,S__default.default.dump(t),e);return;case "toml":yield fsExtra.writeFile(this.target.file,smolToml.stringify(t),e);return;case "xml":yield fsExtra.writeFile(this.target.file,new fastXmlParser.XMLBuilder({format:true,ignoreAttributes:true}).build(t),e);return;case "env":yield fsExtra.writeFile(this.target.file,this.stringifyEnvContent(t),e);return;default:throw new Error(`unsupported structured target type: ${this.target.type}`)}})}parseEnvContent(t){let e={},r=t.split(/\r?\n/);for(let s of r){let i=s.trim();if(!i||i.startsWith("#"))continue;let a=i.indexOf("=");if(a<0)continue;let c=i.slice(0,a).trim(),o=i.slice(a+1).trim();lodash.set(e,c.replace(/__/g,"."),o);}return e}stringifyEnvContent(t){let e=[],r=(s,i)=>{if(s!==null&&typeof s=="object"&&!Array.isArray(s)){for(let[c,o]of Object.entries(s))r(o,[...i,c]);return}let a=i.join("__").toUpperCase();e.push(`${a}=${s!=null?s:""}`);};for(let[s,i]of Object.entries(t))r(i,[s]);return e.join(`
+`)}};var $={file:"package.json",key:"version"},E=class extends f{constructor(t){var s;let e=Object.assign({},$,t),r={type:"json",file:e.file,path:(s=e.path)!=null?s:e.key,createIfNotExists:e.createIfNotExists};super(r);}};exports.DEFAULT_JSON_STORE_OPTIONS=$;exports.JsonStore=E;

package/dist/lib/store/JsonStore.mjs

@@ -1,5 +1,6 @@
-import {readJson,writeJson}from'fs-extra';/**
+import {pathExists,ensureFile,readFile,writeFile}from'fs-extra';import {XMLParser,XMLBuilder}from'fast-xml-parser';import S from'js-yaml';import {set,get}from'lodash';import {parse,stringify}from'smol-toml';/**
   @tikkhun/version
-  2025.7.7
+  2026.4.13
 */
-var J=Object.defineProperty,g=Object.defineProperties;var h=Object.getOwnPropertyDescriptors;var a=Object.getOwnPropertySymbols;var u=Object.prototype.hasOwnProperty,k=Object.prototype.propertyIsEnumerable;var p=(o,t,s)=>t in o?J(o,t,{enumerable:true,configurable:true,writable:true,value:s}):o[t]=s,c=(o,t)=>{for(var s in t||(t={}))u.call(t,s)&&p(o,s,t[s]);if(a)for(var s of a(t))k.call(t,s)&&p(o,s,t[s]);return o},f=(o,t)=>g(o,h(t));var l=(o,t,s)=>new Promise((S,n)=>{var m=e=>{try{r(s.next(e));}catch(i){n(i);}},y=e=>{try{r(s.throw(e));}catch(i){n(i);}},r=e=>e.done?S(e.value):Promise.resolve(e.value).then(m,y);r((s=s.apply(o,t)).next());});var T={file:"package.json",key:"version"},O=class{constructor(t){this.opts=Object.assign({},T,t);}update(t){return l(this,null,function*(){try{let s=yield readJson(this.opts.file);return yield writeJson(this.opts.file,f(c({},s),{[this.opts.key]:t}),{spaces:2}),!0}catch(s){return  false}})}};export{T as DEFAULT_JSON_STORE_OPTIONS,O as JsonStore};
+var V=Object.defineProperty,x=Object.defineProperties;var O=Object.getOwnPropertyDescriptors;var p=Object.getOwnPropertySymbols;var C=Object.prototype.hasOwnProperty,k=Object.prototype.propertyIsEnumerable;var h=(n,t,e)=>t in n?V(n,t,{enumerable:true,configurable:true,writable:true,value:e}):n[t]=e,d=(n,t)=>{for(var e in t||(t={}))C.call(t,e)&&h(n,e,t[e]);if(p)for(var e of p(t))k.call(t,e)&&h(n,e,t[e]);return n},y=(n,t)=>x(n,O(t));var u=(n,t,e)=>new Promise((r,s)=>{var i=o=>{try{c(e.next(o));}catch(l){s(l);}},a=o=>{try{c(e.throw(o));}catch(l){s(l);}},c=o=>o.done?r(o.value):Promise.resolve(o.value).then(i,a);c((e=e.apply(n,t)).next());});var f=class{constructor(t){this.target=t;}get(){return u(this,null,function*(){var t;try{if(!(yield pathExists(this.target.file)))return this.createGetError(`file is not found: ${this.target.file}`);let e=yield this.loadStructuredConfig(),r=this.target.path?get(e,this.target.path):e;return r===void 0?this.createGetError(`path is not found: ${(t=this.target.path)!=null?t:"<root>"}`):typeof r!="string"&&typeof r!="number"?this.createGetError(`value is not string or number: ${JSON.stringify(r)}`):{action:"get",success:!0,file:this.target.file,type:this.target.type,value:r}}catch(e){return this.createGetError(this.getErrorMessage(e))}})}set(t){return u(this,null,function*(){try{let e=yield this.get(),r=e.success?e.value:void 0,s=yield pathExists(this.target.file);if(!s){if(!this.target.createIfNotExists)return this.createSetError(t,`file is not found: ${this.target.file}`,r,"set");yield ensureFile(this.target.file);}let i=s?yield this.loadStructuredConfig():{};if(this.target.path)set(i,this.target.path,t),yield this.saveStructuredConfig(i);else {if(typeof i=="object"&&i!==null&&!Array.isArray(i))return this.createSetError(t,"path is required for structured target",r,"set");yield this.saveStructuredConfig(t);}return {action:"set",success:!0,file:this.target.file,type:this.target.type,oldValue:r,newValue:t}}catch(e){return this.createSetError(t,this.getErrorMessage(e),void 0,"set")}})}update(t){return u(this,null,function*(){let e=yield this.set(t);return y(d({},e),{action:"update"})})}createGetError(t){return {action:"get",success:false,file:this.target.file,type:this.target.type,message:t}}createSetError(t,e,r,s="set"){return {action:s,success:false,file:this.target.file,type:this.target.type,oldValue:r,newValue:t,message:e}}getErrorMessage(t){return t instanceof Error?t.message:String(t)}loadStructuredConfig(){return u(this,null,function*(){var e;let t=yield readFile(this.target.file,(e=this.target.encoding)!=null?e:"utf8");switch(this.target.type){case "json":return JSON.parse(t);case "yaml":return S.load(t);case "toml":return parse(t);case "xml":return new XMLParser({ignoreAttributes:true}).parse(t);case "env":return this.parseEnvContent(t);default:throw new Error(`unsupported structured target type: ${this.target.type}`)}})}saveStructuredConfig(t){return u(this,null,function*(){var r;let e=(r=this.target.encoding)!=null?r:"utf8";switch(this.target.type){case "json":yield writeFile(this.target.file,JSON.stringify(t,null,2),e);return;case "yaml":yield writeFile(this.target.file,S.dump(t),e);return;case "toml":yield writeFile(this.target.file,stringify(t),e);return;case "xml":yield writeFile(this.target.file,new XMLBuilder({format:true,ignoreAttributes:true}).build(t),e);return;case "env":yield writeFile(this.target.file,this.stringifyEnvContent(t),e);return;default:throw new Error(`unsupported structured target type: ${this.target.type}`)}})}parseEnvContent(t){let e={},r=t.split(/\r?\n/);for(let s of r){let i=s.trim();if(!i||i.startsWith("#"))continue;let a=i.indexOf("=");if(a<0)continue;let c=i.slice(0,a).trim(),o=i.slice(a+1).trim();set(e,c.replace(/__/g,"."),o);}return e}stringifyEnvContent(t){let e=[],r=(s,i)=>{if(s!==null&&typeof s=="object"&&!Array.isArray(s)){for(let[c,o]of Object.entries(s))r(o,[...i,c]);return}let a=i.join("__").toUpperCase();e.push(`${a}=${s!=null?s:""}`);};for(let[s,i]of Object.entries(t))r(i,[s]);return e.join(`
+`)}};var $={file:"package.json",key:"version"},E=class extends f{constructor(t){var s;let e=Object.assign({},$,t),r={type:"json",file:e.file,path:(s=e.path)!=null?s:e.key,createIfNotExists:e.createIfNotExists};super(r);}};export{$ as DEFAULT_JSON_STORE_OPTIONS,E as JsonStore};

package/dist/lib/store/Store.d.mts

@@ -1,8 +1,186 @@
-interface Store {
-    update(value: string | number): Promise<boolean> | boolean;
+/**
+ * @description 版本值类型.
+ */
+type VersionValue = string | number;
+/**
+ * @description 结构化文件类型.
+ */
+type StructuredVersionTargetType = 'json' | 'yaml' | 'toml' | 'xml' | 'env';
+/**
+ * @description 文本文件更新模式.
+ */
+type TextStoreMode = 'raw' | 'replace';
+/**
+ * @description 版本目标基础配置.
+ */
+interface BaseVersionTarget {
+    /**
+     * @description 目标文件路径.
+     */
+    file: string;
+    /**
+     * @description 文件编码.
+     */
+    encoding?: BufferEncoding;
+    /**
+     * @description 文件不存在时是否允许创建.
+     */
+    createIfNotExists?: boolean;
+}
+/**
+ * @description 结构化配置文件目标.
+ */
+interface StructuredVersionTarget extends BaseVersionTarget {
+    /**
+     * @description 目标文件类型.
+     */
+    type: StructuredVersionTargetType;
+    /**
+     * @description 配置路径. 例如 version 或 build.app.version.
+     */
+    path?: string;
+}
+/**
+ * @description 文本文件目标.
+ */
+interface TextVersionTarget extends BaseVersionTarget {
+    /**
+     * @description 文本存储类型.
+     */
+    type: 'text';
+    /**
+     * @description 文本更新模式.
+     */
+    mode?: TextStoreMode;
+    /**
+     * @description 读取文本时是否需要 trim.
+     */
+    trim?: boolean;
+    /**
+     * @description 替换模式的正则表达式.
+     */
+    pattern?: string;
+    /**
+     * @description 替换模式的正则标记.
+     */
+    flags?: string;
+    /**
+     * @description 替换模板. 支持 {{version}} 占位符.
+     */
+    replacement?: string;
+}
+/**
+ * @description 自定义目标配置.
+ */
+interface CustomVersionTarget extends BaseVersionTarget {
+    /**
+     * @description 自定义类型.
+     */
+    type: 'custom';
+    /**
+     * @description 自定义读取函数.
+     * @param file 文件路径.
+     */
+    get?: (file: string) => Promise<VersionValue> | VersionValue;
+    /**
+     * @description 自定义写入函数.
+     * @param value 版本值.
+     * @param file 文件路径.
+     */
+    set?: (value: VersionValue, file: string) => Promise<void> | void;
 }
-interface StoreOptions {
+/**
+ * @description 支持的版本目标.
+ */
+type VersionTarget = StructuredVersionTarget | TextVersionTarget | CustomVersionTarget;
+/**
+ * @description store 读取结果.
+ */
+interface StoreGetResult {
+    /**
+     * @description 操作名称.
+     */
+    action: 'get';
+    /**
+     * @description 是否成功.
+     */
+    success: boolean;
+    /**
+     * @description 目标文件路径.
+     */
     file: string;
+    /**
+     * @description 目标文件类型.
+     */
+    type: VersionTarget['type'];
+    /**
+     * @description 当前读取到的值.
+     */
+    value?: VersionValue;
+    /**
+     * @description 附加消息.
+     */
+    message?: string;
+}
+/**
+ * @description store 写入结果.
+ */
+interface StoreSetResult {
+    /**
+     * @description 操作名称.
+     */
+    action: 'set' | 'update';
+    /**
+     * @description 是否成功.
+     */
+    success: boolean;
+    /**
+     * @description 目标文件路径.
+     */
+    file: string;
+    /**
+     * @description 目标文件类型.
+     */
+    type: VersionTarget['type'];
+    /**
+     * @description 写入前的旧值.
+     */
+    oldValue?: VersionValue;
+    /**
+     * @description 写入后的新值.
+     */
+    newValue?: VersionValue;
+    /**
+     * @description 附加消息.
+     */
+    message?: string;
+}
+/**
+ * @description store 操作结果.
+ */
+type StoreResult = StoreGetResult | StoreSetResult;
+/**
+ * @description store 接口. 负责从目标文件读取和写入版本.
+ */
+interface Store {
+    /**
+     * @description 绑定的目标配置.
+     */
+    target: VersionTarget;
+    /**
+     * @description 读取当前版本值.
+     */
+    get(): Promise<StoreGetResult> | StoreGetResult;
+    /**
+     * @description 直接写入版本值.
+     * @param value 版本值.
+     */
+    set(value: VersionValue): Promise<StoreSetResult> | StoreSetResult;
+    /**
+     * @description 更新版本值. 语义上等同 set, 但保留给 CLI 和日志使用.
+     * @param value 版本值.
+     */
+    update(value: VersionValue): Promise<StoreSetResult> | StoreSetResult;
 }
 
-export type { Store, StoreOptions };
+export type { BaseVersionTarget, CustomVersionTarget, Store, StoreGetResult, StoreResult, StoreSetResult, StructuredVersionTarget, StructuredVersionTargetType, TextStoreMode, TextVersionTarget, VersionTarget, VersionValue };

package/dist/lib/store/Store.d.ts

@@ -1,8 +1,186 @@
-interface Store {
-    update(value: string | number): Promise<boolean> | boolean;
+/**
+ * @description 版本值类型.
+ */
+type VersionValue = string | number;
+/**
+ * @description 结构化文件类型.
+ */
+type StructuredVersionTargetType = 'json' | 'yaml' | 'toml' | 'xml' | 'env';
+/**
+ * @description 文本文件更新模式.
+ */
+type TextStoreMode = 'raw' | 'replace';
+/**
+ * @description 版本目标基础配置.
+ */
+interface BaseVersionTarget {
+    /**
+     * @description 目标文件路径.
+     */
+    file: string;
+    /**
+     * @description 文件编码.
+     */
+    encoding?: BufferEncoding;
+    /**
+     * @description 文件不存在时是否允许创建.
+     */
+    createIfNotExists?: boolean;
+}
+/**
+ * @description 结构化配置文件目标.
+ */
+interface StructuredVersionTarget extends BaseVersionTarget {
+    /**
+     * @description 目标文件类型.
+     */
+    type: StructuredVersionTargetType;
+    /**
+     * @description 配置路径. 例如 version 或 build.app.version.
+     */
+    path?: string;
+}
+/**
+ * @description 文本文件目标.
+ */
+interface TextVersionTarget extends BaseVersionTarget {
+    /**
+     * @description 文本存储类型.
+     */
+    type: 'text';
+    /**
+     * @description 文本更新模式.
+     */
+    mode?: TextStoreMode;
+    /**
+     * @description 读取文本时是否需要 trim.
+     */
+    trim?: boolean;
+    /**
+     * @description 替换模式的正则表达式.
+     */
+    pattern?: string;
+    /**
+     * @description 替换模式的正则标记.
+     */
+    flags?: string;
+    /**
+     * @description 替换模板. 支持 {{version}} 占位符.
+     */
+    replacement?: string;
+}
+/**
+ * @description 自定义目标配置.
+ */
+interface CustomVersionTarget extends BaseVersionTarget {
+    /**
+     * @description 自定义类型.
+     */
+    type: 'custom';
+    /**
+     * @description 自定义读取函数.
+     * @param file 文件路径.
+     */
+    get?: (file: string) => Promise<VersionValue> | VersionValue;
+    /**
+     * @description 自定义写入函数.
+     * @param value 版本值.
+     * @param file 文件路径.
+     */
+    set?: (value: VersionValue, file: string) => Promise<void> | void;
 }
-interface StoreOptions {
+/**
+ * @description 支持的版本目标.
+ */
+type VersionTarget = StructuredVersionTarget | TextVersionTarget | CustomVersionTarget;
+/**
+ * @description store 读取结果.
+ */
+interface StoreGetResult {
+    /**
+     * @description 操作名称.
+     */
+    action: 'get';
+    /**
+     * @description 是否成功.
+     */
+    success: boolean;
+    /**
+     * @description 目标文件路径.
+     */
     file: string;
+    /**
+     * @description 目标文件类型.
+     */
+    type: VersionTarget['type'];
+    /**
+     * @description 当前读取到的值.
+     */
+    value?: VersionValue;
+    /**
+     * @description 附加消息.
+     */
+    message?: string;
+}
+/**
+ * @description store 写入结果.
+ */
+interface StoreSetResult {
+    /**
+     * @description 操作名称.
+     */
+    action: 'set' | 'update';
+    /**
+     * @description 是否成功.
+     */
+    success: boolean;
+    /**
+     * @description 目标文件路径.
+     */
+    file: string;
+    /**
+     * @description 目标文件类型.
+     */
+    type: VersionTarget['type'];
+    /**
+     * @description 写入前的旧值.
+     */
+    oldValue?: VersionValue;
+    /**
+     * @description 写入后的新值.
+     */
+    newValue?: VersionValue;
+    /**
+     * @description 附加消息.
+     */
+    message?: string;
+}
+/**
+ * @description store 操作结果.
+ */
+type StoreResult = StoreGetResult | StoreSetResult;
+/**
+ * @description store 接口. 负责从目标文件读取和写入版本.
+ */
+interface Store {
+    /**
+     * @description 绑定的目标配置.
+     */
+    target: VersionTarget;
+    /**
+     * @description 读取当前版本值.
+     */
+    get(): Promise<StoreGetResult> | StoreGetResult;
+    /**
+     * @description 直接写入版本值.
+     * @param value 版本值.
+     */
+    set(value: VersionValue): Promise<StoreSetResult> | StoreSetResult;
+    /**
+     * @description 更新版本值. 语义上等同 set, 但保留给 CLI 和日志使用.
+     * @param value 版本值.
+     */
+    update(value: VersionValue): Promise<StoreSetResult> | StoreSetResult;
 }
 
-export type { Store, StoreOptions };
+export type { BaseVersionTarget, CustomVersionTarget, Store, StoreGetResult, StoreResult, StoreSetResult, StructuredVersionTarget, StructuredVersionTargetType, TextStoreMode, TextVersionTarget, VersionTarget, VersionValue };

package/dist/lib/store/StoreFactory.d.mts

@@ -0,0 +1,14 @@
+import { VersionTarget, Store } from './Store.mjs';
+
+/**
+ * @description store 工厂.
+ */
+declare class StoreFactory {
+    /**
+     * @description 根据目标配置创建 store.
+     * @param target 目标配置.
+     */
+    static create(target: VersionTarget): Store;
+}
+
+export { StoreFactory };

package/dist/lib/store/StoreFactory.d.ts

@@ -0,0 +1,14 @@
+import { VersionTarget, Store } from './Store.js';
+
+/**
+ * @description store 工厂.
+ */
+declare class StoreFactory {
+    /**
+     * @description 根据目标配置创建 store.
+     * @param target 目标配置.
+     */
+    static create(target: VersionTarget): Store;
+}
+
+export { StoreFactory };

package/dist/lib/store/StoreFactory.js

@@ -0,0 +1,6 @@
+'use strict';var fsExtra=require('fs-extra'),fastXmlParser=require('fast-xml-parser'),E=require('js-yaml'),lodash=require('lodash'),smolToml=require('smol-toml');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var E__default=/*#__PURE__*/_interopDefault(E);/**
+  @tikkhun/version
+  2026.4.13
+*/
+var P=Object.defineProperty,G=Object.defineProperties;var C=Object.getOwnPropertyDescriptors;var w=Object.getOwnPropertySymbols;var O=Object.prototype.hasOwnProperty,v=Object.prototype.propertyIsEnumerable;var S=(a,t,e)=>t in a?P(a,t,{enumerable:true,configurable:true,writable:true,value:e}):a[t]=e,u=(a,t)=>{for(var e in t||(t={}))O.call(t,e)&&S(a,e,t[e]);if(w)for(var e of w(t))v.call(t,e)&&S(a,e,t[e]);return a},l=(a,t)=>G(a,C(t));var n=(a,t,e)=>new Promise((r,s)=>{var i=o=>{try{g(e.next(o));}catch(d){s(d);}},c=o=>{try{g(e.throw(o));}catch(d){s(d);}},g=o=>o.done?r(o.value):Promise.resolve(o.value).then(i,c);g((e=e.apply(a,t)).next());});var h=class{constructor(t){this.target=t;}get(){return n(this,null,function*(){var t;try{if(!(yield fsExtra.pathExists(this.target.file)))return this.createGetError(`file is not found: ${this.target.file}`);let e=yield this.loadStructuredConfig(),r=this.target.path?lodash.get(e,this.target.path):e;return r===void 0?this.createGetError(`path is not found: ${(t=this.target.path)!=null?t:"<root>"}`):typeof r!="string"&&typeof r!="number"?this.createGetError(`value is not string or number: ${JSON.stringify(r)}`):{action:"get",success:!0,file:this.target.file,type:this.target.type,value:r}}catch(e){return this.createGetError(this.getErrorMessage(e))}})}set(t){return n(this,null,function*(){try{let e=yield this.get(),r=e.success?e.value:void 0,s=yield fsExtra.pathExists(this.target.file);if(!s){if(!this.target.createIfNotExists)return this.createSetError(t,`file is not found: ${this.target.file}`,r,"set");yield fsExtra.ensureFile(this.target.file);}let i=s?yield this.loadStructuredConfig():{};if(this.target.path)lodash.set(i,this.target.path,t),yield this.saveStructuredConfig(i);else {if(typeof i=="object"&&i!==null&&!Array.isArray(i))return this.createSetError(t,"path is required for structured target",r,"set");yield this.saveStructuredConfig(t);}return {action:"set",success:!0,file:this.target.file,type:this.target.type,oldValue:r,newValue:t}}catch(e){return this.createSetError(t,this.getErrorMessage(e),void 0,"set")}})}update(t){return n(this,null,function*(){let e=yield this.set(t);return l(u({},e),{action:"update"})})}createGetError(t){return {action:"get",success:false,file:this.target.file,type:this.target.type,message:t}}createSetError(t,e,r,s="set"){return {action:s,success:false,file:this.target.file,type:this.target.type,oldValue:r,newValue:t,message:e}}getErrorMessage(t){return t instanceof Error?t.message:String(t)}loadStructuredConfig(){return n(this,null,function*(){var e;let t=yield fsExtra.readFile(this.target.file,(e=this.target.encoding)!=null?e:"utf8");switch(this.target.type){case "json":return JSON.parse(t);case "yaml":return E__default.default.load(t);case "toml":return smolToml.parse(t);case "xml":return new fastXmlParser.XMLParser({ignoreAttributes:true}).parse(t);case "env":return this.parseEnvContent(t);default:throw new Error(`unsupported structured target type: ${this.target.type}`)}})}saveStructuredConfig(t){return n(this,null,function*(){var r;let e=(r=this.target.encoding)!=null?r:"utf8";switch(this.target.type){case "json":yield fsExtra.writeFile(this.target.file,JSON.stringify(t,null,2),e);return;case "yaml":yield fsExtra.writeFile(this.target.file,E__default.default.dump(t),e);return;case "toml":yield fsExtra.writeFile(this.target.file,smolToml.stringify(t),e);return;case "xml":yield fsExtra.writeFile(this.target.file,new fastXmlParser.XMLBuilder({format:true,ignoreAttributes:true}).build(t),e);return;case "env":yield fsExtra.writeFile(this.target.file,this.stringifyEnvContent(t),e);return;default:throw new Error(`unsupported structured target type: ${this.target.type}`)}})}parseEnvContent(t){let e={},r=t.split(/\r?\n/);for(let s of r){let i=s.trim();if(!i||i.startsWith("#"))continue;let c=i.indexOf("=");if(c<0)continue;let g=i.slice(0,c).trim(),o=i.slice(c+1).trim();lodash.set(e,g.replace(/__/g,"."),o);}return e}stringifyEnvContent(t){let e=[],r=(s,i)=>{if(s!==null&&typeof s=="object"&&!Array.isArray(s)){for(let[g,o]of Object.entries(s))r(o,[...i,g]);return}let c=i.join("__").toUpperCase();e.push(`${c}=${s!=null?s:""}`);};for(let[s,i]of Object.entries(t))r(i,[s]);return e.join(`
+`)}};var L={file:"",mode:"raw",trim:true,replacement:"{{version}}"},p=class{constructor(t){this.target=u(u({type:"text"},L),t);}get(){return n(this,null,function*(){var t;try{if(!(yield fsExtra.pathExists(this.target.file)))return this.createGetError(`file is not found: ${this.target.file}`);let e=yield fsExtra.readFile(this.target.file,(t=this.target.encoding)!=null?t:"utf8"),r=this.resolveValueFromText(e);return r===void 0?this.createGetError("version is not found in text content"):{action:"get",success:!0,file:this.target.file,type:this.target.type,value:r}}catch(e){return this.createGetError(this.getErrorMessage(e))}})}set(t){return n(this,null,function*(){try{let e=yield this.get(),r=e.success?e.value:void 0,s=yield this.createNextText(t);return yield this.writeText(s),{action:"set",success:!0,file:this.target.file,type:this.target.type,oldValue:r,newValue:t}}catch(e){return {action:"set",success:false,file:this.target.file,type:this.target.type,newValue:t,message:this.getErrorMessage(e)}}})}update(t){return n(this,null,function*(){let e=yield this.set(t);return l(u({},e),{action:"update"})})}resolveValueFromText(t){var e;if(this.target.mode==="replace"){let s=this.createPattern().exec(t);if(!s)return;let i=(e=s.groups)==null?void 0:e.version;return i!==void 0?i:s[1]!==void 0?s[1]:s[0]}return this.target.trim?t.trim():t}createNextText(t){return n(this,null,function*(){var e,r;if(this.target.mode==="replace"){if(!(yield fsExtra.pathExists(this.target.file)))throw new Error(`file is not found: ${this.target.file}`);let s=yield fsExtra.readFile(this.target.file,(e=this.target.encoding)!=null?e:"utf8");if(!this.createPattern().test(s))throw new Error("pattern is not matched");let c=((r=this.target.replacement)!=null?r:"{{version}}").replaceAll("{{version}}",String(t));return s.replace(this.createPattern(),c)}return String(t)})}writeText(t){return n(this,null,function*(){var e;if(!(yield fsExtra.pathExists(this.target.file))){if(!this.target.createIfNotExists)throw new Error(`file is not found: ${this.target.file}`);yield fsExtra.ensureFile(this.target.file);}yield fsExtra.writeFile(this.target.file,t,(e=this.target.encoding)!=null?e:"utf8");})}createPattern(){if(!this.target.pattern)throw new Error("pattern is required when text mode is replace");return new RegExp(this.target.pattern,this.target.flags)}createGetError(t){return {action:"get",success:false,file:this.target.file,type:this.target.type,message:t}}getErrorMessage(t){return t instanceof Error?t.message:String(t)}};var R=class{static create(t){return t.type==="text"?new p(t):t.type==="custom"?new y(t):new h(t)}},y=class{constructor(t){this.target=t;}get(){return n(this,null,function*(){if(!this.target.get)return {action:"get",success:false,file:this.target.file,type:this.target.type,message:"custom get is not implemented"};try{let t=yield this.target.get(this.target.file);return {action:"get",success:!0,file:this.target.file,type:this.target.type,value:t}}catch(t){return {action:"get",success:false,file:this.target.file,type:this.target.type,message:t instanceof Error?t.message:String(t)}}})}set(t){return n(this,null,function*(){try{let e=yield this.get();return this.target.set?(yield this.target.set(t,this.target.file),{action:"set",success:!0,file:this.target.file,type:this.target.type,oldValue:e.success?e.value:void 0,newValue:t}):{action:"set",success:!1,file:this.target.file,type:this.target.type,oldValue:e.success?e.value:void 0,newValue:t,message:"custom set is not implemented"}}catch(e){return {action:"set",success:false,file:this.target.file,type:this.target.type,newValue:t,message:e instanceof Error?e.message:String(e)}}})}update(t){return n(this,null,function*(){let e=yield this.set(t);return l(u({},e),{action:"update"})})}};exports.StoreFactory=R;

package/dist/lib/store/StoreFactory.mjs

@@ -0,0 +1,6 @@
+import {pathExists,readFile,ensureFile,writeFile}from'fs-extra';import {XMLParser,XMLBuilder}from'fast-xml-parser';import E from'js-yaml';import {set,get}from'lodash';import {parse,stringify}from'smol-toml';/**
+  @tikkhun/version
+  2026.4.13
+*/
+var P=Object.defineProperty,G=Object.defineProperties;var C=Object.getOwnPropertyDescriptors;var w=Object.getOwnPropertySymbols;var O=Object.prototype.hasOwnProperty,v=Object.prototype.propertyIsEnumerable;var S=(a,t,e)=>t in a?P(a,t,{enumerable:true,configurable:true,writable:true,value:e}):a[t]=e,u=(a,t)=>{for(var e in t||(t={}))O.call(t,e)&&S(a,e,t[e]);if(w)for(var e of w(t))v.call(t,e)&&S(a,e,t[e]);return a},l=(a,t)=>G(a,C(t));var n=(a,t,e)=>new Promise((r,s)=>{var i=o=>{try{g(e.next(o));}catch(d){s(d);}},c=o=>{try{g(e.throw(o));}catch(d){s(d);}},g=o=>o.done?r(o.value):Promise.resolve(o.value).then(i,c);g((e=e.apply(a,t)).next());});var h=class{constructor(t){this.target=t;}get(){return n(this,null,function*(){var t;try{if(!(yield pathExists(this.target.file)))return this.createGetError(`file is not found: ${this.target.file}`);let e=yield this.loadStructuredConfig(),r=this.target.path?get(e,this.target.path):e;return r===void 0?this.createGetError(`path is not found: ${(t=this.target.path)!=null?t:"<root>"}`):typeof r!="string"&&typeof r!="number"?this.createGetError(`value is not string or number: ${JSON.stringify(r)}`):{action:"get",success:!0,file:this.target.file,type:this.target.type,value:r}}catch(e){return this.createGetError(this.getErrorMessage(e))}})}set(t){return n(this,null,function*(){try{let e=yield this.get(),r=e.success?e.value:void 0,s=yield pathExists(this.target.file);if(!s){if(!this.target.createIfNotExists)return this.createSetError(t,`file is not found: ${this.target.file}`,r,"set");yield ensureFile(this.target.file);}let i=s?yield this.loadStructuredConfig():{};if(this.target.path)set(i,this.target.path,t),yield this.saveStructuredConfig(i);else {if(typeof i=="object"&&i!==null&&!Array.isArray(i))return this.createSetError(t,"path is required for structured target",r,"set");yield this.saveStructuredConfig(t);}return {action:"set",success:!0,file:this.target.file,type:this.target.type,oldValue:r,newValue:t}}catch(e){return this.createSetError(t,this.getErrorMessage(e),void 0,"set")}})}update(t){return n(this,null,function*(){let e=yield this.set(t);return l(u({},e),{action:"update"})})}createGetError(t){return {action:"get",success:false,file:this.target.file,type:this.target.type,message:t}}createSetError(t,e,r,s="set"){return {action:s,success:false,file:this.target.file,type:this.target.type,oldValue:r,newValue:t,message:e}}getErrorMessage(t){return t instanceof Error?t.message:String(t)}loadStructuredConfig(){return n(this,null,function*(){var e;let t=yield readFile(this.target.file,(e=this.target.encoding)!=null?e:"utf8");switch(this.target.type){case "json":return JSON.parse(t);case "yaml":return E.load(t);case "toml":return parse(t);case "xml":return new XMLParser({ignoreAttributes:true}).parse(t);case "env":return this.parseEnvContent(t);default:throw new Error(`unsupported structured target type: ${this.target.type}`)}})}saveStructuredConfig(t){return n(this,null,function*(){var r;let e=(r=this.target.encoding)!=null?r:"utf8";switch(this.target.type){case "json":yield writeFile(this.target.file,JSON.stringify(t,null,2),e);return;case "yaml":yield writeFile(this.target.file,E.dump(t),e);return;case "toml":yield writeFile(this.target.file,stringify(t),e);return;case "xml":yield writeFile(this.target.file,new XMLBuilder({format:true,ignoreAttributes:true}).build(t),e);return;case "env":yield writeFile(this.target.file,this.stringifyEnvContent(t),e);return;default:throw new Error(`unsupported structured target type: ${this.target.type}`)}})}parseEnvContent(t){let e={},r=t.split(/\r?\n/);for(let s of r){let i=s.trim();if(!i||i.startsWith("#"))continue;let c=i.indexOf("=");if(c<0)continue;let g=i.slice(0,c).trim(),o=i.slice(c+1).trim();set(e,g.replace(/__/g,"."),o);}return e}stringifyEnvContent(t){let e=[],r=(s,i)=>{if(s!==null&&typeof s=="object"&&!Array.isArray(s)){for(let[g,o]of Object.entries(s))r(o,[...i,g]);return}let c=i.join("__").toUpperCase();e.push(`${c}=${s!=null?s:""}`);};for(let[s,i]of Object.entries(t))r(i,[s]);return e.join(`
+`)}};var L={file:"",mode:"raw",trim:true,replacement:"{{version}}"},p=class{constructor(t){this.target=u(u({type:"text"},L),t);}get(){return n(this,null,function*(){var t;try{if(!(yield pathExists(this.target.file)))return this.createGetError(`file is not found: ${this.target.file}`);let e=yield readFile(this.target.file,(t=this.target.encoding)!=null?t:"utf8"),r=this.resolveValueFromText(e);return r===void 0?this.createGetError("version is not found in text content"):{action:"get",success:!0,file:this.target.file,type:this.target.type,value:r}}catch(e){return this.createGetError(this.getErrorMessage(e))}})}set(t){return n(this,null,function*(){try{let e=yield this.get(),r=e.success?e.value:void 0,s=yield this.createNextText(t);return yield this.writeText(s),{action:"set",success:!0,file:this.target.file,type:this.target.type,oldValue:r,newValue:t}}catch(e){return {action:"set",success:false,file:this.target.file,type:this.target.type,newValue:t,message:this.getErrorMessage(e)}}})}update(t){return n(this,null,function*(){let e=yield this.set(t);return l(u({},e),{action:"update"})})}resolveValueFromText(t){var e;if(this.target.mode==="replace"){let s=this.createPattern().exec(t);if(!s)return;let i=(e=s.groups)==null?void 0:e.version;return i!==void 0?i:s[1]!==void 0?s[1]:s[0]}return this.target.trim?t.trim():t}createNextText(t){return n(this,null,function*(){var e,r;if(this.target.mode==="replace"){if(!(yield pathExists(this.target.file)))throw new Error(`file is not found: ${this.target.file}`);let s=yield readFile(this.target.file,(e=this.target.encoding)!=null?e:"utf8");if(!this.createPattern().test(s))throw new Error("pattern is not matched");let c=((r=this.target.replacement)!=null?r:"{{version}}").replaceAll("{{version}}",String(t));return s.replace(this.createPattern(),c)}return String(t)})}writeText(t){return n(this,null,function*(){var e;if(!(yield pathExists(this.target.file))){if(!this.target.createIfNotExists)throw new Error(`file is not found: ${this.target.file}`);yield ensureFile(this.target.file);}yield writeFile(this.target.file,t,(e=this.target.encoding)!=null?e:"utf8");})}createPattern(){if(!this.target.pattern)throw new Error("pattern is required when text mode is replace");return new RegExp(this.target.pattern,this.target.flags)}createGetError(t){return {action:"get",success:false,file:this.target.file,type:this.target.type,message:t}}getErrorMessage(t){return t instanceof Error?t.message:String(t)}};var R=class{static create(t){return t.type==="text"?new p(t):t.type==="custom"?new y(t):new h(t)}},y=class{constructor(t){this.target=t;}get(){return n(this,null,function*(){if(!this.target.get)return {action:"get",success:false,file:this.target.file,type:this.target.type,message:"custom get is not implemented"};try{let t=yield this.target.get(this.target.file);return {action:"get",success:!0,file:this.target.file,type:this.target.type,value:t}}catch(t){return {action:"get",success:false,file:this.target.file,type:this.target.type,message:t instanceof Error?t.message:String(t)}}})}set(t){return n(this,null,function*(){try{let e=yield this.get();return this.target.set?(yield this.target.set(t,this.target.file),{action:"set",success:!0,file:this.target.file,type:this.target.type,oldValue:e.success?e.value:void 0,newValue:t}):{action:"set",success:!1,file:this.target.file,type:this.target.type,oldValue:e.success?e.value:void 0,newValue:t,message:"custom set is not implemented"}}catch(e){return {action:"set",success:false,file:this.target.file,type:this.target.type,newValue:t,message:e instanceof Error?e.message:String(e)}}})}update(t){return n(this,null,function*(){let e=yield this.set(t);return l(u({},e),{action:"update"})})}};export{R as StoreFactory};

package/dist/lib/store/TextStore.d.mts

@@ -1,14 +1,70 @@
-import { Store } from './Store.mjs';
+import { TextVersionTarget, Store, StoreGetResult, VersionValue, StoreSetResult } from './Store.mjs';
 
-interface TextStoreOptions {
-    file: string;
+/**
+ * @description 文本 store 配置.
+ */
+interface TextStoreOptions extends Omit<TextVersionTarget, 'type'> {
 }
+/**
+ * @description 文本 store 默认配置.
+ */
 declare const DEFAULT_TEXT_STORE_OPTIONS: TextStoreOptions;
+/**
+ * @description 文本版本 store.
+ */
 declare class TextStore implements Store {
-    opts: TextStoreOptions;
-    filePath: string;
+    /**
+     * @description 当前 store 绑定的目标.
+     */
+    target: TextVersionTarget;
+    /**
+     * @description 初始化文本 store.
+     * @param options store 配置.
+     */
     constructor(options: TextStoreOptions);
-    update(text: any): boolean;
+    /**
+     * @description 读取文本文件中的版本值.
+     */
+    get(): Promise<StoreGetResult>;
+    /**
+     * @description 写入文本文件中的版本值.
+     * @param value 版本值.
+     */
+    set(value: VersionValue): Promise<StoreSetResult>;
+    /**
+     * @description 更新文本文件中的版本值.
+     * @param value 版本值.
+     */
+    update(value: VersionValue): Promise<StoreSetResult>;
+    /**
+     * @description 从文本内容中提取版本值.
+     * @param text 文件内容.
+     */
+    protected resolveValueFromText(text: string): VersionValue | undefined;
+    /**
+     * @description 生成下一份文本内容.
+     * @param value 版本值.
+     */
+    protected createNextText(value: VersionValue): Promise<string>;
+    /**
+     * @description 写入文本内容.
+     * @param text 文件内容.
+     */
+    protected writeText(text: string): Promise<void>;
+    /**
+     * @description 构建替换正则.
+     */
+    protected createPattern(): RegExp;
+    /**
+     * @description 创建读取失败结果.
+     * @param message 错误消息.
+     */
+    protected createGetError(message: string): StoreGetResult;
+    /**
+     * @description 提取异常消息.
+     * @param error 异常对象.
+     */
+    protected getErrorMessage(error: unknown): string;
 }
 
 export { DEFAULT_TEXT_STORE_OPTIONS, TextStore, type TextStoreOptions };

package/dist/lib/store/TextStore.d.ts

@@ -1,14 +1,70 @@
-import { Store } from './Store.js';
+import { TextVersionTarget, Store, StoreGetResult, VersionValue, StoreSetResult } from './Store.js';
 
-interface TextStoreOptions {
-    file: string;
+/**
+ * @description 文本 store 配置.
+ */
+interface TextStoreOptions extends Omit<TextVersionTarget, 'type'> {
 }
+/**
+ * @description 文本 store 默认配置.
+ */
 declare const DEFAULT_TEXT_STORE_OPTIONS: TextStoreOptions;
+/**
+ * @description 文本版本 store.
+ */
 declare class TextStore implements Store {
-    opts: TextStoreOptions;
-    filePath: string;
+    /**
+     * @description 当前 store 绑定的目标.
+     */
+    target: TextVersionTarget;
+    /**
+     * @description 初始化文本 store.
+     * @param options store 配置.
+     */
     constructor(options: TextStoreOptions);
-    update(text: any): boolean;
+    /**
+     * @description 读取文本文件中的版本值.
+     */
+    get(): Promise<StoreGetResult>;
+    /**
+     * @description 写入文本文件中的版本值.
+     * @param value 版本值.
+     */
+    set(value: VersionValue): Promise<StoreSetResult>;
+    /**
+     * @description 更新文本文件中的版本值.
+     * @param value 版本值.
+     */
+    update(value: VersionValue): Promise<StoreSetResult>;
+    /**
+     * @description 从文本内容中提取版本值.
+     * @param text 文件内容.
+     */
+    protected resolveValueFromText(text: string): VersionValue | undefined;
+    /**
+     * @description 生成下一份文本内容.
+     * @param value 版本值.
+     */
+    protected createNextText(value: VersionValue): Promise<string>;
+    /**
+     * @description 写入文本内容.
+     * @param text 文件内容.
+     */
+    protected writeText(text: string): Promise<void>;
+    /**
+     * @description 构建替换正则.
+     */
+    protected createPattern(): RegExp;
+    /**
+     * @description 创建读取失败结果.
+     * @param message 错误消息.
+     */
+    protected createGetError(message: string): StoreGetResult;
+    /**
+     * @description 提取异常消息.
+     * @param error 异常对象.
+     */
+    protected getErrorMessage(error: unknown): string;
 }
 
 export { DEFAULT_TEXT_STORE_OPTIONS, TextStore, type TextStoreOptions };