first attempt to build an api.d.ts file - dependencies not working yet.

.gitignore

@@ -59,3 +59,6 @@ typings/
 
 # next.js build output
 .next
+
+# VS Code items
+.vscode/

api.ts

@@ -0,0 +1,112 @@
+/* --------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All Rights Reserved.
+ * See 'LICENSE' in the project root for license information.
+ * ------------------------------------------------------------------------------------------ */
+'use strict';
+
+import * as vscode from 'vscode';
+import { CancellationToken } from 'vscode-jsonrpc';
+
+/**
+ * An interface to allow Custom Configuration Provider extensions to communicate with this extension.
+ */
+export interface CppToolsApi {
+    /**
+     * Register the Custom Configuration Provider.
+     * This must be called as soon as the provider extension is ready. This is necessary for cpptools
+     * to request configurations from the provider.
+     * @param provider An instance of the [CustomConfigurationProvider](#CustomConfigurationProvider)
+     * instance representing the provider extension.
+     */
+    registerCustomConfigurationProvider(provider: CustomConfigurationProvider): void;
+
+    /**
+     * Notifies cpptools that the current configuration has changed. Upon receiving this notification,
+     * cpptools will request the new configurations.
+     * @param provider An instance of the [CustomConfigurationProvider](#CustomConfigurationProvider)
+     * instance representing the provider extension.
+     */
+    didChangeCustomConfiguration(provider: CustomConfigurationProvider): void;
+}
+
+/**
+ * An interface to allow this extension to communicate with Custom Configuration Provider extensions.
+ */
+export interface CustomConfigurationProvider {
+    /**
+     * The name of the Custom Configuration Provider extension.
+     */
+    name: string;
+
+    /**
+     * A request to determine whether this provider can provide IntelliSense configurations for the given document.
+     * @param uri The URI of the document.
+     * @param token (optional) The cancellation token.
+     * @returns 'true' if this provider can provide IntelliSense configurations for the given document.
+     */
+    canProvideConfiguration(uri: vscode.Uri, token?: CancellationToken): Thenable<boolean>;
+
+    /**
+     * A request to get Intellisense configurations for the given files.
+     * @param uris A list of one of more URIs for the files to provide configurations for.
+     * @param token (optional) The cancellation token.
+     * @returns A list of [SourceFileConfigurationItem](#SourceFileConfigurationItem) for the documents that this provider
+     * is able to provide IntelliSense configurations for.
+     * Note: If this provider cannot provide configurations for a file in `uris`, then the file will not be included
+     * in the return value. An empty list will be returned if the provider cannot provide configurations for any of the files.
+     */
+    provideConfigurations(uris: vscode.Uri[], token?: CancellationToken): Thenable<SourceFileConfigurationItem[]>;
+}
+
+/**
+ * The model representing the custom IntelliSense configurations for a source file.
+ */
+export interface SourceFileConfiguration {
+    /**
+     * This must also include the system include path (compiler defaults) unless
+     * [compilerPath](#SourceFileConfiguration.compilerPath) is specified.
+     */
+    includePath: string[];
+
+    /**
+     * This must also include the compiler default defines (__cplusplus, etc) unless
+     * [compilerPath](#SourceFileConfiguration.compilerPath) is specified.
+     */
+    defines: string[];
+
+    /**
+     * Currently, "msvc-x64" or "clang-x64".
+     */
+    intelliSenseMode: string;
+    
+    /**
+     * The C or C++ standard. See `package.json` for valid values.
+     */
+    standard: string;
+
+    /**
+     * Any files that need to be included before the source file is parsed.
+     */
+    forcedInclude?: string[];
+
+    /**
+     * The full path to the compiler. If specified, the extension will query it for default includes and defines and
+     * add them to [includePath](#SourceFileConfiguration.includePath) and [defines](#SourceFileConfiguration.defines).
+     */
+    compilerPath?: string;
+}
+
+/**
+ * A model representing a source file and its corresponding configuration.
+ */
+export interface SourceFileConfigurationItem {
+    /**
+     * The URI of the source file.
+     */
+    uri: string;
+
+    /**
+     * The IntelliSense configuration for [uri](#SourceFileConfigurationItem.uri)
+     */
+    configuration: SourceFileConfiguration;
+}

package.json

@@ -0,0 +1,29 @@
+{
+  "name": "vscode-cpptools",
+  "version": "0.1.0",
+  "description": "Public API for vscode-cpptools",
+  "typings": "./out/api.d.ts",
+  "engines": {
+    "vscode": "^1.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^2.5.3",
+    "vscode": "^1.1.17"
+  },
+  "scripts": {
+    "compile": "tsc -p ./"
+  },
+  "keywords": [
+    "vscode",
+    "cpptools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Microsoft/vscode-cpptools-api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Microsoft/vscode-cpptools-api/issues"
+  },
+  "author": "Microsoft Corporation",
+  "license": "MIT"
+}

tsconfig.json

@@ -0,0 +1,14 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "target": "es6",
+        "noImplicitAny": false,
+        "sourceMap": false,
+        "outDir": "out",
+        "declaration": true
+    },
+    "exclude": [
+        "node_modules",
+        "out"
+    ]
+}