@guanghechen/filesplit 2.0.1

package/CHANGELOG.md

@@ -0,0 +1,727 @@
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 1.0.0-alpha.23 (2024-09-18)
+
+- :wrench: chore: upgrade devDependencies and fix configs
+  ([230fb63](https://github.com/guanghechen/sora/commit/230fb63))
+
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [1.0.0-alpha.22](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.21...@guanghechen/file-split@1.0.0-alpha.22) (2024-03-10)
+
+### Performance Improvements
+
+- :art: format codes
+  ([177eb54](https://github.com/guanghechen/sora/commit/177eb5407fe9209269541a327d42084901a63090))
+
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [1.0.0-alpha.21](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.20...@guanghechen/file-split@1.0.0-alpha.21) (2024-03-09)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [1.0.0-alpha.20](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.19...@guanghechen/file-split@1.0.0-alpha.20) (2024-02-03)
+
+### Performance Improvements
+
+- 💄 fix lint
+  ([2d5bb6f](https://github.com/guanghechen/sora/commit/2d5bb6f03d0312a42c1117d95181df8b69de827a))
+- 🔧 fix nx scripts
+  ([47bc4e6](https://github.com/guanghechen/sora/commit/47bc4e66df825cb37127219bccf60dc81d6a9b48))
+- 🔧 update tsconfig
+  ([98855bc](https://github.com/guanghechen/sora/commit/98855bcc245d98c61217c5bafc6a1b2506b7824d))
+
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [1.0.0-alpha.19](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.18...@guanghechen/file-split@1.0.0-alpha.19) (2024-01-15)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.18](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.17...@guanghechen/file-split@1.0.0-alpha.18) (2024-01-02)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.17](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.16...@guanghechen/file-split@1.0.0-alpha.17) (2023-12-10)
+
+### Performance Improvements
+
+- 🎨 export const DEFAULT_FILEPART_CODE_PREFIX from @guanghechen/filepart.types
+  ([d6d2b1d](https://github.com/guanghechen/sora/commit/d6d2b1d960a9a02b3315c4cbd32cdc1fa53cccc3))
+- 🎨 make methods return iterator instead of array
+  ([1fddedd](https://github.com/guanghechen/sora/commit/1fddedd8a8de6b21c0431bdacf2a7d8a17bd2c86))
+- 🎨 move filepart related code from @guanghechen/file-split to new package @guanghechen/filepart
+  ([833aa10](https://github.com/guanghechen/sora/commit/833aa10f4eee38b09a375b221a0a763f96d8fd4c))
+
+# [1.0.0-alpha.16](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.15...@guanghechen/file-split@1.0.0-alpha.16) (2023-12-07)
+
+### Performance Improvements
+
+- 🎨 add interface for FileSplitter
+  ([0aefc92](https://github.com/guanghechen/sora/commit/0aefc92678d981d10e5cef4bab9227d1c0fc9d7d))
+
+# [1.0.0-alpha.15](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.14...@guanghechen/file-split@1.0.0-alpha.15) (2023-12-04)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.14](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.13...@guanghechen/file-split@1.0.0-alpha.14) (2023-12-03)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.13](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.12...@guanghechen/file-split@1.0.0-alpha.13) (2023-12-02)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.12](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.11...@guanghechen/file-split@1.0.0-alpha.12) (2023-11-29)
+
+### Performance Improvements
+
+- 🔧 no longer to require node engine version in packages
+  ([6dc2014](https://github.com/guanghechen/sora/commit/6dc2014122dd44bcadc893e2ee98697265e7d61e))
+
+# [1.0.0-alpha.11](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.10...@guanghechen/file-split@1.0.0-alpha.11) (2023-11-18)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.10](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.9...@guanghechen/file-split@1.0.0-alpha.10) (2023-11-18)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.9](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.8...@guanghechen/file-split@1.0.0-alpha.9) (2023-11-18)
+
+### Performance Improvements
+
+- 🔧 upgrade engine version requirement from '>= 16.0.0' to '>= 18.0.0'
+  ([ddb9521](https://github.com/guanghechen/sora/commit/ddb9521b529b2ca838554794339b9e27ac80b8aa))
+
+# [1.0.0-alpha.8](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.7...@guanghechen/file-split@1.0.0-alpha.8) (2023-11-07)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.7](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.6...@guanghechen/file-split@1.0.0-alpha.7) (2023-10-26)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.6](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.5...@guanghechen/file-split@1.0.0-alpha.6) (2023-10-25)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.5](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.4...@guanghechen/file-split@1.0.0-alpha.5) (2023-10-22)
+
+### Performance Improvements
+
+- 🎨 prefer Uint8Array instead of Buffer
+  ([0789b58](https://github.com/guanghechen/sora/commit/0789b58deb7c8d0f6fc8d2ae1eb0cf2b71390552))
+
+# [1.0.0-alpha.4](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.3...@guanghechen/file-split@1.0.0-alpha.4) (2023-10-16)
+
+### Performance Improvements
+
+- 🔧 remove unnecessary devDependencies
+  ([944f3ae](https://github.com/guanghechen/sora/commit/944f3aee64e68ce52ca30237c7d0240a82c9c58f))
+
+# [1.0.0-alpha.3](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.2...@guanghechen/file-split@1.0.0-alpha.3) (2023-10-10)
+
+**Note:** Version bump only for package @guanghechen/file-split
+
+# [1.0.0-alpha.2](https://github.com/guanghechen/sora/compare/@guanghechen/file-split@1.0.0-alpha.1...@guanghechen/file-split@1.0.0-alpha.2) (2023-10-09)
+
+### Performance Improvements
+
+- 🎨 make codes tidy
+  ([3ca94af](https://github.com/guanghechen/sora/commit/3ca94af8bb8c3ef1a9bf2995a9f2dd9e4081b6d3))
+
+# 1.0.0-alpha.1 (2023-10-04)
+
+### Features
+
+- ✨ add @guagnhechen/file-split (migrate from @guanghechen/helper-file)
+  ([56ef3f1](https://github.com/guanghechen/sora/commit/56ef3f163dd6ae2e40d93ea78aacecc80886220f))
+
+### Performance Improvements
+
+- 🎨 move @guagnhechen/invariant to @guanghechen/internal
+  ([e8341be](https://github.com/guanghechen/sora/commit/e8341be562e92d08142187d59dad099ac2e4a4e4))
+- ⬆️ the version of subpackage devDependencies is not matter
+  ([3287c22](https://github.com/guanghechen/sora/commit/3287c22fb150af6620c1c9f6f4b186498aea815b))
+
+## [5.0.7](https://github.com/guanghechen/node-scaffolds/compare/@guanghechen/helper-file@5.0.6...@guanghechen/helper-file@5.0.7) (2023-09-07)
+
+### Performance Improvements
+
+- ⬆️ upgrade dependencies
+  ([83e3f3e](https://github.com/guanghechen/node-scaffolds/commit/83e3f3eaf4c3a354e2ddf167fa1a4bb75e750427))
+
+## [5.0.6](https://github.com/guanghechen/node-scaffolds/compare/@guanghechen/helper-file@5.0.5...@guanghechen/helper-file@5.0.6) (2023-08-27)
+
+### Performance Improvements
+
+- ⬆️ upgrade dependencies
+  ([8fa97de](https://github.com/guanghechen/node-scaffolds/commit/8fa97dee952f55565a2ac9b6680256c406df72ab))
+
+## [5.0.5](https://github.com/guanghechen/node-scaffolds/compare/@guanghechen/helper-file@5.0.4...@guanghechen/helper-file@5.0.5) (2023-08-19)
+
+### Performance Improvements
+
+- ⬆️ upgrade dependencies
+  ([2c25097](https://github.com/guanghechen/node-scaffolds/commit/2c25097d9733f3e17d9725fede8dc960073099fe))
+
+## [5.0.4](https://github.com/guanghechen/node-scaffolds/compare/@guanghechen/helper-file@5.0.3...@guanghechen/helper-file@5.0.4) (2023-08-08)
+
+### Performance Improvements
+
+- ⬆️ upgrade dependencies
+  ([bbc1ae6](https://github.com/guanghechen/node-scaffolds/commit/bbc1ae6b40aa4030f4103035f062dd4040a35b08))
+
+## [5.0.3](https://github.com/guanghechen/node-scaffolds/compare/@guanghechen/helper-file@5.0.2...@guanghechen/helper-file@5.0.3) (2023-07-25)
+
+### Performance Improvements
+
+- 🔧 update npm script
+  ([4ffc90a](https://github.com/guanghechen/node-scaffolds/commit/4ffc90aff15c75fcc6afeeabf4d83dbc8c1b7933))
+- ⬆️ upgrade dependencies
+  ([a9b6097](https://github.com/guanghechen/node-scaffolds/commit/a9b609785175e91903ca8215a807691ba6fbc419))
+
+## [5.0.2](https://github.com/guanghechen/node-scaffolds/compare/@guanghechen/helper-file@5.0.1...@guanghechen/helper-file@5.0.2) (2023-07-15)
+
+### Performance Improvements
+
+- ⬆️ upgrade dependencies
+  ([4f0f471](https://github.com/guanghechen/node-scaffolds/commit/4f0f4712d061099ea9d5605efeb54357e4479f6a))
+
+## [5.0.1](https://github.com/guanghechen/node-scaffolds/compare/@guanghechen/helper-file@5.0.0...@guanghechen/helper-file@5.0.1) (2023-05-26)
+
+### Performance Improvements
+
+- 🔧 update jest config to reuse tsconfig for test
+  ([54883f0](https://github.com/guanghechen/node-scaffolds/commit/54883f032cbba78af4609d6d4fb2b5e1ac68b518))
+
+# 5.0.0 (2023-05-13)
+
+### Performance Improvements
+
+- 📝 remove all CHANGELOG in repo
+  ([40909ed](https://github.com/guanghechen/node-scaffolds/commit/40909ed439632e0c4b0cd817614e24fdeac2fa23))
+
+# 5.0.0-alpha.3 (2023-05-07)
+
+### Performance Improvements
+
+- :bookmark: release
+  ([b5a3423](https://github.com/guanghechen/node-scaffolds/commit/b5a3423a3dd338d13ac4247c2651f4693f9fe363))
+- ⬆️ upgrade devDependencies
+  ([30a9c27](https://github.com/guanghechen/node-scaffolds/commit/30a9c27c22b8debcf8dd5b2652ec335458caf31c))
+
+# 5.0.0-alpha.2 (2023-05-01)
+
+### Performance Improvements
+
+- 🔖 publish v5.0.0-alpha.2
+  ([708dd6d](https://github.com/guanghechen/node-scaffolds/commit/708dd6d721059e902c375e628c939b28664f3058))
+- ⬆️ upgrade dependencies
+  ([d7f49fe](https://github.com/guanghechen/node-scaffolds/commit/d7f49fe9a0cedfbb2a7584da196a1bcc7b78bacd))
+
+# 5.0.0-alpha.1 (2023-04-09)
+
+### Performance Improvements
+
+- 🔖 publish v5.0.0-alpha.1
+  ([45d61b7](https://github.com/guanghechen/node-scaffolds/commit/45d61b7ac2bd92cd6fbbfb5c310bd6bbb95f49f8))
+
+# 5.0.0-alpha.0 (2023-04-02)
+
+### Performance Improvements
+
+- ⬆️ don't pack src/ folder in tarball
+  ([69671c5](https://github.com/guanghechen/node-scaffolds/commit/69671c533e15278052bf7b99bec2d70eab141393))
+- 🔖 publish v5.0.0-alpha.0
+  ([cf3e9a2](https://github.com/guanghechen/node-scaffolds/commit/cf3e9a2293c95fe113aa3515409276d5c50a794d))
+- 📝 update links for release-5.x.x
+  ([672ea87](https://github.com/guanghechen/node-scaffolds/commit/672ea87c86f2eca1adfd136e74a4a4f7c58592a2))
+
+## 4.7.4 (2023-03-26)
+
+### Performance Improvements
+
+- 🔖 publish v4.7.4
+  ([c30d5c4](https://github.com/guanghechen/node-scaffolds/commit/c30d5c42d2b5671118ab0261390e17ae45d279c6))
+- ⬆️ upgrade devDependencies
+  ([8bfcfc5](https://github.com/guanghechen/node-scaffolds/commit/8bfcfc5931cb388a7e93c17b417507f0ce964bb5))
+
+## 4.7.3 (2023-03-25)
+
+### Performance Improvements
+
+- 🔖 publish v4.7.3
+  ([5c5cb47](https://github.com/guanghechen/node-scaffolds/commit/5c5cb4750d7d4e455e0b39565c0a304f736a3251))
+- 🎨 update options
+  ([2c75565](https://github.com/guanghechen/node-scaffolds/commit/2c75565e3d59b19fde37cb7c4f0eea677859fedb))
+
+## 4.7.2 (2023-03-23)
+
+### Performance Improvements
+
+- 🔖 publish v4.7.2
+  ([e628cc9](https://github.com/guanghechen/node-scaffolds/commit/e628cc99eb2dcd8665bbac124ec587824382c698))
+- ⬆️ upgrade devDependencies
+  ([2be4555](https://github.com/guanghechen/node-scaffolds/commit/2be4555e58cc40bd290faa66f160751be3e22bee))
+
+## 4.7.1 (2023-03-19)
+
+### Performance Improvements
+
+- 🔖 publish v4.7.1
+  ([1349c5c](https://github.com/guanghechen/node-scaffolds/commit/1349c5cf88890817b259b579449884bafb598d86))
+- ⬆️ upgrade devDependencies
+  ([ce172dd](https://github.com/guanghechen/node-scaffolds/commit/ce172ddfc3899902475fa14795e70f261ed35b37))
+
+# 4.7.0 (2023-03-12)
+
+### Performance Improvements
+
+- 🔖 publish v4.7.0
+  ([0641367](https://github.com/guanghechen/node-scaffolds/commit/06413670b283538876023c66d0f2afa45074b016))
+
+## 4.6.5 (2023-03-12)
+
+### Performance Improvements
+
+- 🔖 publish v4.6.5
+  ([83a48e7](https://github.com/guanghechen/node-scaffolds/commit/83a48e74ac5875200e8c30c332ffc1a4ff57e79f))
+
+## 4.6.4 (2023-03-12)
+
+### Performance Improvements
+
+- 🔖 publish v4.6.4
+  ([1ad9150](https://github.com/guanghechen/node-scaffolds/commit/1ad9150445f9c7d03153f81f54bf0815b7510f50))
+
+## 4.6.3 (2023-03-11)
+
+### Performance Improvements
+
+- 🔖 publish v4.6.3
+  ([16683dd](https://github.com/guanghechen/node-scaffolds/commit/16683dd3e64ea492c1b49d0dea7e81b98ea9d71c))
+
+## 4.6.2 (2023-03-10)
+
+### Performance Improvements
+
+- 🔖 publish v4.6.2
+  ([3547f1c](https://github.com/guanghechen/node-scaffolds/commit/3547f1ca30871d8065c3c075d360d23df3fe84f2))
+- ⬆️ upgrade devDependencies
+  ([5f4cfd5](https://github.com/guanghechen/node-scaffolds/commit/5f4cfd5c9d5b8f371d54d9a4c2a3882f7498b882))
+
+## 4.6.1 (2023-03-05)
+
+### Performance Improvements
+
+- 🔖 publish v4.6.1
+  ([2d88cf7](https://github.com/guanghechen/node-scaffolds/commit/2d88cf7835c017183a5fd097ebf2a7c7fe622692))
+- ⬆️ upgrade devDependencies
+  ([b358df3](https://github.com/guanghechen/node-scaffolds/commit/b358df3c4da109260dbd4ab43e72f80ffdf3cecd))
+
+# 4.6.0 (2023-02-28)
+
+### Performance Improvements
+
+- 🔖 publish v4.6.0
+  ([d45f55f](https://github.com/guanghechen/node-scaffolds/commit/d45f55f4cd4d8214beb0724a45de4f36baa431c1))
+
+# 4.5.0 (2023-02-27)
+
+### Performance Improvements
+
+- 🔖 publish v4.5.0
+  ([a361eb1](https://github.com/guanghechen/node-scaffolds/commit/a361eb1b21a9fa55e7da7c44584dfc4f04c0af36))
+
+## 4.4.3 (2023-02-27)
+
+### Performance Improvements
+
+- 🔖 publish v4.4.3
+  ([29113fb](https://github.com/guanghechen/node-scaffolds/commit/29113fb651d40ec8144059875e2dd36b103e25b8))
+
+## 4.4.2 (2023-02-26)
+
+### Performance Improvements
+
+- 🔖 publish v4.4.2
+  ([e864740](https://github.com/guanghechen/node-scaffolds/commit/e8647409675f14054b6ba4eee770377e3d68ec1e))
+
+## 4.4.1 (2023-02-25)
+
+### Performance Improvements
+
+- 🔖 publish v4.4.1
+  ([332c5ff](https://github.com/guanghechen/node-scaffolds/commit/332c5ff77ef74b08a5349e80c64cc35a7ea1bbed))
+
+# 4.4.0 (2023-02-25)
+
+### Performance Improvements
+
+- 🔖 publish v4.4.0
+  ([c54cc52](https://github.com/guanghechen/node-scaffolds/commit/c54cc52236ed01f80b310cb8c0a07fe0beb42755))
+- ⬆️ upgrade devDependencies
+  ([3a4d2de](https://github.com/guanghechen/node-scaffolds/commit/3a4d2def1cc59fdabe58888da7970da348de538a))
+
+# 4.3.0 (2023-02-21)
+
+### Performance Improvements
+
+- 🔖 publish v4.3.0
+  ([501a8df](https://github.com/guanghechen/node-scaffolds/commit/501a8dfb2cf7ff8302af41cf24acf99ca5c254c8))
+
+## 4.2.2 (2023-02-20)
+
+### Performance Improvements
+
+- 🔖 publish v4.2.2
+  ([bf0f251](https://github.com/guanghechen/node-scaffolds/commit/bf0f251214e1eac2056911e2ad7895dfa19959d7))
+
+## 4.2.1 (2023-02-20)
+
+### Performance Improvements
+
+- 🔖 publish v4.2.1
+  ([6a117ec](https://github.com/guanghechen/node-scaffolds/commit/6a117ece78cfaeff8d7d14da548e07d20a2816a7))
+
+# 4.2.0 (2023-02-19)
+
+### Performance Improvements
+
+- 🔖 publish v4.2.0
+  ([ee9c6e2](https://github.com/guanghechen/node-scaffolds/commit/ee9c6e246278aa1bd6a2f5802891b4b41f5fbb6f))
+
+## 4.1.3 (2023-02-18)
+
+### Performance Improvements
+
+- 🔖 publish v4.1.3
+  ([89ce0d8](https://github.com/guanghechen/node-scaffolds/commit/89ce0d84e973cc87444db249ea6a6eeb6572a524))
+
+## 4.1.2 (2023-02-18)
+
+### Performance Improvements
+
+- 🔖 publish v4.1.2
+  ([ff461e9](https://github.com/guanghechen/node-scaffolds/commit/ff461e94432c8baa395c4d82af81f53448ff5084))
+
+## 4.1.1 (2023-02-18)
+
+### Performance Improvements
+
+- 🔖 publish v4.1.1
+  ([01f6698](https://github.com/guanghechen/node-scaffolds/commit/01f6698a7456bddbfe1c62df41d500e83a68de0d))
+- 🔧 remove unnecessary devDependencies
+  ([f717518](https://github.com/guanghechen/node-scaffolds/commit/f71751803558970cccde05f96bff63436db8e2aa))
+- ⬆️ upgrade devDependencies
+  ([e46df0d](https://github.com/guanghechen/node-scaffolds/commit/e46df0def851adee643918b6626f1f867eb729e4))
+
+# 4.1.0 (2023-02-18)
+
+### Performance Improvements
+
+- 🔖 publish v4.1.0
+  ([a2eb1f3](https://github.com/guanghechen/node-scaffolds/commit/a2eb1f37d4646e3e612f3b407a6cf078daf436a6))
+
+# 4.0.0 (2023-02-13)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0
+  ([a635369](https://github.com/guanghechen/node-scaffolds/commit/a63536936a3d9886579f405da75606be0dc2bb81))
+
+# 4.0.0-alpha.8 (2023-02-12)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0-alpha.8
+  ([07368f1](https://github.com/guanghechen/node-scaffolds/commit/07368f180b4184a9a1a56a7b4699d11c02375fa9))
+
+# 4.0.0-alpha.7 (2023-02-12)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0-alpha.7
+  ([c93c32c](https://github.com/guanghechen/node-scaffolds/commit/c93c32cdebd9525f5db4e9219eb2fb6d750bffea))
+- 🔧 upgrade devDependencies
+  ([320adbe](https://github.com/guanghechen/node-scaffolds/commit/320adbe4fdd15f859933c1eb913518e687942004))
+
+# 4.0.0-alpha.6 (2023-02-08)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0-alpha.6
+  ([a9e5548](https://github.com/guanghechen/node-scaffolds/commit/a9e55488e45affeedc069037e18743c1856b208b))
+
+# 4.0.0-alpha.5 (2023-02-05)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0-alpha.5
+  ([df74a71](https://github.com/guanghechen/node-scaffolds/commit/df74a71a3ac9afa7a54e423e691e5bbf7122deeb))
+
+# 4.0.0-alpha.4 (2023-02-04)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0-alpha.4
+  ([bbbbb92](https://github.com/guanghechen/node-scaffolds/commit/bbbbb92773cd18e39a848bc1a3e54e0d80388c23))
+
+# 4.0.0-alpha.3 (2023-02-04)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0-alpha.3
+  ([1f3b9e1](https://github.com/guanghechen/node-scaffolds/commit/1f3b9e198486a47e8d400f89e581985e03b57ded))
+
+# 4.0.0-alpha.2 (2023-02-04)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0-alpha.2
+  ([42930f9](https://github.com/guanghechen/node-scaffolds/commit/42930f930e2f81eb227fd61dd8af9c9afd40528f))
+
+# 4.0.0-alpha.1 (2023-02-04)
+
+### Performance Improvements
+
+- 🔖 publish v4.0.0-alpha.1
+  ([66bd5c7](https://github.com/guanghechen/node-scaffolds/commit/66bd5c7f0ee9b32f269cc366c33575fcef01fa97))
+- ⬆️ upgrade devDependencies
+  ([75c3da9](https://github.com/guanghechen/node-scaffolds/commit/75c3da99c657543aaa9a8c1517766f0044898b22))
+
+# 4.0.0-alpha.0 (2023-02-04)
+
+### Bug Fixes
+
+- 🐛 should always use `undefined` encoding to get raw buffer instead of any pretreated data
+  ([53ba810](https://github.com/guanghechen/node-scaffolds/commit/53ba81011213f0955444477d7e4683be6452b961))
+
+### Features
+
+- ✨ implement @guanghechen/helper-cipher-file (abstract from helper-cipher)
+  ([a661a46](https://github.com/guanghechen/node-scaffolds/commit/a661a46e94ab6942b3283fefce97404c52837861))
+
+### Performance Improvements
+
+- [BREAKING] improve: prefer fileSize instead of a filepath in calcFilePartItemsBySize and
+  calcFilePartItemsByCount
+  ([9412c29](https://github.com/guanghechen/node-scaffolds/commit/9412c2951f475cb7f26913d6570e04d504879034))
+- :sparkles: [BREAKING] feat: implement @guanghechen/helper-fs & move some methods from
+  @guanghechen/helper-file and @guanghechen/helper-path to it
+  ([51e1a57](https://github.com/guanghechen/node-scaffolds/commit/51e1a57838940bfba81d9c7b2b4c316b209c5d10))
+- 🎨 extract calcFilePartNames from BigFileHelper
+  ([f8758b3](https://github.com/guanghechen/node-scaffolds/commit/f8758b3de0042932cf82142ed4b2d17fda194a91))
+- 🎨 narrow types
+  ([36dd01b](https://github.com/guanghechen/node-scaffolds/commit/36dd01bf91628d46c67b55c4cbd489ba0ac2aafb))
+- ✅ refactor tests
+  ([2d4a7e0](https://github.com/guanghechen/node-scaffolds/commit/2d4a7e0b71a8565f86bbe65ca4bb4cf5e3e4c08f))
+- 🔖 publish v4.0.0-alpha.0
+  ([2e04d90](https://github.com/guanghechen/node-scaffolds/commit/2e04d90202c630a1bbef60440b9504c993bb37fb))
+- 📝 update doc url
+  ([c99c7f8](https://github.com/guanghechen/node-scaffolds/commit/c99c7f8849dc96e800d0fd166ac8fe748b1356f0))
+- ✅ update tests
+  ([c1866e1](https://github.com/guanghechen/node-scaffolds/commit/c1866e1ea03bb0923eadcd5eb8d4329a9721b613))
+- ✅ update tests
+  ([d06290d](https://github.com/guanghechen/node-scaffolds/commit/d06290dafb3a71341de17abfb92f0d0189a1cdf1))
+- ⬆️ upgrade dependencies
+  ([f72ecb0](https://github.com/guanghechen/node-scaffolds/commit/f72ecb02a5c74f791c465aefacf11fe24e2fa1e2))
+- ⬆️ upgrade devDependencies
+  ([325e12d](https://github.com/guanghechen/node-scaffolds/commit/325e12d78a76d205ad82a1c8a6758a34df404c34))
+- ⬆️ upgrade devDependencies
+  ([5abb430](https://github.com/guanghechen/node-scaffolds/commit/5abb430a3b59da5ab02c2b55cc30cc46e6a627b5))
+
+## 3.0.2 (2023-01-14)
+
+### Performance Improvements
+
+- 🔖 publish v3.0.2
+  ([6837f48](https://github.com/guanghechen/node-scaffolds/commit/6837f483f60ac736a14941616f36600043b0b992))
+
+## 3.0.1 (2023-01-14)
+
+### Performance Improvements
+
+- 🔖 publish v3.0.1
+  ([d10a768](https://github.com/guanghechen/node-scaffolds/commit/d10a768cddab80934dcd6c0fc6316383e8f44a52))
+- ⬆️ upgrade devDependencies
+  ([2993a46](https://github.com/guanghechen/node-scaffolds/commit/2993a46e3665c7cfb23858f44812498cb2f39573))
+
+# 3.0.0 (2023-01-09)
+
+### Performance Improvements
+
+- 🔖 publish v3.0.0
+  ([a8cbe2a](https://github.com/guanghechen/node-scaffolds/commit/a8cbe2af542ccc3e112c9ee7cf564a496312a1e2))
+
+# 3.0.0-alpha.5 (2023-01-05)
+
+### Performance Improvements
+
+- :bug: fix jest-config within esm
+  ([4050e62](https://github.com/guanghechen/node-scaffolds/commit/4050e629536ae003c99ef9eeafa59c8aa8e1f0b3))
+- 🔖 publish v3.0.0-alpha.5
+  ([ff359c7](https://github.com/guanghechen/node-scaffolds/commit/ff359c7d9fcd48603b88b87698d825992ff55886))
+
+# 3.0.0-alpha.4 (2023-01-04)
+
+### Performance Improvements
+
+- :wrench: fix commonjs entry
+  ([259e185](https://github.com/guanghechen/node-scaffolds/commit/259e185ee811cebc4cf9b41d8c27c937460ef6d4))
+- 🔖 publish v3.0.0-alpha.4
+  ([ac69bef](https://github.com/guanghechen/node-scaffolds/commit/ac69bef736b78ddb90fd6830371118dcadaececa))
+
+# 3.0.0-alpha.3 (2023-01-04)
+
+### Performance Improvements
+
+- 🔖 publish v3.0.0-alpha.3
+  ([d05d30a](https://github.com/guanghechen/node-scaffolds/commit/d05d30a9812564cd3e19835bf1b6462df64fdda4))
+- 🔧 support dual esm/commonjs packages
+  ([90363f5](https://github.com/guanghechen/node-scaffolds/commit/90363f585471b527063133dedb1dff50d8b2a890))
+
+# 3.0.0-alpha.2 (2023-01-02)
+
+### Performance Improvements
+
+- :wrench: [BREAKING] chore: support ESM only
+  ([29b8c42](https://github.com/guanghechen/node-scaffolds/commit/29b8c421c0a2dfdd04cf4d7ff3ef0e5a93d70e16))
+- 🔖 publish v3.0.0-alpha.2
+  ([76c56b7](https://github.com/guanghechen/node-scaffolds/commit/76c56b76cb6b1fb368d47a8c20d2c06398f0009b))
+
+# 3.0.0-alpha.1 (2023-01-02)
+
+### Performance Improvements
+
+- 🔖 publish v3.0.0-alpha.1
+  ([69dd141](https://github.com/guanghechen/node-scaffolds/commit/69dd141feb9fae875cf252ac6f6404542425a147))
+
+# 3.0.0-alpha.0 (2022-12-31)
+
+### Performance Improvements
+
+- 🔧 fix build scripts
+  ([b24918c](https://github.com/guanghechen/node-scaffolds/commit/b24918c278188a043f7aabfc30739fa97d5ad060))
+- 🔧 fix test
+  ([6f911d4](https://github.com/guanghechen/node-scaffolds/commit/6f911d421240af2f17e6283bc4cbd53a32ac3bdc))
+- 🔖 publish v3.0.0-alpha.0
+  ([cf4b41a](https://github.com/guanghechen/node-scaffolds/commit/cf4b41a4fbd48d5ef5237b6827ddef1fe9484576))
+- 📝 update link for v3.x.x
+  ([f39886b](https://github.com/guanghechen/node-scaffolds/commit/f39886b5568ad9ba3d9e09bc56947725c363c5f3))
+
+## 2.1.4 (2022-11-03)
+
+### Performance Improvements
+
+- 🔖 publish v2.1.4
+  ([8eedd0e](https://github.com/guanghechen/node-scaffolds/commit/8eedd0e65701ed9c63e7b5682dfbd96545136c0f))
+
+## 2.1.3 (2022-11-03)
+
+### Performance Improvements
+
+- 🔖 publish v2.1.3
+  ([79de5ac](https://github.com/guanghechen/node-scaffolds/commit/79de5ac90778283d4405357b50a2d291eecf4040))
+
+## 2.1.2 (2022-10-20)
+
+### Performance Improvements
+
+- 🔖 publish v2.1.2
+  ([1815a70](https://github.com/guanghechen/node-scaffolds/commit/1815a70b6f81b50d08b3de21692c51c32aeb4d10))
+
+## 2.1.1 (2022-10-13)
+
+### Performance Improvements
+
+- 🔖 publish v2.1.1
+  ([717d5f1](https://github.com/guanghechen/node-scaffolds/commit/717d5f12e96e7cf93340c75eb100356220e5e9ca))
+
+# 2.1.0 (2022-09-18)
+
+### Performance Improvements
+
+- 🔖 publish v2.1.0
+  ([43dcadd](https://github.com/guanghechen/node-scaffolds/commit/43dcadd72fe3ce0c0aa040c0b810e286769a9a24))
+- ⬆️ ugprade jest to v29.x.x & update jest-config
+  ([d54145c](https://github.com/guanghechen/node-scaffolds/commit/d54145ce1e8b59780828a259ed6ddca6aa6e6b5f))
+
+# 2.0.0 (2022-09-17)
+
+### Performance Improvements
+
+- ✅ fix test
+  ([4a39ef8](https://github.com/guanghechen/node-scaffolds/commit/4a39ef83035ce3a65fdd5bc36f5f57869fef456d))
+- 🔖 publish v2.0.0
+  ([543c55f](https://github.com/guanghechen/node-scaffolds/commit/543c55f065895fef8fc2d3865cf6a4b72091355a))
+- 🔧 support node >= 16
+  ([208522b](https://github.com/guanghechen/node-scaffolds/commit/208522b6a7f8eba53a2562595706b25d63e91c29))
+- 📝 update READMEs
+  ([d6743d2](https://github.com/guanghechen/node-scaffolds/commit/d6743d24c94ea6c7a24ff4a2dc48113a2c2f96ce))
+
+# 2.0.0-alpha.3 (2022-09-15)
+
+### Performance Improvements
+
+- :truck: move some filepath relative methods from @algorithm.ts/helper-file to
+  @algorithm/helper-path
+  ([1da75c9](https://github.com/guanghechen/node-scaffolds/commit/1da75c9901b828d7b477b8c24f5dda483d3c1e3e))
+- 🔖 publish v2.0.0-alpha.3
+  ([3214b8d](https://github.com/guanghechen/node-scaffolds/commit/3214b8d4b812707ccf1358d0f0fe1dc5c462a343))
+
+# 2.0.0-alpha.2 (2022-08-27)
+
+### Performance Improvements
+
+- 🔖 publish v2.0.0-alpha.2
+  ([2d52783](https://github.com/guanghechen/node-scaffolds/commit/2d5278386a2d9503cb5c88d237d3a2dd34488446))
+- 🔧 update build configs
+  ([1770796](https://github.com/guanghechen/node-scaffolds/commit/177079603d8884e550cbc015f691f13939da056e))
+
+# 2.0.0-alpha.1 (2022-08-13)
+
+### Performance Improvements
+
+- 🔖 publish v2.0.0-alpha.1
+  ([55e1c7c](https://github.com/guanghechen/node-scaffolds/commit/55e1c7c75cf158298376c0a6dcd903cc6686a423))
+
+# 2.0.0-alpha.0 (2022-08-05)
+
+### Features
+
+- ✨ abstract stream utilities to @guanghechen/helper-stream
+  ([921396f](https://github.com/guanghechen/node-scaffolds/commit/921396fa5e922d3c308d04840cdbf5d5c5b2b700))
+
+### Performance Improvements
+
+- 🔧 modify build script
+  ([4234bc0](https://github.com/guanghechen/node-scaffolds/commit/4234bc058bd9ade25778cb43ee5db939d8e630a9))
+- 🔖 publish v2.0.0-alpha.0
+  ([fe24ebd](https://github.com/guanghechen/node-scaffolds/commit/fe24ebdb066667fadbea415d33f564f9823b51d9))
+- 💥 refactor @guanghechen/chalk-logger
+  ([7d8c62a](https://github.com/guanghechen/node-scaffolds/commit/7d8c62a2efe6f1c907be0a75b74913da98fac27c))
+- 💥 rename @guanghechen/commander-helper to @guanghechen/helper-commander
+  ([9f42244](https://github.com/guanghechen/node-scaffolds/commit/9f422444af5087d539a0f733b96bd64ad03198e7))
+- 💥 rename @guanghechen/jest-helper to @guanghechen/helper-jest
+  ([8545bc2](https://github.com/guanghechen/node-scaffolds/commit/8545bc27992418b69a78106d1ba3d65c31486314))
+- 💥 rename @guanghehcen/file-helper to @guanghechen/helper-file
+  ([2859ff4](https://github.com/guanghechen/node-scaffolds/commit/2859ff4ebf307188d6bf59b0fcb6c1d52f785a28))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-present guanghechen (https://github.com/guanghechen)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,145 @@
+<header>
+  <h1 align="center">
+    <a href="https://github.com/guanghechen/sora/tree/@guanghechen/filesplit@2.0.0/packages/filesplit#readme">@guanghechen/filesplit</a>
+  </h1>
+  <div align="center">
+    <a href="https://www.npmjs.com/package/@guanghechen/filesplit">
+      <img
+        alt="Npm Version"
+        src="https://img.shields.io/npm/v/@guanghechen/filesplit.svg"
+      />
+    </a>
+    <a href="https://www.npmjs.com/package/@guanghechen/filesplit">
+      <img
+        alt="Npm Download"
+        src="https://img.shields.io/npm/dm/@guanghechen/filesplit.svg"
+      />
+    </a>
+    <a href="https://www.npmjs.com/package/@guanghechen/filesplit">
+      <img
+        alt="Npm License"
+        src="https://img.shields.io/npm/l/@guanghechen/filesplit.svg"
+      />
+    </a>
+    <a href="#install">
+      <img
+        alt="Module Formats: cjs"
+        src="https://img.shields.io/badge/module_formats-cjs-green.svg"
+      />
+    </a>
+    <a href="https://github.com/nodejs/node">
+      <img
+        alt="Node.js Version"
+        src="https://img.shields.io/node/v/@guanghechen/filesplit"
+      />
+    </a>
+    <a href="https://github.com/facebook/jest">
+      <img
+        alt="Tested with Jest"
+        src="https://img.shields.io/badge/tested_with-jest-9c465e.svg"
+      />
+    </a>
+    <a href="https://github.com/prettier/prettier">
+      <img
+        alt="Code Style: prettier"
+        src="https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square"
+      />
+    </a>
+  </div>
+</header>
+<br/>
+
+A utility class for splitting large files into smaller chunks and merging them back. Inspired by
+[node-split-file](https://github.com/tomvlk/node-split-file).
+
+## Install
+
+- npm
+
+  ```bash
+  npm install --save @guanghechen/filesplit
+  ```
+
+- yarn
+
+  ```bash
+  yarn add @guanghechen/filesplit
+  ```
+
+## Usage
+
+### Split a File
+
+```typescript
+import { FileSplitter } from '@guanghechen/filesplit'
+import { calcFilePartItemsBySize } from '@guanghechen/filepart'
+import fs from 'node:fs'
+
+async function splitFile(filepath: string): Promise<string[]> {
+  const splitter = new FileSplitter()
+  const fileSize = fs.statSync(filepath).size
+  const parts = [...calcFilePartItemsBySize(fileSize, 1024 * 1024 * 80)] // 80MB per chunk
+  const partFilepaths: string[] = await splitter.split(filepath, parts)
+  return partFilepaths
+}
+
+// Split 'large-file.zip' into 80MB chunks
+// Result: ['large-file.zip.ghc-part01', 'large-file.zip.ghc-part02', ...]
+await splitFile('large-file.zip')
+```
+
+### Merge Files
+
+```typescript
+import { FileSplitter } from '@guanghechen/filesplit'
+
+const splitter = new FileSplitter()
+
+// Merge chunks back into original file
+await splitter.merge(
+  ['large-file.zip.ghc-part01', 'large-file.zip.ghc-part02', 'large-file.zip.ghc-part03'],
+  'large-file-restored.zip'
+)
+```
+
+### Custom Part Code Prefix
+
+```typescript
+import { FileSplitter } from '@guanghechen/filesplit'
+
+// Use custom suffix for part files
+const splitter = new FileSplitter({ partCodePrefix: '.chunk' })
+
+// Split will create: file.txt.chunk01, file.txt.chunk02, etc.
+```
+
+### Using Default Instance
+
+```typescript
+import { fileSplitter } from '@guanghechen/filesplit'
+
+// Use the default singleton instance
+await fileSplitter.split(filepath, parts)
+await fileSplitter.merge(inputFilepaths, outputFilepath)
+```
+
+### Calculate Part Filepaths
+
+```typescript
+import { FileSplitter } from '@guanghechen/filesplit'
+import { calcFilePartItemsByCount } from '@guanghechen/filepart'
+
+const splitter = new FileSplitter()
+const parts = [...calcFilePartItemsByCount(1000000, 3)]
+
+// Get the expected part filepaths without actually splitting
+const partFilepaths = splitter.calcPartFilepaths('/path/to/file.zip', parts)
+// Result: ['/path/to/file.zip.ghc-part1', '/path/to/file.zip.ghc-part2', '/path/to/file.zip.ghc-part3']
+```
+
+## Reference
+
+- [homepage][homepage]
+
+[homepage]:
+  https://github.com/guanghechen/sora/tree/@guanghechen/filesplit@2.0.0/packages/filesplit#readme

package/lib/cjs/index.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+var filepart = require('@guanghechen/filepart');
+var invariant = require('@guanghechen/invariant');
+var stream = require('@guanghechen/stream');
+var node_fs = require('node:fs');
+
+class FileSplitter {
+    partCodePrefix;
+    #encoding = undefined;
+    constructor(options = {}) {
+        this.partCodePrefix = options.partCodePrefix ?? filepart.DEFAULT_FILEPART_CODE_PREFIX;
+    }
+    calcPartFilepaths(filepath, parts) {
+        if (parts.length <= 1)
+            return [filepath];
+        const partFilepaths = [];
+        for (const partName of filepart.calcFilePartNames(parts, this.partCodePrefix)) {
+            const partFilepath = filepath + partName;
+            partFilepaths.push(partFilepath);
+        }
+        return partFilepaths;
+    }
+    async split(filepath, parts, outputFilepath) {
+        if (parts.length <= 1)
+            return [filepath];
+        const tasks = [];
+        const partFilepaths = this.calcPartFilepaths(outputFilepath ?? filepath, parts);
+        for (let i = 0; i < partFilepaths.length; ++i) {
+            const part = parts[i];
+            const partFilepath = partFilepaths[i];
+            const reader = node_fs.createReadStream(filepath, {
+                encoding: this.#encoding,
+                start: part.start,
+                end: part.end - 1,
+            });
+            const writer = node_fs.createWriteStream(partFilepath);
+            const task = stream.consumeStream(reader, writer);
+            tasks.push(task);
+        }
+        await Promise.all(tasks);
+        return partFilepaths;
+    }
+    async merge(inputFilepaths, outputFilepath) {
+        invariant.invariant(inputFilepaths.length > 0, 'Input file list is empty!');
+        const readers = inputFilepaths.map(filepath => node_fs.createReadStream(filepath, { encoding: this.#encoding }));
+        const writer = node_fs.createWriteStream(outputFilepath, {
+            encoding: this.#encoding,
+        });
+        await stream.consumeStreams(readers, writer);
+    }
+}
+const fileSplitter = new FileSplitter();
+
+exports.FileSplitter = FileSplitter;
+exports.fileSplitter = fileSplitter;

package/lib/esm/index.mjs

@@ -0,0 +1,53 @@
+import { DEFAULT_FILEPART_CODE_PREFIX, calcFilePartNames } from '@guanghechen/filepart';
+import { invariant } from '@guanghechen/invariant';
+import { consumeStream, consumeStreams } from '@guanghechen/stream';
+import { createReadStream, createWriteStream } from 'node:fs';
+
+class FileSplitter {
+    partCodePrefix;
+    #encoding = undefined;
+    constructor(options = {}) {
+        this.partCodePrefix = options.partCodePrefix ?? DEFAULT_FILEPART_CODE_PREFIX;
+    }
+    calcPartFilepaths(filepath, parts) {
+        if (parts.length <= 1)
+            return [filepath];
+        const partFilepaths = [];
+        for (const partName of calcFilePartNames(parts, this.partCodePrefix)) {
+            const partFilepath = filepath + partName;
+            partFilepaths.push(partFilepath);
+        }
+        return partFilepaths;
+    }
+    async split(filepath, parts, outputFilepath) {
+        if (parts.length <= 1)
+            return [filepath];
+        const tasks = [];
+        const partFilepaths = this.calcPartFilepaths(outputFilepath ?? filepath, parts);
+        for (let i = 0; i < partFilepaths.length; ++i) {
+            const part = parts[i];
+            const partFilepath = partFilepaths[i];
+            const reader = createReadStream(filepath, {
+                encoding: this.#encoding,
+                start: part.start,
+                end: part.end - 1,
+            });
+            const writer = createWriteStream(partFilepath);
+            const task = consumeStream(reader, writer);
+            tasks.push(task);
+        }
+        await Promise.all(tasks);
+        return partFilepaths;
+    }
+    async merge(inputFilepaths, outputFilepath) {
+        invariant(inputFilepaths.length > 0, 'Input file list is empty!');
+        const readers = inputFilepaths.map(filepath => createReadStream(filepath, { encoding: this.#encoding }));
+        const writer = createWriteStream(outputFilepath, {
+            encoding: this.#encoding,
+        });
+        await consumeStreams(readers, writer);
+    }
+}
+const fileSplitter = new FileSplitter();
+
+export { FileSplitter, fileSplitter };

package/lib/types/index.d.ts

@@ -0,0 +1,49 @@
+import { IFilePartItem } from '@guanghechen/filepart';
+
+interface IFileSplitter {
+    /**
+     * File part code prefix.
+     */
+    readonly partCodePrefix: string;
+    /**
+     * Calculate the name of parts of sourcefile respectively.
+     *
+     * @param filepath
+     * @param parts
+     * @returns
+     */
+    calcPartFilepaths(filepath: string, parts: IFilePartItem[]): string[];
+    /**
+     * Split file with part descriptions.
+     */
+    split(filepath: string, parts: IFilePartItem[], outputFilepath?: string): Promise<string[]>;
+    /**
+     * Merge files
+     *
+     * @param inputFilepaths
+     * @param outputFilepath
+     */
+    merge(inputFilepaths: string[], outputFilepath: string): Promise<void>;
+}
+
+interface IProps {
+    /**
+     * The suffix name of a file part.
+     */
+    readonly partCodePrefix?: string;
+}
+/**
+ * Inspired by https://github.com/tomvlk/node-split-file.
+ */
+declare class FileSplitter implements IFileSplitter {
+    #private;
+    readonly partCodePrefix: string;
+    constructor(options?: IProps);
+    calcPartFilepaths(filepath: string, parts: IFilePartItem[]): string[];
+    split(filepath: string, parts: IFilePartItem[], outputFilepath?: string): Promise<string[]>;
+    merge(inputFilepaths: string[], outputFilepath: string): Promise<void>;
+}
+declare const fileSplitter: FileSplitter;
+
+export { FileSplitter, fileSplitter };
+export type { IFileSplitter };

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@guanghechen/filesplit",
+  "version": "2.0.1",
+  "description": "File helper",
+  "author": {
+    "name": "guanghechen",
+    "url": "https://github.com/guanghechen/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/guanghechen/sora/tree/@guanghechen/filesplit@2.0.0",
+    "directory": "packages/filesplit"
+  },
+  "homepage": "https://github.com/guanghechen/sora/tree/@guanghechen/filesplit@2.0.0/packages/filesplit#readme",
+  "keywords": [
+    "file helper",
+    "split file",
+    "merge streams"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "source": "./src/index.ts",
+      "import": "./lib/esm/index.mjs",
+      "require": "./lib/cjs/index.cjs"
+    }
+  },
+  "source": "./src/index.ts",
+  "main": "./lib/cjs/index.cjs",
+  "module": "./lib/esm/index.mjs",
+  "types": "./lib/types/index.d.ts",
+  "license": "MIT",
+  "files": [
+    "lib/",
+    "!lib/**/*.map",
+    "package.json",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@guanghechen/filepart": "^2.0.1",
+    "@guanghechen/invariant": "^7.0.1",
+    "@guanghechen/stream": "^2.0.1"
+  },
+  "scripts": {
+    "build": "rollup -c ../../rollup.config.mjs",
+    "clean": "rimraf lib",
+    "test": "vitest run --config ../../vitest.config.ts",
+    "test:coverage": "vitest run --config ../../vitest.config.ts --coverage",
+    "test:update": "vitest run --config ../../vitest.config.ts -u"
+  }
+}