Add external API types to be published

Author: thegecko

api/README.md

@@ -0,0 +1,30 @@
+# VS Code clangd Extension API
+
+The VS Code clangd extension exposes an API that other extensions can consume:
+
+```typescript
+import * as vscode from 'vscode';
+import type { ClangdExtension, ASTParams, ASTNode, ASTType } from '@clangd/vscode-clangd';
+
+const CLANGD_EXTENSION = 'llvm-vs-code-extensions.vscode-clangd';
+const CLANGD_API_VERSION = 1;
+
+const provideHover = (document: vscode.TextDocument, position: vscode.Position, _token: vscode.CancellationToken): Promise<vscode.Hover | undefined> => {
+
+    const clangdExtension = vscode.extensions.getExtension<ClangdExtension>(CLANGD_EXTENSION);
+
+    if (clangdExtension) {
+        const api = (await clangdExtension.activate()).getApi(CLANGD_API_VERSION);
+ 
+        const textDocument = api.languageClient.code2ProtocolConverter.asTextDocumentIdentifier(document);
+        const range = api.languageClient.code2ProtocolConverter.asRange(new vscode.Range(position, position));
+        const params: ASTParams = { textDocument, range };
+ 
+        const ast: ASTNode | undefined = await api.languageClient.sendRequest(ASTType, params);
+
+        return {
+            contents: [ast.kind]
+        };
+    }
+};
+```

api/package.json

@@ -0,0 +1,13 @@
+{
+    "name": "@clangd/vscode-clangd",
+    "version": "0.0.0",
+    "description": "API for the llvm-vs-code-extensions.vscode-clangd VS Code extension",
+    "types": "vscode-clangd.d.ts",
+    "publishConfig": {
+        "registry": "https://npm.pkg.github.com"
+    },
+    "repository": "https://github.com/clangd/vscode-clangd",
+    "dependencies": {
+        "vscode-languageclient": "8.0.2"
+    }
+}

api/vscode-clangd.d.ts

@@ -0,0 +1,27 @@
+import {BaseLanguageClient} from 'vscode-languageclient';
+import * as vscodelc from 'vscode-languageclient/node';
+
+// The wire format: we send a position, and get back a tree of ASTNode.
+export interface ASTParams {
+  textDocument: vscodelc.TextDocumentIdentifier;
+  range: vscodelc.Range;
+}
+
+export interface ASTNode {
+  role: string;    // e.g. expression
+  kind: string;    // e.g. BinaryOperator
+  detail?: string; // e.g. ||
+  arcana?: string; // e.g. BinaryOperator <0x12345> <col:12, col:1> 'bool' '||'
+  children?: Array<ASTNode>;
+  range?: vscodelc.Range;
+}
+
+export const ASTType = 'textDocument/ast';
+
+export interface ClangdApiV1 {
+  languageClient: BaseLanguageClient
+}
+
+export interface ClangdExtension {
+  getApi(version: 1): ClangdApiV1;
+}

src/api.ts

@@ -1,12 +1,5 @@
 import {BaseLanguageClient} from 'vscode-languageclient';
-
-export interface ClangdApiV1 {
-  languageClient: BaseLanguageClient
-}
-
-export interface ClangdExtension {
-  getApi(version: 1): ClangdApiV1;
-}
+import {ClangdApiV1, ClangdExtension} from '../api/vscode-clangd';
 
 export class ClangdExtensionImpl implements ClangdExtension {
   constructor(

src/ast.ts

@@ -4,27 +4,15 @@ import * as vscode from 'vscode';
 import * as vscodelc from 'vscode-languageclient/node';
 
 import {ClangdContext} from './clangd-context';
+import {ASTParams, ASTNode, ASTType} from '../api/vscode-clangd';
 
 export function activate(context: ClangdContext) {
   const feature = new ASTFeature(context);
   context.client.registerFeature(feature);
 }
 
-// The wire format: we send a position, and get back a tree of ASTNode.
-interface ASTParams {
-  textDocument: vscodelc.TextDocumentIdentifier;
-  range: vscodelc.Range;
-}
-interface ASTNode {
-  role: string;    // e.g. expression
-  kind: string;    // e.g. BinaryOperator
-  detail?: string; // e.g. ||
-  arcana?: string; // e.g. BinaryOperator <0x12345> <col:12, col:1> 'bool' '||'
-  children?: Array<ASTNode>;
-  range?: vscodelc.Range;
-}
 const ASTRequestType =
-    new vscodelc.RequestType<ASTParams, ASTNode|null, void>('textDocument/ast');
+    new vscodelc.RequestType<ASTParams, ASTNode|null, void>(ASTType);
 
 class ASTFeature implements vscodelc.StaticFeature {
   constructor(private context: ClangdContext) {

src/extension.ts

@@ -1,6 +1,7 @@
 import * as vscode from 'vscode';
 import {ClangdContext} from './clangd-context';
-import {ClangdExtension, ClangdExtensionImpl} from './api';
+import {ClangdExtension} from '../api/vscode-clangd';
+import {ClangdExtensionImpl} from './api';
 
 /**
  *  This method is called when the extension is activated. The extension is