parse-entities is a small, fast decoder for HTML character references (HTML entities), providing spec-compliant decoding of strings like `&` and numeric references. It is useful in tools like linters, where you may want different warnings with reasons and positional info about where each reference occurred.
Project status
- Maintenance status: The upstream GitHub repository shows an upstream push on 2026-01-22, indicating the project is not fully dormant, but the most recent published updates appear to be 4.0.2 on 2024-12-13, so releases or published updates are infrequent.
- Update cadence: Historically, updates are irregular (for example, 4.0.2 in 2024, 4.0.1 in 2023, 4.0.0 in 2021), and there is roughly a year-plus gap since the last published update relative to today (2026-09-10).
AI summary generated
Recent updates
4.0.2
parse-entities 4.0.2 makes a set of mostly type-focused refactors and build metadata adjustments. It also removes the unused `character-entities` runtime dependency, keeping `character-entities-legacy` as the actual dependency used for reference decoding.
4.0.1
parse-entities 4.0.1 is a tooling and type-related release, with changes centered around TypeScript configuration and minor documentation refactors. The release notes mention a typo fix in types and removing skipLibCheck, plus doc/tsconfig refactoring.
4.0.0
Version 4.0.0 contains a webpack-related fix per the release notes, but the actual code changes also include a significant public API change. The release notes do not mention the removal of the exported `decodeEntity` helper or the underlying named character reference decoding implementation swap.
3.1.0
Release 3.1.0 primarily refactors the package internals and adds/updates TypeScript typings, while also mentioning documentation improvements. The code diff shows the implementation was moved under a new lib/ directory and the public module entrypoints now re-export types and (apparently) decodeEntity from the main package.
3.0.0
Version 3.0.0 migrates the project to ESM, adds JSDoc-driven typing, and refactors internals to reduce bundle size. The actual diff shows additional public API and typing surface changes that go beyond the brief release notes.
BreakingFeatures2.0.0
Release 2.0.0 primarily introduces a bundled TypeScript declaration file for parse-entities. The code changes are minimal, with the main functional impact being new shipped typings and corresponding contributor/test tooling updates in package.json.
BreakingFeatures1.2.2
Release 1.2.2 is documented as a small update, primarily adding more badges and switching various URLs from HTTP to HTTPS. However, the code diff shows additional changes beyond release-note scope, including a substantial refactor of the core parsing loop and multiple development tooling/config updates.
1.2.1
Release 1.2.1 is described as a fix for React Native support. The only code change in the diff is a packaging metadata update in package.json, plus the version bump from 1.2.0 to 1.2.1.
1.2.0
Release 1.2.0 changes how named HTML entities are decoded in browser builds. Instead of using a bundled character entity map, the code now decodes via the DOM (browser-specific implementation).
1.1.2
Release 1.1.2 is presented as a code-style and documentation refactor, plus an addition of a list of related projects. The code diff shows a fairly large internal refactor of index.js and substantial tooling updates (formatting, build/test scripts, and devDependency bumps), with the runtime API appearing to remain the same entry point.
Features