This patch updates utilium to 3.0.

This patch updates to typescript 6.0 and removes some polyfilled types.

This patch changes zenfs-test back to using a .js file since type stripping is not supported for files in node_modues.

• Moved logic for stat and lstat into VFS (in preparation for #287)
• Added --runs/-r to zenfs-test, which will run a test suite (e.g. for the SingleBuffer tests) multiple times and output average run time
• Fixed MetadataBlock.lockIndex sometimes causing a runtime error due to microsoft/TypeScript#61862
• Updated memium to v0.4.3

• Fixed incorrect escaping in globToRegex
• Fixed incorrect path joining in glob/globSync
• Fixed more issues in glob/globSync
• Added glob tests

• Updated to @types/node v25
  • Changed some return types to use NonSharedBuffer (see DefinitelyTyped/DefinitelyTyped#72687)
• Updated some other dependencies
• Fixed zenfs-test --report causing CI to fail because the coverage reporter isn't compatible with Node v25 (bcoe/c8#582)
• Updated eslint config

• Added support for synchronous configuration (#281, thanks @lvcabral) [docs]
• Fixed PassthroughOptions.prefix being passed through path.resolve, breaking Windows paths (#284)
• Changed journalOperations to a Set for better performance^[internal]
• Added a note in the readme about path and readline emulation

Contributors

• @lvcabral

• Fixed incorrect path resolution when inside a context with a non-root PWD (#263)
• Fixed bindContext copying from the created child context instead of assigning to it
• Fixed resolveMount not resolving paths using the context's PWD
• normalizePath now passes through this to path.resolve
• Anti-regression tests now have the issue number in the test name instead of as a comment
• Contexts are now more secure at runtime, with readonly members being made non-writable and non-configurable
• Added internal contextOf and createChildContext
• V_Context is now unknown for better compatibility with Node.js
• bindContext now checks if the specified root is a directory and exists
• Fixed incorrect example for bindContext in documentation

• Fixed SingleBuffer metadata block corruption (#277, thanks @lvcabral)
• Cleaned up hex string formatting in SingleBuffer
• Added debug message when SingleBuffer metadata blocks are rotated
• Fixed backends requiring entries in options when extending SharedConfig

Contributors

• @lvcabral

• Changed path resolution to be more efficient and faster by internal functions (resolveMount/resolve) instead of realpath from the Node.js compatibility layer
• Fixed incorrect behavior in read when passing 0 for position
• Fixed passthrough needing __promisify__/native
• Fixed incorrect Dirent.parentPath returned by readdir
• The VFS now compares file systems based on their UUID instead of the object identity
  • For example if you create two instances of the same SingleBuffer backend, the VFS treats them as equal and you won't get EXDEV
• The Node.js compatibility code and the VFS code have been organized into two different source directories: node and vfs. This is more readable and maintainable.
• VFS <-> Backend error handling is now handled in one place (withExceptionContext) and returned by resolveMount for convience
  • For contributors: this means calling FileSystem methods like fs.touch(...) will automatically do all the path conversion. You no longer need to wrap these calls with wrap or a try/catch
• Added missing contexts.ts export to internal/index.js
• Added a proper NodeFS type for the node:fs API without node-specific bits like __promisiy__
• Added VFS Dirent class
• Added exports from readline, constants
• Renamed AsyncHandle to Handle and merged it with sync handle/methods ^[internal]
• Deprecated Inode.toStats() ^[internal]

Testing

• Added -d/--debug flag to zenfs-test (dumps commands)
• Added --profile to zenfs-test
• Added test for different working directory with context (#263, marked as todo to not cause failures)
• Fixed directory test
• Changed tests to import from @zenfs/core instead of ../dist, ../../dist, etc.

Documentation

• Added dedicated documentation page for devices
• Fixed fs functions not being listed under the fs namespace in documentation
• Fixed some outdated documentation
• Updated Memium since beforehand it broke Typedoc
• Switched to Typedoc's built-in excludeReferences instead of a plugin
• Updated readme: fixed typos and added backends from other @zenfs packages
• Added a note to contributing guidelines for issue vs discussion
• Removed Dirent-specific tests (i.e. ones that used new Dirent()

Development

• Issues now use GitHub Issue forms, which should help maintainers (me) triage faster
• npm scripts are now type checked
• Changed to using the built-in styleText for npm scripts
• Updated license identifier in index.ts so it is included by bundlers
• Moved license guide to copying
• Improved the .gitignore file