Registry / devops / esbuild-plugin-conditional-build

esbuild-plugin-conditional-build

JSON →
library1.0.2jsnpmunverified

An esbuild plugin for conditional compilation using `//#if`, `//#else`, and `//#endif` directives in JavaScript/TypeScript files. Version 1.0.2, released as first stable. Requires esbuild and ESM setup (`type: module` in package.json and `.mjs` extensions). Differentiates from other conditional build tools by being lightweight and esbuild-native, using simple comment-based directives.

devops
github ↗package ↗
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.

Package is ESM-only (type: module required). CommonJS require will fail.

import conditionalBuild from 'esbuild-plugin-conditional-build'

Exported as default, not named.

import conditionalBuild from 'esbuild-plugin-conditional-build'

Type exports may not exist; always check documentation.

import type { ConditionalBuildOptions } from 'esbuild-plugin-conditional-build'

Sets up esbuild with conditional build plugin, defining 'DEVELOPMENT' constant and building entry point.

// build.mjs import conditionalBuild from 'esbuild-plugin-conditional-build'; import { build } from 'esbuild'; build({ entryPoints: ['src/foo.js'], outdir: 'dist', plugins: [ conditionalBuild(['DEVELOPMENT']) ] }).catch(() => process.exit(1));
Debug
Known footguns
breakingRequires ESM: 'type': 'module' in package.json and .mjs file extensions.
gotchaFiles must start with '//#conditional' comment for directives to work.
gotchaDirectives only work in files that are processed by esbuild with this plugin. Not a general preprocessor.
Upgrade
Version history

Breaking-change detection hasn't run for this library yet.

Audit
Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity
11 hits · last 30 days
claudebot
4
gptbot
3
ahrefsbot
3
bingbot
1
Resources
githubhttps://github.com/AndrewPerson/Conditional-Build ↗
packagehttps://www.npmjs.com/package/esbuild-plugin-conditional-build ↗