codegraph/src/web-tree-sitter.d.ts

/**
 * Local type override for web-tree-sitter.
 *
 * The upstream types declare children/namedChildren as (Node | null)[],
 * but in practice they never contain null entries. This override uses
 * non-nullable arrays to match native tree-sitter's API and avoid
 * pervasive null-check changes across the extraction pipeline.
 *
 * This file takes precedence over node_modules/web-tree-sitter/web-tree-sitter.d.ts
 * because TypeScript resolves local declarations first.
 */
declare module 'web-tree-sitter' {
  export interface Point {
    row: number;
    column: number;
  }

  export interface Range {
    startPosition: Point;
    endPosition: Point;
    startIndex: number;
    endIndex: number;
  }

  export interface Edit {
    startPosition: Point;
    oldEndPosition: Point;
    newEndPosition: Point;
    startIndex: number;
    oldEndIndex: number;
    newEndIndex: number;
  }

  export type ParseCallback = (index: number, position: Point) => string | undefined;

  export interface ParseOptions {
    includedRanges?: Range[];
    progressCallback?: (state: { currentOffset: number; hasError: boolean }) => void;
  }

  export interface EmscriptenModule {
    [key: string]: any;
  }

  export class Parser {
    language: Language | null;
    static init(moduleOptions?: EmscriptenModule): Promise<void>;
    constructor();
    delete(): void;
    setLanguage(language: Language | null): this;
    parse(callback: string | ParseCallback, oldTree?: Tree | null, options?: ParseOptions): Tree | null;
    reset(): void;
    getIncludedRanges(): Range[];
    getTimeoutMicros(): number;
    setTimeoutMicros(timeout: number): void;
    setLogger(callback: ((message: string, isLex: boolean) => void) | boolean | null): this;
    getLogger(): ((message: string, isLex: boolean) => void) | null;
  }

  export class Language {
    types: string[];
    fields: (string | null)[];
    get name(): string | null;
    get version(): number;
    get abiVersion(): number;
    get fieldCount(): number;
    get stateCount(): number;
    fieldIdForName(fieldName: string): number | null;
    fieldNameForId(fieldId: number): string | null;
    idForNodeType(type: string, named: boolean): number | null;
    get nodeTypeCount(): number;
    nodeTypeForId(typeId: number): string | null;
    nodeTypeIsNamed(typeId: number): boolean;
    nodeTypeIsVisible(typeId: number): boolean;
    get supertypes(): number[];
    subtypes(supertype: number): number[];
    nextState(stateId: number, typeId: number): number;
    lookaheadIterator(stateId: number): any;
    query(source: string): any;
    static load(input: string | Uint8Array): Promise<Language>;
  }

  export class Tree {
    language: Language;
    copy(): Tree;
    delete(): void;
    get rootNode(): Node;
    rootNodeWithOffset(offsetBytes: number, offsetExtent: Point): Node;
    edit(edit: Edit): void;
    walk(): TreeCursor;
    getChangedRanges(other: Tree): Range[];
    getIncludedRanges(): Range[];
  }

  export class Node {
    id: number;
    startIndex: number;
    startPosition: Point;
    tree: Tree;
    get typeId(): number;
    get grammarId(): number;
    get type(): string;
    get grammarType(): string;
    get isNamed(): boolean;
    get isExtra(): boolean;
    get isError(): boolean;
    get isMissing(): boolean;
    get hasChanges(): boolean;
    get hasError(): boolean;
    get endIndex(): number;
    get endPosition(): Point;
    get text(): string;
    get parseState(): number;
    get nextParseState(): number;
    equals(other: Node): boolean;
    child(index: number): Node | null;
    namedChild(index: number): Node | null;
    childForFieldId(fieldId: number): Node | null;
    childForFieldName(fieldName: string): Node | null;
    fieldNameForChild(index: number): string | null;
    fieldNameForNamedChild(index: number): string | null;
    childrenForFieldName(fieldName: string): Node[];
    childrenForFieldId(fieldId: number): Node[];
    firstChildForIndex(index: number): Node | null;
    firstNamedChildForIndex(index: number): Node | null;
    get childCount(): number;
    get namedChildCount(): number;
    get firstChild(): Node | null;
    get firstNamedChild(): Node | null;
    get lastChild(): Node | null;
    get lastNamedChild(): Node | null;
    // Override: non-nullable arrays (tree-sitter never returns null in these)
    get children(): Node[];
    get namedChildren(): Node[];
    descendantsOfType(types: string | string[], startPosition?: Point, endPosition?: Point): Node[];
    get nextSibling(): Node | null;
    get previousSibling(): Node | null;
    get nextNamedSibling(): Node | null;
    get previousNamedSibling(): Node | null;
    get descendantCount(): number;
    get parent(): Node | null;
    childWithDescendant(descendant: Node): Node | null;
    descendantForIndex(start: number, end?: number): Node | null;
    namedDescendantForIndex(start: number, end?: number): Node | null;
    descendantForPosition(start: Point, end?: Point): Node | null;
    namedDescendantForPosition(start: Point, end?: Point): Node | null;
    walk(): TreeCursor;
    edit(edit: Edit): void;
    toString(): string;
  }

  export class TreeCursor {
    copy(): TreeCursor;
    delete(): void;
    get currentNode(): Node;
    get currentFieldId(): number;
    get currentFieldName(): string | null;
    get currentDepth(): number;
    get currentDescendantIndex(): number;
    get nodeType(): string;
    get nodeTypeId(): number;
    get nodeStateId(): number;
    get nodeId(): number;
    get nodeIsNamed(): boolean;
    get nodeIsMissing(): boolean;
    get nodeText(): string;
    get startPosition(): Point;
    get endPosition(): Point;
    get startIndex(): number;
    get endIndex(): number;
    gotoFirstChild(): boolean;
    gotoLastChild(): boolean;
    gotoParent(): boolean;
    gotoNextSibling(): boolean;
    gotoPreviousSibling(): boolean;
    gotoDescendant(goalDescendantIndex: number): void;
    gotoFirstChildForIndex(goalIndex: number): boolean;
    gotoFirstChildForPosition(goalPosition: Point): boolean;
    reset(node: Node): void;
    resetTo(cursor: TreeCursor): void;
  }
}