Utility for determining whether an AST node represents a JavaScript reference. Useful for scope analysis and related tooling that must distinguish between identifiers that refer to variables and those that are used in other positions (for example, property accesses or exported names).
Project status
- The repo appears maintained but with infrequent published updates, last recorded update was v3.0.3 on 2024-11-12, while the upstream push was later on 2026-01-20 (so there is evidence of activity, but not regular tagging).
- Update cadence looks irregular and slow, with prior published updates on 2023-09-10 (v3.0.2) and 2023-01-03 (v3.0.1), indicating no steady rhythm of releases.
AI summary generated
Recent updates
v3.0.3
This release updates `is-reference` to recognize AST `import.meta` (ESTree `MetaProperty`) nodes and treats part of that structure as a reference. The repo also bumps several dependencies and updates its TypeScript typing source JSDoc. No additional publisher release notes were provided for v3.0.3.
Featuresv3.0.2
v3.0.2 makes a small runtime change in src/index.js, but the main impact is on TypeScript typing generation and package export metadata. The release notes provided by the publisher are empty, while the diff shows changes to type tooling (dts-buddy) and stricter tsconfig settings that can affect the generated .d.ts files.
Featuresv3.0.1
Release v3.0.1 was published on 2023-01-03, but the publisher did not provide any release notes. Because no change details are available, developers should review the corresponding commits or changelog in the repository before upgrading to assess potential API, behavior, or dependency impacts.
v3.0.0
v3.0.0 updates the library to align with newer ESTree typings and AST node naming. The core runtime change is how class field nodes are recognized, switching the expected node type name used in the reference-detection logic.
Breakingv2.0.0
v2.0.0 contains a major packaging and language shift, converting the library to JavaScript. The provided release notes are missing, so the only “documented” change is a brief changelog entry, while the code diff shows additional breaking API and module system changes.
v1.2.1
This release (v1.2.1) makes a small dependency change around the TypeScript type package @types/estree. The code changes are limited to metadata files (changelog, package.json, and package-lock.json), with no application logic changes visible in the provided diff.
v1.2.0
Release v1.2.0 adds support for determining references inside JavaScript class fields. No release notes were provided by the publisher, so the documented intent is unclear from the release description alone.
BreakingFeaturesv1.1.4
v1.1.4 makes a targeted change to how is-reference determines whether AST nodes are references. The core logic now treats import specifiers more precisely, aligning behavior for `import { foo as bar }` cases.
v1.1.3
Version v1.1.3 updates the `isReference` AST helper to handle cases where an expression is standalone and not nested under a `Program` node. The main code change adds a guard so `Identifier` nodes with no parent are treated as references.
v1.1.2
Release v1.1.2 was published on 2019-03-24, but the publisher did not provide any release notes. As a result, there is not enough information here to identify new features, bug fixes, breaking changes, or security updates.