{"_id":"@agentskillmania/settings-yaml","_rev":"8-991abcc3670aad8901b1064d47f1ecef","name":"@agentskillmania/settings-yaml","dist-tags":{"latest":"0.5.0","alpha":"0.5.0-alpha.2"},"versions":{"0.1.0":{"name":"@agentskillmania/settings-yaml","version":"0.1.0","author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"license":"MIT","_id":"@agentskillmania/settings-yaml@0.1.0","maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"homepage":"https://github.com/agentskillmania/colts#readme","bugs":{"url":"https://github.com/agentskillmania/colts/issues"},"dist":{"shasum":"200a412fe042a0c2910d644d05dbaafa4e2d2b25","tarball":"https://registry.npmjs.org/@agentskillmania/settings-yaml/-/settings-yaml-0.1.0.tgz","fileCount":6,"integrity":"sha512-nbowP8R0lZLjfn47YhWNFo86/zjac3sUwRAY9+j5OuSMkYncDWHNVVkcF3Mtyj8jy6eCeos2tXTMWfK3DQL6AQ==","signatures":[{"sig":"MEUCIQDoUBLf8epU6rdHsY/17K52UIdlA+kG4/87qzrl7HmDgQIgGvEVWguNRwZXMzhWcesrmka0wSsfGsH/Rrv0LfQc6kc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11131},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6de54f65967d77a7ea360c1db7f0b12cd051f186","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:unit":"vitest run test/unit","test:watch":"vitest watch test/unit","format:check":"prettier --check \"src/**/*.ts\"","test:coverage":"vitest run test/unit --coverage","prepublishOnly":"pnpm test:unit && pnpm build"},"_npmUser":{"name":"yusangeng","email":"yusangeng@outlook.com"},"repository":{"url":"git+https://github.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"_npmVersion":"11.6.1","description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","directories":{},"_nodeVersion":"22.15.0","dependencies":{"js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"tmp":"tmp/settings-yaml_0.1.0_1775746709397_0.8228151175829572","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agentskillmania/settings-yaml","version":"0.2.1","author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"license":"MIT","_id":"@agentskillmania/settings-yaml@0.2.1","maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"homepage":"https://github.com/agentskillmania/colts#readme","bugs":{"url":"https://github.com/agentskillmania/colts/issues"},"dist":{"shasum":"37cfffb53c40ebb5407635724985a69931e7f128","tarball":"https://registry.npmjs.org/@agentskillmania/settings-yaml/-/settings-yaml-0.2.1.tgz","fileCount":12,"integrity":"sha512-lgFe7+rrQg/KjQmUtkQOHRagAe5/OhgAoQ65b4dEM4vZSjKakDzw2nvMJXNDS1s8C2RiePBs/BvLKOSFnvDyLQ==","signatures":[{"sig":"MEUCIGSgyVAEaSmYqdX9YpcdUPPscSBQZT23IBJsdK2ltrLQAiEA1WqaHynH0hlnszjVrPNafo6dSYbScLyiFzni9i3L8MU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37195},"main":"./dist/index.js","type":"module","_from":"file:agentskillmania-settings-yaml-0.2.1.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:unit":"vitest run test/unit","test:watch":"vitest watch test/unit","format:check":"prettier --check \"src/**/*.ts\"","test:coverage":"vitest run test/unit --coverage"},"_npmUser":{"name":"yusangeng","email":"yusangeng@outlook.com"},"_resolved":"/private/var/folders/dc/61lk2kgn1697rt0gd1s5jwf80000gn/T/01bf7273c2b5ac76b71016b094ce8d59/agentskillmania-settings-yaml-0.2.1.tgz","_integrity":"sha512-lgFe7+rrQg/KjQmUtkQOHRagAe5/OhgAoQ65b4dEM4vZSjKakDzw2nvMJXNDS1s8C2RiePBs/BvLKOSFnvDyLQ==","repository":{"url":"git+https://github.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"_npmVersion":"11.6.1","description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","directories":{},"_nodeVersion":"22.15.0","dependencies":{"js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"tmp":"tmp/settings-yaml_0.2.1_1776415235287_0.21559152938596515","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@agentskillmania/settings-yaml","version":"0.2.2","author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"license":"MIT","_id":"@agentskillmania/settings-yaml@0.2.2","maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"homepage":"https://github.com/agentskillmania/colts#readme","bugs":{"url":"https://github.com/agentskillmania/colts/issues"},"dist":{"shasum":"19a97473694b4fc02417ea75605813d2739c7de8","tarball":"https://registry.npmjs.org/@agentskillmania/settings-yaml/-/settings-yaml-0.2.2.tgz","fileCount":12,"integrity":"sha512-UzLH9j7DvEwgUWz43dWcTPphN8gMNNV1uxM4bX48uSWL2x/05ksdft1X59AgCgr9Yz1VCTWhkoh81s5WSnkxwg==","signatures":[{"sig":"MEQCICle/wHfJC+I6oL6TfrATqV/ycQH5aCqMhZ7TSI8nkCKAiBp2lpz2rrvD3CrfjAAA6Gv3mxLTUsWxbfjmSoYpKnXFQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35515},"main":"./dist/index.js","type":"module","_from":"file:agentskillmania-settings-yaml-0.2.2.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:unit":"vitest run test/unit","test:watch":"vitest watch test/unit","format:check":"prettier --check \"src/**/*.ts\"","test:coverage":"vitest run test/unit --coverage"},"_npmUser":{"name":"yusangeng","email":"yusangeng@outlook.com"},"_resolved":"/private/var/folders/dc/61lk2kgn1697rt0gd1s5jwf80000gn/T/62437f9c8c3e90dbd9d9dae00dcc3035/agentskillmania-settings-yaml-0.2.2.tgz","_integrity":"sha512-UzLH9j7DvEwgUWz43dWcTPphN8gMNNV1uxM4bX48uSWL2x/05ksdft1X59AgCgr9Yz1VCTWhkoh81s5WSnkxwg==","repository":{"url":"git+https://github.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"_npmVersion":"11.6.1","description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","directories":{},"_nodeVersion":"22.15.0","dependencies":{"js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"tmp":"tmp/settings-yaml_0.2.2_1776418259749_0.19094425081783784","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@agentskillmania/settings-yaml","version":"0.3.0","author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"license":"MIT","_id":"@agentskillmania/settings-yaml@0.3.0","maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"homepage":"https://github.com/agentskillmania/colts#readme","bugs":{"url":"https://github.com/agentskillmania/colts/issues"},"dist":{"shasum":"90a83d60a795b423998bcf198331a8de95a988c8","tarball":"https://registry.npmjs.org/@agentskillmania/settings-yaml/-/settings-yaml-0.3.0.tgz","fileCount":12,"integrity":"sha512-6Q7OyLxLHN91nK0XlVeNtIAnD3SjO2n9dmxFMzN0B6/Nv+2rlJbHBZc22v9DOTWo7OwzrJcve9xOnj54GJZfqA==","signatures":[{"sig":"MEUCIQCmwRDe/9luwkspLtb8f9s4HBzCP2csc+emc+3qwJN9DwIgNjefHloEEXuVpBXziKscHkBPP8IBla5Qlug2ghK2mh4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36034},"main":"./dist/index.js","type":"module","_from":"file:agentskillmania-settings-yaml-0.3.0.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:unit":"vitest run test/unit","test:watch":"vitest watch test/unit","format:check":"prettier --check \"src/**/*.ts\"","test:coverage":"vitest run test/unit --coverage"},"_npmUser":{"name":"yusangeng","email":"yusangeng@outlook.com"},"_resolved":"/private/var/folders/dc/61lk2kgn1697rt0gd1s5jwf80000gn/T/ab756403d1cc1a6d2ba21658166f2fb7/agentskillmania-settings-yaml-0.3.0.tgz","_integrity":"sha512-6Q7OyLxLHN91nK0XlVeNtIAnD3SjO2n9dmxFMzN0B6/Nv+2rlJbHBZc22v9DOTWo7OwzrJcve9xOnj54GJZfqA==","repository":{"url":"git+https://github.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"_npmVersion":"11.6.1","description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","directories":{},"_nodeVersion":"22.15.0","dependencies":{"js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"tmp":"tmp/settings-yaml_0.3.0_1778229489056_0.9312547531124693","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@agentskillmania/settings-yaml","version":"0.4.0","author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"license":"MIT","_id":"@agentskillmania/settings-yaml@0.4.0","maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"homepage":"https://github.com/agentskillmania/colts#readme","bugs":{"url":"https://github.com/agentskillmania/colts/issues"},"dist":{"shasum":"079ce755a1cb30e546f77f43c118b07be367db0f","tarball":"https://registry.npmjs.org/@agentskillmania/settings-yaml/-/settings-yaml-0.4.0.tgz","fileCount":12,"integrity":"sha512-V2Hr1veLiysL3aZONoWqKAgY4X004+p2RqKWB0thDvL18kKdS48PVccY5o76hE2oS3PWbCZvNgncEOK0/kv2wA==","signatures":[{"sig":"MEUCIQDCUjhpdLhV3fX5Y8GqICsHFRA2KE2BuZs2GfO7CzCT3QIgfQ84+O5VCYHnw33a9pzuQV7IAEu/KpJBFDklwa/HHmk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38188},"main":"./dist/index.js","type":"module","_from":"file:agentskillmania-settings-yaml-0.4.0.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:unit":"vitest run test/unit","test:watch":"vitest watch test/unit","format:check":"prettier --check \"src/**/*.ts\"","test:coverage":"vitest run test/unit --coverage"},"_npmUser":{"name":"yusangeng","email":"yusangeng@outlook.com"},"_resolved":"/private/var/folders/dc/61lk2kgn1697rt0gd1s5jwf80000gn/T/91362c717d8dea256c427cbd41166dee/agentskillmania-settings-yaml-0.4.0.tgz","_integrity":"sha512-V2Hr1veLiysL3aZONoWqKAgY4X004+p2RqKWB0thDvL18kKdS48PVccY5o76hE2oS3PWbCZvNgncEOK0/kv2wA==","repository":{"url":"git+https://github.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"_npmVersion":"11.6.1","description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","directories":{},"_nodeVersion":"22.15.0","dependencies":{"js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"tmp":"tmp/settings-yaml_0.4.0_1786593536726_0.5175145229724618","host":"s3://npm-registry-packages-npm-production"}},"0.5.0-alpha.1":{"name":"@agentskillmania/settings-yaml","version":"0.5.0-alpha.1","author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"license":"MIT","_id":"@agentskillmania/settings-yaml@0.5.0-alpha.1","maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"homepage":"https://github.com/agentskillmania/colts#readme","bugs":{"url":"https://github.com/agentskillmania/colts/issues"},"dist":{"shasum":"3731ce9fe6f19319f53c9f13594a92b49ebd6953","tarball":"https://registry.npmjs.org/@agentskillmania/settings-yaml/-/settings-yaml-0.5.0-alpha.1.tgz","fileCount":12,"integrity":"sha512-Xj3lSfWT44+75hIODipFb7Myl5J1iPG8zc1KL03iyM4bUJWS6GTxI2s5LHN/L+B9tRYn5lKhI5QVFhTL9DqAFA==","signatures":[{"sig":"MEUCIGgjqzOuNyXWkTKv9b4vhsNMuGXPYYaScmVQdHL+gs0WAiEAsdin2q5/Zg8fZUGPqn+oDVTA/LK5yC1RmkXkorAEfWg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38196},"main":"./dist/index.js","type":"module","_from":"file:agentskillmania-settings-yaml-0.5.0-alpha.1.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:unit":"vitest run test/unit","test:watch":"vitest watch test/unit","format:check":"prettier --check \"src/**/*.ts\"","test:coverage":"vitest run test/unit --coverage"},"_npmUser":{"name":"yusangeng","email":"yusangeng@outlook.com"},"_resolved":"/private/var/folders/dc/61lk2kgn1697rt0gd1s5jwf80000gn/T/e424d045f8c2bee1c384700caaee7591/agentskillmania-settings-yaml-0.5.0-alpha.1.tgz","_integrity":"sha512-Xj3lSfWT44+75hIODipFb7Myl5J1iPG8zc1KL03iyM4bUJWS6GTxI2s5LHN/L+B9tRYn5lKhI5QVFhTL9DqAFA==","repository":{"url":"git+https://github.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"_npmVersion":"10.9.8","description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.zh_CN.md","devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"tmp":"tmp/settings-yaml_0.5.0-alpha.1_1789577438916_0.6268476975676411","host":"s3://npm-registry-packages-npm-production"}},"0.5.0-alpha.2":{"name":"@agentskillmania/settings-yaml","version":"0.5.0-alpha.2","author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"license":"MIT","_id":"@agentskillmania/settings-yaml@0.5.0-alpha.2","maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"dist":{"shasum":"5aa5f765e5b75ff897ac16eec1db28290869551e","tarball":"https://registry.npmjs.org/@agentskillmania/settings-yaml/-/settings-yaml-0.5.0-alpha.2.tgz","fileCount":12,"integrity":"sha512-NSaTNgMEPSqMSpGpsLGL+FL7AJG7wb4tQ5cCgKWMbg7kH2CfkmjIDK6wDHeF12oMBzSk5eSC/3z7Birk2HXoJQ==","signatures":[{"sig":"MEQCIATmaJC/bKpkl4MhjEEtkhMyoDCz6Kae6sq6dkM0KmkDAiAub5Sf9Ikm+QnR03FdcMsDsWAEe+skMdmWDSkRvbfl0g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCajrMtx9YayD8mod7nqiFEUgGrIQullfQT1E8e+dee6gIhAPLvzjOouDe+bz9Q9gS3//N++JA0Q1mmemKZ9dIh9lxR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38195},"main":"./dist/index.js","type":"module","_from":"file:agentskillmania-settings-yaml-0.5.0-alpha.2.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:unit":"vitest run test/unit","test:watch":"vitest watch test/unit","format:check":"prettier --check \"src/**/*.ts\"","test:coverage":"vitest run test/unit --coverage"},"_npmUser":{"name":"yusangeng","email":"yusangeng@outlook.com"},"_resolved":"/private/var/folders/dc/61lk2kgn1697rt0gd1s5jwf80000gn/T/aef9c7565f7f645c70596b57b2fa7987/agentskillmania-settings-yaml-0.5.0-alpha.2.tgz","_integrity":"sha512-NSaTNgMEPSqMSpGpsLGL+FL7AJG7wb4tQ5cCgKWMbg7kH2CfkmjIDK6wDHeF12oMBzSk5eSC/3z7Birk2HXoJQ==","repository":{"url":"https://gitee.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"_npmVersion":"10.9.8","description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.zh_CN.md","devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"tmp":"tmp/settings-yaml_0.5.0-alpha.2_1789803525539_0.8184020365434606","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"_id":"@agentskillmania/settings-yaml@0.5.0","dist":{"shasum":"ac1b72d63c30aa9162852667dd488b6108829961","tarball":"https://registry.npmjs.org/@agentskillmania/settings-yaml/-/settings-yaml-0.5.0.tgz","fileCount":12,"integrity":"sha512-N6DLhaO9DEpxnYAW1X6dkIoY2Zj9W2OylYZkHvtolcl9PY9Q6uc73rHd5kWPmqII/kkOAKHM2UDZhjxivJVqZg==","signatures":[{"sig":"MEYCIQCMceo9P7CJXy17Jp9xJX+D/aHXSBnpCJo2KsihWmo+/AIhAIDGl+lEomu/E/lXlv6qUmnInSHy3HhDIJnWpzEMyR3C","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIChVGcy3PtRIUo23y/ZVylLe18Kxqm7GDC54xTtonK6RAiEA5146Jfuw/shqWcs0UeXpLUDlaziRlTsW1JyMKT0KRgA="}],"unpackedSize":38187},"main":"./dist/index.js","name":"@agentskillmania/settings-yaml","type":"module","_from":"file:agentskillmania-settings-yaml-0.5.0.tgz","types":"./dist/index.d.ts","author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"license":"MIT","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:unit":"vitest run test/unit","test:watch":"vitest watch test/unit","format:check":"prettier --check \"src/**/*.ts\"","test:coverage":"vitest run test/unit --coverage"},"version":"0.5.0","_npmUser":{"name":"yusangeng","email":"yusangeng@outlook.com"},"_resolved":"/private/var/folders/dc/61lk2kgn1697rt0gd1s5jwf80000gn/T/0cb4bd640f02d1b38058dddf533377c4/agentskillmania-settings-yaml-0.5.0.tgz","_integrity":"sha512-N6DLhaO9DEpxnYAW1X6dkIoY2Zj9W2OylYZkHvtolcl9PY9Q6uc73rHd5kWPmqII/kkOAKHM2UDZhjxivJVqZg==","repository":{"url":"https://gitee.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"_npmVersion":"10.9.8","description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","directories":{},"maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"_nodeVersion":"22.23.2","dependencies":{"js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/settings-yaml_0.5.0_1790059756379_0.03679886071788108"}}},"time":{"created":"2026-04-09T14:58:29.296Z","modified":"2026-09-22T06:49:16.686Z","0.1.0":"2026-04-09T14:58:29.575Z","0.2.1":"2026-04-17T08:40:35.407Z","0.2.2":"2026-04-17T09:30:59.945Z","0.3.0":"2026-05-08T08:38:09.221Z","0.4.0":"2026-08-13T03:58:56.873Z","0.5.0-alpha.1":"2026-09-16T16:50:39.057Z","0.5.0-alpha.2":"2026-09-19T07:38:45.625Z","0.5.0":"2026-09-22T06:49:16.470Z"},"author":{"name":"yusangeng","email":"yusangeng@outlook.com"},"license":"MIT","repository":{"url":"https://gitee.com/agentskillmania/colts.git","type":"git","directory":"packages/settings-yaml"},"description":"A robust configuration management library for loading, merging, and managing YAML-based settings with deep merge support, default value fallback, and runtime override capabilities.","maintainers":[{"name":"yusangeng","email":"yusangeng@outlook.com"}],"readme":"# @agentskillmania/settings-yaml\n\n[![npm version](https://img.shields.io/npm/v/@agentskillmania/settings-yaml.svg)](https://www.npmjs.com/package/@agentskillmania/settings-yaml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![English Documentation](https://img.shields.io/badge/docs-English-blue.svg)](./README.md)\n\nYAML 配置管理库。深度合并、默认值回退、运行时覆盖。一行初始化，点号路径读写，按需持久化。\n\n## 特色\n\n- **深度合并** — 递归合并嵌套对象，数组按元素逐项合并\n- **默认值回退** — 根据默认 YAML 模板自动创建配置文件\n- **运行时覆盖** — 支持临时覆盖（如命令行参数），优先级最高\n- **不可变值** — 返回的配置对象已被冻结\n- **点号路径访问** — 通过 `server.port` 风格的路径读写嵌套值\n\n## 安装\n\n```bash\npnpm add @agentskillmania/settings-yaml\n```\n\n## 快速开始\n\n```typescript\nimport { Settings } from '@agentskillmania/settings-yaml';\n\nconst settings = new Settings('~/.config/myapp/config.yaml');\n\nawait settings.initialize({\n  defaultYaml: `\n    server:\n      port: 3000\n      host: localhost\n  `,\n});\n\nconst config = settings.getValues();\nconsole.log(config.server.port); // 3000\n```\n\n## 合并优先级\n\n配置按以下优先级合并（从高到低）：\n\n1. 传给 `initialize()` 的 `override` 对象\n2. 磁盘上已有的配置文件\n3. `defaultYaml` 默认模板\n\n## API 参考\n\n### `constructor(configPath: string)`\n\n创建 `Settings` 实例。支持绝对路径、相对路径和 `~/` 主目录路径。\n\n### `async initialize(options?): Promise<void>`\n\n- 配置文件**不存在**且提供了 `defaultYaml`：使用默认值创建文件\n- 配置文件**不存在**且未提供 `defaultYaml`：抛出错误\n- 配置文件**已存在**：读取并与 `defaultYaml` 深度合并\n- `override` 值具有最高优先级\n- 自动创建中间目录\n\n### `getValues(): T`\n\n返回深度合并后的配置对象，已被冻结。\n\n### `has(keyPath: string): boolean`\n\n使用点号路径检查嵌套 key 是否存在。\n\n```typescript\nsettings.has('server.port'); // true\n```\n\n### `set(keyPath: string, value: unknown): void`\n\n更新内存中的嵌套值。需调用 `save()` 持久化。\n\n```typescript\nsettings.set('server.port', 8080);\n```\n\n### `toObject(): Record<string, unknown>`\n\n返回当前配置的可变深拷贝。\n\n### `async save(): Promise<void>`\n\n将内存中的配置写回磁盘。\n\n```typescript\nsettings.set('llm.model', 'gpt-4o');\nawait settings.save();\n```\n\n## 示例\n\n```typescript\n// 默认值 + 运行时覆盖\nawait settings.initialize({\n  defaultYaml: `server: { port: 3000 }`,\n  override: { server: { port: 9000 } },\n});\n// 结果: { server: { port: 9000 } }\n\n// 读取并修改\nawait settings.initialize();\nif (settings.has('debug')) {\n  settings.set('debug', false);\n  await settings.save();\n}\n```\n\n## License\n\nMIT\n","readmeFilename":"README.zh_CN.md"}