esbuild-plugin-jsy

0.0.2 verified Fri May 01 auth: no javascript

ESBuild plugin for JSY syntax transpilation to standard JavaScript. Current version 0.0.2 is experimental with no regular release cadence. JSY is a custom JavaScript superset that compiles to standard JS. This plugin allows using JSY files directly in ESBuild builds. Key differentiators: minimal configuration, integrates JSY transpilation into ESBuild pipeline. Alternatives include using JSY CLI separately.

Common errors

error Cannot find module 'jsy-lang' ↓

cause Missing peer dependency jsy-lang.

fix

npm install jsy-lang

error require() of ES Module esbuild-plugin-jsy from CJS not supported. ↓

cause Package is ESM-only but loaded via CommonJS require.

fix

Use import (ESM) or switch to dynamic import() in CommonJS.

error jsyPlugin is not a function ↓

cause Named import used instead of default import.

fix

import jsyPlugin from 'esbuild-plugin-jsy' (no braces)

Warnings

breaking Plugin is marked as experimental (version 0.x); API may change without notice. ↓

fix Pin exact version and test upgrades carefully.

gotcha JSY is a non-standard JavaScript superset; output may not be valid ES2020 without proper configuration. ↓

fix Ensure JSY configuration matches target environment.

gotcha Plugin requires that JSY is installed separately as a peer dependency. ↓

fix Run npm install jsy-lang alongside esbuild-plugin-jsy.

Install

npm install esbuild-plugin-jsy

yarn add esbuild-plugin-jsy

pnpm add esbuild-plugin-jsy

Imports

default

wrong

const jsyPlugin = require('esbuild-plugin-jsy')

correct

import jsyPlugin from 'esbuild-plugin-jsy'

Package is ESM-only; CommonJS require will error.

jsyPlugin

wrong

import { jsyPlugin } from 'esbuild-plugin-jsy'

correct

import jsyPlugin from 'esbuild-plugin-jsy'

Default export is the plugin function; named export does not exist.

Plugin type
```
import type { Plugin } from 'esbuild'
```
TypeScript users should import Plugin type from esbuild, not from this package.

Quickstart

Build a JSY entry point with ESBuild using the JSY plugin.

import esbuild from 'esbuild';
import jsyPlugin from 'esbuild-plugin-jsy';

await esbuild.build({
  entryPoints: ['app.jsy'],
  bundle: true,
  outfile: 'out.js',
  plugins: [jsyPlugin()],
});