All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
Guiding Principles
- Changelogs are for humans, not machines.
- There should be an entry for every single version.
- The same types of changes should be grouped.
- Versions and sections should be linkable.
- The latest version comes first.
- The release date of each versions is displayed.
- Mention whether you follow Semantic Versioning.
Types of changes
Changelog entries are classified using the following labels (from keep-a-changelog):
Addedfor new features.Changedfor changes in existing functionality.Deprecatedfor soon-to-be removed features.Removedfor now removed features.Fixedfor any bug fixes.Securityin case of vulnerabilities.
scan()now scans the full pattern when tokens are requested, instead of merging the remaining path segments into the final token (#62, 5f5819d).scan()now returns complete pattern parts, including leading and trailing empty segments, and handles nested and escaped parentheses correctly (#58, f201165).
- Preserved every branch when safely rewriting repeated extglobs (#182, 6289307).
- Honored the
windowsoption when matching basenames (#183, ab8bc4d).
- Prevented regular expression denial of service (ReDoS) from crafted repeated or nested extglob quantifiers by safely rewriting or treating risky patterns as literals. The new
maxExtglobRecursionoption defaults to0; positive numeric values allow limited nesting, whilefalsedisables the safeguard (CVE-2026-33671, 5eceecd). - Prevented inherited object properties from being interpreted as POSIX character classes (CVE-2026-33672, 4516eb5).
- Moved Windows platform detection to the shared utilities (f7751de).
- Updated development dependencies (d958901).
- Raised the minimum supported Node.js version from 10 to 12 (6ce95f5).
- On supported Node.js versions, 4.0.0 does not remove any public matcher API or change matching semantics. Its compatibility change is the removal of Picomatch's Node.js version check for regular expression lookbehinds. Runtimes without native lookbehind support, which are outside the supported Node.js range, now use the standard
toRegex()behavior: a non-matching fallback by default and the nativeRegExperror whendebug: true(#129, 907d706).
- Preserved complete
textvalues whenparse()combines adjacent text tokens (#100, #125, #126, 563f534). Thanks to @connor4312.
- Removed the Node.js
osdependency from the main entry point to support browser environments (#124, b0ff9b1). Thanks to @gwsbhqt. - Added
sideEffects: falsetopackage.json(#128, 8f18eb6). Thanks to @frandiox. - Restored all properties from the core matcher, including the undocumented
picomatch.constants, on the package's main export (335eac6).
- Backported the extglob-quantifier ReDoS fix from 4.0.4. Risky repeated extglobs are now safely rewritten or treated as literals by default; positive numeric
maxExtglobRecursionvalues allow limited nesting, whilefalsedisables the safeguard (CVE-2026-33671, 05c0743). - Prevented inherited object properties from being interpreted as POSIX character classes (CVE-2026-33672, 0bdde35).
- Raised the minimum supported Node.js version from 8.6 to 10 (5214db4).
- Windows path-separator handling in the core and static APIs is now controlled by the
windowsoption instead of automatic platform detection. Calls without an options object use POSIX behavior; passwindows: truewhen backslashes should be treated as path separators. The mainpicomatch()entry point applies platform detection only when an options object is provided (#73, 49d10c4). - The undocumented
picomatch.constantsproperty is no longer copied to the package's main export (7e120bb). It is restored in 4.0.0 (335eac6). - The v3
matchBase()implementation did not forward Windows mode to its platform-independent basename helper. As a result, backslash-separated inputs did not match by basename, even withwindows: true. This is fixed in 4.0.5 (#183, ab8bc4d).
- Added the dependency-free
picomatch/posixentry point for browser and other non-Node.js environments. It uses POSIX path semantics unlesswindows: trueis passed (7e120bb).
- Removed the Node.js
pathdependency and automaticprocess.platformdetection from the core matcher, and documented the existingwindowsoption (#73).
- Backported the extglob-quantifier ReDoS fix from 4.0.4. Risky repeated extglobs are now safely rewritten or treated as literals by default; positive numeric
maxExtglobRecursionvalues allow limited nesting, whilefalsedisables the safeguard (CVE-2026-33671, eec17ae). - Prevented inherited object properties from being interpreted as POSIX character classes (CVE-2026-33672, fc1f6b6).
- Fixes bug when a pattern containing an expression after the closing parenthesis (
/!(*.d).{ts,tsx}) was incorrectly converted to regexp (9f241ef).
- Fixes bug where file names with two dots were not being matched consistently with negation extglobs containing a star (56083ef)
- Do not skip pattern seperator for square brackets (fb08a30).
- Set negatedExtGlob also if it does not span the whole pattern (032e3f5).
- Correctly handle parts of the pattern after parentheses in the
scanmethod (e15b920).
- Fixes #49, so that braces with no sets or ranges are now propertly treated as literals.
- Disable fastpaths mode for the parse method (5b8d33f)
- Add
tokens,slashes, andpartsto the object returned bypicomatch.scan().
- add benchmarks for scan (4793b92)
- Add eslint object-curly-spacing rule (707c650)
- Add prefer-const eslint rule (5c7501c)
- Add support for nonegate in scan API (275c9b9)
- Change lets to consts. Move root import up. (4840625)
- closes #21 (766bcb0)
- Fix "Extglobs" table in readme (eb19da8)
- fixes #20 (9caca07)
- fixes #26 (fa58f45)
- Lint test (d433a34)
- lint unit tests (0159b55)
- Make scan work with noext (6c02e03)
- minor linting (c2a2b87)
- minor parser improvements (197671d)
- remove eslint since it... (07876fa)
- remove funding file (8ebe96d)
- Remove unused funks (cbc6d54)
- Run eslint during pretest, fix existing eslint findings (0682367)
- support
noparenin scan (3d37569) - update changelog (7b34e77)
- update travis (777f038)
- Use eslint-disable-next-line instead of eslint-disable (4e7c1fd)
- 2.0.7 (9eb9a71)
- supports lookbehinds (1f63f7e)
- update .verb.md file with typo change (2741279)
- fix: typo in README (0753e44)
- Readme link fixed by @danez.
options.capturenow works as expected when fastpaths are enabled. See https://github.com/micromatch/picomatch/pull/12/commits/26aefd71f1cfaf95c37f1c1fcab68a693b037304. Thanks to @DrPizza.
- Adds support for
options.onIgnore. See the readme for details - Adds support for
options.onResult. See the readme for details
- The unixify option was renamed to
windows - caching and all related options and methods have been removed
- adds
.onMatchoption - improvements to
.scanmethod - numerous improvements and optimizations for matching and parsing
- better windows path handling
First release.