⬅️ Back to Table of Contents

📄 Reference.ts

📊 Analysis Summary

Metric	Count
🔧 Functions	5
🧱 Classes	1
📦 Imports	4
📐 Interfaces	1
🎯 Enums	2

📚 Table of Contents

• Imports
• Functions
• Classes
• Interfaces
• Enums

🛠️ File Location:

📂 packages/scope-manager/src/referencer/Reference.ts

📦 Imports

Name	Source
TSESTree	@typescript-eslint/types
Scope	../scope
Variable	../variable
createIdGenerator	../ID

---

Functions

Reference.isWrite(): boolean

Code

public isWrite(): boolean {
    return !!(this.#flag & ReferenceFlag.Write);
  }

• JSDoc:

  /**
     * Whether the reference is writeable.
     * @public
     */
  

• Return Type: boolean

Reference.isRead(): boolean

Code

public isRead(): boolean {
    return !!(this.#flag & ReferenceFlag.Read);
  }

• JSDoc:

  /**
     * Whether the reference is readable.
     * @public
     */
  

• Return Type: boolean

Reference.isReadOnly(): boolean

Code

public isReadOnly(): boolean {
    return this.#flag === ReferenceFlag.Read;
  }

• JSDoc:

  /**
     * Whether the reference is read-only.
     * @public
     */
  

• Return Type: boolean

Reference.isWriteOnly(): boolean

Code

public isWriteOnly(): boolean {
    return this.#flag === ReferenceFlag.Write;
  }

• JSDoc:

  /**
     * Whether the reference is write-only.
     * @public
     */
  

• Return Type: boolean

Reference.isReadWrite(): boolean

Code

public isReadWrite(): boolean {
    return this.#flag === ReferenceFlag.ReadWrite;
  }

• JSDoc:

  /**
     * Whether the reference is read-write.
     * @public
     */
  

• Return Type: boolean

---

Classes

Reference

Class Code

export class Reference {
  /**
   * A unique ID for this instance - primarily used to help debugging and testing
   */
  public readonly $id: number = generator();

  /**
   * The read-write mode of the reference.
   */
  readonly #flag: ReferenceFlag;

  /**
   * Reference to the enclosing Scope.
   * @public
   */
  public readonly from: Scope;

  /**
   * Identifier syntax node.
   * @public
   */
  public readonly identifier: TSESTree.Identifier | TSESTree.JSXIdentifier;

  /**
   * `true` if this writing reference is a variable initializer or a default value.
   * @public
   */
  public readonly init?: boolean;

  public readonly maybeImplicitGlobal?: ReferenceImplicitGlobal | null;

  /**
   * The {@link Variable} object that this reference refers to. If such variable was not defined, this is `null`.
   * @public
   */
  public resolved: Variable | null;

  /**
   * If reference is writeable, this is the node being written to it.
   * @public
   */
  public readonly writeExpr?: TSESTree.Node | null;

  /**
   * In some cases, a reference may be a type, value or both a type and value reference.
   */
  readonly #referenceType: ReferenceTypeFlag;

  constructor(
    identifier: TSESTree.Identifier | TSESTree.JSXIdentifier,
    scope: Scope,
    flag: ReferenceFlag,
    writeExpr?: TSESTree.Node | null,
    maybeImplicitGlobal?: ReferenceImplicitGlobal | null,
    init?: boolean,
    referenceType = ReferenceTypeFlag.Value,
  ) {
    this.identifier = identifier;
    this.from = scope;
    this.resolved = null;
    this.#flag = flag;

    if (this.isWrite()) {
      this.writeExpr = writeExpr;
      this.init = init;
    }

    this.maybeImplicitGlobal = maybeImplicitGlobal;
    this.#referenceType = referenceType;
  }

  /**
   * True if this reference can reference types
   */
  public get isTypeReference(): boolean {
    return (this.#referenceType & ReferenceTypeFlag.Type) !== 0;
  }

  /**
   * True if this reference can reference values
   */
  public get isValueReference(): boolean {
    return (this.#referenceType & ReferenceTypeFlag.Value) !== 0;
  }

  /**
   * Whether the reference is writeable.
   * @public
   */
  public isWrite(): boolean {
    return !!(this.#flag & ReferenceFlag.Write);
  }

  /**
   * Whether the reference is readable.
   * @public
   */
  public isRead(): boolean {
    return !!(this.#flag & ReferenceFlag.Read);
  }

  /**
   * Whether the reference is read-only.
   * @public
   */
  public isReadOnly(): boolean {
    return this.#flag === ReferenceFlag.Read;
  }

  /**
   * Whether the reference is write-only.
   * @public
   */
  public isWriteOnly(): boolean {
    return this.#flag === ReferenceFlag.Write;
  }

  /**
   * Whether the reference is read-write.
   * @public
   */
  public isReadWrite(): boolean {
    return this.#flag === ReferenceFlag.ReadWrite;
  }
}

Methods

isWrite(): boolean

Code

public isWrite(): boolean {
    return !!(this.#flag & ReferenceFlag.Write);
  }

isRead(): boolean

Code

public isRead(): boolean {
    return !!(this.#flag & ReferenceFlag.Read);
  }

isReadOnly(): boolean

Code

public isReadOnly(): boolean {
    return this.#flag === ReferenceFlag.Read;
  }

isWriteOnly(): boolean

Code

public isWriteOnly(): boolean {
    return this.#flag === ReferenceFlag.Write;
  }

isReadWrite(): boolean

Code

public isReadWrite(): boolean {
    return this.#flag === ReferenceFlag.ReadWrite;
  }

---

Interfaces

ReferenceImplicitGlobal

Interface Code

export interface ReferenceImplicitGlobal {
  node: TSESTree.Node;
  pattern: TSESTree.BindingName;
  ref?: Reference;
}

Properties

Name	Type	Optional	Description
node	TSESTree.Node	✗
pattern	TSESTree.BindingName	✗
ref	Reference	✓

---

Enums

enum ReferenceFlag

Enum Code

export enum ReferenceFlag {
  Read = 0x1,
  Write = 0x2,
  ReadWrite = 0x3,
}

Members

Name	Value	Description
Read	1
Write	2
ReadWrite	3

enum ReferenceTypeFlag

Enum Code

export enum ReferenceTypeFlag {
  Value = 0x1,
  Type = 0x2,
}

Members

Name	Value	Description
Value	1
Type	2

---