try tweaks to tsconfigs to allow typechecking dist-raw APIs

Author: cspotcode

package.json

@@ -60,7 +60,7 @@
     "rebuild": "npm run clean && npm run build",
     "build": "npm run build-nopack && npm run build-pack",
     "build-nopack": "npm run build-tsc && npm run build-configSchema",
-    "build-tsc": "tsc --build ./tsconfig.build.json",
+    "build-tsc": "tsc --build ./tsconfig.declarations.json && ( rm -r .tmp/declarations/src 2> /dev/null || true) && tsc --build ./tsconfig.build.json",
     "build-configSchema": "typescript-json-schema --topRef --refs --validationKeywords allOf --out tsconfig.schema.json tsconfig.build-schema.json TsConfigSchema && node --require ./register ./scripts/create-merged-schema",
     "build-pack": "node ./scripts/build-pack.js",
     "test-spec": "ava",

tsconfig.build-dist-raw.json

@@ -7,13 +7,14 @@
   // so that `src`->`dist` paths map correctly.
 
   "extends": "./tsconfig.json",
-  "references": [{
-    "path": "./tsconfig.build-dist-raw.json"
-  }],
   "compilerOptions": {
     "noEmit": false,
     "allowJs": false,
     "rootDir": "src",
+    "rootDirs": [
+      ".",
+      ".tmp/declarations"
+    ],
     "outDir": "dist",
     "tsBuildInfoFile": ".tmp/tsconfig.build.tsbuildinfo",
   }

tsconfig.build.json

@@ -0,0 +1,18 @@
+{
+  // Purpose: to extract .d.ts declarations from dist-raw
+  "extends": "./tsconfig.json",
+  "include": [
+    "src",
+    "dist-raw"
+  ],
+  "compilerOptions": {
+    "incremental": true,
+    "allowJs": true,
+    "emitDeclarationOnly": true,
+    "stripInternal": false,
+    "noEmit": false,
+    "rootDir": ".",
+    "outDir": ".tmp/declarations",
+    "tsBuildInfoFile": ".tmp/tsconfig.declarations.tsbuildinfo",
+  }
+}

tsconfig.declarations.json

@@ -1,4 +1,9 @@
 {
+  // Role: support editor code intelligence
+
+  // Note: this tsconfig is not used for compiling.
+  // See tsconfig.declarations.json and tsconfig.build.json
+
   "$schema": "./tsconfig.schemastore-schema.json",
   "compilerOptions": {
     "allowJs": true,