{"id":15433,"library":"esbuild-windows-arm64","title":"esbuild Windows ARM64 Binary","description":"esbuild-windows-arm64 provides the native binary for esbuild on Windows ARM 64-bit architectures. esbuild is a powerful and extremely fast JavaScript bundler and minifier, written in Go. It significantly speeds up development workflows by processing JavaScript (ESNext, JSX), TypeScript (TSX), CSS, JSON, and other asset types with high efficiency. Key features include tree-shaking, code splitting, source map generation, and the ability to target various JavaScript language versions and environments (e.g., browser, node). The esbuild project itself is in rapid, active development, with frequent releases (often multiple per month) introducing new features, optimizations, and bug fixes. While this specific package (esbuild-windows-arm64) is a platform-specific binary dependency, the main esbuild package is currently stable around version 0.28.x and is a highly recommended tool for optimizing build times in modern web development.","status":"active","version":"0.15.18","language":"javascript","source_language":"en","source_url":"https://github.com/evanw/esbuild","tags":["javascript"],"install":[{"cmd":"npm install esbuild-windows-arm64","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-windows-arm64","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-windows-arm64","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The primary function for programmatic bundling. ESM is preferred for modern Node.js applications.","wrong":"const build = require('esbuild').build;","symbol":"build","correct":"import { build } from 'esbuild'"},{"note":"Used for transforming a single string of code without bundling, useful for testing or specific code manipulation.","wrong":"const { transform } = require('esbuild');","symbol":"transform","correct":"import { transform } from 'esbuild'"},{"note":"esbuild does not export a default, so a namespace import or named imports are required for ESM. CommonJS uses `require('esbuild')` directly.","wrong":"import esbuild from 'esbuild';","symbol":"* as esbuild","correct":"import * as esbuild from 'esbuild'"}],"quickstart":{"code":"import { build } from 'esbuild';\nimport path from 'path';\n\nconst entryPoint = 'src/index.ts';\nconst outputDirectory = 'dist';\nconst outFile = path.join(outputDirectory, 'bundle.js');\n\nasync function buildProject() {\n  try {\n    await build({\n      entryPoints: [entryPoint],\n      bundle: true,\n      outdir: outputDirectory,\n      outfile: outFile,\n      platform: 'node', // or 'browser'\n      target: 'es2020', // Specify target JavaScript version\n      minify: true, // Enable minification\n      sourcemap: true, // Generate source maps\n      define: { // Define global constants\n        'process.env.NODE_ENV': JSON.stringify('production'),\n        'process.env.MY_API_KEY': JSON.stringify(process.env.MY_API_KEY ?? ''),\n      },\n      logLevel: 'info',\n      external: ['node-fetch'], // Example of an external dependency not to bundle\n      plugins: [\n        {\n          name: 'log-build',\n          setup(build) {\n            build.onStart(() => console.log('Starting esbuild build...'));\n            build.onEnd(() => console.log('esbuild build finished successfully!'));\n          },\n        },\n      ],\n    });\n    console.log(`Build successful: ${outFile}`);\n  } catch (error) {\n    console.error('esbuild build failed:', error);\n    process.exit(1);\n  }\n}\n\nbuildProject();","lang":"typescript","description":"Demonstrates a basic esbuild setup for bundling a TypeScript project, including minification, source maps, environment variable definition, and a simple plugin."},"warnings":[{"fix":"Pin the exact version of `esbuild` in `package.json` (e.g., `\"esbuild\": \"0.27.0\"`) or use a patch-only version range (`\"esbuild\": \"~0.27.0\"`) to prevent automatic minor/major updates. Always review the changelog before upgrading.","message":"Version 0.27.0 of esbuild introduced deliberate backwards-incompatible changes. Unintended upgrades across minor or major versions can break builds.","severity":"breaking","affected_versions":">=0.27.0"},{"fix":"Always install the main `esbuild` package (`npm install esbuild`). It will automatically pull in the correct platform-specific binary for your environment. Avoid direct installation or version pinning of specific binary packages like this one unless you have a very specific advanced use case.","message":"`esbuild-windows-arm64` is a platform-specific binary dependency, not the main `esbuild` package. Directly managing its version can lead to mismatches with the core `esbuild` API and unexpected build issues.","severity":"gotcha","affected_versions":">=0.15.18"},{"fix":"Upgrade your `esbuild` dependency to version `0.27.7` or newer to ensure correct lowering of TypeScript parameter properties based on the configured target environment.","message":"Before version 0.27.7, esbuild incorrectly generated class fields for TypeScript parameter properties when targeting environments that do not support class fields, potentially leading to runtime errors.","severity":"breaking","affected_versions":"<0.27.7"},{"fix":"If you are encountering issues with CSS media queries, upgrade `esbuild` to version `0.27.4` or later to benefit from the fixes related to media query handling.","message":"Versions of esbuild prior to 0.27.4 contained regressions in parsing and printing specific CSS media query syntaxes (e.g., `<media-type> and <media-condition-without-or>`), which could result in incorrect or invalid CSS output.","severity":"gotcha","affected_versions":"<0.27.4"},{"fix":"Upgrade to `esbuild >=0.27.1` to resolve the bundling issue related to `var` hoisting in specific CommonJS/ESM interop scenarios.","message":"A bundler bug existed in versions before 0.27.1 affecting ES modules imported via `require` with top-level `var` declarations inside `if` statements, potentially causing incorrect variable scoping or runtime behavior.","severity":"gotcha","affected_versions":"<0.27.1"}],"env_vars":null,"last_verified":"2026-04-21T00:00:00.000Z","next_check":"2026-07-20T00:00:00.000Z","problems":[{"fix":"Run `npm rebuild esbuild` or `npm install --force esbuild` to re-download and re-install the native binary. Verify your Node.js version meets esbuild's requirements and your system architecture is supported.","cause":"The esbuild package could not find or correctly load the native binary for the detected operating system and architecture, or the binary is corrupted/missing.","error":"Error: The esbuild binary for your current system is not available"},{"fix":"Ensure 'esbuild' is listed in your `package.json` and run `npm install` (or `yarn add esbuild`). If it still fails, try clearing your npm cache with `npm cache clean --force` and then reinstalling.","cause":"The 'esbuild' package is not installed or not resolvable from the current working directory, or `node_modules` is corrupted.","error":"Error: Cannot find module 'esbuild'"},{"fix":"If esbuild is installed locally, use `npx esbuild [args]` to run it. For global access, install it globally via `npm install -g esbuild` and ensure your system's PATH includes the npm global bin directory.","cause":"The esbuild Command Line Interface (CLI) executable is not in your system's PATH, or esbuild was installed locally and you are trying to run it globally without `npx`.","error":"esbuild: command not found"},{"fix":"Configure the `target` option in your `esbuild` build process to a newer `ECMAScript` version (e.g., `target: 'esnext'` or `target: ['es2020', 'chrome80']`) to enable support for modern language features.","cause":"esbuild's default target `ECMAScript` version is too old for the syntax used in your source code, or specific experimental features require explicit configuration.","error":"Syntax error with modern JavaScript/TypeScript features (e.g., 'Class private fields are not supported in esbuild by default')"}],"ecosystem":"npm"}