Registry / web-framework / esbuild-plugin-solid-js

esbuild-plugin-solid-js

library1.0.1jsnpmunverified

esbuild plugin (v1.0.1) that applies Solid JS transforms to JSX/TSX files using babel-preset-solid, with correct sourcemap inlining. It bridges esbuild’s fast bundling with Solid’s reactive JSX compilation. Unlike manual babel integration, this plugin preserves sourcemaps end-to-end. Does not perform TypeScript transpilation (use esbuild’s built-in ts transform). Active development, simple API with one default export.

web-framework

npm install esbuild-plugin-solid-js

package ↗homepage ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-SOL

esbuild-plugin-solid-js

web-frameworkjavascriptv1.0.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

solid

✓ import solid from 'esbuild-plugin-solid-js'

✗ import { solid } from 'esbuild-plugin-solid-js'

Default export only; named import will fail.

solid (CommonJS)

✓ const solid = require('esbuild-plugin-solid-js')

✗ const { solid } = require('esbuild-plugin-solid-js')

Default export via require(). Destructuring will return undefined.

TypeScript usage

✓ import solid from 'esbuild-plugin-solid-js'

Works with TypeScript if jsx is set to 'preserve' and jsxImportSource to 'solid-js'.

Build a Solid.js application using esbuild with this plugin, showing TypeScript and sourcemap config.

import * as esbuild from 'esbuild'; import solid from 'esbuild-plugin-solid-js'; await esbuild.build({ entryPoints: ['src/index.tsx'], bundle: true, outfile: 'dist/bundle.js', plugins: [solid()], tsconfig: 'tsconfig.json' }); // Ensure tsconfig.json has: // { "compilerOptions": { "jsx": "preserve", "jsxImportSource": "solid-js", "inlineSources": true, "inlineSourceMap": true } }

Debug

Known issues

gotchaOnly transpiles JSX/TSX files. Does NOT perform TypeScript transpilation.

fix

Use esbuild's built-in TypeScript support (set tsconfig properly) or run tsc separately.

affects: all

gotchaRequires specific tsconfig settings: jsx: 'preserve', jsxImportSource: 'solid-js', inlineSources: true, inlineSourceMap: true.

fix

Update tsconfig.json compilerOptions as above.

affects: all

gotchaDefault export only; named import will result in undefined.

fix

Use import solid from 'esbuild-plugin-solid-js' not import { solid } from ...

affects: all

gotchaBabel-based plugin may slow down builds compared to native esbuild transforms.

fix

Consider using solid-js's vite plugin for faster builds if not tied to esbuild.

affects: all

Errors

Common errors & fixes

Error: transform: Plugin 'solid' returned non-object

Calling plugin incorrectly (solid instead of solid()).

fix

Pass solid() as a plugin: plugins: [solid()]

Cannot find module 'esbuild-plugin-solid-js'

Package not installed.

fix

Run npm install esbuild-plugin-solid-js --save-dev

Property 'solid' does not exist on type 'typeof import("esbuild-plugin-solid-js")'

Using named import instead of default import.

fix

Change to import solid from 'esbuild-plugin-solid-js'

The JSX syntax is not enabled

tsconfig.json missing jsx: 'preserve'.

fix

Set jsx to 'preserve' in tsconfig compilerOptions.

Upgrade

Version history

1.0.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/esbuild-plugin-solid-js ↗

homepagehttps://gitlab.com/hesxenon/esbuild-plugin-solid-js#readme ↗