github-mirror/framework
2
0
Fork 0
mirror of https://github.com/flarum/framework.git synced 2024-11-24 22:03:27 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
2.x
framework/js-packages/tsconfig/README.md
David Wheatley 3bdb0af993
fix: intellisense imports defaulting to absolute path from src folder (#3549) 
* docs: remove baseUrl recommendation

Fixes https://github.com/flarum/flarum-tsconfig/issues/4

* chore: implement change within framework monorepo
2022-08-05 20:23:45 +01:00

1.4 KiB
Raw Permalink Blame History

Flarum Typescript Config

A standardised tsconfig.json for use in Flarum extensions.

Usage

You'll need to configure a tsconfig.json file to ensure your IDE sets up Typescript support correctly.

You need to install this package as a dev dependency to your extension JS:

npm install --save-dev flarum-tsconfig
yarn add --dev flarum-tsconfig

A baseline tsconfig.json is provided below that you can modify as needed. This file needs to be copied into your extension's js folder for your IDE to apply the correct settings.

{
  // Use Flarum's tsconfig as a starting point
  "extends": "flarum-tsconfig",
  // This will match all .ts, .tsx, .d.ts, .js, .jsx files in your `src` folder
  // and also tells your Typescript server to read core's global typings for
  // access to `dayjs` and `$` in the global namespace.
  "include": ["src/**/*", "../vendor/flarum/core/js/dist-typings/@types/**/*"],
  "compilerOptions": {
    // This will output typings to `dist-typings`
    "declarationDir": "./dist-typings",
    "paths": {
      "flarum/*": ["../vendor/flarum/core/js/dist-typings/*"]
    }
  }
}

You'll also need to ensure that you run composer update in your extension's root directory to ensure that a copy of Flarum core is downloaded to your vendor folder. Remember that vendor should not be committed to Git repositories.