426 lines
16 KiB
Go
426 lines
16 KiB
Go
// This is esbuild's runtime code. It contains helper functions that are
|
|
// automatically injected into output files to implement certain features. For
|
|
// example, the "**" operator is replaced with a call to "__pow" when targeting
|
|
// ES2015. Tree shaking automatically removes unused code from the runtime.
|
|
|
|
package runtime
|
|
|
|
import (
|
|
"github.com/evanw/esbuild/internal/compat"
|
|
"github.com/evanw/esbuild/internal/logger"
|
|
)
|
|
|
|
// The runtime source is always at a special index. The index is always zero
|
|
// but this constant is always used instead to improve readability and ensure
|
|
// all code that references this index can be discovered easily.
|
|
const SourceIndex = uint32(0)
|
|
|
|
func CanUseES6(unsupportedFeatures compat.JSFeature) bool {
|
|
return !unsupportedFeatures.Has(compat.Let) && !unsupportedFeatures.Has(compat.ForOf)
|
|
}
|
|
|
|
func code(isES6 bool) string {
|
|
// Note: These helper functions used to be named similar things to the helper
|
|
// functions from the TypeScript compiler. However, people sometimes use these
|
|
// two projects in combination and TypeScript's implementation of these helpers
|
|
// causes name collisions. Some examples:
|
|
//
|
|
// * The "tslib" library will overwrite esbuild's helper functions if the bundled
|
|
// code is run in the global scope: https://github.com/evanw/esbuild/issues/1102
|
|
//
|
|
// * Running the TypeScript compiler on esbuild's output to convert ES6 to ES5
|
|
// will also overwrite esbuild's helper functions because TypeScript doesn't
|
|
// change the names of its helper functions to avoid name collisions:
|
|
// https://github.com/microsoft/TypeScript/issues/43296
|
|
//
|
|
// These can both be considered bugs in TypeScript. However, they are unlikely
|
|
// to be fixed and it's simplest to just avoid using the same names to avoid
|
|
// these bugs. Forbidden names (from "tslib"):
|
|
//
|
|
// __assign
|
|
// __asyncDelegator
|
|
// __asyncGenerator
|
|
// __asyncValues
|
|
// __await
|
|
// __awaiter
|
|
// __classPrivateFieldGet
|
|
// __classPrivateFieldSet
|
|
// __createBinding
|
|
// __decorate
|
|
// __exportStar
|
|
// __extends
|
|
// __generator
|
|
// __importDefault
|
|
// __importStar
|
|
// __makeTemplateObject
|
|
// __metadata
|
|
// __param
|
|
// __read
|
|
// __rest
|
|
// __spread
|
|
// __spreadArray
|
|
// __spreadArrays
|
|
// __values
|
|
//
|
|
// Note: The "__objRest" function has a for-of loop which requires ES6, but
|
|
// transforming destructuring to ES5 isn't even supported so it's ok.
|
|
text := `
|
|
var __create = Object.create
|
|
var __freeze = Object.freeze
|
|
var __defProp = Object.defineProperty
|
|
var __defProps = Object.defineProperties
|
|
var __getOwnPropDesc = Object.getOwnPropertyDescriptor // Note: can return "undefined" due to a Safari bug
|
|
var __getOwnPropDescs = Object.getOwnPropertyDescriptors
|
|
var __getOwnPropNames = Object.getOwnPropertyNames
|
|
var __getOwnPropSymbols = Object.getOwnPropertySymbols
|
|
var __getProtoOf = Object.getPrototypeOf
|
|
var __hasOwnProp = Object.prototype.hasOwnProperty
|
|
var __propIsEnum = Object.prototype.propertyIsEnumerable
|
|
var __reflectGet = Reflect.get
|
|
var __reflectSet = Reflect.set
|
|
|
|
export var __pow = Math.pow
|
|
|
|
var __defNormalProp = (obj, key, value) => key in obj
|
|
? __defProp(obj, key, {enumerable: true, configurable: true, writable: true, value})
|
|
: obj[key] = value
|
|
|
|
export var __spreadValues = (a, b) => {
|
|
for (var prop in b ||= {})
|
|
if (__hasOwnProp.call(b, prop))
|
|
__defNormalProp(a, prop, b[prop])
|
|
if (__getOwnPropSymbols)
|
|
`
|
|
|
|
// Avoid "of" when not using ES6
|
|
if isES6 {
|
|
text += `
|
|
for (var prop of __getOwnPropSymbols(b)) {
|
|
`
|
|
} else {
|
|
text += `
|
|
for (var props = __getOwnPropSymbols(b), i = 0, n = props.length, prop; i < n; i++) {
|
|
prop = props[i]
|
|
`
|
|
}
|
|
|
|
text += `
|
|
if (__propIsEnum.call(b, prop))
|
|
__defNormalProp(a, prop, b[prop])
|
|
}
|
|
return a
|
|
}
|
|
export var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b))
|
|
|
|
// Tells importing modules that this can be considered an ES module
|
|
var __markAsModule = target => __defProp(target, '__esModule', { value: true })
|
|
|
|
// Update the "name" property on the function or class for "--keep-names"
|
|
export var __name = (target, value) => __defProp(target, 'name', { value, configurable: true })
|
|
|
|
// This fallback "require" function exists so that "typeof require" can
|
|
// naturally be "function" even in non-CommonJS environments since esbuild
|
|
// emulates a CommonJS environment (issue #1202). However, people want this
|
|
// shim to fall back to "globalThis.require" even if it's defined later
|
|
// (including property accesses such as "require.resolve") so we need to
|
|
// use a proxy (issue #1614).
|
|
export var __require =
|
|
/* @__PURE__ */ (x =>
|
|
typeof require !== 'undefined' ? require :
|
|
typeof Proxy !== 'undefined' ? new Proxy(x, {
|
|
get: (a, b) => (typeof require !== 'undefined' ? require : a)[b]
|
|
}) : x
|
|
)(function(x) {
|
|
if (typeof require !== 'undefined') return require.apply(this, arguments)
|
|
throw new Error('Dynamic require of "' + x + '" is not supported')
|
|
})
|
|
|
|
// For object rest patterns
|
|
export var __restKey = key => typeof key === 'symbol' ? key : key + ''
|
|
export var __objRest = (source, exclude) => {
|
|
var target = {}
|
|
for (var prop in source)
|
|
if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
|
|
target[prop] = source[prop]
|
|
if (source != null && __getOwnPropSymbols)
|
|
`
|
|
|
|
// Avoid "of" when not using ES6
|
|
if isES6 {
|
|
text += `
|
|
for (var prop of __getOwnPropSymbols(source)) {
|
|
`
|
|
} else {
|
|
text += `
|
|
for (var props = __getOwnPropSymbols(source), i = 0, n = props.length, prop; i < n; i++) {
|
|
prop = props[i]
|
|
`
|
|
}
|
|
|
|
text += `
|
|
if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
|
|
target[prop] = source[prop]
|
|
}
|
|
return target
|
|
}
|
|
|
|
// This is for lazily-initialized ESM code. This has two implementations, a
|
|
// compact one for minified code and a verbose one that generates friendly
|
|
// names in V8's profiler and in stack traces.
|
|
export var __esm = (fn, res) => function __init() {
|
|
return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res
|
|
}
|
|
export var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res)
|
|
|
|
// Wraps a CommonJS closure and returns a require() function. This has two
|
|
// implementations, a compact one for minified code and a verbose one that
|
|
// generates friendly names in V8's profiler and in stack traces.
|
|
export var __commonJS = (cb, mod) => function __require() {
|
|
return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = {exports: {}}).exports, mod), mod.exports
|
|
}
|
|
export var __commonJSMin = (cb, mod) => () => (mod || cb((mod = {exports: {}}).exports, mod), mod.exports)
|
|
|
|
// Used to implement ESM exports both for "require()" and "import * as"
|
|
export var __export = (target, all) => {
|
|
for (var name in all)
|
|
__defProp(target, name, { get: all[name], enumerable: true })
|
|
}
|
|
export var __reExport = (target, module, copyDefault, desc) => {
|
|
if (module && typeof module === 'object' || typeof module === 'function')
|
|
`
|
|
|
|
// Avoid "let" when not using ES6
|
|
if isES6 {
|
|
text += `
|
|
for (let key of __getOwnPropNames(module))
|
|
if (!__hasOwnProp.call(target, key) && (copyDefault || key !== 'default'))
|
|
__defProp(target, key, { get: () => module[key], enumerable: !(desc = __getOwnPropDesc(module, key)) || desc.enumerable })
|
|
`
|
|
} else {
|
|
text += `
|
|
for (var keys = __getOwnPropNames(module), i = 0, n = keys.length, key; i < n; i++) {
|
|
key = keys[i]
|
|
if (!__hasOwnProp.call(target, key) && (copyDefault || key !== 'default'))
|
|
__defProp(target, key, { get: (k => module[k]).bind(null, key), enumerable: !(desc = __getOwnPropDesc(module, key)) || desc.enumerable })
|
|
}
|
|
`
|
|
}
|
|
|
|
text += `
|
|
return target
|
|
}
|
|
|
|
// Converts the module from CommonJS to ESM
|
|
export var __toESM = (module, isNodeMode) => {
|
|
return __reExport(__markAsModule(
|
|
__defProp(
|
|
module != null ? __create(__getProtoOf(module)) : {},
|
|
'default',
|
|
|
|
// If the importer is not in node compatibility mode and this is an ESM
|
|
// file that has been converted to a CommonJS file using a Babel-
|
|
// compatible transform (i.e. "__esModule" has been set), then forward
|
|
// "default" to the export named "default". Otherwise set "default" to
|
|
// "module.exports" for node compatibility.
|
|
!isNodeMode && module && module.__esModule
|
|
? { get: () => module.default, enumerable: true }
|
|
: { value: module, enumerable: true })
|
|
), module)
|
|
}
|
|
|
|
// Converts the module from ESM to CommonJS
|
|
export var __toCommonJS = /* @__PURE__ */ (cache => {
|
|
return (module, temp) => {
|
|
return (cache && cache.get(module)) || (
|
|
temp = __reExport(__markAsModule({}), module, /* copyDefault */ 1),
|
|
cache && cache.set(module, temp),
|
|
temp)
|
|
}
|
|
})(typeof WeakMap !== 'undefined' ? new WeakMap : 0)
|
|
|
|
// For TypeScript decorators
|
|
// - kind === undefined: class
|
|
// - kind === 1: method, parameter
|
|
// - kind === 2: field
|
|
export var __decorateClass = (decorators, target, key, kind) => {
|
|
var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target
|
|
for (var i = decorators.length - 1, decorator; i >= 0; i--)
|
|
if (decorator = decorators[i])
|
|
result = (kind ? decorator(target, key, result) : decorator(result)) || result
|
|
if (kind && result)
|
|
__defProp(target, key, result)
|
|
return result
|
|
}
|
|
export var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index)
|
|
|
|
// For class members
|
|
export var __publicField = (obj, key, value) => {
|
|
__defNormalProp(obj, typeof key !== 'symbol' ? key + '' : key, value)
|
|
return value
|
|
}
|
|
var __accessCheck = (obj, member, msg) => {
|
|
if (!member.has(obj)) throw TypeError('Cannot ' + msg)
|
|
}
|
|
export var __privateIn = (member, obj) => {
|
|
if (Object(obj) !== obj) throw TypeError('Cannot use the "in" operator on this value')
|
|
return member.has(obj)
|
|
}
|
|
export var __privateGet = (obj, member, getter) => {
|
|
__accessCheck(obj, member, 'read from private field')
|
|
return getter ? getter.call(obj) : member.get(obj)
|
|
}
|
|
export var __privateAdd = (obj, member, value) => {
|
|
if (member.has(obj)) throw TypeError('Cannot add the same private member more than once')
|
|
member instanceof WeakSet ? member.add(obj) : member.set(obj, value)
|
|
}
|
|
export var __privateSet = (obj, member, value, setter) => {
|
|
__accessCheck(obj, member, 'write to private field')
|
|
setter ? setter.call(obj, value) : member.set(obj, value)
|
|
return value
|
|
}
|
|
export var __privateWrapper = (obj, member, setter, getter) => {
|
|
return {
|
|
set _(value) { __privateSet(obj, member, value, setter) },
|
|
get _() { return __privateGet(obj, member, getter) },
|
|
}
|
|
}
|
|
export var __privateMethod = (obj, member, method) => {
|
|
__accessCheck(obj, member, 'access private method')
|
|
return method
|
|
}
|
|
|
|
// For "super" property accesses
|
|
export var __superStaticGet = (obj, member) => __reflectGet(__getProtoOf(obj), member, obj)
|
|
export var __superStaticSet = (obj, member, value) => (__reflectSet(__getProtoOf(obj), member, value, obj), value)
|
|
export var __superWrapper = (getter, setter, member) => {
|
|
return {
|
|
set _(value) { setter(member, value) },
|
|
get _() { return getter(member) },
|
|
}
|
|
}
|
|
export var __superStaticWrapper = (obj, member) => {
|
|
return {
|
|
set _(value) { __superStaticSet(obj, member, value) },
|
|
get _() { return __superStaticGet(obj, member) },
|
|
}
|
|
}
|
|
|
|
// For lowering tagged template literals
|
|
export var __template = (cooked, raw) => __freeze(__defProp(cooked, 'raw', { value: __freeze(raw || cooked.slice()) }))
|
|
|
|
// This helps for lowering async functions
|
|
export var __async = (__this, __arguments, generator) => {
|
|
return new Promise((resolve, reject) => {
|
|
var fulfilled = value => {
|
|
try {
|
|
step(generator.next(value))
|
|
} catch (e) {
|
|
reject(e)
|
|
}
|
|
}
|
|
var rejected = value => {
|
|
try {
|
|
step(generator.throw(value))
|
|
} catch (e) {
|
|
reject(e)
|
|
}
|
|
}
|
|
var step = x => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected)
|
|
step((generator = generator.apply(__this, __arguments)).next())
|
|
})
|
|
}
|
|
|
|
// This is for the "binary" loader (custom code is ~2x faster than "atob")
|
|
export var __toBinaryNode = base64 => new Uint8Array(Buffer.from(base64, 'base64'))
|
|
export var __toBinary = /* @__PURE__ */ (() => {
|
|
var table = new Uint8Array(128)
|
|
for (var i = 0; i < 64; i++) table[i < 26 ? i + 65 : i < 52 ? i + 71 : i < 62 ? i - 4 : i * 4 - 205] = i
|
|
return base64 => {
|
|
var n = base64.length, bytes = new Uint8Array((n - (base64[n - 1] == '=') - (base64[n - 2] == '=')) * 3 / 4 | 0)
|
|
for (var i = 0, j = 0; i < n;) {
|
|
var c0 = table[base64.charCodeAt(i++)], c1 = table[base64.charCodeAt(i++)]
|
|
var c2 = table[base64.charCodeAt(i++)], c3 = table[base64.charCodeAt(i++)]
|
|
bytes[j++] = (c0 << 2) | (c1 >> 4)
|
|
bytes[j++] = (c1 << 4) | (c2 >> 2)
|
|
bytes[j++] = (c2 << 6) | c3
|
|
}
|
|
return bytes
|
|
}
|
|
})()
|
|
`
|
|
|
|
return text
|
|
}
|
|
|
|
var ES6Source = logger.Source{
|
|
Index: SourceIndex,
|
|
KeyPath: logger.Path{Text: "<runtime>"},
|
|
PrettyPath: "<runtime>",
|
|
IdentifierName: "runtime",
|
|
Contents: code(true /* isES6 */),
|
|
}
|
|
|
|
var ES5Source = logger.Source{
|
|
Index: SourceIndex,
|
|
KeyPath: logger.Path{Text: "<runtime>"},
|
|
PrettyPath: "<runtime>",
|
|
IdentifierName: "runtime",
|
|
Contents: code(false /* isES6 */),
|
|
}
|
|
|
|
// The TypeScript decorator transform behaves similar to the official
|
|
// TypeScript compiler.
|
|
//
|
|
// One difference is that the "__decorateClass" function doesn't contain a reference
|
|
// to the non-existent "Reflect.decorate" function. This function was never
|
|
// standardized and checking for it is wasted code (as well as a potentially
|
|
// dangerous cause of unintentional behavior changes in the future).
|
|
//
|
|
// Another difference is that the "__decorateClass" function doesn't take in an
|
|
// optional property descriptor like it does in the official TypeScript
|
|
// compiler's support code. This appears to be a dead code path in the official
|
|
// support code that is only there for legacy reasons.
|
|
//
|
|
// Here are some examples of how esbuild's decorator transform works:
|
|
//
|
|
// ============================= Class decorator ==============================
|
|
//
|
|
// // TypeScript // JavaScript
|
|
// @dec let C = class {
|
|
// class C { };
|
|
// } C = __decorateClass([
|
|
// dec
|
|
// ], C);
|
|
//
|
|
// ============================ Method decorator ==============================
|
|
//
|
|
// // TypeScript // JavaScript
|
|
// class C { class C {
|
|
// @dec foo() {}
|
|
// foo() {} }
|
|
// } __decorateClass([
|
|
// dec
|
|
// ], C.prototype, 'foo', 1);
|
|
//
|
|
// =========================== Parameter decorator ============================
|
|
//
|
|
// // TypeScript // JavaScript
|
|
// class C { class C {
|
|
// foo(@dec bar) {} foo(bar) {}
|
|
// } }
|
|
// __decorateClass([
|
|
// __decorateParam(0, dec)
|
|
// ], C.prototype, 'foo', 1);
|
|
//
|
|
// ============================= Field decorator ==============================
|
|
//
|
|
// // TypeScript // JavaScript
|
|
// class C { class C {
|
|
// @dec constructor() {
|
|
// foo = 123 this.foo = 123
|
|
// } }
|
|
// }
|
|
// __decorateClass([
|
|
// dec
|
|
// ], C.prototype, 'foo', 2);
|