feat: add call-hierarchy.d.ts (#82)

Co-authored-by: Amin Yahyaabadi <aminyahyaabadi74@gmail.com>

Author: ayame113

types-packages/call-hierarchy.d.ts

@@ -0,0 +1,36 @@
+import type * as Atom from "atom"
+import type { IdeUri } from "./uri"
+
+export type CallHierarchyType = "incoming" | "outgoing"
+
+export interface CallHierarchyProvider {
+  name: string
+  priority: number
+  grammarScopes: ReadonlyArray<string>
+  getIncomingCallHierarchy(editor: Atom.TextEditor, point: Atom.Point): Promise<CallHierarchy<"incoming"> | null>
+  getOutgoingCallHierarchy(editor: Atom.TextEditor, point: Atom.Point): Promise<CallHierarchy<"outgoing"> | null>
+}
+
+interface CallHierarchy<T extends CallHierarchyType> {
+  type: T
+  data: CallHierarchyItem[]
+  /** Returns CallHierarchy data about the i-th CallHierarchyItem. */
+  itemAt(i: number): Promise<CallHierarchy<T>>
+}
+
+interface CallHierarchyItem {
+  path: IdeUri
+  name: string
+  /** Same as the icon of outline.d.ts */
+  icon?: string
+  tags: SymbolTagKind[]
+  detail?: string
+  range: Atom.Range
+  selectionRange: Atom.Range
+}
+
+/**
+ * Kind of symbol tag - matches the names from the Language Server Protocol. LSP specification:
+ * https://microsoft.github.io/language-server-protocol/specifications/specification-current/#symbolTag
+ */
+export type SymbolTagKind = "deprecated" // currently no other type

types-packages/main.d.ts

@@ -5,6 +5,7 @@
 
 export * from "./uri"
 export * from "./busy-signal"
+export * from "./call-hierarchy"
 export * from "./code-actions"
 export * from "./code-highlight"
 export * from "./datatip"
@@ -20,6 +21,7 @@ export * from "./refactor"
 export * from "./console"
 
 import { BusySignalProvider } from "./busy-signal.d"
+import { CallHierarchyProvider } from "./call-hierarchy"
 import { CodeActionProvider } from "./code-actions"
 import { CodeHighlightProvider } from "./code-highlight"
 import { AnyDatatipProvider } from "./datatip"
@@ -39,6 +41,7 @@ export interface ProviderCommon {
 export type Provider =
   | ProviderCommon
   | BusySignalProvider
+  | CallHierarchyProvider
   | CodeActionProvider
   | CodeHighlightProvider
   | AnyDatatipProvider