TypeScript / package.json configurations

[rajsite]

Describe the issue

We should consider creating a package or documenting recommended TypeScript Config and package.json export configs. For now using this issue to capture some common guidance today:

• use strict
• Do not enable skipLibCheck: true, see: https://github.com/remcohaszing/skiplibcheck
• Prefer "moduleResolution": "Node16" (or higher) for web+node / node-only libraries or "moduleResolution": "bundler" for web-only libraries. Related have a package.json structure of:

   "type": "module",
   "exports": {
    "./package.json": "./package.json",
    ".": {
      "types": "./dist/esm/index.d.ts",
      "import": "./dist/esm/index.js"
    },
    "./*": {
      "types": "./dist/esm/*.d.ts",
      "import": "./dist/esm/*/index.js"
    }
   },
   "typesVersions": {
    "*": {
      "*": [
        "dist/esm/*",
        "dist/esm/*/index.d.ts"
      ]
    }
   },
  

  Which enables base and secondary entrypoints from index files and is a file structure / package.json configuration compatible with modern and legacy node import behaviors.

[jattasNI]

Kinda related: the TypeScript 6 beta was announced and they're deprecating or recommending against a bunch of tsconfig configuration values. I haven't read too closely but if we do anything in this area we could factor in that guidance to shift our codebases away from settings that eventually won't be available.