@4mbl/tsconfig 1.0.0 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @4mbl/tsconfig
 
-> Templates for `tsconfig` files for various environments.
+> TypeScript configuration templates for various environments.
 
 ## Usage
 
@@ -19,43 +19,25 @@ Create a `tsconfig.json` file in the root of your project and extend the desired
 }
 ```
 
-To avoid path related problems, you should override the following settings in your project's `tsconfig` file.
-
-```jsonc
-{
-  "extends": "@4mbl/tsconfig/node/latest",
-  "include": ["src/**/*"],
-  "exclude": ["node_modules"],
-  "compilerOptions": {
-    "rootDir": "src",
-    "paths": {
-      "@/*": ["*"]
-    }
-  }
-
-  /* your custom settings */
-}
-```
-
 ## Available templates
 
 There are currently three `tsconfig` templates.
 
-### Base <kbd>[tsconfig](./base/latest.json) | [changelog](./base/CHANGELOG.md)</kbd>
+### Base <kbd>[tsconfig](https://unpkg.com/@4mbl/tsconfig@latest/base/latest.json) | [changelog](./base/changelog.md)</kbd>
 
-This is the base `tsconfig` file that is used by the other `tsconfig` files. It contains the basic configuration for TypeScript without any environment specific settings.
+This is the base `tsconfig` file that is used by the other templates. It contains the basic configuration for TypeScript without any environment specific settings.
 
-### Node <kbd>[tsconfig](./node/latest.json) | [changelog](./node/CHANGELOG.md)</kbd>
+### Node <kbd>[tsconfig](https://unpkg.com/@4mbl/tsconfig@latest/node/latest.json) | [changelog](./node/changelog.md)</kbd>
 
-Extends the base `tsconfig` file and adds settings specific to Node.js.
+Extends the base template and adds settings specific to Node.js.
 
-### Browser <kbd>[tsconfig](./browser/latest.json) | [changelog](./browser/CHANGELOG.md)</kbd>
+### Browser <kbd>[tsconfig](https://unpkg.com/@4mbl/tsconfig@latest/browser/latest.json) | [changelog](./browser/changelog.md)</kbd>
 
-Extends the base `tsconfig` file and adds settings specific to browser and React applications.
+Extends the base template and adds settings specific to browser and React applications.
 
 ## Versioning
 
-The package and each template are versioned separately. Seperate versioning allows you to update the package without worrying about breaking changes to the templates. It also allows you to easily test newer versions of the templates by just updating the `extends` field in your project's `tsconfig` file.
+The package and each template are versioned separately. Seperate versioning allows you to update the package without worrying about breaking changes to the templates. It also allows you to easily test newer versions of the templates by just changing the `extends` field in the `tsconfig` file of your project.
 
 ### Package versioning
 
@@ -65,14 +47,14 @@ The package itself follows the following versioning scheme: `major.minor.patch`
 * `minor` - Non-base template is changed or added.
 * `patch` - Non-breaking changes to the templates.
 
-If you are using a specific version of the template in your project's `tsconfig` file, you can update the package without worrying about any breaking changes to your project.
+If you are extending a specific version of a template in your project, you can update the package without worrying about any breaking changes to your project.
 
 ### Template versioning
 
 Each template is versioned separately. The versioning scheme is: `major.minor.patch`
 
-* `major` - Major overhaul of the template. Rarely used.
+* `major` - Major overhaul of the template. Major changes to upstream templates warrant a major version on the inheriting templates.
 * `minor` - Breaking changes to the template.
 * `patch` - Non-breaking changes to the template.
 
-Each template also has a `latest` version. However, it is not recommended to use the `latest` version in your project's `tsconfig` file as it may introduce breaking changes when the package is updated.
+Each template also has a `latest` version. However, it is not recommended to extend the `latest` version in your project as it may introduce breaking changes when the package is updated.

package/base/1.0.0.json

@@ -1,40 +1,40 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "display": "Base",
-  "_version": "1.0.0",
-  "compilerOptions": {
-    /* Base Options */
-    "lib": ["ESNext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "moduleDetection": "force",
-    "rootDir": "../../../../../../../",
-    "baseUrl": "../../../../../../../",
-    "paths": {
-      "@/*": ["../../../../../../../src/*"]
-    },
-
-    /* Output */
-    "target": "ES6",
-    "outDir": "dist",
-    "sourceMap": true,
-    "declaration": true,
-    "incremental": true,
-    "isolatedModules": true,
-    "esModuleInterop": true,
-
-    /* Linting */
-    "checkJs": true,
-    "forceConsistentCasingInFileNames": true,
-    "noFallthroughCasesInSwitch": true,
-    "noImplicitAny": true,
-    "noImplicitReturns": false,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "strict": true,
-    "noUncheckedIndexedAccess": true
-  },
-  "include": ["../../../../../../../src/**/*"],
-  "exclude": ["../../../../../../node_modules"]
-}
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Base",
+  "_version": "1.0.0",
+  "compilerOptions": {
+    /* Base Options */
+    "lib": ["ESNext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "moduleDetection": "force",
+    "rootDir": "../../../../../../../",
+    "baseUrl": "../../../../../../../",
+    "paths": {
+      "@/*": ["../../../../../../../src/*"]
+    },
+
+    /* Output */
+    "target": "ES6",
+    "outDir": "dist",
+    "sourceMap": true,
+    "declaration": true,
+    "incremental": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+
+    /* Linting */
+    "checkJs": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": false,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true
+  },
+  "include": ["../../../../../../../src/**/*"],
+  "exclude": ["../../../../../../node_modules"]
+}

package/base/2.0.0.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Base",
+  "_version": "2.0.0",
+  "compilerOptions": {
+    /* Base Options */
+    "lib": ["ESNext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "moduleDetection": "force",
+    "rootDir": "${configDir}/",
+    "baseUrl": "${configDir}/",
+    "paths": {
+      "@/*": ["${configDir}/src/*"]
+    },
+
+    /* Output */
+    "target": "ES6",
+    "outDir": "dist",
+    "sourceMap": true,
+    "declaration": true,
+    "incremental": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+
+    /* Linting */
+    "strict": true,
+    "checkJs": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": false,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noUncheckedIndexedAccess": true
+  },
+  "include": ["${configDir}/src/**/*"],
+  "exclude": ["${configDir}/node_modules"]
+}

package/base/latest.json

@@ -1,40 +1,40 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "display": "Base",
-  "_version": "0.0.1",
-  "compilerOptions": {
-    /* Base Options */
-    "lib": ["ESNext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "moduleDetection": "force",
-    "rootDir": "../../../../../../../",
-    "baseUrl": "../../../../../../../",
-    "paths": {
-      "@/*": ["../../../../../../../src/*"]
-    },
-
-    /* Output */
-    "target": "ES6",
-    "outDir": "dist",
-    "sourceMap": true,
-    "declaration": true,
-    "incremental": true,
-    "isolatedModules": true,
-    "esModuleInterop": true,
-
-    /* Linting */
-    "checkJs": true,
-    "forceConsistentCasingInFileNames": true,
-    "noFallthroughCasesInSwitch": true,
-    "noImplicitAny": true,
-    "noImplicitReturns": false,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "strict": true,
-    "noUncheckedIndexedAccess": true
-  },
-  "include": ["../../../../../../../src/**/*"],
-  "exclude": ["../../../../../../node_modules"]
-}
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Base",
+  "_version": "2.0.0",
+  "compilerOptions": {
+    /* Base Options */
+    "lib": ["ESNext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "moduleDetection": "force",
+    "rootDir": "${configDir}/",
+    "baseUrl": "${configDir}/",
+    "paths": {
+      "@/*": ["${configDir}/src/*"]
+    },
+
+    /* Output */
+    "target": "ES6",
+    "outDir": "dist",
+    "sourceMap": true,
+    "declaration": true,
+    "incremental": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+
+    /* Linting */
+    "strict": true,
+    "checkJs": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": false,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noUncheckedIndexedAccess": true
+  },
+  "include": ["${configDir}/src/**/*"],
+  "exclude": ["${configDir}/node_modules"]
+}

package/browser/2.0.0.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Browser",
+  "_version": "2.0.0",
+  "extends": "../base/2.0.0.json",
+  "compilerOptions": {
+    "lib": ["DOM", "DOM.Iterable", "ESNext"],
+    "jsx": "react-jsx",
+    "tsBuildInfoFile": "tsconfig.browser.tsbuildinfo",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "noEmit": true,
+    "sourceMap": true
+  }
+}

package/browser/latest.json

@@ -1,15 +1,15 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "display": "Browser",
-  "_version": "0.0.1",
-  "extends": "../base/0.0.1.json",
-  "compilerOptions": {
-    "lib": ["DOM", "DOM.Iterable", "ESNext"],
-    "jsx": "react-jsx",
-    "tsBuildInfoFile": "tsconfig.browser.tsbuildinfo",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "noEmit": true,
-    "sourceMap": true
-  }
-}
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Browser",
+  "_version": "2.0.0",
+  "extends": "../base/2.0.0.json",
+  "compilerOptions": {
+    "lib": ["DOM", "DOM.Iterable", "ESNext"],
+    "jsx": "react-jsx",
+    "tsBuildInfoFile": "tsconfig.browser.tsbuildinfo",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "noEmit": true,
+    "sourceMap": true
+  }
+}

package/node/1.0.0.json

@@ -1,11 +1,11 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "display": "Node",
-  "_version": "1.0.0",
-  "extends": "../base/1.0.0.json",
-  "compilerOptions": {
-    "target": "ESNext",
-    "moduleResolution": "NodeNext",
-    "module": "NodeNext"
-  }
-}
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Node",
+  "_version": "1.0.0",
+  "extends": "../base/1.0.0.json",
+  "compilerOptions": {
+    "target": "ESNext",
+    "moduleResolution": "NodeNext",
+    "module": "NodeNext"
+  }
+}

package/node/2.0.0.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Node",
+  "_version": "2.0.0",
+  "extends": "../base/2.0.0.json",
+  "compilerOptions": {
+    "target": "ESNext",
+    "moduleResolution": "NodeNext",
+    "module": "NodeNext"
+  }
+}

package/node/latest.json

@@ -1,11 +1,11 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "display": "Node",
-  "_version": "0.0.1",
-  "extends": "../base/0.0.1.json",
-  "compilerOptions": {
-    "target": "ESNext",
-    "moduleResolution": "NodeNext",
-    "module": "NodeNext"
-  }
-}
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Node",
+  "_version": "2.0.0",
+  "extends": "../base/2.0.0.json",
+  "compilerOptions": {
+    "target": "ESNext",
+    "moduleResolution": "NodeNext",
+    "module": "NodeNext"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@4mbl/tsconfig",
-  "version": "1.0.0",
-  "description": "tsconfig templates for typescript projects",
+  "version": "2.0.0",
+  "description": "TypeScript configuration templates for various environments.",
   "type": "module",
   "author": "4mbl",
   "license": "MIT",
@@ -16,10 +16,20 @@
   ],
   "scripts": {
     "build": "node ./scripts/copyLatest.js *",
+    "delete:latest": "node ./scripts/deleteLatestJson.js",
+    "delete:version": "node ./scripts/deleteVersionFile.js",
     "get:version": "node -pe \"require('./package.json')['version']\" > version.txt",
-    "release": "npm run get:version && npm run build && npm publish && git add . && git commit --file version.txt && git push && rm version.txt",
+    "release": "npm run get:version && npm run build && npm publish && npm run delete:latest && git add . && git commit --file version.txt && git push && npm run delete:version",
     "release:patch": "npm version patch --no-git-tag-version && npm run release",
     "release:minor": "npm version minor --no-git-tag-version && npm run release",
     "release:major": "npm version major --no-git-tag-version && npm run release"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.5.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
   }
 }