feat: enable declarationMap, use .d.ts files in monorepo too

Configure TSC to emit declaration maps, providing information needed by
IDEs like VSCode to jump from usage of a symbol to its definition in
the original source code.

Simplify layout of all packages, remove top-level `index.ts` and
`index.d.ts` files in favor of a package.json entry

    "types": "dist/index.d.ts"

Simplify layout of module packages (excluding example applications) and
remove the top-level `index.js` file in favor of a package.json entry
    "main": "dist/index.js"

Update developer documentation and project templates accordingly.

Benefits of these changes:

- It's a preparation step for TypeScript Project References

- Build is consuming less CPU cycles now. User time used to be 5m21
  before, it's 1m48s now. Real time went down from 0m49s to 0m37s.

- Simpler project setup in our packages, we no longer need to maintain
  dummy index files at the top level.

Drawbacks:

- Refactor-rename does not work across packagas. I believe this is a
  limitation of TypeScript, hopefully it will be eventually fixed.

- Navigation across packages may not work until the monorepo is built.

Author: bajtos

benchmark/index.ts

@@ -9,6 +9,7 @@
     "benchmark"
   ],
   "main": "index.js",
+  "types:": "dist/index.d.ts",
   "engines": {
     "node": ">=8.9"
   },

benchmark/package.json

@@ -10,6 +10,7 @@
     "express"
   ],
   "main": "index.js",
+  "types": "dist/index.d.ts",
   "engines": {
     "node": ">=8.9"
   },

docs/site/DEVELOPING.md

@@ -3,6 +3,7 @@
   "version": "1.1.20",
   "description": "A simple hello-world Application using LoopBack 4",
   "main": "index.js",
+  "types": "dist/index.d.ts",
   "engines": {
     "node": ">=8.9"
   },

docs/site/VSCODE.md

@@ -2,7 +2,8 @@
   "name": "@loopback/example-log-extension",
   "version": "1.1.20",
   "description": "An example extension project for LoopBack 4",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "engines": {
     "node": ">=8.9"
   },

examples/express-composition/index.d.ts

@@ -9,6 +9,8 @@
   "engines": {
     "node": ">=8.9"
   },
+  "main": "index.js",
+  "types": "dist/index.d.ts",
   "scripts": {
     "build:apidocs": "lb-apidocs",
     "build": "lb-tsc es2017 --outDir dist",

examples/express-composition/index.ts

@@ -10,6 +10,7 @@
     "soap"
   ],
   "main": "index.js",
+  "types": "dist/index.d.ts",
   "engines": {
     "node": ">=8"
   },

examples/express-composition/package.json

@@ -3,6 +3,7 @@
   "version": "1.6.3",
   "description": "Continuation of the todo example using relations in LoopBack 4.",
   "main": "index.js",
+  "types": "dist/index.d.ts",
   "engines": {
     "node": ">=8.9"
   },

examples/hello-world/index.d.ts

@@ -3,6 +3,7 @@
   "version": "1.5.15",
   "description": "Tutorial example on how to build an application with LoopBack 4.",
   "main": "index.js",
+  "types": "dist/index.d.ts",
   "engines": {
     "node": ">=8.9"
   },

examples/hello-world/index.ts

@@ -23,7 +23,7 @@
       "loglevel": "silent",
       "stream": true,
       "concurrency": 8,
-      "sort": false
+      "sort": true
     },
     "clean": {
       "loglevel": "silent",

examples/hello-world/package.json

@@ -5,6 +5,8 @@
   "engines": {
     "node": ">=8.9"
   },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "scripts": {
     "acceptance": "lb-mocha \"dist/__tests__/acceptance/**/*.js\"",
     "build:apidocs": "lb-apidocs",
@@ -45,8 +47,6 @@
   ],
   "files": [
     "README.md",
-    "index.js",
-    "index.d.ts",
     "dist",
     "src",
     "!*/__tests__"

examples/log-extension/index.d.ts

@@ -5,6 +5,8 @@
   "engines": {
     "node": ">=8.9"
   },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "publishConfig": {
     "access": "public"
   },
@@ -42,8 +44,6 @@
   },
   "files": [
     "README.md",
-    "index.js",
-    "index.d.ts",
     "dist",
     "src",
     "!*/__tests__"

examples/log-extension/index.js

@@ -15,6 +15,7 @@
     "moduleResolution": "node",
     "target": "es2017",
     "sourceMap": true,
-    "declaration": true
+    "declaration": true,
+    "declarationMap": true
   }
 }

examples/log-extension/index.ts

@@ -6,7 +6,12 @@
     "loopback-<%= project.projectType -%>",
     "loopback"
   ],
+  <% if (project.projectType === 'application') { -%>
   "main": "index.js",
+  <% } else { -%>
+  "main": "dist/index.js",
+  <% } -%>
+  "types": "dist/index.d.ts",
   "engines": {
     "node": ">=8.9"
   },

examples/log-extension/package.json

@@ -6,7 +6,12 @@
     "loopback-<%= project.projectType -%>",
     "loopback"
   ],
+  <% if (project.projectType === 'application') { -%>
   "main": "index.js",
+  <% } else { -%>
+  "main": "dist/index.js",
+  <% } -%>
+  "types": "dist/index.d.ts",
   "engines": {
     "node": ">=8.9"
   },

examples/rpc-server/index.d.ts

@@ -22,7 +22,8 @@
     "moduleResolution": "node",
     "target": "es2017",
     "sourceMap": true,
-    "declaration": true
+    "declaration": true,
+    "declarationMap": true
   },
   "include": ["src"],
   "exclude": [

examples/rpc-server/index.ts

@@ -7,6 +7,7 @@
   "engines": {
     "node": ">=8.9"
   },
+  "main": "index.js",
   "files": [
     "bin",
     "lib",

examples/rpc-server/package.json

@@ -343,7 +343,6 @@ module.exports = function(projGenerator, props, projectType) {
           ['.eslintrc.js', "extends: '@loopback/eslint-config'"],
           ['tsconfig.json', '"compilerOptions"'],
           ['tsconfig.json', '"resolveJsonModule": true'],
-          ['index.js', "require('./dist')"],
         ]);
       });
     });