All notable changes to Rush-FS are documented here. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- (Add new changes here before each release.)
0.1.0 - 2026-03-05
- Package name: The main npm package is now
@rush-fs/core(scoped). Install withpnpm add @rush-fs/coreornpm i @rush-fs/core, and import withimport { readdir, readFile, ... } from '@rush-fs/core'. - Migration from
rush-fs: If you were using the old unscoped packagerush-fs, replace it with@rush-fs/coreinpackage.jsonand in all imports. The API is unchanged; only the package name and version differ. The oldrush-fspackage may be deprecated on npm in a separate step; prefer@rush-fs/corefor new installs. - glob:
gitIgnoreoption now defaults tofalseto align with Node.jsfs.globSync(no .gitignore filtering by default).
- glob: Patterns with a path prefix (e.g.
.dir/**/*.txtorsrc/**/*.ts) now work when used without an explicitcwd; the prefix is used as the search root, matching Node.js behavior. - glob: Recursive pattern
**/*.extwithcwdnow correctly recurses into subdirectories. - readFile: Async
readFile(path, encoding)with string as second argument (e.g.readFile(path, 'utf-8')) now returns a decoded string instead of Buffer, matching Node.js and fixing issue #16.
- Re-publish with
optionalDependenciescorrectly injected afternapi prepublish, sopnpm i rush-fs/npm i rush-fsauto-installs the platform native binding. No API or behavior changes from 0.0.4.
- Publish:
optionalDependenciesare now injected afternapi prepublishin the Release workflow, so the published npm package correctly lists platform packages. Installingrush-fswill again auto-install the native binding for your OS/arch (e.g.@rush-fs/rush-fs-darwin-arm64). If you are on an older version and see "Cannot find native binding", see README#Installation for a manual fix.
- Docs: Nextra-based documentation site under
docs/with i18n (EN / 中文), guide, API reference, and benchmarks. - README: Installation troubleshooting: how to reinstall or manually add the platform package when the native binding is missing.
0.0.3 - (historical)
- Earlier releases; see GitHub Releases for tags and assets.