Registry / web-framework / parcel-plugin-typescript

parcel-plugin-typescript

library1.0.0jsnpmunverified

parcel-plugin-typescript provides enhanced TypeScript integration for Parcel 1, extending beyond Parcel's native transpiling. Key features include full type checking in a separate process for performance, on-the-fly path mappings based on `tsconfig.json`'s `paths` and `baseUrl` options, and support for custom AST transformers. This plugin aims to offer a comprehensive TypeScript development experience similar to `awesome-typescript-loader` or `ts-loader` in Webpack. The package is currently at version 1.0.0, specifically designed for Parcel 1.x environments. With Parcel 1 no longer actively maintained and superseded by Parcel 2, this plugin is considered unsupported for modern Parcel workflows. There is no ongoing release cadence, and the project repository indicates inactivity since 2019.

web-framework

npm install parcel-plugin-typescript

github ↗package ↗

INSTALL

IMPORT

SIG · PARCEL-PLUGIN-TYPE

parcel-plugin-typescript

web-frameworkjavascriptv1.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

This quickstart demonstrates setting up a basic Parcel 1 project with `parcel-plugin-typescript`. It includes `package.json` with dependencies and scripts, `tsconfig.json` configured for path mappings and plugin options, an `index.html` to load the TypeScript, and example TypeScript files (`index.ts` and `utils/helper.ts`) using path aliases.

{ "name": "parcel-ts-plugin-example", "version": "1.0.0", "scripts": { "start": "parcel src/index.html --open", "build": "parcel build src/index.html" }, "devDependencies": { "parcel-bundler": "^1.9.0", "parcel-plugin-typescript": "^1.0.0", "typescript": "^2.4.0" } } // package.json { "compilerOptions": { "target": "es5", "module": "commonjs", "strict": true, "esModuleInterop": true, "skipLibCheck": true, "forceConsistentCasingInFileNames": true, "baseUrl": "./src", "paths": { "@utils/*": ["utils/*"] } }, "parcelTsPluginOptions": { "transpileOnly": false } } // tsconfig.json  <!DOCTYPE html> <html> <head> <title>Parcel TS Plugin Example</title> </head> <body> <h1>Parcel 1 + TypeScript Plugin</h1> <div id="app"></div> <script src="index.ts"></script> </body> </html> // src/utils/helper.ts export function getMessage(name: string): string { return `Hello from ${name}!`; } // src/index.ts import { getMessage } from '@utils/helper'; // Demonstrates path mapping const appDiv = document.getElementById('app'); if (appDiv) { appDiv.innerHTML = getMessage("Parcel TS Plugin"); } // Intentionally introduce a type error to show type checking works (if transpileOnly is false) // const wrongType: number = "this is a string"; console.log(getMessage("console"));

Debug

Known issues

breakingThis plugin is designed exclusively for Parcel 1.x. It is not compatible with Parcel 2.x, which has its own significantly improved built-in TypeScript support. Attempting to use this plugin with Parcel 2 will result in build failures or it being ignored.

fix

For Parcel 2.x, remove `parcel-plugin-typescript` and rely on Parcel's native TypeScript integration, which includes type checking, or consider community plugins specifically designed for Parcel 2.

affects: >=1.0.0

deprecatedThe project is no longer actively maintained. The last commit on GitHub was in 2019, coinciding with the shift towards Parcel 2. This means no new features, bug fixes, or security updates will be provided.

fix

Consider migrating to Parcel 2.x or an alternative bundler with active TypeScript support.

affects: >=1.0.0

gotchaAngular support, previously mentioned as an upcoming feature or implicitly supported, was moved to a separate plugin, `parcel-plugin-angular`. This plugin does not provide specialized Angular integration.

fix

If Angular support for Parcel 1 is needed, investigate `parcel-plugin-angular` or migrate to a modern Angular CLI setup that uses Webpack or Vite.

affects: >=1.0.0

gotchaType checking can be disabled via the `transpileOnly: true` option in `parcelTsPluginOptions` within `tsconfig.json`. If type errors are not appearing, verify this setting is `false`.

fix

Ensure `transpileOnly` is set to `false` in your `tsconfig.json` under `parcelTsPluginOptions` to enable full type checking during the build process.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module '@path/to/module'

TypeScript path mappings (e.g., `baseUrl`, `paths` in `tsconfig.json`) are not being correctly applied or resolved by Parcel.

fix

Ensure `baseUrl` and `paths` are correctly configured in `tsconfig.json`. Verify that `parcel-plugin-typescript` is installed and that Parcel is discovering the plugin. Also, check for typos in the import paths.

TypeScript errors are not displayed during `parcel build` or `parcel watch`.

The `transpileOnly` option in `parcelTsPluginOptions` is set to `true`, disabling full type checking, or the plugin is not correctly integrated/discovered.

fix

Set `"transpileOnly": false` in the `parcelTsPluginOptions` object within your `tsconfig.json`. Confirm that `parcel-plugin-typescript` is listed in your `devDependencies` and Parcel 1.x is installed.

Plugin 'parcel-plugin-typescript' was not found.

Parcel 1.x failed to discover and load the plugin, or the wrong Parcel version is being used.

fix

Ensure `parcel-plugin-typescript` is listed in your `devDependencies` or `dependencies` in `package.json`. Confirm you are using Parcel 1.x (e.g., `parcel-bundler` version `^1.9.0`) and not Parcel 2.x.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

parcel-bundlerrequiredRequired peer dependency for Parcel 1.x.

typescriptrequiredRequired peer dependency for TypeScript compilation and type checking.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/fathyb/parcel-plugin-typescript ↗

packagehttps://www.npmjs.com/package/parcel-plugin-typescript ↗