@build-script/heft-esbuild-plugin NPM

esbuild task - 运行esbuild

从heft调用esbuild
支持rig

TODO

监视模式未实现

Usage

向 heft.json 添加:

	"esbuild": {
		// "taskDependencies": ["typescript"], // 当前需要设置这个才能在监视模式下工作（否则只能运行第一次）
		"taskPlugin": {
			"pluginPackage": "@build-script/heft-esbuild-plugin",
			"options": {
				"any": "thing"
			}
		}
	},

创建文件: config/esbuild.{ts,mts,cts,mjs,cjs,json} 不能用.js后缀

编写配置文件，并导出options，可以是数组，同时运行多个esbuild:

/// <reference types='@build-script/heft-esbuild-plugin' />
import type { BuildOptions, Plugin } from 'esbuild';

console.assert(options.any === 'thing', 'what the f*ck?');

export const options: BuildOptions[] = [
	{
		entryPoints: [{ in: './src/renderer.ts', out: 'renderer' }],
		platform: 'browser',
		outdir: './lib',
		external: ['electron'],
		plugins: [nodeSassPlugin()],
	},
	{
		entryPoints: [
			{ in: './src/preload.ts', out: 'preload' },
			{ in: './src/main.ts', out: 'main' },
		],
		platform: 'node',
		outdir: './lib',
		define: { 'process.env.NODE_ENV': 'production' },
		external: ['electron'],
	},
];

session api

esbuild脚本中可以访问全局变量session

IGlobalSession
session.options 就是从 heft.json 设置中传递的 options 字段

注意：此全局变量会在脚本加载后删除，如果需要使用，必须赋值到本地变量。

例如:

const session = globalThis.session; // save local copy for use

function after() {
	console.log(session.rootDir);
}

不可以这样:

function after() {
	console.log(session.rootDir); // Oops! session is gone
}

文件写入钩子

IOutputModifier

import type { OutputFile } from '@build-script/heft-esbuild-plugin';
import type { BuildOptions } from 'esbuild';
interface T {
	field: number;
}
export function onEmit(files: OutputFile[], options: BuildOptions, state: T): T {
	files[0].text = "/** note: don't use this file */\n" + files[0].text;
	files.push({ path: '/absolute/path.js', text: 'virtual file' });

	return state;
}