Preset for building your SolidJS package with tsup.
npm install tsup-preset-solid



Preset for building your SolidJS packages with ease using tsup _(powered by esbuild)_.
- Preconfigured - Just install, set your entries and you're done.
- Fast - Uses esbuild under the hood.
- SolidStart support - Includes solid export condition with preserved JSX.
- Best practices - Ensures that the built library works well with Solid's tooling ecosystem.
- Development and server entries - Creates a separate entry for development, server-side rendering and production form a single source.
- Multiple entries - Supports multiple package entries. _(submodules)_
- Automatic package.json configuration - Automatically writes export fields to package.json based on passed options.
> Warning This preset is tailored towards a specific usage, mainly for primitives libraries or small headless libraries, so diverging from the happy path may cause unexpected results. Please report any issues you find.
``bash`
npm i -D tsup tsup-preset-solidor
pnpm add -D tsup tsup-preset-solidor
yarn add -D tsup tsup-preset-solid
`ts
// tsup.config.ts
import { defineConfig } from 'tsup'
import * as preset from 'tsup-preset-solid'
const preset_options: preset.PresetOptions = {
// array or single object
entries: [
// default entry (index)
{
// entries with '.tsx' extension will have solid export condition generatedtrue
entry: 'src/index.tsx',
// set or pass a specific path to generate a development-only entrytrue
dev_entry: 'src/dev.tsx',
// set or pass a specific path to generate a server-only entrytrue
server_entry: true,
},
{
// non-default entries with "index" filename should have a name specified
name: 'additional',
entry: 'src/additional/index.ts',
dev_entry: true,
},
{
entry: 'src/shared.ts',
},
],
// Set to to remove all console.* calls and debugger statements in prod buildstrue
drop_console: true,
// Set to to generate a CommonJS build alongside ESM
cjs: false,
}
export default defineConfig(config => {
const watching = !!config.watch
const parsed_data = preset.parsePresetOptions(preset_options, watching)
if (!watching) {
const package_fields = preset.generatePackageExports(parsed_data)
console.log(\npackage.json: \n${JSON.stringify(package_fields, null, 2)}\n\n)
/*
will update ./package.json with the correct export fields
*/
preset.writePackageJson(package_fields)
}
return preset.generateTsupOptions(parsed_data)
})
`
`json`
{
"type": "module",
"files": ["dist"],
"scripts": {
"build": "tsup",
"dev": "tsup --watch"
}
}
1. solid export condition
This preset will automatically add solid export condition to your package.json if you have any .tsx entry files. This is required for SolidStart to work properly.
2. "type": "module"
This preset requires your package to be a module.
3. Needs ESM
This preset requires your package to be ESM. If you want to support CJS additionally, you can set cjs: true in the options. Other export format are not supported.
4. development-only solid export issue
Currently SolidStart has an issue with development and solid export condition. (solid-start issue)
This can be "fixed" by overriding the @rollup/plugin-node-resolve dependency in your package.json:
`json``
{
"pnpm": {
"overrides": {
"@rollup/plugin-node-resolve": "13.3.0"
}
}
}