const std = @import("std");
const logger = @import("root").bun.logger;
const JSXRuntime = @import("options.zig").JSX.Runtime;
const Runtime = @import("runtime.zig").Runtime;
const bun = @import("root").bun;
const string = bun.string;
const Output = bun.Output;
const Global = bun.Global;
const Environment = bun.Environment;
const strings = bun.strings;
const MutableString = bun.MutableString;
const stringZ = bun.stringZ;
const default_allocator = bun.default_allocator;
const C = bun.C;
const Ref = @import("ast/base.zig").Ref;
const Index = @import("ast/base.zig").Index;
const RefHashCtx = @import("ast/base.zig").RefHashCtx;
const ObjectPool = @import("./pool.zig").ObjectPool;
const ImportRecord = @import("import_record.zig").ImportRecord;
const allocators = @import("allocators.zig");
const JSC = @import("root").bun.JSC;
const HTTP = @import("root").bun.HTTP;
const RefCtx = @import("./ast/base.zig").RefCtx;
const JSONParser = bun.JSON;
const is_bindgen = std.meta.globalOption("bindgen", bool) orelse false;
const ComptimeStringMap = bun.ComptimeStringMap;
const JSPrinter = @import("./js_printer.zig");
const js_lexer = @import("./js_lexer.zig");
const TypeScript = @import("./js_parser.zig").TypeScript;
const ThreadlocalArena = @import("./mimalloc_arena.zig").Arena;
/// This is the index to the automatically-generated part containing code that
/// calls "__export(exports, { ... getters ... })". This is used to generate
/// getters on an exports object for ES6 export statements, and is both for
/// ES6 star imports and CommonJS-style modules. All files have one of these,
/// although it may contain no statements if there is nothing to export.
pub const namespace_export_part_index = 0;
pub fn NewBaseStore(comptime Union: anytype, comptime count: usize) type {
var max_size = 0;
var max_align = 1;
for (Union) |kind| {
max_size = @max(@sizeOf(kind), max_size);
max_align = if (@sizeOf(kind) == 0) max_align else @max(@alignOf(kind), max_align);
}
const UnionValueType = [max_size]u8;
const SizeType = std.math.IntFittingRange(0, (count + 1));
const MaxAlign = max_align;
return struct {
const Allocator = std.mem.Allocator;
const Self = @This();
pub const WithBase = struct {
head: Block = Block{},
store: Self,
};
pub const Block = struct {
used: SizeType = 0,
items: [count]UnionValueType align(MaxAlign) = undefined,
pub inline fn isFull(block: *const Block) bool {
return block.used >= @as(SizeType, count);
}
pub fn append(block: *Block, comptime ValueType: type, value: ValueType) *UnionValueType {
if (comptime Environment.allow_assert) std.debug.assert(block.used < count);
const index = block.used;
block.items[index][0..value.len].* = value.*;
block.used +|= 1;
return &block.items[index];
}
};
const Overflow = struct {
const max = 4096 * 3;
const UsedSize = std.math.IntFittingRange(0, max + 1);
used: UsedSize = 0,
allocated: UsedSize = 0,
allocator: Allocator = default_allocator,
ptrs: [max]*Block = undefined,
pub fn tail(this: *Overflow) *Block {
if (this.ptrs[this.used].isFull()) {
this.used +%= 1;
if (this.allocated > this.used) {
this.ptrs[this.used].used = 0;
}
}
if (this.allocated <= this.used) {
var new_ptrs = this.allocator.alloc(Block, 2) catch unreachable;
new_ptrs[0] = Block{};
new_ptrs[1] = Block{};
this.ptrs[this.allocated] = &new_ptrs[0];
this.ptrs[this.allocated + 1] = &new_ptrs[1];
this.allocated +%= 2;
}
return this.ptrs[this.used];
}
pub inline fn slice(this: *Overflow) []*Block {
return this.ptrs[0..this.used];
}
};
overflow: Overflow = Overflow{},
pub threadlocal var _self: *Self = undefined;
pub fn reclaim() []*Block {
var overflow = &_self.overflow;
if (overflow.used == 0) {
if (overflow.allocated == 0 or overflow.ptrs[0].used == 0) {
return &.{};
}
}
var to_move = overflow.ptrs[0..overflow.allocated][overflow.used..];
// This returns the list of maxed out blocks
var used_list = overflow.slice();
// The last block may be partially used.
if (overflow.allocated > overflow.used and to_move.len > 0 and to_move.ptr[0].used > 0) {
to_move = to_move[1..];
used_list.len += 1;
}
var used = overflow.allocator.dupe(*Block, used_list) catch unreachable;
for (to_move, overflow.ptrs[0..to_move.len]) |b, *out| {
b.* = Block{
.items = undefined,
.used = 0,
};
out.* = b;
}
overflow.allocated = @as(Overflow.UsedSize, @truncate(to_move.len));
overflow.used = 0;
return used;
}
/// Reset all AST nodes, allowing the memory to be reused for the next parse.
/// Only call this when we're done with ALL AST nodes, or you risk
/// undefined memory bugs.
///
/// Nested parsing should either use the same store, or call
/// Store.reclaim.
pub fn reset() void {
const blocks = _self.overflow.slice();
for (blocks) |b| {
if (comptime Environment.isDebug) {
// ensure we crash if we use a freed value
var bytes = std.mem.asBytes(&b.items);
@memset(bytes, undefined);
}
b.used = 0;
}
_self.overflow.used = 0;
}
pub fn init(allocator: std.mem.Allocator) *Self {
var base = allocator.create(WithBase) catch unreachable;
base.* = WithBase{ .store = .{ .overflow = Overflow{ .allocator = allocator } } };
var instance = &base.store;
instance.overflow.ptrs[0] = &base.head;
instance.overflow.allocated = 1;
_self = instance;
return _self;
}
fn deinit() void {
var sliced = _self.overflow.slice();
var allocator = _self.overflow.allocator;
if (sliced.len > 1) {
var i: usize = 1;
const end = sliced.len;
while (i < end) {
var ptrs = @as(*[2]Block, @ptrCast(sliced[i]));
allocator.free(ptrs);
i += 2;
}
_self.overflow.allocated = 1;
}
var base_store = @fieldParentPtr(WithBase, "store", _self);
if (_self.overflow.ptrs[0] == &base_store.head) {
allocator.destroy(base_store);
}
_self = undefined;
}
pub fn append(comptime Disabler: type, comptime ValueType: type, value: ValueType) *ValueType {
Disabler.assert();
return _self._append(ValueType, value);
}
inline fn _append(self: *Self, comptime ValueType: type, value: ValueType) *ValueType {
const bytes = std.mem.asBytes(&value);
const BytesAsSlice = @TypeOf(bytes);
var block = self.overflow.tail();
return @as(
*ValueType,
@ptrCast(@alignCast(block.append(BytesAsSlice, bytes))),
);
}
};
}
// There are three types.
// 1. Expr (expression)
// 2. Stmt (statement)
// 3. Binding
// Q: "What's the difference between an expression and a statement?"
// A: > Expression: Something which evaluates to a value. Example: 1+2/x
// > Statement: A line of code which does something. Example: GOTO 100
// > https://stackoverflow.com/questions/19132/expression-versus-statement/19224#19224
// Expr, Binding, and Stmt each wrap a Data:
// Data is where the actual data where the node lives.
// There are four possible versions of this structure:
// [ ] 1. *Expr, *Stmt, *Binding
// [ ] 1a. *Expr, *Stmt, *Binding something something dynamic dispatch
// [ ] 2. *Data
// [x] 3. Data.(*) (The union value in Data is a pointer)
// I chose #3 mostly for code simplification -- sometimes, the data is modified in-place.
// But also it uses the least memory.
// Since Data is a union, the size in bytes of Data is the max of all types
// So with #1 or #2, if S.Function consumes 768 bits, that means Data must be >= 768 bits
// Which means "true" in code now takes up over 768 bits, probably more than what v8 spends
// Instead, this approach means Data is the size of a pointer.
// It's not really clear which approach is best without benchmarking it.
// The downside with this approach is potentially worse memory locality, since the data for the node is somewhere else.
// But it could also be better memory locality due to smaller in-memory size (more likely to hit the cache)
// only benchmarks will provide an answer!
// But we must have pointers somewhere in here because can't have types that contain themselves
pub const BindingNodeIndex = Binding;
pub const StmtNodeIndex = Stmt;
pub const ExprNodeIndex = Expr;
pub const BabyList = bun.BabyList;
/// Slice that stores capacity and length in the same space as a regular slice.
pub const ExprNodeList = BabyList(Expr);
pub const StmtNodeList = []Stmt;
pub const BindingNodeList = []Binding;
pub const ImportItemStatus = enum(u2) {
none,
// The linker doesn't report import/export mismatch errors
generated,
// The printer will replace this import with "undefined"
missing,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
};
pub const AssignTarget = enum(u2) {
none = 0,
replace = 1, // "a = b"
update = 2, // "a += b"
pub fn jsonStringify(self: *const @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
};
pub const LocRef = struct {
loc: logger.Loc = logger.Loc.Empty,
// TODO: remove this optional and make Ref a function getter
// That will make this struct 128 bits instead of 192 bits and we can remove some heap allocations
ref: ?Ref = null,
};
pub const Flags = struct {
pub const JSXElement = enum {
is_key_before_rest,
has_any_dynamic,
can_be_inlined,
can_be_hoisted,
pub const Bitset = std.enums.EnumSet(JSXElement);
};
pub const Property = enum {
is_computed,
is_method,
is_static,
was_shorthand,
is_spread,
pub inline fn init(fields: Fields) Set {
return Set.init(fields);
}
pub const None = Set{};
pub const Fields = std.enums.EnumFieldStruct(Flags.Property, bool, false);
pub const Set = std.enums.EnumSet(Flags.Property);
};
pub const Function = enum {
is_async,
is_generator,
has_rest_arg,
has_if_scope,
is_forward_declaration,
/// This is true if the function is a method
is_unique_formal_parameters,
/// Only applicable to function statements.
is_export,
/// Used for Hot Module Reloading's wrapper function
/// "iife" stands for "immediately invoked function expression"
print_as_iife,
pub inline fn init(fields: Fields) Set {
return Set.init(fields);
}
pub const None = Set{};
pub const Fields = std.enums.EnumFieldStruct(Function, bool, false);
pub const Set = std.enums.EnumSet(Function);
};
};
pub const Binding = struct {
loc: logger.Loc,
data: B,
const Serializable = struct {
type: Tag,
object: string,
value: B,
loc: logger.Loc,
};
pub fn jsonStringify(self: *const @This(), writer: anytype) !void {
return try writer.write(Serializable{ .type = std.meta.activeTag(self.data), .object = "binding", .value = self.data, .loc = self.loc });
}
pub fn ToExpr(comptime expr_type: type, comptime func_type: anytype) type {
const ExprType = expr_type;
return struct {
context: *ExprType,
allocator: std.mem.Allocator,
pub const Context = @This();
pub fn wrapIdentifier(ctx: *const Context, loc: logger.Loc, ref: Ref) Expr {
return func_type(ctx.context, loc, ref);
}
pub fn init(context: *ExprType) Context {
return Context{ .context = context, .allocator = context.allocator };
}
};
}
pub fn toExpr(binding: *const Binding, wrapper: anytype) Expr {
const loc = binding.loc;
switch (binding.data) {
.b_missing => {
return Expr{ .data = .{ .e_missing = E.Missing{} }, .loc = loc };
},
.b_identifier => |b| {
return wrapper.wrapIdentifier(loc, b.ref);
},
.b_array => |b| {
var exprs = wrapper.allocator.alloc(Expr, b.items.len) catch unreachable;
var i: usize = 0;
while (i < exprs.len) : (i += 1) {
const item = b.items[i];
exprs[i] = convert: {
const expr = toExpr(&item.binding, wrapper);
if (b.has_spread and i == exprs.len - 1) {
break :convert Expr.init(E.Spread, E.Spread{ .value = expr }, expr.loc);
} else if (item.default_value) |default| {
break :convert Expr.assign(expr, default, wrapper.allocator);
} else {
break :convert expr;
}
};
}
return Expr.init(E.Array, E.Array{ .items = ExprNodeList.init(exprs), .is_single_line = b.is_single_line }, loc);
},
.b_object => |b| {
var properties = wrapper
.allocator
.alloc(G.Property, b.properties.len) catch unreachable;
for (properties, b.properties) |*property, item| {
property.* = .{
.flags = item.flags,
.key = item.key,
.kind = if (item.flags.contains(.is_spread))
.spread
else
.normal,
.value = toExpr(&item.value, wrapper),
.initializer = item.default_value,
};
}
return Expr.init(
E.Object,
E.Object{
.properties = G.Property.List.init(properties),
.is_single_line = b.is_single_line,
},
loc,
);
},
else => {
Global.panic("Internal error", .{});
},
}
}
pub const Tag = enum(u5) {
b_identifier,
b_array,
b_property,
b_object,
b_missing,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
};
pub var icount: usize = 0;
pub fn init(t: anytype, loc: logger.Loc) Binding {
icount += 1;
switch (@TypeOf(t)) {
*B.Identifier => {
return Binding{ .loc = loc, .data = B{ .b_identifier = t } };
},
*B.Array => {
return Binding{ .loc = loc, .data = B{ .b_array = t } };
},
*B.Property => {
return Binding{ .loc = loc, .data = B{ .b_property = t } };
},
*B.Object => {
return Binding{ .loc = loc, .data = B{ .b_object = t } };
},
B.Missing => {
return Binding{ .loc = loc, .data = B{ .b_missing = t } };
},
else => {
@compileError("Invalid type passed to Binding.init");
},
}
}
pub fn alloc(allocator: std.mem.Allocator, t: anytype, loc: logger.Loc) Binding {
icount += 1;
switch (@TypeOf(t)) {
B.Identifier => {
var data = allocator.create(B.Identifier) catch unreachable;
data.* = t;
return Binding{ .loc = loc, .data = B{ .b_identifier = data } };
},
B.Array => {
var data = allocator.create(B.Array) catch unreachable;
data.* = t;
return Binding{ .loc = loc, .data = B{ .b_array = data } };
},
B.Property => {
var data = allocator.create(B.Property) catch unreachable;
data.* = t;
return Binding{ .loc = loc, .data = B{ .b_property = data } };
},
B.Object => {
var data = allocator.create(B.Object) catch unreachable;
data.* = t;
return Binding{ .loc = loc, .data = B{ .b_object = data } };
},
B.Missing => {
return Binding{ .loc = loc, .data = B{ .b_missing = .{} } };
},
else => {
@compileError("Invalid type passed to Binding.alloc");
},
}
}
};
/// B is for Binding!
/// These are the types of bindings that can be used in the AST.
pub const B = union(Binding.Tag) {
b_identifier: *B.Identifier,
b_array: *B.Array,
b_property: *B.Property,
b_object: *B.Object,
b_missing: B.Missing,
pub const Identifier = struct {
ref: Ref,
};
pub const Property = struct {
flags: Flags.Property.Set = Flags.Property.None,
key: ExprNodeIndex,
value: BindingNodeIndex,
default_value: ?ExprNodeIndex = null,
};
pub const Object = struct { properties: []Property, is_single_line: bool = false };
pub const Array = struct {
items: []ArrayBinding,
has_spread: bool = false,
is_single_line: bool = false,
};
pub const Missing = struct {};
};
pub const ClauseItem = struct {
alias: string = "",
alias_loc: logger.Loc = logger.Loc.Empty,
name: LocRef,
/// This is the original name of the symbol stored in "Name". It's needed for
/// "SExportClause" statements such as this:
///
/// export {foo as bar} from 'path'
///
/// In this case both "foo" and "bar" are aliases because it's a re-export.
/// We need to preserve both aliases in case the symbol is renamed. In this
/// example, "foo" is "OriginalName" and "bar" is "Alias".
original_name: string = "",
pub const default_alias: string = "default";
};
pub const SlotCounts = struct {
slots: Symbol.SlotNamespace.CountsArray = Symbol.SlotNamespace.CountsArray.initFill(0),
pub fn unionMax(this: *SlotCounts, other: SlotCounts) void {
for (&this.slots.values, other.slots.values) |*a, b| {
if (a.* < b) a.* = b;
}
}
};
pub const CharAndCount = struct {
char: u8 = 0,
count: i32 = 0,
index: usize = 0,
pub const Array = [64]CharAndCount;
pub fn lessThan(_: void, a: CharAndCount, b: CharAndCount) bool {
return a.count > b.count or (a.count == b.count and a.index < b.index);
}
};
pub const CharFreq = struct {
const Vector = @Vector(64, i32);
const Buffer = [64]i32;
freqs: Buffer align(1) = undefined,
const scan_big_chunk_size = 32;
pub fn scan(this: *CharFreq, text: string, delta: i32) void {
if (delta == 0)
return;
if (text.len < scan_big_chunk_size) {
scanSmall(&this.freqs, text, delta);
} else {
scanBig(&this.freqs, text, delta);
}
}
fn scanBig(out: *align(1) Buffer, text: string, delta: i32) void {
// https://zig.godbolt.org/z/P5dPojWGK
var freqs = out.*;
defer out.* = freqs;
var deltas: [255]i32 = [_]i32{0} ** 255;
var remain = text;
std.debug.assert(remain.len >= scan_big_chunk_size);
const unrolled = remain.len - (remain.len % scan_big_chunk_size);
var remain_end = remain.ptr + unrolled;
var unrolled_ptr = remain.ptr;
remain = remain[unrolled..];
while (unrolled_ptr != remain_end) : (unrolled_ptr += scan_big_chunk_size) {
const chunk = unrolled_ptr[0..scan_big_chunk_size].*;
comptime var i: usize = 0;
inline while (i < scan_big_chunk_size) : (i += scan_big_chunk_size) {
deltas[@as(usize, chunk[i])] += delta;
}
}
for (remain) |c| {
deltas[@as(usize, c)] += delta;
}
freqs[0..26].* = deltas['a' .. 'a' + 26].*;
freqs[26 .. 26 * 2].* = deltas['A' .. 'A' + 26].*;
freqs[26 * 2 .. 62].* = deltas['0' .. '0' + 10].*;
freqs[62] = deltas['_'];
freqs[63] = deltas['$'];
}
fn scanSmall(out: *align(1) Buffer, text: string, delta: i32) void {
var freqs: [64]i32 = out.*;
defer out.* = freqs;
for (text) |c| {
const i: usize = switch (c) {
'a'...'z' => @as(usize, @intCast(c)) - 'a',
'A'...'Z' => @as(usize, @intCast(c)) - ('A' - 26),
'0'...'9' => @as(usize, @intCast(c)) + (53 - '0'),
'_' => 62,
'$' => 63,
else => continue,
};
freqs[i] += delta;
}
}
pub fn include(this: *CharFreq, other: CharFreq) void {
// https://zig.godbolt.org/z/Mq8eK6K9s
var left: @Vector(64, i32) = this.freqs;
defer this.freqs = left;
const right: @Vector(64, i32) = other.freqs;
left += right;
}
pub fn compile(this: *const CharFreq, allocator: std.mem.Allocator) NameMinifier {
var array: CharAndCount.Array = brk: {
var _array: CharAndCount.Array = undefined;
const freqs = this.freqs;
for (&_array, NameMinifier.default_tail, &freqs, 0..) |*dest, char, freq, i| {
dest.* = CharAndCount{
.char = char,
.index = i,
.count = freq,
};
}
break :brk _array;
};
std.sort.block(CharAndCount, &array, {}, CharAndCount.lessThan);
var minifier = NameMinifier.init(allocator);
minifier.head.ensureTotalCapacityPrecise(NameMinifier.default_head.len) catch unreachable;
minifier.tail.ensureTotalCapacityPrecise(NameMinifier.default_tail.len) catch unreachable;
// TODO: investigate counting number of < 0 and > 0 and pre-allocating
for (array) |item| {
if (item.char < '0' or item.char > '9') {
minifier.head.append(item.char) catch unreachable;
}
minifier.tail.append(item.char) catch unreachable;
}
return minifier;
}
};
pub const NameMinifier = struct {
head: std.ArrayList(u8),
tail: std.ArrayList(u8),
pub const default_head = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_$";
pub const default_tail = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_$";
pub fn init(allocator: std.mem.Allocator) NameMinifier {
return .{
.head = std.ArrayList(u8).init(allocator),
.tail = std.ArrayList(u8).init(allocator),
};
}
pub fn numberToMinifiedName(this: *NameMinifier, name: *std.ArrayList(u8), _i: isize) !void {
name.clearRetainingCapacity();
var i = _i;
var j = @as(usize, @intCast(@mod(i, 54)));
try name.appendSlice(this.head.items[j .. j + 1]);
i = @divFloor(i, 54);
while (i > 0) {
i -= 1;
j = @as(usize, @intCast(@mod(i, 64)));
try name.appendSlice(this.tail.items[j .. j + 1]);
i = @divFloor(i, 64);
}
}
pub fn defaultNumberToMinifiedName(allocator: std.mem.Allocator, _i: isize) !string {
var i = _i;
var j = @as(usize, @intCast(@mod(i, 54)));
var name = std.ArrayList(u8).init(allocator);
try name.appendSlice(default_head[j .. j + 1]);
i = @divFloor(i, 54);
while (i > 0) {
i -= 1;
j = @as(usize, @intCast(@mod(i, 64)));
try name.appendSlice(default_tail[j .. j + 1]);
i = @divFloor(i, 64);
}
return name.items;
}
};
pub const G = struct {
pub const Decl = struct {
binding: BindingNodeIndex,
value: ?ExprNodeIndex = null,
pub const List = BabyList(Decl);
};
pub const NamespaceAlias = struct {
namespace_ref: Ref,
alias: string,
was_originally_property_access: bool = false,
import_record_index: u32 = std.math.maxInt(u32),
};
pub const ExportStarAlias = struct {
loc: logger.Loc,
// Although this alias name starts off as being the same as the statement's
// namespace symbol, it may diverge if the namespace symbol name is minified.
// The original alias name is preserved here to avoid this scenario.
original_name: string,
};
pub const Class = struct {
class_keyword: logger.Range = logger.Range.None,
ts_decorators: ExprNodeList = ExprNodeList{},
class_name: ?LocRef = null,
extends: ?ExprNodeIndex = null,
body_loc: logger.Loc = logger.Loc.Empty,
close_brace_loc: logger.Loc = logger.Loc.Empty,
properties: []Property = &([_]Property{}),
has_decorators: bool = false,
pub fn canBeMoved(this: *const Class) bool {
if (this.extends != null)
return false;
if (this.has_decorators) {
return false;
}
for (this.properties) |property| {
if (property.kind == .class_static_block)
return false;
const flags = property.flags;
if (flags.contains(.is_computed) or flags.contains(.is_spread)) {
return false;
}
if (property.kind == .normal) {
if (flags.contains(.is_static)) {
for ([2]?Expr{ property.value, property.initializer }) |val_| {
if (val_) |val| {
switch (val.data) {
.e_arrow, .e_function => {},
else => {
if (!val.canBeConstValue()) {
return false;
}
},
}
}
}
}
}
}
return true;
}
};
// invalid shadowing if left as Comment
pub const Comment = struct { loc: logger.Loc, text: string };
pub const ClassStaticBlock = struct {
stmts: BabyList(Stmt) = .{},
loc: logger.Loc,
};
pub const Property = struct {
// This is used when parsing a pattern that uses default values:
//
// [a = 1] = [];
// ({a = 1} = {});
//
// It's also used for class fields:
//
// class Foo { a = 1 }
//
initializer: ?ExprNodeIndex = null,
kind: Kind = Kind.normal,
flags: Flags.Property.Set = Flags.Property.None,
class_static_block: ?*ClassStaticBlock = null,
ts_decorators: ExprNodeList = ExprNodeList{},
// Key is optional for spread
key: ?ExprNodeIndex = null,
// This is omitted for class fields
value: ?ExprNodeIndex = null,
ts_metadata: TypeScript.Metadata = .m_none,
pub const List = BabyList(Property);
pub const Kind = enum(u3) {
normal,
get,
set,
spread,
declare,
class_static_block,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
};
};
pub const FnBody = struct {
loc: logger.Loc,
stmts: StmtNodeList,
};
pub const Fn = struct {
name: ?LocRef = null,
open_parens_loc: logger.Loc = logger.Loc.Empty,
args: []Arg = &([_]Arg{}),
// This was originally nullable, but doing so I believe caused a miscompilation
// Specifically, the body was always null.
body: FnBody = FnBody{ .loc = logger.Loc.Empty, .stmts = &([_]StmtNodeIndex{}) },
arguments_ref: ?Ref = null,
flags: Flags.Function.Set = Flags.Function.None,
return_ts_metadata: TypeScript.Metadata = .m_none,
};
pub const Arg = struct {
ts_decorators: ExprNodeList = ExprNodeList{},
binding: BindingNodeIndex,
default: ?ExprNodeIndex = null,
// "constructor(public x: boolean) {}"
is_typescript_ctor_field: bool = false,
ts_metadata: TypeScript.Metadata = .m_none,
};
};
pub const Symbol = struct {
/// This is the name that came from the parser. Printed names may be renamed
/// during minification or to avoid name collisions. Do not use the original
/// name during printing.
original_name: string,
/// This is used for symbols that represent items in the import clause of an
/// ES6 import statement. These should always be referenced by EImportIdentifier
/// instead of an EIdentifier. When this is present, the expression should
/// be printed as a property access off the namespace instead of as a bare
/// identifier.
///
/// For correctness, this must be stored on the symbol instead of indirectly
/// associated with the Ref for the symbol somehow. In ES6 "flat bundling"
/// mode, re-exported symbols are collapsed using MergeSymbols() and renamed
/// symbols from other files that end up at this symbol must be able to tell
/// if it has a namespace alias.
namespace_alias: ?G.NamespaceAlias = null,
/// Used by the parser for single pass parsing.
link: Ref = Ref.None,
/// An estimate of the number of uses of this symbol. This is used to detect
/// whether a symbol is used or not. For example, TypeScript imports that are
/// unused must be removed because they are probably type-only imports. This
/// is an estimate and may not be completely accurate due to oversights in the
/// code. But it should always be non-zero when the symbol is used.
use_count_estimate: u32 = 0,
/// This is for generating cross-chunk imports and exports for code splitting.
///
/// Do not use this directly. Use `chunkIndex()` instead.
chunk_index: u32 = invalid_chunk_index,
/// This is used for minification. Symbols that are declared in sibling scopes
/// can share a name. A good heuristic (from Google Closure Compiler) is to
/// assign names to symbols from sibling scopes in declaration order. That way
/// local variable names are reused in each global function like this, which
/// improves gzip compression:
///
/// function x(a, b) { ... }
/// function y(a, b, c) { ... }
///
/// The parser fills this in for symbols inside nested scopes. There are three
/// slot namespaces: regular symbols, label symbols, and private symbols.
///
/// Do not use this directly. Use `nestedScopeSlot()` instead.
nested_scope_slot: u32 = invalid_nested_scope_slot,
did_keep_name: bool = true,
must_start_with_capital_letter_for_jsx: bool = false,
/// The kind of symbol. This is used to determine how to print the symbol
/// and how to deal with conflicts, renaming, etc.
kind: Kind = Kind.other,
/// Certain symbols must not be renamed or minified. For example, the
/// "arguments" variable is declared by the runtime for every function.
/// Renaming can also break any identifier used inside a "with" statement.
must_not_be_renamed: bool = false,
/// We automatically generate import items for property accesses off of
/// namespace imports. This lets us remove the expensive namespace imports
/// while bundling in many cases, replacing them with a cheap import item
/// instead:
///
/// import * as ns from 'path'
/// ns.foo()
///
/// That can often be replaced by this, which avoids needing the namespace:
///
/// import {foo} from 'path'
/// foo()
///
/// However, if the import is actually missing then we don't want to report a
/// compile-time error like we do for real import items. This status lets us
/// avoid this. We also need to be able to replace such import items with
/// undefined, which this status is also used for.
import_item_status: ImportItemStatus = ImportItemStatus.none,
/// --- Not actually used yet -----------------------------------------------
/// Sometimes we lower private symbols even if they are supported. For example,
/// consider the following TypeScript code:
///
/// class Foo {
/// #foo = 123
/// bar = this.#foo
/// }
///
/// If "useDefineForClassFields: false" is set in "tsconfig.json", then "bar"
/// must use assignment semantics instead of define semantics. We can compile
/// that to this code:
///
/// class Foo {
/// constructor() {
/// this.#foo = 123;
/// this.bar = this.#foo;
/// }
/// #foo;
/// }
///
/// However, we can't do the same for static fields:
///
/// class Foo {
/// static #foo = 123
/// static bar = this.#foo
/// }
///
/// Compiling these static fields to something like this would be invalid:
///
/// class Foo {
/// static #foo;
/// }
/// Foo.#foo = 123;
/// Foo.bar = Foo.#foo;
///
/// Thus "#foo" must be lowered even though it's supported. Another case is
/// when we're converting top-level class declarations to class expressions
/// to avoid the TDZ and the class shadowing symbol is referenced within the
/// class body:
///
/// class Foo {
/// static #foo = Foo
/// }
///
/// This cannot be converted into something like this:
///
/// var Foo = class {
/// static #foo;
/// };
/// Foo.#foo = Foo;
///
/// --- Not actually used yet -----------------------------------------------
private_symbol_must_be_lowered: bool = false,
remove_overwritten_function_declaration: bool = false,
/// In debug mode, sometimes its helpful to know what source file
/// A symbol came from. This is used for that.
///
/// We don't want this in non-debug mode because it increases the size of
/// the symbol table.
debug_mode_source_index: if (Environment.allow_assert)
Index.Int
else
u0 = 0,
const invalid_chunk_index = std.math.maxInt(u32);
pub const invalid_nested_scope_slot = std.math.maxInt(u32);
pub const SlotNamespace = enum {
must_not_be_renamed,
default,
label,
private_name,
mangled_prop,
pub const CountsArray = std.EnumArray(SlotNamespace, u32);
};
/// This is for generating cross-chunk imports and exports for code splitting.
pub inline fn chunkIndex(this: *const Symbol) ?u32 {
const i = this.chunk_index;
return if (i == invalid_chunk_index) null else i;
}
pub inline fn nestedScopeSlot(this: *const Symbol) ?u32 {
const i = this.nested_scope_slot;
return if (i == invalid_nested_scope_slot) null else i;
}
pub fn slotNamespace(this: *const Symbol) SlotNamespace {
const kind = this.kind;
if (kind == .unbound or this.must_not_be_renamed) {
return .must_not_be_renamed;
}
if (kind.isPrivate()) {
return .private_name;
}
return switch (kind) {
// .mangled_prop => .mangled_prop,
.label => .label,
else => .default,
};
}
pub inline fn hasLink(this: *const Symbol) bool {
return this.link.tag != .invalid;
}
pub const Kind = enum {
// An unbound symbol is one that isn't declared in the file it's referenced
// in. For example, using "window" without declaring it will be unbound.
unbound,
// This has special merging behavior. You're allowed to re-declare these
// symbols more than once in the same scope. These symbols are also hoisted
// out of the scope they are declared in to the closest containing function
// or module scope. These are the symbols with this kind:
//
// - Function arguments
// - Function statements
// - Variables declared using "var"
//
hoisted,
hoisted_function,
// There's a weird special case where catch variables declared using a simple
// identifier (i.e. not a binding pattern) block hoisted variables instead of
// becoming an error:
//
// var e = 0;
// try { throw 1 } catch (e) {
// print(e) // 1
// var e = 2
// print(e) // 2
// }
// print(e) // 0 (since the hoisting stops at the catch block boundary)
//
// However, other forms are still a syntax error:
//
// try {} catch (e) { let e }
// try {} catch ({e}) { var e }
//
// This symbol is for handling this weird special case.
catch_identifier,
// Generator and async functions are not hoisted, but still have special
// properties such as being able to overwrite previous functions with the
// same name
generator_or_async_function,
// This is the special "arguments" variable inside functions
arguments,
// Classes can merge with TypeScript namespaces.
class,
// A class-private identifier (i.e. "#foo").
private_field,
private_method,
private_get,
private_set,
private_get_set_pair,
private_static_field,
private_static_method,
private_static_get,
private_static_set,
private_static_get_set_pair,
// Labels are in their own namespace
label,
// TypeScript enums can merge with TypeScript namespaces and other TypeScript
// enums.
ts_enum,
// TypeScript namespaces can merge with classes, functions, TypeScript enums,
// and other TypeScript namespaces.
ts_namespace,
// In TypeScript, imports are allowed to silently collide with symbols within
// the module. Presumably this is because the imports may be type-only.
import,
// Assigning to a "const" symbol will throw a TypeError at runtime
cconst,
// This annotates all other symbols that don't have special behavior.
other,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
pub inline fn isPrivate(kind: Symbol.Kind) bool {
return @intFromEnum(kind) >= @intFromEnum(Symbol.Kind.private_field) and @intFromEnum(kind) <= @intFromEnum(Symbol.Kind.private_static_get_set_pair);
}
pub inline fn isHoisted(kind: Symbol.Kind) bool {
return switch (kind) {
.hoisted, .hoisted_function => true,
else => false,
};
}
pub inline fn isHoistedOrFunction(kind: Symbol.Kind) bool {
return switch (kind) {
.hoisted, .hoisted_function, .generator_or_async_function => true,
else => false,
};
}
pub inline fn isFunction(kind: Symbol.Kind) bool {
return switch (kind) {
.hoisted_function, .generator_or_async_function => true,
else => false,
};
}
};
pub const isKindPrivate = Symbol.Kind.isPrivate;
pub const isKindHoisted = Symbol.Kind.isHoisted;
pub const isKindHoistedOrFunction = Symbol.Kind.isHoistedOrFunction;
pub const isKindFunction = Symbol.Kind.isFunction;
pub const Use = struct {
count_estimate: u32 = 0,
};
pub const List = BabyList(Symbol);
pub const NestedList = BabyList(List);
pub fn mergeContentsWith(this: *Symbol, old: *Symbol) void {
this.use_count_estimate += old.use_count_estimate;
if (old.must_not_be_renamed) {
this.original_name = old.original_name;
this.must_not_be_renamed = true;
}
// TODO: MustStartWithCapitalLetterForJSX
}
pub const Map = struct {
// This could be represented as a "map[Ref]Symbol" but a two-level array was
// more efficient in profiles. This appears to be because it doesn't involve
// a hash. This representation also makes it trivial to quickly merge symbol
// maps from multiple files together. Each file only generates symbols in a
// single inner array, so you can join the maps together by just make a
// single outer array containing all of the inner arrays. See the comment on
// "Ref" for more detail.
symbols_for_source: NestedList = NestedList{},
pub fn dump(this: Map) void {
defer Output.flush();
for (this.symbols_for_source.slice(), 0..) |symbols, i| {
Output.prettyln("\n\n-- Source ID: {d} ({d} symbols) --\n\n", .{ i, symbols.len });
for (symbols.slice(), 0..) |symbol, inner_index| {
Output.prettyln(
" name: {s}\n tag: {s}\n {any}\n",
.{
symbol.original_name, @tagName(symbol.kind),
if (symbol.hasLink()) symbol.link else Ref{
.source_index = @as(Ref.Int, @truncate(i)),
.inner_index = @as(Ref.Int, @truncate(inner_index)),
.tag = .symbol,
},
},
);
}
}
}
pub fn assignChunkIndex(this: *Map, decls_: DeclaredSymbol.List, chunk_index: u32) void {
const Iterator = struct {
map: *Map,
chunk_index: u32,
pub fn next(self: @This(), ref: Ref) void {
var symbol = self.map.get(ref).?;
symbol.chunk_index = self.chunk_index;
}
};
var decls = decls_;
DeclaredSymbol.forEachTopLevelSymbol(&decls, Iterator{ .map = this, .chunk_index = chunk_index }, Iterator.next);
}
pub fn merge(this: *Map, old: Ref, new: Ref) Ref {
if (old.eql(new)) {
return new;
}
var old_symbol = this.get(old).?;
if (old_symbol.hasLink()) {
const old_link = old_symbol.link;
old_symbol.link = this.merge(old_link, new);
return old_symbol.link;
}
var new_symbol = this.get(new).?;
if (new_symbol.hasLink()) {
const new_link = new_symbol.link;
new_symbol.link = this.merge(old, new_link);
return new_symbol.link;
}
old_symbol.link = new;
new_symbol.mergeContentsWith(old_symbol);
return new;
}
pub fn get(self: *const Map, ref: Ref) ?*Symbol {
if (Ref.isSourceIndexNull(ref.sourceIndex()) or ref.isSourceContentsSlice()) {
return null;
}
return self.symbols_for_source.at(ref.sourceIndex()).mut(ref.innerIndex());
}
pub fn getConst(self: *const Map, ref: Ref) ?*const Symbol {
if (Ref.isSourceIndexNull(ref.sourceIndex()) or ref.isSourceContentsSlice()) {
return null;
}
return self.symbols_for_source.at(ref.sourceIndex()).at(ref.innerIndex());
}
pub fn init(sourceCount: usize, allocator: std.mem.Allocator) !Map {
var symbols_for_source: NestedList = NestedList.init(try allocator.alloc([]Symbol, sourceCount));
return Map{ .symbols_for_source = symbols_for_source };
}
pub fn initList(list: NestedList) Map {
return Map{ .symbols_for_source = list };
}
pub fn getWithLink(symbols: *const Map, ref: Ref) ?*Symbol {
var symbol: *Symbol = symbols.get(ref) orelse return null;
if (symbol.hasLink()) {
return symbols.get(symbol.link) orelse symbol;
}
return symbol;
}
pub fn getWithLinkConst(symbols: *Map, ref: Ref) ?*const Symbol {
var symbol: *const Symbol = symbols.getConst(ref) orelse return null;
if (symbol.hasLink()) {
return symbols.getConst(symbol.link) orelse symbol;
}
return symbol;
}
pub fn followAll(symbols: *Map) void {
const trace = bun.tracy.traceNamed(@src(), "Symbols.followAll");
defer trace.end();
for (symbols.symbols_for_source.slice()) |list| {
for (list.slice()) |*symbol| {
if (!symbol.hasLink()) continue;
symbol.link = follow(symbols, symbol.link);
}
}
}
pub fn follow(symbols: *const Map, ref: Ref) Ref {
var symbol = symbols.get(ref) orelse return ref;
if (!symbol.hasLink()) {
return ref;
}
const link = follow(symbols, symbol.link);
if (!symbol.link.eql(link)) {
symbol.link = link;
}
return link;
}
};
pub inline fn isHoisted(self: *const Symbol) bool {
return Symbol.isKindHoisted(self.kind);
}
pub fn isReactComponentishName(symbol: *const Symbol) bool {
switch (symbol.kind) {
.hoisted, .hoisted_function, .cconst, .class, .other => {
return switch (symbol.original_name[0]) {
'A'...'Z' => true,
else => false,
};
},
else => {
return false;
},
}
}
};
pub const OptionalChain = enum(u2) {
// "a?.b"
start,
// "a?.b.c" => ".c" is OptionalChainContinue
// "(a?.b).c" => ".c" is OptionalChain null
ccontinue,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
};
pub const E = struct {
pub const Array = struct {
items: ExprNodeList = ExprNodeList{},
comma_after_spread: ?logger.Loc = null,
is_single_line: bool = false,
is_parenthesized: bool = false,
was_originally_macro: bool = false,
close_bracket_loc: logger.Loc = logger.Loc.Empty,
pub fn push(this: *Array, allocator: std.mem.Allocator, item: Expr) !void {
try this.items.push(allocator, item);
}
pub inline fn slice(this: Array) []Expr {
return this.items.slice();
}
pub fn inlineSpreadOfArrayLiterals(
this: *Array,
allocator: std.mem.Allocator,
estimated_count: usize,
) !ExprNodeList {
var out = try allocator.alloc(
Expr,
// This over-allocates a little but it's fine
estimated_count + @as(usize, this.items.len),
);
var remain = out;
for (this.items.slice()) |item| {
switch (item.data) {
.e_spread => |val| {
if (val.value.data == .e_array) {
for (val.value.data.e_array.items.slice()) |inner_item| {
if (inner_item.data == .e_missing) {
remain[0] = Expr.init(E.Undefined, .{}, inner_item.loc);
remain = remain[1..];
} else {
remain[0] = inner_item;
remain = remain[1..];
}
}
// skip empty arrays
// don't include the inlined spread.
continue;
}
// non-arrays are kept in
},
else => {},
}
remain[0] = item;
remain = remain[1..];
}
return ExprNodeList.init(out[0 .. out.len - remain.len]);
}
pub fn toJS(this: @This(), allocator: std.mem.Allocator, globalObject: *JSC.JSGlobalObject) ToJSError!JSC.JSValue {
const items = this.items.slice();
var array = JSC.JSValue.createEmptyArray(globalObject, items.len);
array.protect();
defer array.unprotect();
for (items, 0..) |expr, j| {
array.putIndex(globalObject, @as(u32, @truncate(j)), try expr.data.toJS(allocator, globalObject));
}
return array;
}
};
pub const Unary = struct {
op: Op.Code,
value: ExprNodeIndex,
};
pub const Binary = struct {
left: ExprNodeIndex,
right: ExprNodeIndex,
op: Op.Code,
};
pub const Boolean = struct {
value: bool,
pub fn toJS(this: @This(), ctx: JSC.C.JSContextRef, _: JSC.C.ExceptionRef) JSC.C.JSValueRef {
return JSC.C.JSValueMakeBoolean(ctx, this.value);
}
};
pub const Super = struct {};
pub const Null = struct {};
pub const This = struct {};
pub const Undefined = struct {};
pub const New = struct {
target: ExprNodeIndex,
args: ExprNodeList = ExprNodeList{},
// True if there is a comment containing "@__PURE__" or "#__PURE__" preceding
// this call expression. See the comment inside ECall for more details.
can_be_unwrapped_if_unused: bool = false,
close_parens_loc: logger.Loc,
};
pub const NewTarget = struct {
range: logger.Range,
};
pub const ImportMeta = struct {};
pub const Call = struct {
// Node:
target: ExprNodeIndex,
args: ExprNodeList = ExprNodeList{},
optional_chain: ?OptionalChain = null,
is_direct_eval: bool = false,
close_paren_loc: logger.Loc = logger.Loc.Empty,
// True if there is a comment containing "@__PURE__" or "#__PURE__" preceding
// this call expression. This is an annotation used for tree shaking, and
// means that the call can be removed if it's unused. It does not mean the
// call is pure (e.g. it may still return something different if called twice).
//
// Note that the arguments are not considered to be part of the call. If the
// call itself is removed due to this annotation, the arguments must remain
// if they have side effects.
can_be_unwrapped_if_unused: bool = false,
// Used when printing to generate the source prop on the fly
was_jsx_element: bool = false,
pub fn hasSameFlagsAs(a: *Call, b: *Call) bool {
return (a.optional_chain == b.optional_chain and
a.is_direct_eval == b.is_direct_eval and
a.can_be_unwrapped_if_unused == b.can_be_unwrapped_if_unused);
}
};
pub const Dot = struct {
// target is Node
target: ExprNodeIndex,
name: string,
name_loc: logger.Loc,
optional_chain: ?OptionalChain = null,
// If true, this property access is known to be free of side-effects. That
// means it can be removed if the resulting value isn't used.
can_be_removed_if_unused: bool = false,
// If true, this property access is a function that, when called, can be
// unwrapped if the resulting value is unused. Unwrapping means discarding
// the call target but keeping any arguments with side effects.
call_can_be_unwrapped_if_unused: bool = false,
pub fn hasSameFlagsAs(a: *Dot, b: *Dot) bool {
return (a.optional_chain == b.optional_chain and
a.is_direct_eval == b.is_direct_eval and
a.can_be_unwrapped_if_unused == b.can_be_unwrapped_if_unused and a.call_can_be_unwrapped_if_unused == b.call_can_be_unwrapped_if_unused);
}
};
pub const Index = struct {
index: ExprNodeIndex,
target: ExprNodeIndex,
optional_chain: ?OptionalChain = null,
pub fn hasSameFlagsAs(a: *E.Index, b: *E.Index) bool {
return (a.optional_chain == b.optional_chain);
}
};
pub const Arrow = struct {
args: []G.Arg = &[_]G.Arg{},
body: G.FnBody,
is_async: bool = false,
has_rest_arg: bool = false,
prefer_expr: bool = false, // Use shorthand if true and "Body" is a single return statement
};
pub const Function = struct { func: G.Fn };
pub const Identifier = struct {
ref: Ref = Ref.None,
// If we're inside a "with" statement, this identifier may be a property
// access. In that case it would be incorrect to remove this identifier since
// the property access may be a getter or setter with side effects.
must_keep_due_to_with_stmt: bool = false,
// If true, this identifier is known to not have a side effect (i.e. to not
// throw an exception) when referenced. If false, this identifier may or may
// not have side effects when referenced. This is used to allow the removal
// of known globals such as "Object" if they aren't used.
can_be_removed_if_unused: bool = false,
// If true, this identifier represents a function that, when called, can be
// unwrapped if the resulting value is unused. Unwrapping means discarding
// the call target but keeping any arguments with side effects.
call_can_be_unwrapped_if_unused: bool = false,
pub inline fn init(ref: Ref) Identifier {
return Identifier{
.ref = ref,
.must_keep_due_to_with_stmt = false,
.can_be_removed_if_unused = false,
.call_can_be_unwrapped_if_unused = false,
};
}
};
/// This is similar to an `Identifier` but it represents a reference to an ES6
/// import item.
///
/// Depending on how the code is linked, the file containing this EImportIdentifier
/// may or may not be in the same module group as the file it was imported from.
///
/// If it's the same module group than we can just merge the import item symbol
/// with the corresponding symbol that was imported, effectively renaming them
/// to be the same thing and statically binding them together.
///
/// But if it's a different module group, then the import must be dynamically
/// evaluated using a property access off the corresponding namespace symbol,
/// which represents the result of a require() call.
///
/// It's stored as a separate type so it's not easy to confuse with a plain
/// identifier. For example, it'd be bad if code trying to convert "{x: x}" into
/// "{x}" shorthand syntax wasn't aware that the "x" in this case is actually
/// "{x: importedNamespace.x}". This separate type forces code to opt-in to
/// doing this instead of opt-out.
pub const ImportIdentifier = struct {
ref: Ref = Ref.None,
/// If true, this was originally an identifier expression such as "foo". If
/// false, this could potentially have been a member access expression such
/// as "ns.foo" off of an imported namespace object.
was_originally_identifier: bool = false,
};
pub const CommonJSExportIdentifier = struct {
ref: Ref = Ref.None,
};
// This is similar to EIdentifier but it represents class-private fields and
// methods. It can be used where computed properties can be used, such as
// EIndex and Property.
pub const PrivateIdentifier = struct {
ref: Ref,
};
/// In development mode, the new JSX transform has a few special props
/// - `React.jsxDEV(type, arguments, key, isStaticChildren, source, self)`
/// - `arguments`:
/// ```{ ...props, children: children, }```
/// - `source`: https://github.com/babel/babel/blob/ef87648f3f05ccc393f89dea7d4c7c57abf398ce/packages/babel-plugin-transform-react-jsx-source/src/index.js#L24-L48
/// ```{
/// fileName: string | null,
/// columnNumber: number | null,
/// lineNumber: number | null,
/// }```
/// - `children`:
/// - static the function is React.jsxsDEV, "jsxs" instead of "jsx"
/// - one child? the function is React.jsxDEV,
/// - no children? the function is React.jsxDEV and children is an empty array.
/// `isStaticChildren`: https://github.com/facebook/react/blob/4ca62cac45c288878d2532e5056981d177f9fdac/packages/react/src/jsx/ReactJSXElementValidator.js#L369-L384
/// This flag means children is an array of JSX Elements literals.
/// The documentation on this is sparse, but it appears that
/// React just calls Object.freeze on the children array.
/// Object.freeze, historically, is quite a bit slower[0] than just not doing that.
/// Given that...I am choosing to always pass "false" to this.
/// This also skips extra state that we'd need to track.
/// If React Fast Refresh ends up using this later, then we can revisit this decision.
/// [0]: https://github.com/automerge/automerge/issues/177
pub const JSXElement = struct {
/// JSX tag name
///
=> E.String.init("div")
///
=> E.Identifier{.ref = symbolPointingToMyComponent }
/// null represents a fragment
tag: ?ExprNodeIndex = null,
/// JSX props
properties: G.Property.List = G.Property.List{},
/// JSX element children {this_is_a_child_element}
children: ExprNodeList = ExprNodeList{},
/// key is the key prop like
key: ?ExprNodeIndex = null,
flags: Flags.JSXElement.Bitset = Flags.JSXElement.Bitset{},
close_tag_loc: logger.Loc = logger.Loc.Empty,
pub const SpecialProp = enum {
__self, // old react transform used this as a prop
__source,
key,
ref,
any,
pub const Map = ComptimeStringMap(SpecialProp, .{
.{ "__self", .__self },
.{ "__source", .__source },
.{ "key", .key },
.{ "ref", .ref },
});
};
};
pub const Missing = struct {
pub fn jsonStringify(_: *const @This(), writer: anytype) !void {
return try writer.write(null);
}
};
pub const Number = struct {
value: f64,
const double_digit = [_]string{ "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52", "53", "54", "55", "56", "57", "58", "59", "60", "61", "62", "63", "64", "65", "66", "67", "68", "69", "70", "71", "72", "73", "74", "75", "76", "77", "78", "79", "80", "81", "82", "83", "84", "85", "86", "87", "88", "89", "90", "91", "92", "93", "94", "95", "96", "97", "98", "99", "100" };
const neg_double_digit = [_]string{ "-0", "-1", "-2", "-3", "-4", "-5", "-6", "-7", "-8", "-9", "-10", "-11", "-12", "-13", "-14", "-15", "-16", "-17", "-18", "-19", "-20", "-21", "-22", "-23", "-24", "-25", "-26", "-27", "-28", "-29", "-30", "-31", "-32", "-33", "-34", "-35", "-36", "-37", "-38", "-39", "-40", "-41", "-42", "-43", "-44", "-45", "-46", "-47", "-48", "-49", "-50", "-51", "-52", "-53", "-54", "-55", "-56", "-57", "-58", "-59", "-60", "-61", "-62", "-63", "-64", "-65", "-66", "-67", "-68", "-69", "-70", "-71", "-72", "-73", "-74", "-75", "-76", "-77", "-78", "-79", "-80", "-81", "-82", "-83", "-84", "-85", "-86", "-87", "-88", "-89", "-90", "-91", "-92", "-93", "-94", "-95", "-96", "-97", "-98", "-99", "-100" };
/// String concatenation with numbers is required by the TypeScript compiler for
/// "constant expression" handling in enums. However, we don't want to introduce
/// correctness bugs by accidentally stringifying a number differently than how
/// a real JavaScript VM would do it. So we are conservative and we only do this
/// when we know it'll be the same result.
pub fn toStringSafely(this: Number, allocator: std.mem.Allocator) ?string {
return toStringFromF64Safe(this.value, allocator);
}
pub fn toStringFromF64Safe(value: f64, allocator: std.mem.Allocator) ?string {
if (comptime !Environment.isWasm) {
if (value == @trunc(value) and (value < std.math.maxInt(i32) and value > std.math.minInt(i32))) {
const int_value = @as(i64, @intFromFloat(value));
const abs = @as(u64, @intCast(@abs(int_value)));
if (abs < double_digit.len) {
return if (int_value < 0)
neg_double_digit[abs]
else
double_digit[abs];
}
return std.fmt.allocPrint(allocator, "{d}", .{@as(i32, @intCast(int_value))}) catch return null;
}
}
if (std.math.isNan(value)) {
return "NaN";
}
if (std.math.isNegativeInf(value)) {
return "-Infinity";
}
if (std.math.isInf(value)) {
return "Infinity";
}
return null;
}
pub inline fn toU64(self: Number) u64 {
return self.to(u64);
}
pub inline fn toUsize(self: Number) usize {
return self.to(usize);
}
pub inline fn toU32(self: Number) u32 {
return self.to(u32);
}
pub inline fn toU16(self: Number) u16 {
return self.to(u16);
}
pub fn to(self: Number, comptime T: type) T {
return @as(T, @intFromFloat(@min(@max(@trunc(self.value), 0), comptime @min(std.math.floatMax(f64), std.math.maxInt(T)))));
}
pub fn jsonStringify(self: *const Number, writer: anytype) !void {
return try writer.write(self.value);
}
pub fn toJS(this: @This()) JSC.JSValue {
return JSC.JSValue.jsNumber(this.value);
}
};
pub const BigInt = struct {
value: string,
pub var empty = BigInt{ .value = "" };
pub fn jsonStringify(self: *const @This(), writer: anytype) !void {
return try writer.write(self.value);
}
pub fn toJS(_: @This()) JSC.JSValue {
// TODO:
return JSC.JSValue.jsNumber(0);
}
};
pub const Object = struct {
properties: G.Property.List = G.Property.List{},
comma_after_spread: ?logger.Loc = null,
is_single_line: bool = false,
is_parenthesized: bool = false,
was_originally_macro: bool = false,
close_brace_loc: logger.Loc = logger.Loc.Empty,
// used in TOML parser to merge properties
pub const Rope = struct {
head: Expr,
next: ?*Rope = null,
const OOM = error{OutOfMemory};
pub fn append(this: *Rope, expr: Expr, allocator: std.mem.Allocator) OOM!*Rope {
if (this.next) |next| {
return try next.append(expr, allocator);
}
var rope = try allocator.create(Rope);
rope.* = .{
.head = expr,
};
this.next = rope;
return rope;
}
};
// pub fn toJS(this: Object, ctx: JSC.C.JSContextRef, exception: JSC.C.ExceptionRef) JSC.C.JSValueRef {
// const Creator = struct {
// object: Object,
// pub fn create(this: *@This(), obj: *JSObject, global: *JSGlobalObject) void {
// var iter = this.query.iter();
// var str: ZigString = undefined;
// while (iter.next(&query_string_values_buf)) |entry| {
// str = ZigString.init(entry.name);
// std.debug.assert(entry.values.len > 0);
// if (entry.values.len > 1) {
// var values = query_string_value_refs_buf[0..entry.values.len];
// for (entry.values) |value, i| {
// values[i] = ZigString.init(value);
// }
// obj.putRecord(global, &str, values.ptr, values.len);
// } else {
// query_string_value_refs_buf[0] = ZigString.init(entry.values[0]);
// obj.putRecord(global, &str, &query_string_value_refs_buf, 1);
// }
// }
// }
// };
// }
pub fn get(self: *const Object, key: string) ?Expr {
return if (asProperty(self, key)) |query| query.expr else @as(?Expr, null);
}
pub fn toJS(this: *Object, allocator: std.mem.Allocator, globalObject: *JSC.JSGlobalObject) ToJSError!JSC.JSValue {
var obj = JSC.JSValue.createEmptyObject(globalObject, this.properties.len);
obj.protect();
defer obj.unprotect();
const props: []const G.Property = this.properties.slice();
for (props) |prop| {
if (prop.kind != .normal or prop.class_static_block != null or prop.key == null or prop.key.?.data != .e_string or prop.value == null) {
return error.@"Cannot convert argument type to JS";
}
var key = prop.key.?.data.e_string.toZigString(allocator);
obj.put(globalObject, &key, try prop.value.?.toJS(allocator, globalObject));
}
return obj;
}
pub fn put(self: *Object, allocator: std.mem.Allocator, key: string, expr: Expr) !void {
if (asProperty(self, key)) |query| {
self.properties.ptr[query.i].value = expr;
} else {
try self.properties.push(allocator, .{
.key = Expr.init(E.String, E.String.init(key), expr.loc),
.value = expr,
});
}
}
pub fn putString(self: *Object, allocator: std.mem.Allocator, key: string, value: string) !void {
return try put(self, allocator, key, Expr.init(E.String, E.String.init(value), logger.Loc.Empty));
}
pub const SetError = error{ OutOfMemory, Clobber };
pub fn set(self: *const Object, key: Expr, allocator: std.mem.Allocator, value: Expr) SetError!void {
if (self.hasProperty(key.data.e_string.data)) return error.Clobber;
try self.properties.push(allocator, .{
.key = key,
.value = value,
});
}
pub const RopeQuery = struct {
expr: Expr,
rope: *const Rope,
};
// this is terribly, shamefully slow
pub fn setRope(self: *Object, rope: *const Rope, allocator: std.mem.Allocator, value: Expr) SetError!void {
if (self.get(rope.head.data.e_string.data)) |existing| {
switch (existing.data) {
.e_array => |array| {
if (rope.next == null) {
try array.push(allocator, value);
return;
}
if (array.items.last()) |last| {
if (last.data != .e_object) {
return error.Clobber;
}
try last.data.e_object.setRope(rope.next.?, allocator, value);
return;
}
try array.push(allocator, value);
return;
},
.e_object => |object| {
if (rope.next != null) {
try object.setRope(rope.next.?, allocator, value);
return;
}
return error.Clobber;
},
else => {
return error.Clobber;
},
}
}
var value_ = value;
if (rope.next) |next| {
var obj = Expr.init(E.Object, E.Object{ .properties = .{} }, rope.head.loc);
try obj.data.e_object.setRope(next, allocator, value);
value_ = obj;
}
try self.properties.push(allocator, .{
.key = rope.head,
.value = value_,
});
}
pub fn getOrPutObject(self: *Object, rope: *const Rope, allocator: std.mem.Allocator) SetError!Expr {
if (self.get(rope.head.data.e_string.data)) |existing| {
switch (existing.data) {
.e_array => |array| {
if (rope.next == null) {
return error.Clobber;
}
if (array.items.last()) |last| {
if (last.data != .e_object) {
return error.Clobber;
}
return try last.data.e_object.getOrPutObject(rope.next.?, allocator);
}
return error.Clobber;
},
.e_object => |object| {
if (rope.next == null) {
// success
return existing;
}
return try object.getOrPutObject(rope.next.?, allocator);
},
else => {
return error.Clobber;
},
}
}
if (rope.next) |next| {
var obj = Expr.init(E.Object, E.Object{ .properties = .{} }, rope.head.loc);
const out = try obj.data.e_object.getOrPutObject(next, allocator);
try self.properties.push(allocator, .{
.key = rope.head,
.value = obj,
});
return out;
}
const out = Expr.init(E.Object, E.Object{}, rope.head.loc);
try self.properties.push(allocator, .{
.key = rope.head,
.value = out,
});
return out;
}
pub fn getOrPutArray(self: *Object, rope: *const Rope, allocator: std.mem.Allocator) SetError!Expr {
if (self.get(rope.head.data.e_string.data)) |existing| {
switch (existing.data) {
.e_array => |array| {
if (rope.next == null) {
return existing;
}
if (array.items.last()) |last| {
if (last.data != .e_object) {
return error.Clobber;
}
return try last.data.e_object.getOrPutArray(rope.next.?, allocator);
}
return error.Clobber;
},
.e_object => |object| {
if (rope.next == null) {
return error.Clobber;
}
return try object.getOrPutArray(rope.next.?, allocator);
},
else => {
return error.Clobber;
},
}
}
if (rope.next) |next| {
var obj = Expr.init(E.Object, E.Object{ .properties = .{} }, rope.head.loc);
const out = try obj.data.e_object.getOrPutArray(next, allocator);
try self.properties.push(allocator, .{
.key = rope.head,
.value = obj,
});
return out;
}
const out = Expr.init(E.Array, E.Array{}, rope.head.loc);
try self.properties.push(allocator, .{
.key = rope.head,
.value = out,
});
return out;
}
pub fn hasProperty(obj: *const Object, name: string) bool {
for (obj.properties.slice()) |prop| {
const key = prop.key orelse continue;
if (std.meta.activeTag(key.data) != .e_string) continue;
if (key.data.e_string.eql(string, name)) return true;
}
return false;
}
pub fn asProperty(obj: *const Object, name: string) ?Expr.Query {
for (obj.properties.slice(), 0..) |prop, i| {
const value = prop.value orelse continue;
const key = prop.key orelse continue;
if (std.meta.activeTag(key.data) != .e_string) continue;
const key_str = key.data.e_string;
if (key_str.eql(string, name)) {
return Expr.Query{
.expr = value,
.loc = key.loc,
.i = @as(u32, @truncate(i)),
};
}
}
return null;
}
pub fn alphabetizeProperties(this: *Object) void {
std.sort.block(G.Property, this.properties.slice(), {}, Sorter.isLessThan);
}
pub fn packageJSONSort(this: *Object) void {
std.sort.block(G.Property, this.properties.slice(), {}, PackageJSONSort.Fields.isLessThan);
}
const PackageJSONSort = struct {
const Fields = enum(u8) {
name = 0,
version = 1,
author = 2,
repository = 3,
config = 4,
main = 5,
module = 6,
dependencies = 7,
devDependencies = 8,
optionalDependencies = 9,
peerDependencies = 10,
exports = 11,
__fake = 12,
pub const Map = ComptimeStringMap(Fields, .{
.{ "name", Fields.name },
.{ "version", Fields.version },
.{ "author", Fields.author },
.{ "repository", Fields.repository },
.{ "config", Fields.config },
.{ "main", Fields.main },
.{ "module", Fields.module },
.{ "dependencies", Fields.dependencies },
.{ "devDependencies", Fields.devDependencies },
.{ "optionalDependencies", Fields.optionalDependencies },
.{ "peerDependencies", Fields.peerDependencies },
.{ "exports", Fields.exports },
});
pub fn isLessThan(ctx: void, lhs: G.Property, rhs: G.Property) bool {
var lhs_key_size: u8 = @intFromEnum(Fields.__fake);
var rhs_key_size: u8 = @intFromEnum(Fields.__fake);
if (lhs.key != null and lhs.key.?.data == .e_string) {
lhs_key_size = @intFromEnum(Map.get(lhs.key.?.data.e_string.data) orelse Fields.__fake);
}
if (rhs.key != null and rhs.key.?.data == .e_string) {
rhs_key_size = @intFromEnum(Map.get(rhs.key.?.data.e_string.data) orelse Fields.__fake);
}
return switch (std.math.order(lhs_key_size, rhs_key_size)) {
.lt => true,
.gt => false,
.eq => strings.cmpStringsAsc(ctx, lhs.key.?.data.e_string.data, rhs.key.?.data.e_string.data),
};
}
};
};
const Sorter = struct {
pub fn isLessThan(ctx: void, lhs: G.Property, rhs: G.Property) bool {
return strings.cmpStringsAsc(ctx, lhs.key.?.data.e_string.data, rhs.key.?.data.e_string.data);
}
};
};
pub const Spread = struct { value: ExprNodeIndex };
/// JavaScript string literal type
pub const String = struct {
// A version of this where `utf8` and `value` are stored in a packed union, with len as a single u32 was attempted.
// It did not improve benchmarks. Neither did converting this from a heap-allocated type to a stack-allocated type.
data: []const u8 = "",
prefer_template: bool = false,
// A very simple rope implementation
// We only use this for string folding, so this is kind of overkill
// We don't need to deal with substrings
next: ?*String = null,
end: ?*String = null,
rope_len: u32 = 0,
is_utf16: bool = false,
pub fn isIdentifier(this: *String, allocator: std.mem.Allocator) bool {
if (!this.isUTF8()) {
return bun.js_lexer.isIdentifierUTF16(this.slice16());
}
return bun.js_lexer.isIdentifier(this.slice(allocator));
}
pub var class = E.String{ .data = "class" };
pub fn push(this: *String, other: *String) void {
std.debug.assert(this.isUTF8());
std.debug.assert(other.isUTF8());
if (other.rope_len == 0) {
other.rope_len = @as(u32, @truncate(other.data.len));
}
if (this.rope_len == 0) {
this.rope_len = @as(u32, @truncate(this.data.len));
}
this.rope_len += other.rope_len;
if (this.next == null) {
this.next = other;
this.end = other;
} else {
var end = this.end.?;
while (end.next != null) end = end.end.?;
end.next = other;
this.end = other;
}
}
pub fn toUTF8(this: *String, allocator: std.mem.Allocator) !void {
if (!this.is_utf16) return;
this.data = try strings.toUTF8Alloc(allocator, this.slice16());
this.is_utf16 = false;
}
pub fn init(value: anytype) String {
const Value = @TypeOf(value);
if (Value == []u16 or Value == []const u16) {
return .{
.data = @as([*]const u8, @ptrCast(value.ptr))[0..value.len],
.is_utf16 = true,
};
}
return .{
.data = value,
};
}
pub fn slice16(this: *const String) []const u16 {
std.debug.assert(this.is_utf16);
return @as([*]const u16, @ptrCast(@alignCast(this.data.ptr)))[0..this.data.len];
}
pub fn resolveRopeIfNeeded(this: *String, allocator: std.mem.Allocator) void {
if (this.next == null or !this.isUTF8()) return;
var str = this.next;
var bytes = std.ArrayList(u8).initCapacity(allocator, this.rope_len) catch unreachable;
bytes.appendSliceAssumeCapacity(this.data);
while (str) |strin| {
bytes.appendSlice(strin.data) catch unreachable;
str = strin.next;
}
this.data = bytes.items;
this.next = null;
}
pub fn slice(this: *String, allocator: std.mem.Allocator) []const u8 {
this.resolveRopeIfNeeded(allocator);
return this.string(allocator) catch unreachable;
}
pub var empty = String{};
pub var @"true" = String{ .data = "true" };
pub var @"false" = String{ .data = "false" };
pub var @"null" = String{ .data = "null" };
pub var @"undefined" = String{ .data = "undefined" };
pub fn clone(str: *const String, allocator: std.mem.Allocator) !String {
return String{
.data = try allocator.dupe(u8, str.data),
.prefer_template = str.prefer_template,
.is_utf16 = !str.isUTF8(),
};
}
pub fn cloneSliceIfNecessary(str: *const String, allocator: std.mem.Allocator) !bun.string {
if (Expr.Data.Store.memory_allocator) |mem| {
if (mem == GlobalStoreHandle.global_store_ast) {
return str.string(allocator);
}
}
if (str.isUTF8()) {
return allocator.dupe(u8, str.string(allocator) catch unreachable);
}
return str.string(allocator);
}
pub fn javascriptLength(s: *const String) u32 {
if (s.rope_len > 0) {
// We only support ascii ropes for now
return s.rope_len;
}
if (s.isUTF8()) {
if (comptime !Environment.isNative) {
var allocated = (strings.toUTF16Alloc(bun.default_allocator, s.data, false) catch return 0) orelse return s.data.len;
defer bun.default_allocator.free(allocated);
return @as(u32, @truncate(allocated.len));
}
return @as(u32, @truncate(bun.simdutf.length.utf16.from.utf8.le(s.data)));
}
return @as(u32, @truncate(s.slice16().len));
}
pub inline fn len(s: *const String) usize {
return if (s.rope_len > 0) s.rope_len else s.data.len;
}
pub inline fn isUTF8(s: *const String) bool {
return !s.is_utf16;
}
pub inline fn isBlank(s: *const String) bool {
return s.len() == 0;
}
pub inline fn isPresent(s: *const String) bool {
return s.len() > 0;
}
pub fn eql(s: *const String, comptime _t: type, other: anytype) bool {
if (s.isUTF8()) {
switch (_t) {
@This() => {
if (other.isUTF8()) {
return strings.eqlLong(s.data, other.data, true);
} else {
return strings.utf16EqlString(other.slice16(), s.data);
}
},
bun.string => {
return strings.eqlLong(s.data, other, true);
},
[]u16, []const u16 => {
return strings.utf16EqlString(other, s.data);
},
else => {
@compileError("Invalid type");
},
}
} else {
switch (_t) {
@This() => {
if (other.isUTF8()) {
return strings.utf16EqlString(s.slice16(), other.data);
} else {
return std.mem.eql(u16, other.slice16(), s.slice16());
}
},
bun.string => {
return strings.utf16EqlString(s.slice16(), other);
},
[]u16, []const u16 => {
return std.mem.eql(u16, other.slice16(), s.slice16());
},
else => {
@compileError("Invalid type");
},
}
}
}
pub fn eqlComptime(s: *const String, comptime value: anytype) bool {
return if (s.isUTF8())
strings.eqlComptime(s.data, value)
else
strings.eqlComptimeUTF16(s.slice16(), value);
}
pub fn hasPrefixComptime(s: *const String, comptime value: anytype) bool {
if (s.data.len < value.len)
return false;
return if (s.isUTF8())
strings.eqlComptime(s.data[0..value.len], value)
else
strings.eqlComptimeUTF16(s.slice16()[0..value.len], value);
}
pub fn string(s: *const String, allocator: std.mem.Allocator) !bun.string {
if (s.isUTF8()) {
return s.data;
} else {
return strings.toUTF8Alloc(allocator, s.slice16());
}
}
pub fn stringCloned(s: *const String, allocator: std.mem.Allocator) !bun.string {
if (s.isUTF8()) {
return try allocator.dupe(u8, s.data);
} else {
return strings.toUTF8Alloc(allocator, s.slice16());
}
}
pub fn hash(s: *const String) u64 {
if (s.isBlank()) return 0;
if (s.isUTF8()) {
// hash utf-8
return bun.hash(s.data);
} else {
// hash utf-16
return bun.hash(@as([*]const u8, @ptrCast(s.slice16().ptr))[0 .. s.slice16().len * 2]);
}
}
pub fn toJS(s: *String, allocator: std.mem.Allocator, globalObject: *JSC.JSGlobalObject) JSC.JSValue {
if (!s.isPresent()) {
var emp = bun.String.empty;
return emp.toJS(globalObject);
}
if (s.is_utf16) {
var out = bun.String.createUninitializedUTF16(s.len());
defer out.deref();
@memcpy(@constCast(out.utf16()), s.slice16());
return out.toJS(globalObject);
}
{
s.resolveRopeIfNeeded(allocator);
const decoded = js_lexer.decodeUTF8(s.slice(allocator), allocator) catch unreachable;
defer allocator.free(decoded);
var out = bun.String.createUninitializedUTF16(decoded.len);
defer out.deref();
@memcpy(@constCast(out.utf16()), decoded);
return out.toJS(globalObject);
}
}
pub fn toZigString(s: *String, allocator: std.mem.Allocator) JSC.ZigString {
if (s.isUTF8()) {
return JSC.ZigString.fromUTF8(s.slice(allocator));
} else {
return JSC.ZigString.init16(s.slice16());
}
}
pub fn jsonStringify(s: *const String, writer: anytype) !void {
var buf = [_]u8{0} ** 4096;
var i: usize = 0;
for (s.slice16()) |char| {
buf[i] = @as(u8, @intCast(char));
i += 1;
if (i >= 4096) {
break;
}
}
return try writer.write(buf[0..i]);
}
};
// value is in the Node
pub const TemplatePart = struct {
value: ExprNodeIndex,
tail_loc: logger.Loc,
tail: Template.Contents,
};
pub const Template = struct {
tag: ?ExprNodeIndex = null,
parts: []TemplatePart = &([_]TemplatePart{}),
head: Contents,
pub const Contents = union(Tag) {
cooked: E.String,
raw: string,
const Tag = enum {
cooked,
raw,
};
};
/// "`a${'b'}c`" => "`abc`"
pub fn fold(
this: *Template,
allocator: std.mem.Allocator,
loc: logger.Loc,
) Expr {
if (this.tag != null or (this.head == .cooked and !this.head.cooked.isUTF8())) {
// we only fold utf-8/ascii for now
return Expr{
.data = .{
.e_template = this,
},
.loc = loc,
};
}
std.debug.assert(this.head == .cooked);
if (this.parts.len == 0) {
return Expr.init(E.String, this.head.cooked, loc);
}
var parts = std.ArrayList(TemplatePart).initCapacity(allocator, this.parts.len) catch unreachable;
var head = Expr.init(E.String, this.head.cooked, loc);
for (this.parts) |part_| {
var part = part_;
std.debug.assert(part.tail == .cooked);
switch (part.value.data) {
.e_number => {
if (part.value.data.e_number.toStringSafely(allocator)) |s| {
part.value = Expr.init(E.String, E.String.init(s), part.value.loc);
}
},
.e_null => {
part.value = Expr.init(E.String, E.String.init("null"), part.value.loc);
},
.e_boolean => {
part.value = Expr.init(E.String, E.String.init(if (part.value.data.e_boolean.value)
"true"
else
"false"), part.value.loc);
},
.e_undefined => {
part.value = Expr.init(E.String, E.String.init("undefined"), part.value.loc);
},
else => {},
}
if (part.value.data == .e_string and part.tail.cooked.isUTF8() and part.value.data.e_string.isUTF8()) {
if (parts.items.len == 0) {
if (part.value.data.e_string.len() > 0) {
head.data.e_string.push(Expr.init(E.String, part.value.data.e_string.*, logger.Loc.Empty).data.e_string);
}
if (part.tail.cooked.len() > 0) {
head.data.e_string.push(Expr.init(E.String, part.tail.cooked, part.tail_loc).data.e_string);
}
continue;
} else {
var prev_part = &parts.items[parts.items.len - 1];
std.debug.assert(prev_part.tail == .cooked);
if (prev_part.tail.cooked.isUTF8()) {
if (part.value.data.e_string.len() > 0) {
prev_part.tail.cooked.push(Expr.init(E.String, part.value.data.e_string.*, logger.Loc.Empty).data.e_string);
}
if (part.tail.cooked.len() > 0) {
prev_part.tail.cooked.push(Expr.init(E.String, part.tail.cooked, part.tail_loc).data.e_string);
}
} else {
parts.appendAssumeCapacity(part);
}
}
} else {
parts.appendAssumeCapacity(part);
}
}
if (parts.items.len == 0) {
parts.deinit();
head.data.e_string.resolveRopeIfNeeded(allocator);
return head;
}
return Expr.init(
E.Template,
E.Template{
.tag = null,
.parts = parts.items,
.head = .{ .cooked = head.data.e_string.* },
},
loc,
);
}
};
pub const RegExp = struct {
value: string,
// This exists for JavaScript bindings
// The RegExp constructor expects flags as a second argument.
// We want to avoid re-lexing the flags, so we store them here.
// This is the index of the first character in a flag, not the "/"
// /foo/gim
// ^
flags_offset: ?u16 = null,
pub var empty = RegExp{ .value = "" };
pub fn pattern(this: RegExp) string {
// rewind until we reach the /foo/gim
// ^
// should only ever be a single character
// but we're being cautious
if (this.flags_offset) |i_| {
var i = i_;
while (i > 0 and this.value[i] != '/') {
i -= 1;
}
return std.mem.trim(u8, this.value[0..i], "/");
}
return std.mem.trim(u8, this.value, "/");
}
pub fn flags(this: RegExp) string {
// rewind until we reach the /foo/gim
// ^
// should only ever be a single character
// but we're being cautious
if (this.flags_offset) |i| {
return this.value[i..];
}
return "";
}
pub fn jsonStringify(self: *const RegExp, writer: anytype) !void {
return try writer.write(self.value);
}
};
pub const Class = G.Class;
pub const Await = struct {
value: ExprNodeIndex,
};
pub const Yield = struct {
value: ?ExprNodeIndex = null,
is_star: bool = false,
};
pub const If = struct {
test_: ExprNodeIndex,
yes: ExprNodeIndex,
no: ExprNodeIndex,
};
pub const RequireString = struct {
import_record_index: u32 = 0,
unwrapped_id: u32 = std.math.maxInt(u32),
};
pub const RequireResolveString = struct {
import_record_index: u32 = 0,
/// TODO:
close_paren_loc: logger.Loc = logger.Loc.Empty,
};
pub const Import = struct {
expr: ExprNodeIndex,
import_record_index: u32,
/// Comments inside "import()" expressions have special meaning for Webpack.
/// Preserving comments inside these expressions makes it possible to use
/// esbuild as a TypeScript-to-JavaScript frontend for Webpack to improve
/// performance. We intentionally do not interpret these comments in esbuild
/// because esbuild is not Webpack. But we do preserve them since doing so is
/// harmless, easy to maintain, and useful to people. See the Webpack docs for
/// more info: https://webpack.js.org/api/module-methods/#magic-comments.
/// TODO:
leading_interior_comments: []G.Comment = &([_]G.Comment{}),
pub fn isImportRecordNull(this: *const Import) bool {
return this.import_record_index == std.math.maxInt(u32);
}
};
};
pub const Stmt = struct {
loc: logger.Loc,
data: Data,
pub const Batcher = bun.Batcher(Stmt);
pub fn assign(a: Expr, b: Expr, allocator: std.mem.Allocator) Stmt {
return Stmt.alloc(
S.SExpr,
S.SExpr{
.value = Expr.assign(a, b, allocator),
},
a.loc,
);
}
const Serializable = struct {
type: Tag,
object: string,
value: Data,
loc: logger.Loc,
};
pub fn jsonStringify(self: *const Stmt, writer: anytype) !void {
return try writer.write(Serializable{ .type = std.meta.activeTag(self.data), .object = "stmt", .value = self.data, .loc = self.loc });
}
pub fn isTypeScript(self: *Stmt) bool {
return @as(Stmt.Tag, self.data) == .s_type_script;
}
pub fn isSuperCall(self: Stmt) bool {
return self.data == .s_expr and self.data.s_expr.value.data == .e_call and self.data.s_expr.value.data.e_call.target.data == .e_super;
}
pub fn isMissingExpr(self: Stmt) bool {
return self.data == .s_expr and self.data.s_expr.value.data == .e_missing;
}
pub fn empty() Stmt {
return Stmt{ .data = .{ .s_empty = None }, .loc = logger.Loc{} };
}
pub fn toEmpty(this: Stmt) Stmt {
return .{
.data = .{
.s_empty = None,
},
.loc = this.loc,
};
}
const None = S.Empty{};
pub var icount: usize = 0;
pub fn init(comptime StatementType: type, origData: *StatementType, loc: logger.Loc) Stmt {
icount += 1;
return switch (comptime StatementType) {
S.Empty => Stmt{ .loc = loc, .data = Data{ .s_empty = S.Empty{} } },
S.Block => Stmt.comptime_init("s_block", S.Block, origData, loc),
S.Break => Stmt.comptime_init("s_break", S.Break, origData, loc),
S.Class => Stmt.comptime_init("s_class", S.Class, origData, loc),
S.Comment => Stmt.comptime_init("s_comment", S.Comment, origData, loc),
S.Continue => Stmt.comptime_init("s_continue", S.Continue, origData, loc),
S.Debugger => Stmt.comptime_init("s_debugger", S.Debugger, origData, loc),
S.Directive => Stmt.comptime_init("s_directive", S.Directive, origData, loc),
S.DoWhile => Stmt.comptime_init("s_do_while", S.DoWhile, origData, loc),
S.Enum => Stmt.comptime_init("s_enum", S.Enum, origData, loc),
S.ExportClause => Stmt.comptime_init("s_export_clause", S.ExportClause, origData, loc),
S.ExportDefault => Stmt.comptime_init("s_export_default", S.ExportDefault, origData, loc),
S.ExportEquals => Stmt.comptime_init("s_export_equals", S.ExportEquals, origData, loc),
S.ExportFrom => Stmt.comptime_init("s_export_from", S.ExportFrom, origData, loc),
S.ExportStar => Stmt.comptime_init("s_export_star", S.ExportStar, origData, loc),
S.SExpr => Stmt.comptime_init("s_expr", S.SExpr, origData, loc),
S.ForIn => Stmt.comptime_init("s_for_in", S.ForIn, origData, loc),
S.ForOf => Stmt.comptime_init("s_for_of", S.ForOf, origData, loc),
S.For => Stmt.comptime_init("s_for", S.For, origData, loc),
S.Function => Stmt.comptime_init("s_function", S.Function, origData, loc),
S.If => Stmt.comptime_init("s_if", S.If, origData, loc),
S.Import => Stmt.comptime_init("s_import", S.Import, origData, loc),
S.Label => Stmt.comptime_init("s_label", S.Label, origData, loc),
S.Local => Stmt.comptime_init("s_local", S.Local, origData, loc),
S.Namespace => Stmt.comptime_init("s_namespace", S.Namespace, origData, loc),
S.Return => Stmt.comptime_init("s_return", S.Return, origData, loc),
S.Switch => Stmt.comptime_init("s_switch", S.Switch, origData, loc),
S.Throw => Stmt.comptime_init("s_throw", S.Throw, origData, loc),
S.Try => Stmt.comptime_init("s_try", S.Try, origData, loc),
S.TypeScript => Stmt.comptime_init("s_type_script", S.TypeScript, origData, loc),
S.While => Stmt.comptime_init("s_while", S.While, origData, loc),
S.With => Stmt.comptime_init("s_with", S.With, origData, loc),
else => @compileError("Invalid type in Stmt.init"),
};
}
inline fn comptime_alloc(comptime tag_name: string, comptime typename: type, origData: anytype, loc: logger.Loc) Stmt {
return Stmt{
.loc = loc,
.data = @unionInit(
Data,
tag_name,
Data.Store.append(
typename,
origData,
),
),
};
}
fn allocateData(allocator: std.mem.Allocator, comptime tag_name: string, comptime typename: type, origData: anytype, loc: logger.Loc) Stmt {
var value = allocator.create(@TypeOf(origData)) catch unreachable;
value.* = origData;
return comptime_init(tag_name, *typename, value, loc);
}
inline fn comptime_init(comptime tag_name: string, comptime TypeName: type, origData: TypeName, loc: logger.Loc) Stmt {
return Stmt{ .loc = loc, .data = @unionInit(Data, tag_name, origData) };
}
pub fn alloc(comptime StatementData: type, origData: StatementData, loc: logger.Loc) Stmt {
Stmt.Data.Store.assert();
icount += 1;
return switch (StatementData) {
S.Block => Stmt.comptime_alloc("s_block", S.Block, origData, loc),
S.Break => Stmt.comptime_alloc("s_break", S.Break, origData, loc),
S.Class => Stmt.comptime_alloc("s_class", S.Class, origData, loc),
S.Comment => Stmt.comptime_alloc("s_comment", S.Comment, origData, loc),
S.Continue => Stmt.comptime_alloc("s_continue", S.Continue, origData, loc),
S.Debugger => Stmt{ .loc = loc, .data = .{ .s_debugger = origData } },
S.Directive => Stmt.comptime_alloc("s_directive", S.Directive, origData, loc),
S.DoWhile => Stmt.comptime_alloc("s_do_while", S.DoWhile, origData, loc),
S.Empty => Stmt{ .loc = loc, .data = Data{ .s_empty = S.Empty{} } },
S.Enum => Stmt.comptime_alloc("s_enum", S.Enum, origData, loc),
S.ExportClause => Stmt.comptime_alloc("s_export_clause", S.ExportClause, origData, loc),
S.ExportDefault => Stmt.comptime_alloc("s_export_default", S.ExportDefault, origData, loc),
S.ExportEquals => Stmt.comptime_alloc("s_export_equals", S.ExportEquals, origData, loc),
S.ExportFrom => Stmt.comptime_alloc("s_export_from", S.ExportFrom, origData, loc),
S.ExportStar => Stmt.comptime_alloc("s_export_star", S.ExportStar, origData, loc),
S.SExpr => Stmt.comptime_alloc("s_expr", S.SExpr, origData, loc),
S.ForIn => Stmt.comptime_alloc("s_for_in", S.ForIn, origData, loc),
S.ForOf => Stmt.comptime_alloc("s_for_of", S.ForOf, origData, loc),
S.For => Stmt.comptime_alloc("s_for", S.For, origData, loc),
S.Function => Stmt.comptime_alloc("s_function", S.Function, origData, loc),
S.If => Stmt.comptime_alloc("s_if", S.If, origData, loc),
S.Import => Stmt.comptime_alloc("s_import", S.Import, origData, loc),
S.Label => Stmt.comptime_alloc("s_label", S.Label, origData, loc),
S.Local => Stmt.comptime_alloc("s_local", S.Local, origData, loc),
S.Namespace => Stmt.comptime_alloc("s_namespace", S.Namespace, origData, loc),
S.Return => Stmt.comptime_alloc("s_return", S.Return, origData, loc),
S.Switch => Stmt.comptime_alloc("s_switch", S.Switch, origData, loc),
S.Throw => Stmt.comptime_alloc("s_throw", S.Throw, origData, loc),
S.Try => Stmt.comptime_alloc("s_try", S.Try, origData, loc),
S.TypeScript => Stmt{ .loc = loc, .data = Data{ .s_type_script = S.TypeScript{} } },
S.While => Stmt.comptime_alloc("s_while", S.While, origData, loc),
S.With => Stmt.comptime_alloc("s_with", S.With, origData, loc),
else => @compileError("Invalid type in Stmt.init"),
};
}
pub const Disabler = bun.DebugOnlyDisabler(@This());
/// When the lifetime of an Stmt.Data's pointer must exist longer than reset() is called, use this function.
/// Be careful to free the memory (or use an allocator that does it for you)
/// Also, prefer Stmt.init or Stmt.alloc when possible. This will be slower.
pub fn allocate(allocator: std.mem.Allocator, comptime StatementData: type, origData: StatementData, loc: logger.Loc) Stmt {
Stmt.Data.Store.assert();
icount += 1;
return switch (StatementData) {
S.Block => Stmt.allocateData(allocator, "s_block", S.Block, origData, loc),
S.Break => Stmt.allocateData(allocator, "s_break", S.Break, origData, loc),
S.Class => Stmt.allocateData(allocator, "s_class", S.Class, origData, loc),
S.Comment => Stmt.allocateData(allocator, "s_comment", S.Comment, origData, loc),
S.Continue => Stmt.allocateData(allocator, "s_continue", S.Continue, origData, loc),
S.Debugger => Stmt{ .loc = loc, .data = .{ .s_debugger = origData } },
S.Directive => Stmt.allocateData(allocator, "s_directive", S.Directive, origData, loc),
S.DoWhile => Stmt.allocateData(allocator, "s_do_while", S.DoWhile, origData, loc),
S.Empty => Stmt{ .loc = loc, .data = Data{ .s_empty = S.Empty{} } },
S.Enum => Stmt.allocateData(allocator, "s_enum", S.Enum, origData, loc),
S.ExportClause => Stmt.allocateData(allocator, "s_export_clause", S.ExportClause, origData, loc),
S.ExportDefault => Stmt.allocateData(allocator, "s_export_default", S.ExportDefault, origData, loc),
S.ExportEquals => Stmt.allocateData(allocator, "s_export_equals", S.ExportEquals, origData, loc),
S.ExportFrom => Stmt.allocateData(allocator, "s_export_from", S.ExportFrom, origData, loc),
S.ExportStar => Stmt.allocateData(allocator, "s_export_star", S.ExportStar, origData, loc),
S.SExpr => Stmt.allocateData(allocator, "s_expr", S.SExpr, origData, loc),
S.ForIn => Stmt.allocateData(allocator, "s_for_in", S.ForIn, origData, loc),
S.ForOf => Stmt.allocateData(allocator, "s_for_of", S.ForOf, origData, loc),
S.For => Stmt.allocateData(allocator, "s_for", S.For, origData, loc),
S.Function => Stmt.allocateData(allocator, "s_function", S.Function, origData, loc),
S.If => Stmt.allocateData(allocator, "s_if", S.If, origData, loc),
S.Import => Stmt.allocateData(allocator, "s_import", S.Import, origData, loc),
S.Label => Stmt.allocateData(allocator, "s_label", S.Label, origData, loc),
S.Local => Stmt.allocateData(allocator, "s_local", S.Local, origData, loc),
S.Namespace => Stmt.allocateData(allocator, "s_namespace", S.Namespace, origData, loc),
S.Return => Stmt.allocateData(allocator, "s_return", S.Return, origData, loc),
S.Switch => Stmt.allocateData(allocator, "s_switch", S.Switch, origData, loc),
S.Throw => Stmt.allocateData(allocator, "s_throw", S.Throw, origData, loc),
S.Try => Stmt.allocateData(allocator, "s_try", S.Try, origData, loc),
S.TypeScript => Stmt{ .loc = loc, .data = Data{ .s_type_script = S.TypeScript{} } },
S.While => Stmt.allocateData(allocator, "s_while", S.While, origData, loc),
S.With => Stmt.allocateData(allocator, "s_with", S.With, origData, loc),
else => @compileError("Invalid type in Stmt.init"),
};
}
pub const Tag = enum(u6) {
s_block,
s_break,
s_class,
s_comment,
s_continue,
s_directive,
s_do_while,
s_enum,
s_export_clause,
s_export_default,
s_export_equals,
s_export_from,
s_export_star,
s_expr,
s_for_in,
s_for_of,
s_for,
s_function,
s_if,
s_import,
s_label,
s_local,
s_namespace,
s_return,
s_switch,
s_throw,
s_try,
s_while,
s_with,
s_type_script,
s_empty,
s_debugger,
s_lazy_export,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
pub fn isExportLike(tag: Tag) bool {
return switch (tag) {
.s_export_clause, .s_export_default, .s_export_equals, .s_export_from, .s_export_star, .s_empty => true,
else => false,
};
}
};
pub const Data = union(Tag) {
s_block: *S.Block,
s_break: *S.Break,
s_class: *S.Class,
s_comment: *S.Comment,
s_continue: *S.Continue,
s_directive: *S.Directive,
s_do_while: *S.DoWhile,
s_enum: *S.Enum,
s_export_clause: *S.ExportClause,
s_export_default: *S.ExportDefault,
s_export_equals: *S.ExportEquals,
s_export_from: *S.ExportFrom,
s_export_star: *S.ExportStar,
s_expr: *S.SExpr,
s_for_in: *S.ForIn,
s_for_of: *S.ForOf,
s_for: *S.For,
s_function: *S.Function,
s_if: *S.If,
s_import: *S.Import,
s_label: *S.Label,
s_local: *S.Local,
s_namespace: *S.Namespace,
s_return: *S.Return,
s_switch: *S.Switch,
s_throw: *S.Throw,
s_try: *S.Try,
s_while: *S.While,
s_with: *S.With,
s_type_script: S.TypeScript,
s_empty: S.Empty, // special case, its a zero value type
s_debugger: S.Debugger,
s_lazy_export: Expr.Data,
pub const Store = struct {
const Union = [_]type{
S.Block,
S.Break,
S.Class,
S.Comment,
S.Continue,
S.Directive,
S.DoWhile,
S.Enum,
S.ExportClause,
S.ExportDefault,
S.ExportEquals,
S.ExportFrom,
S.ExportStar,
S.SExpr,
S.ForIn,
S.ForOf,
S.For,
S.Function,
S.If,
S.Import,
S.Label,
S.Local,
S.Namespace,
S.Return,
S.Switch,
S.Throw,
S.Try,
S.TypeScript,
S.While,
S.With,
};
const All = NewBaseStore(Union, 128);
pub threadlocal var memory_allocator: ?*ASTMemoryAllocator = null;
threadlocal var has_inited = false;
pub threadlocal var disable_reset = false;
pub fn create(allocator: std.mem.Allocator) void {
if (has_inited or memory_allocator != null) {
return;
}
has_inited = true;
_ = All.init(allocator);
}
pub fn reset() void {
if (disable_reset or memory_allocator != null) return;
All.reset();
}
pub fn deinit() void {
if (!has_inited or memory_allocator != null) return;
All.deinit();
has_inited = false;
}
pub inline fn assert() void {
if (comptime Environment.allow_assert) {
if (!has_inited and memory_allocator == null)
bun.unreachablePanic("Store must be init'd", .{});
}
}
pub fn append(comptime ValueType: type, value: anytype) *ValueType {
if (memory_allocator) |allocator| {
return allocator.append(ValueType, value);
}
return All.append(Disabler, ValueType, value);
}
pub fn toOwnedSlice() []*Store.All.Block {
if (!has_inited or Store.All._self.overflow.used == 0 or disable_reset) return &[_]*Store.All.Block{};
return Store.All.reclaim();
}
};
};
pub fn caresAboutScope(self: *Stmt) bool {
return switch (self.data) {
.s_block, .s_empty, .s_debugger, .s_expr, .s_if, .s_for, .s_for_in, .s_for_of, .s_do_while, .s_while, .s_with, .s_try, .s_switch, .s_return, .s_throw, .s_break, .s_continue, .s_directive => {
return false;
},
.s_local => |local| {
return local.kind != S.Kind.k_var;
},
else => {
return true;
},
};
}
};
pub const Expr = struct {
loc: logger.Loc,
data: Data,
pub fn isAnonymousNamed(expr: Expr) bool {
return switch (expr.data) {
.e_arrow => true,
.e_function => |func| func.func.name == null,
.e_class => |class| class.class_name == null,
else => false,
};
}
pub fn clone(this: Expr, allocator: std.mem.Allocator) !Expr {
return .{
.loc = this.loc,
.data = try this.data.clone(allocator),
};
}
pub fn wrapInArrow(this: Expr, allocator: std.mem.Allocator) !Expr {
var stmts = try allocator.alloc(Stmt, 1);
stmts[0] = Stmt.alloc(S.Return, S.Return{ .value = this }, this.loc);
return Expr.init(E.Arrow, E.Arrow{
.args = &.{},
.body = .{
.loc = this.loc,
.stmts = stmts,
},
}, this.loc);
}
pub fn canBeInlinedFromPropertyAccess(this: Expr) bool {
return switch (this.data) {
// if the array has a spread we must keep it
// https://github.com/oven-sh/bun/issues/2594
.e_spread => false,
.e_missing => false,
else => true,
};
}
pub fn canBeConstValue(this: Expr) bool {
return this.data.canBeConstValue();
}
pub fn fromBlob(
blob: *const JSC.WebCore.Blob,
allocator: std.mem.Allocator,
mime_type_: ?HTTP.MimeType,
log: *logger.Log,
loc: logger.Loc,
) !Expr {
var bytes = blob.sharedView();
const mime_type = mime_type_ orelse HTTP.MimeType.init(blob.content_type, null, null);
if (mime_type.category == .json) {
var source = logger.Source.initPathString("fetch.json", bytes);
var out_expr = JSONParser.ParseJSONForMacro(&source, log, allocator) catch {
return error.MacroFailed;
};
out_expr.loc = loc;
switch (out_expr.data) {
.e_object => {
out_expr.data.e_object.was_originally_macro = true;
},
.e_array => {
out_expr.data.e_array.was_originally_macro = true;
},
else => {},
}
return out_expr;
}
if (mime_type.category.isTextLike()) {
var output = MutableString.initEmpty(allocator);
output = try JSPrinter.quoteForJSON(bytes, output, true);
var list = output.toOwnedSlice();
// remove the quotes
if (list.len > 0) {
list = list[1 .. list.len - 1];
}
return Expr.init(E.String, E.String.init(list), loc);
}
return Expr.init(
E.String,
E.String{
.data = try JSC.ZigString.init(bytes).toBase64DataURL(allocator),
},
loc,
);
}
pub inline fn initIdentifier(ref: Ref, loc: logger.Loc) Expr {
return Expr{
.loc = loc,
.data = .{
.e_identifier = E.Identifier.init(ref),
},
};
}
pub fn toEmpty(expr: Expr) Expr {
return Expr{ .data = .{ .e_missing = E.Missing{} }, .loc = expr.loc };
}
pub fn isEmpty(expr: Expr) bool {
return expr.data == .e_missing;
}
pub const Query = struct { expr: Expr, loc: logger.Loc, i: u32 = 0 };
pub fn hasAnyPropertyNamed(expr: *const Expr, comptime names: []const string) bool {
if (std.meta.activeTag(expr.data) != .e_object) return false;
const obj = expr.data.e_object;
if (@intFromPtr(obj.properties.ptr) == 0) return false;
for (obj.properties.slice()) |prop| {
if (prop.value == null) continue;
const key = prop.key orelse continue;
if (std.meta.activeTag(key.data) != .e_string) continue;
const key_str = key.data.e_string;
if (strings.eqlAnyComptime(key_str.data, names)) return true;
}
return false;
}
pub fn toJS(this: Expr, allocator: std.mem.Allocator, globalObject: *JSC.JSGlobalObject) ToJSError!JSC.JSValue {
return this.data.toJS(allocator, globalObject);
}
pub fn get(expr: *const Expr, name: string) ?Expr {
return if (asProperty(expr, name)) |query| query.expr else null;
}
pub fn getRope(self: *const Expr, rope: *const E.Object.Rope) ?E.Object.RopeQuery {
if (self.get(rope.head.data.e_string.data)) |existing| {
switch (existing.data) {
.e_array => |array| {
if (rope.next) |next| {
if (array.items.last()) |end| {
return end.getRope(next);
}
}
return E.Object.RopeQuery{
.expr = existing,
.rope = rope,
};
},
.e_object => {
if (rope.next) |next| {
if (existing.getRope(next)) |end| {
return end;
}
}
return E.Object.RopeQuery{
.expr = existing,
.rope = rope,
};
},
else => return E.Object.RopeQuery{
.expr = existing,
.rope = rope,
},
}
}
return null;
}
// Making this comptime bloats the binary and doesn't seem to impact runtime performance.
pub fn asProperty(expr: *const Expr, name: string) ?Query {
if (std.meta.activeTag(expr.data) != .e_object) return null;
const obj = expr.data.e_object;
if (@intFromPtr(obj.properties.ptr) == 0) return null;
return obj.asProperty(name);
}
pub const ArrayIterator = struct {
array: *const E.Array,
index: u32,
pub fn next(this: *ArrayIterator) ?Expr {
if (this.index >= this.array.items.len) {
return null;
}
defer this.index += 1;
return this.array.items.ptr[this.index];
}
};
pub fn asArray(expr: *const Expr) ?ArrayIterator {
if (std.meta.activeTag(expr.data) != .e_array) return null;
const array = expr.data.e_array;
if (array.items.len == 0 or @intFromPtr(array.items.ptr) == 0) return null;
return ArrayIterator{ .array = array, .index = 0 };
}
pub inline fn asString(expr: *const Expr, allocator: std.mem.Allocator) ?string {
if (std.meta.activeTag(expr.data) != .e_string) return null;
return expr.data.e_string.string(allocator) catch null;
}
pub fn asBool(
expr: *const Expr,
) ?bool {
if (std.meta.activeTag(expr.data) != .e_boolean) return null;
return expr.data.e_boolean.value;
}
pub const EFlags = enum { none, ts_decorator };
const Serializable = struct {
type: Tag,
object: string,
value: Data,
loc: logger.Loc,
};
pub fn isMissing(a: *const Expr) bool {
return std.meta.activeTag(a.data) == Expr.Tag.e_missing;
}
// The goal of this function is to "rotate" the AST if it's possible to use the
// left-associative property of the operator to avoid unnecessary parentheses.
//
// When using this, make absolutely sure that the operator is actually
// associative. For example, the "-" operator is not associative for
// floating-point numbers.
pub fn joinWithLeftAssociativeOp(
comptime op: Op.Code,
a: Expr,
b: Expr,
allocator: std.mem.Allocator,
) Expr {
// "(a, b) op c" => "a, b op c"
switch (a.data) {
.e_binary => |comma| {
if (comma.op == .bin_comma) {
comma.right = joinWithLeftAssociativeOp(op, comma.right, b, allocator);
}
},
else => {},
}
// "a op (b op c)" => "(a op b) op c"
// "a op (b op (c op d))" => "((a op b) op c) op d"
switch (b.data) {
.e_binary => |binary| {
if (binary.op == op) {
return joinWithLeftAssociativeOp(
op,
joinWithLeftAssociativeOp(op, a, binary.left, allocator),
binary.right,
allocator,
);
}
},
else => {},
}
// "a op b" => "a op b"
// "(a op b) op c" => "(a op b) op c"
return Expr.init(E.Binary, E.Binary{ .op = op, .left = a, .right = b }, a.loc);
}
pub fn joinWithComma(a: Expr, b: Expr, _: std.mem.Allocator) Expr {
if (a.isMissing()) {
return b;
}
if (b.isMissing()) {
return a;
}
return Expr.init(E.Binary, E.Binary{ .op = .bin_comma, .left = a, .right = b }, a.loc);
}
pub fn joinAllWithComma(all: []Expr, allocator: std.mem.Allocator) Expr {
std.debug.assert(all.len > 0);
switch (all.len) {
1 => {
return all[0];
},
2 => {
return Expr.joinWithComma(all[0], all[1], allocator);
},
else => {
var i: usize = 1;
var expr = all[0];
while (i < all.len) : (i += 1) {
expr = Expr.joinWithComma(expr, all[i], allocator);
}
return expr;
},
}
}
pub fn joinAllWithCommaCallback(all: []Expr, comptime Context: type, ctx: Context, comptime callback: (fn (ctx: anytype, expr: Expr) ?Expr), allocator: std.mem.Allocator) ?Expr {
switch (all.len) {
0 => return null,
1 => {
return callback(ctx, all[0]);
},
2 => {
return Expr.joinWithComma(
callback(ctx, all[0]) orelse Expr{
.data = .{ .e_missing = .{} },
.loc = all[0].loc,
},
callback(ctx, all[1]) orelse Expr{
.data = .{ .e_missing = .{} },
.loc = all[1].loc,
},
allocator,
);
},
else => {
var i: usize = 1;
var expr = callback(ctx, all[0]) orelse Expr{
.data = .{ .e_missing = .{} },
.loc = all[0].loc,
};
while (i < all.len) : (i += 1) {
expr = Expr.joinWithComma(expr, callback(ctx, all[i]) orelse Expr{
.data = .{ .e_missing = .{} },
.loc = all[i].loc,
}, allocator);
}
return expr;
},
}
}
pub fn jsonStringify(self: *const @This(), writer: anytype) !void {
return try writer.write(Serializable{ .type = std.meta.activeTag(self.data), .object = "expr", .value = self.data, .loc = self.loc });
}
pub fn extractNumericValues(left: Expr.Data, right: Expr.Data) ?[2]f64 {
if (!(@as(Expr.Tag, left) == .e_number and @as(Expr.Tag, right) == .e_number)) {
return null;
}
return [2]f64{ left.e_number.value, right.e_number.value };
}
pub var icount: usize = 0;
// We don't need to dynamically allocate booleans
var true_bool = E.Boolean{ .value = true };
var false_bool = E.Boolean{ .value = false };
var bool_values = [_]*E.Boolean{ &false_bool, &true_bool };
/// When the lifetime of an Expr.Data's pointer must exist longer than reset() is called, use this function.
/// Be careful to free the memory (or use an allocator that does it for you)
/// Also, prefer Expr.init or Expr.alloc when possible. This will be slower.
pub fn allocate(allocator: std.mem.Allocator, comptime Type: type, st: Type, loc: logger.Loc) Expr {
icount += 1;
Data.Store.assert();
switch (Type) {
E.Array => {
return Expr{
.loc = loc,
.data = Data{
.e_array = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Class => {
return Expr{
.loc = loc,
.data = Data{
.e_class = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Unary => {
return Expr{
.loc = loc,
.data = Data{
.e_unary = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Binary => {
return Expr{
.loc = loc,
.data = Data{
.e_binary = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.This => {
return Expr{
.loc = loc,
.data = Data{
.e_this = st,
},
};
},
E.Boolean => {
return Expr{
.loc = loc,
.data = Data{
.e_boolean = st,
},
};
},
E.Super => {
return Expr{
.loc = loc,
.data = Data{
.e_super = st,
},
};
},
E.Null => {
return Expr{
.loc = loc,
.data = Data{
.e_null = st,
},
};
},
E.Undefined => {
return Expr{
.loc = loc,
.data = Data{
.e_undefined = st,
},
};
},
E.New => {
return Expr{
.loc = loc,
.data = Data{
.e_new = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.NewTarget => {
return Expr{
.loc = loc,
.data = Data{
.e_new_target = st,
},
};
},
E.Function => {
return Expr{
.loc = loc,
.data = Data{
.e_function = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.ImportMeta => {
return Expr{
.loc = loc,
.data = Data{
.e_import_meta = st,
},
};
},
E.Call => {
return Expr{
.loc = loc,
.data = Data{
.e_call = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Dot => {
return Expr{
.loc = loc,
.data = Data{
.e_dot = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Index => {
return Expr{
.loc = loc,
.data = Data{
.e_index = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Arrow => {
return Expr{
.loc = loc,
.data = Data{
.e_arrow = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Identifier => {
return Expr{
.loc = loc,
.data = Data{
.e_identifier = E.Identifier{
.ref = st.ref,
.must_keep_due_to_with_stmt = st.must_keep_due_to_with_stmt,
.can_be_removed_if_unused = st.can_be_removed_if_unused,
.call_can_be_unwrapped_if_unused = st.call_can_be_unwrapped_if_unused,
},
},
};
},
E.ImportIdentifier => {
return Expr{
.loc = loc,
.data = Data{
.e_import_identifier = .{
.ref = st.ref,
.was_originally_identifier = st.was_originally_identifier,
},
},
};
},
E.CommonJSExportIdentifier => {
return Expr{
.loc = loc,
.data = Data{
.e_commonjs_export_identifier = .{
.ref = st.ref,
},
},
};
},
E.PrivateIdentifier => {
return Expr{
.loc = loc,
.data = Data{
.e_private_identifier = st,
},
};
},
E.JSXElement => {
return Expr{
.loc = loc,
.data = Data{
.e_jsx_element = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Missing => {
return Expr{ .loc = loc, .data = Data{ .e_missing = E.Missing{} } };
},
E.Number => {
return Expr{
.loc = loc,
.data = Data{
.e_number = st,
},
};
},
E.BigInt => {
return Expr{
.loc = loc,
.data = Data{
.e_big_int = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Object => {
return Expr{
.loc = loc,
.data = Data{
.e_object = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Spread => {
return Expr{
.loc = loc,
.data = Data{
.e_spread = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.String => {
if (comptime Environment.isDebug) {
// Sanity check: assert string is not a null ptr
if (st.data.len > 0 and st.isUTF8()) {
std.debug.assert(@intFromPtr(st.data.ptr) > 0);
}
}
return Expr{
.loc = loc,
.data = Data{
.e_string = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.TemplatePart => {
return Expr{
.loc = loc,
.data = Data{
.e_template_part = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Template => {
return Expr{
.loc = loc,
.data = Data{
.e_template = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.RegExp => {
return Expr{
.loc = loc,
.data = Data{
.e_reg_exp = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Await => {
return Expr{
.loc = loc,
.data = Data{
.e_await = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.Yield => {
return Expr{
.loc = loc,
.data = Data{
.e_yield = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.If => {
return Expr{
.loc = loc,
.data = Data{
.e_if = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.RequireResolveString => {
return Expr{
.loc = loc,
.data = Data{
.e_require_resolve_string = st,
},
};
},
E.Import => {
return Expr{
.loc = loc,
.data = Data{
.e_import = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st;
break :brk item;
},
},
};
},
E.RequireString => {
return Expr{
.loc = loc,
.data = Data{
.e_require_string = st,
},
};
},
*E.String => {
return Expr{
.loc = loc,
.data = Data{
.e_string = brk: {
var item = allocator.create(Type) catch unreachable;
item.* = st.*;
break :brk item;
},
},
};
},
else => {
@compileError("Invalid type passed to Expr.init: " ++ @typeName(Type));
},
}
}
pub const Disabler = bun.DebugOnlyDisabler(@This());
pub fn init(comptime Type: type, st: Type, loc: logger.Loc) Expr {
icount += 1;
Data.Store.assert();
switch (Type) {
E.Array => {
return Expr{
.loc = loc,
.data = Data{
.e_array = Data.Store.append(Type, st),
},
};
},
E.Class => {
return Expr{
.loc = loc,
.data = Data{
.e_class = Data.Store.append(Type, st),
},
};
},
E.Unary => {
return Expr{
.loc = loc,
.data = Data{
.e_unary = Data.Store.append(Type, st),
},
};
},
E.Binary => {
return Expr{
.loc = loc,
.data = Data{
.e_binary = Data.Store.append(Type, st),
},
};
},
E.This => {
return Expr{
.loc = loc,
.data = Data{
.e_this = st,
},
};
},
E.Boolean => {
return Expr{
.loc = loc,
.data = Data{
.e_boolean = st,
},
};
},
E.Super => {
return Expr{
.loc = loc,
.data = Data{
.e_super = st,
},
};
},
E.Null => {
return Expr{
.loc = loc,
.data = Data{
.e_null = st,
},
};
},
E.Undefined => {
return Expr{
.loc = loc,
.data = Data{
.e_undefined = st,
},
};
},
E.New => {
return Expr{
.loc = loc,
.data = Data{
.e_new = Data.Store.append(Type, st),
},
};
},
E.NewTarget => {
return Expr{
.loc = loc,
.data = Data{
.e_new_target = st,
},
};
},
E.Function => {
return Expr{
.loc = loc,
.data = Data{
.e_function = Data.Store.append(Type, st),
},
};
},
E.ImportMeta => {
return Expr{
.loc = loc,
.data = Data{
.e_import_meta = st,
},
};
},
E.Call => {
return Expr{
.loc = loc,
.data = Data{
.e_call = Data.Store.append(Type, st),
},
};
},
E.Dot => {
return Expr{
.loc = loc,
.data = Data{
.e_dot = Data.Store.append(Type, st),
},
};
},
E.Index => {
return Expr{
.loc = loc,
.data = Data{
.e_index = Data.Store.append(Type, st),
},
};
},
E.Arrow => {
return Expr{
.loc = loc,
.data = Data{
.e_arrow = Data.Store.append(Type, st),
},
};
},
E.Identifier => {
return Expr{
.loc = loc,
.data = Data{
.e_identifier = E.Identifier{
.ref = st.ref,
.must_keep_due_to_with_stmt = st.must_keep_due_to_with_stmt,
.can_be_removed_if_unused = st.can_be_removed_if_unused,
.call_can_be_unwrapped_if_unused = st.call_can_be_unwrapped_if_unused,
},
},
};
},
E.ImportIdentifier => {
return Expr{
.loc = loc,
.data = Data{
.e_import_identifier = .{
.ref = st.ref,
.was_originally_identifier = st.was_originally_identifier,
},
},
};
},
E.CommonJSExportIdentifier => {
return Expr{
.loc = loc,
.data = Data{
.e_commonjs_export_identifier = .{
.ref = st.ref,
},
},
};
},
E.PrivateIdentifier => {
return Expr{
.loc = loc,
.data = Data{
.e_private_identifier = st,
},
};
},
E.JSXElement => {
return Expr{
.loc = loc,
.data = Data{
.e_jsx_element = Data.Store.append(Type, st),
},
};
},
E.Missing => {
return Expr{ .loc = loc, .data = Data{ .e_missing = E.Missing{} } };
},
E.Number => {
return Expr{
.loc = loc,
.data = Data{
.e_number = st,
},
};
},
E.BigInt => {
return Expr{
.loc = loc,
.data = Data{
.e_big_int = Data.Store.append(Type, st),
},
};
},
E.Object => {
return Expr{
.loc = loc,
.data = Data{
.e_object = Data.Store.append(Type, st),
},
};
},
E.Spread => {
return Expr{
.loc = loc,
.data = Data{
.e_spread = Data.Store.append(Type, st),
},
};
},
E.String => {
if (comptime Environment.isDebug) {
// Sanity check: assert string is not a null ptr
if (st.data.len > 0 and st.isUTF8()) {
std.debug.assert(@intFromPtr(st.data.ptr) > 0);
}
}
return Expr{
.loc = loc,
.data = Data{
.e_string = Data.Store.append(Type, st),
},
};
},
E.TemplatePart => {
return Expr{
.loc = loc,
.data = Data{
.e_template_part = Data.Store.append(Type, st),
},
};
},
E.Template => {
return Expr{
.loc = loc,
.data = Data{
.e_template = Data.Store.append(Type, st),
},
};
},
E.RegExp => {
return Expr{
.loc = loc,
.data = Data{
.e_reg_exp = Data.Store.append(Type, st),
},
};
},
E.Await => {
return Expr{
.loc = loc,
.data = Data{
.e_await = Data.Store.append(Type, st),
},
};
},
E.Yield => {
return Expr{
.loc = loc,
.data = Data{
.e_yield = Data.Store.append(Type, st),
},
};
},
E.If => {
return Expr{
.loc = loc,
.data = Data{
.e_if = Data.Store.append(Type, st),
},
};
},
E.RequireResolveString => {
return Expr{
.loc = loc,
.data = Data{
.e_require_resolve_string = st,
},
};
},
E.Import => {
return Expr{
.loc = loc,
.data = Data{
.e_import = Data.Store.append(Type, st),
},
};
},
E.RequireString => {
return Expr{
.loc = loc,
.data = Data{
.e_require_string = st,
},
};
},
*E.String => {
return Expr{
.loc = loc,
.data = Data{
.e_string = Data.Store.append(@TypeOf(st.*), st.*),
},
};
},
else => {
@compileError("Invalid type passed to Expr.init: " ++ @typeName(Type));
},
}
}
pub fn isPrimitiveLiteral(this: Expr) bool {
return @as(Tag, this.data).isPrimitiveLiteral();
}
pub fn isRef(this: Expr, ref: Ref) bool {
return switch (this.data) {
.e_import_identifier => |import_identifier| import_identifier.ref.eql(ref),
.e_identifier => |ident| ident.ref.eql(ref),
else => false,
};
}
pub const Tag = enum(u6) {
e_array,
e_unary,
e_binary,
e_class,
e_new,
e_function,
e_call,
e_dot,
e_index,
e_arrow,
e_jsx_element,
e_object,
e_spread,
e_template_part,
e_template,
e_reg_exp,
e_await,
e_yield,
e_if,
e_import,
e_identifier,
e_import_identifier,
e_private_identifier,
e_commonjs_export_identifier,
e_boolean,
e_number,
e_big_int,
e_string,
e_require_string,
e_require_resolve_string,
e_require_call_target,
e_require_resolve_call_target,
e_missing,
e_this,
e_super,
e_null,
e_undefined,
e_new_target,
e_import_meta,
// This should never make it to the printer
inline_identifier,
// object, regex and array may have had side effects
pub fn isPrimitiveLiteral(tag: Tag) bool {
return switch (tag) {
.e_null, .e_undefined, .e_string, .e_boolean, .e_number, .e_big_int => true,
else => false,
};
}
pub fn typeof(tag: Tag) ?string {
return switch (tag) {
.e_array, .e_object, .e_null, .e_reg_exp => "object",
.e_undefined => "undefined",
.e_boolean => "boolean",
.e_number => "number",
.e_big_int => "bigint",
.e_string => "string",
.e_class, .e_function, .e_arrow => "function",
else => null,
};
}
pub fn format(tag: Tag, comptime _: []const u8, _: std.fmt.FormatOptions, writer: anytype) !void {
try switch (tag) {
.e_string => writer.writeAll("string"),
.e_array => writer.writeAll("array"),
.e_unary => writer.writeAll("unary"),
.e_binary => writer.writeAll("binary"),
.e_boolean => writer.writeAll("boolean"),
.e_super => writer.writeAll("super"),
.e_null => writer.writeAll("null"),
.e_undefined => writer.writeAll("undefined"),
.e_new => writer.writeAll("new"),
.e_function => writer.writeAll("function"),
.e_new_target => writer.writeAll("new target"),
.e_import_meta => writer.writeAll("import.meta"),
.e_call => writer.writeAll("call"),
.e_dot => writer.writeAll("dot"),
.e_index => writer.writeAll("index"),
.e_arrow => writer.writeAll("arrow"),
.e_identifier => writer.writeAll("identifier"),
.e_import_identifier => writer.writeAll("import identifier"),
.e_private_identifier => writer.writeAll("#privateIdentifier"),
.e_jsx_element => writer.writeAll(""),
.e_missing => writer.writeAll(""),
.e_number => writer.writeAll("number"),
.e_big_int => writer.writeAll("BigInt"),
.e_object => writer.writeAll("object"),
.e_spread => writer.writeAll("..."),
.e_template_part => writer.writeAll("template_part"),
.e_template => writer.writeAll("template"),
.e_reg_exp => writer.writeAll("regexp"),
.e_await => writer.writeAll("await"),
.e_yield => writer.writeAll("yield"),
.e_if => writer.writeAll("if"),
.e_require_resolve_string => writer.writeAll("require_or_require_resolve"),
.e_import => writer.writeAll("import"),
.e_this => writer.writeAll("this"),
.e_class => writer.writeAll("class"),
.e_require_string => writer.writeAll("require"),
else => writer.writeAll(@tagName(tag)),
};
}
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
pub fn isArray(self: Tag) bool {
switch (self) {
.e_array => {
return true;
},
else => {
return false;
},
}
}
pub fn isUnary(self: Tag) bool {
switch (self) {
.e_unary => {
return true;
},
else => {
return false;
},
}
}
pub fn isBinary(self: Tag) bool {
switch (self) {
.e_binary => {
return true;
},
else => {
return false;
},
}
}
pub fn isThis(self: Tag) bool {
switch (self) {
.e_this => {
return true;
},
else => {
return false;
},
}
}
pub fn isClass(self: Tag) bool {
switch (self) {
.e_class => {
return true;
},
else => {
return false;
},
}
}
pub fn isBoolean(self: Tag) bool {
switch (self) {
.e_boolean => {
return true;
},
else => {
return false;
},
}
}
pub fn isSuper(self: Tag) bool {
switch (self) {
.e_super => {
return true;
},
else => {
return false;
},
}
}
pub fn isNull(self: Tag) bool {
switch (self) {
.e_null => {
return true;
},
else => {
return false;
},
}
}
pub fn isUndefined(self: Tag) bool {
switch (self) {
.e_undefined => {
return true;
},
else => {
return false;
},
}
}
pub fn isNew(self: Tag) bool {
switch (self) {
.e_new => {
return true;
},
else => {
return false;
},
}
}
pub fn isNewTarget(self: Tag) bool {
switch (self) {
.e_new_target => {
return true;
},
else => {
return false;
},
}
}
pub fn isFunction(self: Tag) bool {
switch (self) {
.e_function => {
return true;
},
else => {
return false;
},
}
}
pub fn isImportMeta(self: Tag) bool {
switch (self) {
.e_import_meta => {
return true;
},
else => {
return false;
},
}
}
pub fn isCall(self: Tag) bool {
switch (self) {
.e_call => {
return true;
},
else => {
return false;
},
}
}
pub fn isDot(self: Tag) bool {
switch (self) {
.e_dot => {
return true;
},
else => {
return false;
},
}
}
pub fn isIndex(self: Tag) bool {
switch (self) {
.e_index => {
return true;
},
else => {
return false;
},
}
}
pub fn isArrow(self: Tag) bool {
switch (self) {
.e_arrow => {
return true;
},
else => {
return false;
},
}
}
pub fn isIdentifier(self: Tag) bool {
switch (self) {
.e_identifier => {
return true;
},
else => {
return false;
},
}
}
pub fn isImportIdentifier(self: Tag) bool {
switch (self) {
.e_import_identifier => {
return true;
},
else => {
return false;
},
}
}
pub fn isPrivateIdentifier(self: Tag) bool {
switch (self) {
.e_private_identifier => {
return true;
},
else => {
return false;
},
}
}
pub fn isJsxElement(self: Tag) bool {
switch (self) {
.e_jsx_element => {
return true;
},
else => {
return false;
},
}
}
pub fn isMissing(self: Tag) bool {
switch (self) {
.e_missing => {
return true;
},
else => {
return false;
},
}
}
pub fn isNumber(self: Tag) bool {
switch (self) {
.e_number => {
return true;
},
else => {
return false;
},
}
}
pub fn isBigInt(self: Tag) bool {
switch (self) {
.e_big_int => {
return true;
},
else => {
return false;
},
}
}
pub fn isObject(self: Tag) bool {
switch (self) {
.e_object => {
return true;
},
else => {
return false;
},
}
}
pub fn isSpread(self: Tag) bool {
switch (self) {
.e_spread => {
return true;
},
else => {
return false;
},
}
}
pub fn isString(self: Tag) bool {
switch (self) {
.e_string => {
return true;
},
else => {
return false;
},
}
}
pub fn isTemplatePart(self: Tag) bool {
switch (self) {
.e_template_part => {
return true;
},
else => {
return false;
},
}
}
pub fn isTemplate(self: Tag) bool {
switch (self) {
.e_template => {
return true;
},
else => {
return false;
},
}
}
pub fn isRegExp(self: Tag) bool {
switch (self) {
.e_reg_exp => {
return true;
},
else => {
return false;
},
}
}
pub fn isAwait(self: Tag) bool {
switch (self) {
.e_await => {
return true;
},
else => {
return false;
},
}
}
pub fn isYield(self: Tag) bool {
switch (self) {
.e_yield => {
return true;
},
else => {
return false;
},
}
}
pub fn isIf(self: Tag) bool {
switch (self) {
.e_if => {
return true;
},
else => {
return false;
},
}
}
pub fn isRequireResolveString(self: Tag) bool {
switch (self) {
.e_require_resolve_string => {
return true;
},
else => {
return false;
},
}
}
pub fn isImport(self: Tag) bool {
switch (self) {
.e_import => {
return true;
},
else => {
return false;
},
}
}
};
pub fn isBoolean(a: Expr) bool {
switch (a.data) {
.e_boolean => {
return true;
},
.e_if => |ex| {
return isBoolean(ex.yes) and isBoolean(ex.no);
},
.e_unary => |ex| {
return ex.op == .un_not or ex.op == .un_delete;
},
.e_binary => |ex| {
switch (ex.op) {
.bin_strict_eq, .bin_strict_ne, .bin_loose_eq, .bin_loose_ne, .bin_lt, .bin_gt, .bin_le, .bin_ge, .bin_instanceof, .bin_in => {
return true;
},
.bin_logical_or => {
return isBoolean(ex.left) and isBoolean(ex.right);
},
.bin_logical_and => {
return isBoolean(ex.left) and isBoolean(ex.right);
},
else => {},
}
},
else => {},
}
return false;
}
pub fn assign(a: Expr, b: Expr, _: std.mem.Allocator) Expr {
return init(E.Binary, E.Binary{
.op = .bin_assign,
.left = a,
.right = b,
}, a.loc);
}
pub inline fn at(expr: Expr, comptime Type: type, t: Type, _: std.mem.Allocator) Expr {
return init(Type, t, expr.loc);
}
// Wraps the provided expression in the "!" prefix operator. The expression
// will potentially be simplified to avoid generating unnecessary extra "!"
// operators. For example, calling this with "!!x" will return "!x" instead
// of returning "!!!x".
pub fn not(expr: Expr, allocator: std.mem.Allocator) Expr {
return maybeSimplifyNot(
expr,
allocator,
) orelse Expr.init(
E.Unary,
E.Unary{
.op = .un_not,
.value = expr,
},
expr.loc,
);
}
pub fn hasValueForThisInCall(expr: Expr) bool {
return switch (expr.data) {
.e_dot, .e_index => true,
else => false,
};
}
/// The given "expr" argument should be the operand of a "!" prefix operator
/// (i.e. the "x" in "!x"). This returns a simplified expression for the
/// whole operator (i.e. the "!x") if it can be simplified, or false if not.
/// It's separate from "Not()" above to avoid allocation on failure in case
/// that is undesired.
pub fn maybeSimplifyNot(expr: Expr, allocator: std.mem.Allocator) ?Expr {
switch (expr.data) {
.e_null, .e_undefined => {
return expr.at(E.Boolean, E.Boolean{ .value = true }, allocator);
},
.e_boolean => |b| {
return expr.at(E.Boolean, E.Boolean{ .value = b.value }, allocator);
},
.e_number => |n| {
return expr.at(E.Boolean, E.Boolean{ .value = (n.value == 0 or std.math.isNan(n.value)) }, allocator);
},
.e_big_int => |b| {
return expr.at(E.Boolean, E.Boolean{ .value = strings.eqlComptime(b.value, "0") }, allocator);
},
.e_function,
.e_arrow,
.e_reg_exp,
=> {
return expr.at(E.Boolean, E.Boolean{ .value = false }, allocator);
},
// "!!!a" => "!a"
.e_unary => |un| {
if (un.op == Op.Code.un_not and knownPrimitive(un.value) == .boolean) {
return un.value;
}
},
.e_binary => |ex| {
// TODO: evaluate whether or not it is safe to do this mutation since it's modifying in-place.
// Make sure that these transformations are all safe for special values.
// For example, "!(a < b)" is not the same as "a >= b" if a and/or b are
// NaN (or undefined, or null, or possibly other problem cases too).
switch (ex.op) {
Op.Code.bin_loose_eq => {
// "!(a == b)" => "a != b"
ex.op = .bin_loose_ne;
return expr;
},
Op.Code.bin_loose_ne => {
// "!(a != b)" => "a == b"
ex.op = .bin_loose_eq;
return expr;
},
Op.Code.bin_strict_eq => {
// "!(a === b)" => "a !== b"
ex.op = .bin_strict_ne;
return expr;
},
Op.Code.bin_strict_ne => {
// "!(a !== b)" => "a === b"
ex.op = .bin_strict_eq;
return expr;
},
Op.Code.bin_comma => {
// "!(a, b)" => "a, !b"
ex.right = ex.right.not(allocator);
return expr;
},
else => {},
}
},
else => {},
}
return null;
}
pub fn isOptionalChain(self: *const @This()) bool {
return switch (self.data) {
.e_dot => self.data.e_dot.optional_chain != null,
.e_index => self.data.e_index.optional_chain != null,
.e_call => self.data.e_call.optional_chain != null,
else => false,
};
}
pub inline fn knownPrimitive(self: @This()) PrimitiveType {
return self.data.knownPrimitive();
}
pub const PrimitiveType = enum {
unknown,
mixed,
null,
undefined,
boolean,
number,
string,
bigint,
pub const static = std.enums.EnumSet(PrimitiveType).init(.{
.mixed = true,
.null = true,
.undefined = true,
.boolean = true,
.number = true,
.string = true,
// for our purposes, bigint is dynamic
// it is technically static though
// .@"bigint" = true,
});
pub inline fn isStatic(this: PrimitiveType) bool {
return static.contains(this);
}
pub fn merge(left_known: PrimitiveType, right_known: PrimitiveType) PrimitiveType {
if (right_known == .unknown or left_known == .unknown)
return .unknown;
return if (left_known == right_known)
left_known
else
.mixed;
}
// This can be used when the returned type is either one or the other
};
pub const Data = union(Tag) {
e_array: *E.Array,
e_unary: *E.Unary,
e_binary: *E.Binary,
e_class: *E.Class,
e_new: *E.New,
e_function: *E.Function,
e_call: *E.Call,
e_dot: *E.Dot,
e_index: *E.Index,
e_arrow: *E.Arrow,
e_jsx_element: *E.JSXElement,
e_object: *E.Object,
e_spread: *E.Spread,
e_template_part: *E.TemplatePart,
e_template: *E.Template,
e_reg_exp: *E.RegExp,
e_await: *E.Await,
e_yield: *E.Yield,
e_if: *E.If,
e_import: *E.Import,
e_identifier: E.Identifier,
e_import_identifier: E.ImportIdentifier,
e_private_identifier: E.PrivateIdentifier,
e_commonjs_export_identifier: E.CommonJSExportIdentifier,
e_boolean: E.Boolean,
e_number: E.Number,
e_big_int: *E.BigInt,
e_string: *E.String,
e_require_string: E.RequireString,
e_require_resolve_string: E.RequireResolveString,
e_require_call_target: void,
e_require_resolve_call_target: void,
e_missing: E.Missing,
e_this: E.This,
e_super: E.Super,
e_null: E.Null,
e_undefined: E.Undefined,
e_new_target: E.NewTarget,
e_import_meta: E.ImportMeta,
// This type should not exist outside of MacroContext
// If it ends up in JSParser or JSPrinter, it is a bug.
inline_identifier: i32,
pub fn clone(this: Expr.Data, allocator: std.mem.Allocator) !Data {
return switch (this) {
.e_array => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_array)));
item.* = el.*;
return .{ .e_array = item };
},
.e_unary => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_unary)));
item.* = el.*;
return .{ .e_unary = item };
},
.e_binary => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_binary)));
item.* = el.*;
return .{ .e_binary = item };
},
.e_class => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_class)));
item.* = el.*;
return .{ .e_class = item };
},
.e_new => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_new)));
item.* = el.*;
return .{ .e_new = item };
},
.e_function => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_function)));
item.* = el.*;
return .{ .e_function = item };
},
.e_call => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_call)));
item.* = el.*;
return .{ .e_call = item };
},
.e_dot => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_dot)));
item.* = el.*;
return .{ .e_dot = item };
},
.e_index => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_index)));
item.* = el.*;
return .{ .e_index = item };
},
.e_arrow => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_arrow)));
item.* = el.*;
return .{ .e_arrow = item };
},
.e_jsx_element => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_jsx_element)));
item.* = el.*;
return .{ .e_jsx_element = item };
},
.e_object => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_object)));
item.* = el.*;
return .{ .e_object = item };
},
.e_spread => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_spread)));
item.* = el.*;
return .{ .e_spread = item };
},
.e_template_part => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_template_part)));
item.* = el.*;
return .{ .e_template_part = item };
},
.e_template => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_template)));
item.* = el.*;
return .{ .e_template = item };
},
.e_reg_exp => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_reg_exp)));
item.* = el.*;
return .{ .e_reg_exp = item };
},
.e_await => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_await)));
item.* = el.*;
return .{ .e_await = item };
},
.e_yield => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_yield)));
item.* = el.*;
return .{ .e_yield = item };
},
.e_if => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_if)));
item.* = el.*;
return .{ .e_if = item };
},
.e_import => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_import)));
item.* = el.*;
return .{ .e_import = item };
},
.e_big_int => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_big_int)));
item.* = el.*;
return .{ .e_big_int = item };
},
.e_string => |el| {
var item = try allocator.create(std.meta.Child(@TypeOf(this.e_string)));
item.* = el.*;
return .{ .e_string = item };
},
else => this,
};
}
pub fn canBeConstValue(this: Expr.Data) bool {
return switch (this) {
.e_number, .e_boolean, .e_null, .e_undefined => true,
.e_string => |str| str.next == null,
.e_array => |array| array.was_originally_macro,
.e_object => |object| object.was_originally_macro,
else => false,
};
}
pub fn knownPrimitive(data: Expr.Data) PrimitiveType {
return switch (data) {
.e_big_int => .bigint,
.e_boolean => .boolean,
.e_null => .null,
.e_number => .number,
.e_string => .string,
.e_undefined => .undefined,
.e_template => if (data.e_template.tag == null) PrimitiveType.string else PrimitiveType.unknown,
.e_if => mergeKnownPrimitive(data.e_if.yes.data, data.e_if.no.data),
.e_binary => |binary| brk: {
switch (binary.op) {
.bin_strict_eq,
.bin_strict_ne,
.bin_loose_eq,
.bin_loose_ne,
.bin_lt,
.bin_gt,
.bin_le,
.bin_ge,
.bin_instanceof,
.bin_in,
=> break :brk PrimitiveType.boolean,
.bin_logical_or, .bin_logical_and => break :brk binary.left.data.mergeKnownPrimitive(binary.right.data),
.bin_nullish_coalescing => {
const left = binary.left.data.knownPrimitive();
const right = binary.right.data.knownPrimitive();
if (left == .null or left == .undefined)
break :brk right;
if (left != .unknown) {
if (left != .mixed)
break :brk left; // Definitely not null or undefined
if (right != .unknown)
break :brk PrimitiveType.mixed; // Definitely some kind of primitive
}
},
.bin_add => {
const left = binary.left.data.knownPrimitive();
const right = binary.right.data.knownPrimitive();
if (left == .string or right == .string)
break :brk PrimitiveType.string;
if (left == .bigint or right == .bigint)
break :brk PrimitiveType.bigint;
if (switch (left) {
.unknown, .mixed, .bigint => false,
else => true,
} and switch (right) {
.unknown, .mixed, .bigint => false,
else => true,
})
break :brk PrimitiveType.number;
break :brk PrimitiveType.mixed; // Can be number or bigint or string (or an exception)
},
.bin_sub,
.bin_sub_assign,
.bin_mul,
.bin_mul_assign,
.bin_div,
.bin_div_assign,
.bin_rem,
.bin_rem_assign,
.bin_pow,
.bin_pow_assign,
.bin_bitwise_and,
.bin_bitwise_and_assign,
.bin_bitwise_or,
.bin_bitwise_or_assign,
.bin_bitwise_xor,
.bin_bitwise_xor_assign,
.bin_shl,
.bin_shl_assign,
.bin_shr,
.bin_shr_assign,
.bin_u_shr,
.bin_u_shr_assign,
=> break :brk PrimitiveType.mixed, // Can be number or bigint (or an exception)
.bin_assign,
.bin_comma,
=> break :brk binary.right.data.knownPrimitive(),
else => {},
}
break :brk PrimitiveType.unknown;
},
.e_unary => switch (data.e_unary.op) {
.un_void => PrimitiveType.undefined,
.un_typeof => PrimitiveType.string,
.un_not, .un_delete => PrimitiveType.boolean,
.un_pos => PrimitiveType.number, // Cannot be bigint because that throws an exception
.un_neg, .un_cpl => switch (data.e_unary.value.data.knownPrimitive()) {
.bigint => PrimitiveType.bigint,
.unknown, .mixed => PrimitiveType.mixed,
else => PrimitiveType.number, // Can be number or bigint
},
.un_pre_dec, .un_pre_inc, .un_post_dec, .un_post_inc => PrimitiveType.mixed, // Can be number or bigint
else => PrimitiveType.unknown,
},
else => PrimitiveType.unknown,
};
}
pub fn mergeKnownPrimitive(lhs: Expr.Data, rhs: Expr.Data) PrimitiveType {
return lhs.knownPrimitive().merge(rhs.knownPrimitive());
}
/// Returns true if the result of the "typeof" operator on this expression is
/// statically determined and this expression has no side effects (i.e. can be
/// removed without consequence).
pub inline fn toTypeof(data: Expr.Data) ?string {
return @as(Expr.Tag, data).typeof();
}
pub fn toNumber(data: Expr.Data) ?f64 {
return switch (data) {
.e_null => 0,
.e_undefined => std.math.nan(f64),
.e_boolean => @as(f64, if (data.e_boolean.value) 1.0 else 0.0),
.e_number => data.e_number.value,
else => null,
};
}
pub fn toFiniteNumber(data: Expr.Data) ?f64 {
return switch (data) {
.e_boolean => @as(f64, if (data.e_boolean.value) 1.0 else 0.0),
.e_number => if (std.math.isFinite(data.e_number.value))
data.e_number.value
else
null,
else => null,
};
}
pub const Equality = struct {
equal: bool = false,
ok: bool = false,
};
// Returns "equal, ok". If "ok" is false, then nothing is known about the two
// values. If "ok" is true, the equality or inequality of the two values is
// stored in "equal".
pub fn eql(
left: Expr.Data,
right: Expr.Data,
allocator: std.mem.Allocator,
comptime kind: enum { loose, strict },
) Equality {
// https://dorey.github.io/JavaScript-Equality-Table/
var equality = Equality{};
switch (left) {
.e_null, .e_undefined => {
const ok = switch (@as(Expr.Tag, right)) {
.e_null, .e_undefined => true,
else => @as(Expr.Tag, right).isPrimitiveLiteral(),
};
if (comptime kind == .loose) {
return .{
.equal = switch (@as(Expr.Tag, right)) {
.e_null, .e_undefined => true,
else => false,
},
.ok = ok,
};
}
return .{
.equal = @as(Tag, right) == @as(Tag, left),
.ok = ok,
};
},
.e_boolean => |l| {
switch (right) {
.e_boolean => {
equality.ok = true;
equality.equal = l.value == right.e_boolean.value;
},
.e_number => |num| {
if (comptime kind == .strict) {
// "true === 1" is false
// "false === 0" is false
return .{ .ok = true, .equal = false };
}
return .{
.ok = true,
.equal = if (l.value)
num.value == 1
else
num.value == 0,
};
},
.e_null, .e_undefined => {
return .{ .ok = true, .equal = false };
},
else => {},
}
},
.e_number => |l| {
switch (right) {
.e_number => |r| {
return .{
.ok = true,
.equal = l.value == r.value,
};
},
.e_boolean => |r| {
if (comptime kind == .loose) {
return .{
.ok = true,
// "1 == true" is true
// "0 == false" is true
.equal = if (r.value)
l.value == 1
else
l.value == 0,
};
}
// "1 === true" is false
// "0 === false" is false
return .{ .ok = true, .equal = false };
},
.e_null, .e_undefined => {
// "(not null or undefined) == undefined" is false
return .{ .ok = true, .equal = false };
},
else => {},
}
},
.e_big_int => |l| {
if (right == .e_big_int) {
equality.ok = true;
equality.equal = strings.eql(l.value, l.value);
} else {
equality.ok = switch (right) {
.e_null, .e_undefined => true,
else => false,
};
equality.equal = false;
}
},
.e_string => |l| {
switch (right) {
.e_string => |r| {
equality.ok = true;
r.resolveRopeIfNeeded(allocator);
l.resolveRopeIfNeeded(allocator);
equality.equal = r.eql(E.String, l);
},
.e_null, .e_undefined => {
equality.ok = true;
equality.equal = false;
},
.e_number => |r| {
if (comptime kind == .loose) {
if (r.value == 0 or r.value == 1) {
equality.ok = true;
equality.equal = if (r.value == 0)
l.eqlComptime("0")
else if (r.value == 1)
l.eqlComptime("1")
else
unreachable;
}
} else {
equality.ok = true;
equality.equal = false;
}
},
else => {},
}
},
else => {},
}
return equality;
}
pub fn toJS(this: Data, allocator: std.mem.Allocator, globalObject: *JSC.JSGlobalObject) ToJSError!JSC.JSValue {
return switch (this) {
.e_array => |e| e.toJS(allocator, globalObject),
.e_object => |e| e.toJS(allocator, globalObject),
.e_string => |e| e.toJS(allocator, globalObject),
.e_null => JSC.JSValue.null,
.e_undefined => JSC.JSValue.undefined,
.e_boolean => |boolean| if (boolean.value)
JSC.JSValue.true
else
JSC.JSValue.false,
.e_number => |e| e.toJS(),
// .e_big_int => |e| e.toJS(ctx, exception),
.e_identifier,
.e_import_identifier,
.inline_identifier,
.e_private_identifier,
.e_commonjs_export_identifier,
=> error.@"Cannot convert identifier to JS. Try a statically-known value",
// brk: {
// // var node = try allocator.create(Macro.JSNode);
// // node.* = Macro.JSNode.initExpr(Expr{ .data = this, .loc = logger.Loc.Empty });
// // break :brk JSC.JSValue.c(Macro.JSNode.Class.make(globalObject, node));
// },
else => {
return error.@"Cannot convert argument type to JS";
},
};
}
pub const Store = struct {
const often = 512;
const medium = 256;
const rare = 24;
const All = NewBaseStore(
&([_]type{
E.Array,
E.Unary,
E.Binary,
E.Class,
E.New,
E.Function,
E.Call,
E.Dot,
E.Index,
E.Arrow,
E.RegExp,
E.PrivateIdentifier,
E.JSXElement,
E.Number,
E.BigInt,
E.Object,
E.Spread,
E.String,
E.TemplatePart,
E.Template,
E.Await,
E.Yield,
E.If,
E.Import,
}),
512,
);
pub threadlocal var memory_allocator: ?*ASTMemoryAllocator = null;
threadlocal var has_inited = false;
pub threadlocal var disable_reset = false;
pub fn create(allocator: std.mem.Allocator) void {
if (has_inited or memory_allocator != null) {
return;
}
has_inited = true;
_ = All.init(allocator);
}
pub fn reset() void {
if (disable_reset or memory_allocator != null) return;
All.reset();
}
pub fn deinit() void {
if (!has_inited or memory_allocator != null) return;
All.deinit();
has_inited = false;
}
pub inline fn assert() void {
if (comptime Environment.allow_assert) {
if (!has_inited and memory_allocator == null)
bun.unreachablePanic("Store must be init'd", .{});
}
}
pub fn append(comptime ValueType: type, value: anytype) *ValueType {
if (memory_allocator) |allocator| {
return allocator.append(ValueType, value);
}
return All.append(Disabler, ValueType, value);
}
pub fn toOwnedSlice() []*Store.All.Block {
if (!has_inited or Store.All._self.overflow.used == 0 or disable_reset or memory_allocator != null) return &[_]*Store.All.Block{};
return Store.All.reclaim();
}
};
pub inline fn isStringValue(self: Data) bool {
return @as(Expr.Tag, self) == .e_string;
}
};
};
test "Byte size of Expr" {
try std.io.getStdErr().writeAll(comptime std.fmt.comptimePrint("\n\nByte Size {d}\n\n", .{@sizeOf(Expr.Data)}));
}
pub const EnumValue = struct {
loc: logger.Loc,
ref: Ref,
name: E.String,
value: ?ExprNodeIndex,
};
pub const S = struct {
pub const Block = struct {
stmts: StmtNodeList,
close_brace_loc: logger.Loc = logger.Loc.Empty,
};
pub const SExpr = struct {
value: ExprNodeIndex,
// This is set to true for automatically-generated expressions that should
// not affect tree shaking. For example, calling a function from the runtime
// that doesn't have externally-visible side effects.
does_not_affect_tree_shaking: bool = false,
};
pub const Comment = struct { text: string };
pub const Directive = struct {
value: []const u16,
};
pub const ExportClause = struct { items: []ClauseItem, is_single_line: bool = false };
pub const Empty = struct {};
pub const ExportStar = struct {
namespace_ref: Ref,
alias: ?G.ExportStarAlias = null,
import_record_index: u32,
};
// This is an "export = value;" statement in TypeScript
pub const ExportEquals = struct { value: ExprNodeIndex };
pub const Label = struct { name: LocRef, stmt: StmtNodeIndex };
// This is a stand-in for a TypeScript type declaration
pub const TypeScript = struct {};
pub const Debugger = struct {};
pub const ExportFrom = struct {
items: []ClauseItem,
namespace_ref: Ref,
import_record_index: u32,
is_single_line: bool,
};
pub const ExportDefault = struct {
default_name: LocRef, // value may be a SFunction or SClass
value: StmtOrExpr,
pub fn canBeMoved(self: *const ExportDefault) bool {
return switch (self.value) {
.expr => |e| switch (e.data) {
.e_class => |class| class.canBeMoved(),
.e_arrow, .e_function => true,
else => e.canBeConstValue(),
},
.stmt => |s| switch (s.data) {
.s_class => |class| class.class.canBeMoved(),
.s_function => true,
else => false,
},
};
}
};
pub const Enum = struct {
name: LocRef,
arg: Ref,
values: []EnumValue,
is_export: bool,
};
pub const Namespace = struct {
name: LocRef,
arg: Ref,
stmts: StmtNodeList,
is_export: bool,
};
pub const Function = struct {
func: G.Fn,
};
pub const Class = struct { class: G.Class, is_export: bool = false };
pub const If = struct {
test_: ExprNodeIndex,
yes: StmtNodeIndex,
no: ?StmtNodeIndex,
};
pub const For = struct {
// May be a SConst, SLet, SVar, or SExpr
init: ?StmtNodeIndex = null,
test_: ?ExprNodeIndex = null,
update: ?ExprNodeIndex = null,
body: StmtNodeIndex,
};
pub const ForIn = struct {
// May be a SConst, SLet, SVar, or SExpr
init: StmtNodeIndex,
value: ExprNodeIndex,
body: StmtNodeIndex,
};
pub const ForOf = struct {
is_await: bool = false,
// May be a SConst, SLet, SVar, or SExpr
init: StmtNodeIndex,
value: ExprNodeIndex,
body: StmtNodeIndex,
};
pub const DoWhile = struct { body: StmtNodeIndex, test_: ExprNodeIndex };
pub const While = struct {
test_: ExprNodeIndex,
body: StmtNodeIndex,
};
pub const With = struct {
value: ExprNodeIndex,
body: StmtNodeIndex,
};
pub const Try = struct {
body_loc: logger.Loc,
body: StmtNodeList,
catch_: ?Catch = null,
finally: ?Finally = null,
};
pub const Switch = struct {
test_: ExprNodeIndex,
body_loc: logger.Loc,
cases: []Case,
};
// This object represents all of these types of import statements:
//
// import 'path'
// import {item1, item2} from 'path'
// import * as ns from 'path'
// import defaultItem, {item1, item2} from 'path'
// import defaultItem, * as ns from 'path'
//
// Many parts are optional and can be combined in different ways. The only
// restriction is that you cannot have both a clause and a star namespace.
pub const Import = struct {
// If this is a star import: This is a Ref for the namespace symbol. The Loc
// for the symbol is StarLoc.
//
// Otherwise: This is an auto-generated Ref for the namespace representing
// the imported file. In this case StarLoc is nil. The NamespaceRef is used
// when converting this module to a CommonJS module.
namespace_ref: Ref,
default_name: ?LocRef = null,
items: []ClauseItem = &([_]ClauseItem{}),
star_name_loc: ?logger.Loc = null,
import_record_index: u32,
is_single_line: bool = false,
};
pub const Return = struct { value: ?ExprNodeIndex = null };
pub const Throw = struct { value: ExprNodeIndex };
pub const Local = struct {
kind: Kind = Kind.k_var,
decls: G.Decl.List = .{},
is_export: bool = false,
// The TypeScript compiler doesn't generate code for "import foo = bar"
// statements where the import is never used.
was_ts_import_equals: bool = false,
was_commonjs_export: bool = false,
pub fn canMergeWith(this: *const Local, other: *const Local) bool {
return this.kind == other.kind and this.is_export == other.is_export and
this.was_commonjs_export == other.was_commonjs_export;
}
pub const Kind = enum(u2) {
k_var,
k_let,
k_const,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
};
};
pub const Break = struct {
label: ?LocRef = null,
};
pub const Continue = struct {
label: ?LocRef = null,
};
};
pub const Catch = struct {
loc: logger.Loc,
binding: ?BindingNodeIndex = null,
body: StmtNodeList,
body_loc: logger.Loc,
};
pub const Finally = struct {
loc: logger.Loc,
stmts: StmtNodeList,
};
pub const Case = struct { loc: logger.Loc, value: ?ExprNodeIndex, body: StmtNodeList };
pub const Op = struct {
// If you add a new token, remember to add it to "Table" too
pub const Code = enum {
// Prefix
un_pos,
un_neg,
un_cpl,
un_not,
un_void,
un_typeof,
un_delete,
// Prefix update
un_pre_dec,
un_pre_inc,
// Postfix update
un_post_dec,
un_post_inc,
/// Left-associative
bin_add,
/// Left-associative
bin_sub,
/// Left-associative
bin_mul,
/// Left-associative
bin_div,
/// Left-associative
bin_rem,
/// Left-associative
bin_pow,
/// Left-associative
bin_lt,
/// Left-associative
bin_le,
/// Left-associative
bin_gt,
/// Left-associative
bin_ge,
/// Left-associative
bin_in,
/// Left-associative
bin_instanceof,
/// Left-associative
bin_shl,
/// Left-associative
bin_shr,
/// Left-associative
bin_u_shr,
/// Left-associative
bin_loose_eq,
/// Left-associative
bin_loose_ne,
/// Left-associative
bin_strict_eq,
/// Left-associative
bin_strict_ne,
/// Left-associative
bin_nullish_coalescing,
/// Left-associative
bin_logical_or,
/// Left-associative
bin_logical_and,
/// Left-associative
bin_bitwise_or,
/// Left-associative
bin_bitwise_and,
/// Left-associative
bin_bitwise_xor,
/// Non-associative
bin_comma,
/// Right-associative
bin_assign,
/// Right-associative
bin_add_assign,
/// Right-associative
bin_sub_assign,
/// Right-associative
bin_mul_assign,
/// Right-associative
bin_div_assign,
/// Right-associative
bin_rem_assign,
/// Right-associative
bin_pow_assign,
/// Right-associative
bin_shl_assign,
/// Right-associative
bin_shr_assign,
/// Right-associative
bin_u_shr_assign,
/// Right-associative
bin_bitwise_or_assign,
/// Right-associative
bin_bitwise_and_assign,
/// Right-associative
bin_bitwise_xor_assign,
/// Right-associative
bin_nullish_coalescing_assign,
/// Right-associative
bin_logical_or_assign,
/// Right-associative
bin_logical_and_assign,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
pub fn unaryAssignTarget(code: Op.Code) AssignTarget {
if (@intFromEnum(code) >=
@intFromEnum(Op.Code.un_pre_dec) and @intFromEnum(code) <=
@intFromEnum(Op.Code.un_post_inc))
{
return AssignTarget.update;
}
return AssignTarget.none;
}
pub fn isLeftAssociative(code: Op.Code) bool {
return @intFromEnum(code) >=
@intFromEnum(Op.Code.bin_add) and
@intFromEnum(code) < @intFromEnum(Op.Code.bin_comma) and code != .bin_pow;
}
pub fn isRightAssociative(code: Op.Code) bool {
return @intFromEnum(code) >= @intFromEnum(Op.Code.bin_assign) or code == .bin_pow;
}
pub fn binaryAssignTarget(code: Op.Code) AssignTarget {
if (code == .bin_assign) {
return AssignTarget.replace;
}
if (@intFromEnum(code) > @intFromEnum(Op.Code.bin_assign)) {
return AssignTarget.update;
}
return AssignTarget.none;
}
pub fn isPrefix(code: Op.Code) bool {
return @intFromEnum(code) < @intFromEnum(Op.Code.un_post_dec);
}
};
pub const Level = enum(u6) {
lowest,
comma,
spread,
yield,
assign,
conditional,
nullish_coalescing,
logical_or,
logical_and,
bitwise_or,
bitwise_xor,
bitwise_and,
equals,
compare,
shift,
add,
multiply,
exponentiation,
prefix,
postfix,
new,
call,
member,
pub inline fn lt(self: Level, b: Level) bool {
return @intFromEnum(self) < @intFromEnum(b);
}
pub inline fn gt(self: Level, b: Level) bool {
return @intFromEnum(self) > @intFromEnum(b);
}
pub inline fn gte(self: Level, b: Level) bool {
return @intFromEnum(self) >= @intFromEnum(b);
}
pub inline fn lte(self: Level, b: Level) bool {
return @intFromEnum(self) <= @intFromEnum(b);
}
pub inline fn eql(self: Level, b: Level) bool {
return @intFromEnum(self) == @intFromEnum(b);
}
pub inline fn sub(self: Level, i: anytype) Level {
return @as(Level, @enumFromInt(@intFromEnum(self) - i));
}
pub inline fn addF(self: Level, i: anytype) Level {
return @as(Level, @enumFromInt(@intFromEnum(self) + i));
}
};
text: string,
level: Level,
is_keyword: bool = false,
pub fn init(triple: anytype) Op {
return Op{
.text = triple.@"0",
.level = triple.@"1",
.is_keyword = triple.@"2",
};
}
pub fn jsonStringify(self: *const @This(), writer: anytype) !void {
return try writer.write(self.text);
}
pub const TableType: std.EnumArray(Op.Code, Op) = undefined;
pub const Table = brk: {
var table = std.EnumArray(Op.Code, Op).initUndefined();
// Prefix
table.set(Op.Code.un_pos, Op.init(.{ "+", Level.prefix, false }));
table.set(Op.Code.un_neg, Op.init(.{ "-", Level.prefix, false }));
table.set(Op.Code.un_cpl, Op.init(.{ "~", Level.prefix, false }));
table.set(Op.Code.un_not, Op.init(.{ "!", Level.prefix, false }));
table.set(Op.Code.un_void, Op.init(.{ "void", Level.prefix, true }));
table.set(Op.Code.un_typeof, Op.init(.{ "typeof", Level.prefix, true }));
table.set(Op.Code.un_delete, Op.init(.{ "delete", Level.prefix, true }));
// Prefix update
table.set(Op.Code.un_pre_dec, Op.init(.{ "--", Level.prefix, false }));
table.set(Op.Code.un_pre_inc, Op.init(.{ "++", Level.prefix, false }));
// Postfix update
table.set(Op.Code.un_post_dec, Op.init(.{ "--", Level.postfix, false }));
table.set(Op.Code.un_post_inc, Op.init(.{ "++", Level.postfix, false }));
// Left-associative
table.set(Op.Code.bin_add, Op.init(.{ "+", Level.add, false }));
table.set(Op.Code.bin_sub, Op.init(.{ "-", Level.add, false }));
table.set(Op.Code.bin_mul, Op.init(.{ "*", Level.multiply, false }));
table.set(Op.Code.bin_div, Op.init(.{ "/", Level.multiply, false }));
table.set(Op.Code.bin_rem, Op.init(.{ "%", Level.multiply, false }));
table.set(Op.Code.bin_pow, Op.init(.{ "**", Level.exponentiation, false }));
table.set(Op.Code.bin_lt, Op.init(.{ "<", Level.compare, false }));
table.set(Op.Code.bin_le, Op.init(.{ "<=", Level.compare, false }));
table.set(Op.Code.bin_gt, Op.init(.{ ">", Level.compare, false }));
table.set(Op.Code.bin_ge, Op.init(.{ ">=", Level.compare, false }));
table.set(Op.Code.bin_in, Op.init(.{ "in", Level.compare, true }));
table.set(Op.Code.bin_instanceof, Op.init(.{ "instanceof", Level.compare, true }));
table.set(Op.Code.bin_shl, Op.init(.{ "<<", Level.shift, false }));
table.set(Op.Code.bin_shr, Op.init(.{ ">>", Level.shift, false }));
table.set(Op.Code.bin_u_shr, Op.init(.{ ">>>", Level.shift, false }));
table.set(Op.Code.bin_loose_eq, Op.init(.{ "==", Level.equals, false }));
table.set(Op.Code.bin_loose_ne, Op.init(.{ "!=", Level.equals, false }));
table.set(Op.Code.bin_strict_eq, Op.init(.{ "===", Level.equals, false }));
table.set(Op.Code.bin_strict_ne, Op.init(.{ "!==", Level.equals, false }));
table.set(Op.Code.bin_nullish_coalescing, Op.init(.{ "??", Level.nullish_coalescing, false }));
table.set(Op.Code.bin_logical_or, Op.init(.{ "||", Level.logical_or, false }));
table.set(Op.Code.bin_logical_and, Op.init(.{ "&&", Level.logical_and, false }));
table.set(Op.Code.bin_bitwise_or, Op.init(.{ "|", Level.bitwise_or, false }));
table.set(Op.Code.bin_bitwise_and, Op.init(.{ "&", Level.bitwise_and, false }));
table.set(Op.Code.bin_bitwise_xor, Op.init(.{ "^", Level.bitwise_xor, false }));
// Non-associative
table.set(Op.Code.bin_comma, Op.init(.{ ",", Level.comma, false }));
// Right-associative
table.set(Op.Code.bin_assign, Op.init(.{ "=", Level.assign, false }));
table.set(Op.Code.bin_add_assign, Op.init(.{ "+=", Level.assign, false }));
table.set(Op.Code.bin_sub_assign, Op.init(.{ "-=", Level.assign, false }));
table.set(Op.Code.bin_mul_assign, Op.init(.{ "*=", Level.assign, false }));
table.set(Op.Code.bin_div_assign, Op.init(.{ "/=", Level.assign, false }));
table.set(Op.Code.bin_rem_assign, Op.init(.{ "%=", Level.assign, false }));
table.set(Op.Code.bin_pow_assign, Op.init(.{ "**=", Level.assign, false }));
table.set(Op.Code.bin_shl_assign, Op.init(.{ "<<=", Level.assign, false }));
table.set(Op.Code.bin_shr_assign, Op.init(.{ ">>=", Level.assign, false }));
table.set(Op.Code.bin_u_shr_assign, Op.init(.{ ">>>=", Level.assign, false }));
table.set(Op.Code.bin_bitwise_or_assign, Op.init(.{ "|=", Level.assign, false }));
table.set(Op.Code.bin_bitwise_and_assign, Op.init(.{ "&=", Level.assign, false }));
table.set(Op.Code.bin_bitwise_xor_assign, Op.init(.{ "^=", Level.assign, false }));
table.set(Op.Code.bin_nullish_coalescing_assign, Op.init(.{ "??=", Level.assign, false }));
table.set(Op.Code.bin_logical_or_assign, Op.init(.{ "||=", Level.assign, false }));
table.set(Op.Code.bin_logical_and_assign, Op.init(.{ "&&=", Level.assign, false }));
break :brk table;
};
};
pub const ArrayBinding = struct {
binding: BindingNodeIndex,
default_value: ?ExprNodeIndex = null,
};
pub const Ast = struct {
pub const TopLevelSymbolToParts = std.ArrayHashMapUnmanaged(Ref, BabyList(u32), Ref.ArrayHashCtx, false);
approximate_newline_count: usize = 0,
has_lazy_export: bool = false,
runtime_imports: Runtime.Imports = .{},
nested_scope_slot_counts: SlotCounts = SlotCounts{},
runtime_import_record_id: ?u32 = null,
needs_runtime: bool = false,
externals: []u32 = &[_]u32{},
// This is a list of CommonJS features. When a file uses CommonJS features,
// it's not a candidate for "flat bundling" and must be wrapped in its own
// closure.
has_top_level_return: bool = false,
uses_exports_ref: bool = false,
uses_module_ref: bool = false,
uses_require_ref: bool = false,
force_cjs_to_esm: bool = false,
exports_kind: ExportsKind = ExportsKind.none,
// This is a list of ES6 features. They are ranges instead of booleans so
// that they can be used in log messages. Check to see if "Len > 0".
import_keyword: logger.Range = logger.Range.None, // Does not include TypeScript-specific syntax or "import()"
export_keyword: logger.Range = logger.Range.None, // Does not include TypeScript-specific syntax
top_level_await_keyword: logger.Range = logger.Range.None,
/// These are stored at the AST level instead of on individual AST nodes so
/// they can be manipulated efficiently without a full AST traversal
import_records: ImportRecord.List = .{},
hashbang: string = "",
directive: ?string = null,
url_for_css: ?string = null,
parts: Part.List = Part.List{},
// This list may be mutated later, so we should store the capacity
symbols: Symbol.List = Symbol.List{},
module_scope: Scope = Scope{},
char_freq: ?CharFreq = null,
exports_ref: Ref = Ref.None,
module_ref: Ref = Ref.None,
wrapper_ref: Ref = Ref.None,
require_ref: Ref = Ref.None,
prepend_part: ?Part = null,
// These are used when bundling. They are filled in during the parser pass
// since we already have to traverse the AST then anyway and the parser pass
// is conveniently fully parallelized.
named_imports: NamedImports = NamedImports.init(bun.failing_allocator),
named_exports: NamedExports = NamedExports.init(bun.failing_allocator),
export_star_import_records: []u32 = &([_]u32{}),
allocator: std.mem.Allocator,
top_level_symbols_to_parts: TopLevelSymbolToParts = .{},
commonjs_named_exports: CommonJSNamedExports = .{},
redirect_import_record_index: ?u32 = null,
/// Only populated when bundling
target: bun.options.Target = .browser,
const_values: ConstValuesMap = .{},
/// Not to be confused with `commonjs_named_exports`
/// This is a list of named exports that may exist in a CommonJS module
/// We use this with `commonjs_at_runtime` to re-export CommonJS
commonjs_export_names: []string = &([_]string{}),
import_meta_ref: Ref = Ref.None,
pub const CommonJSNamedExport = struct {
loc_ref: LocRef,
needs_decl: bool = true,
};
pub const CommonJSNamedExports = bun.StringArrayHashMapUnmanaged(CommonJSNamedExport);
pub const NamedImports = std.ArrayHashMap(Ref, NamedImport, RefHashCtx, true);
pub const NamedExports = bun.StringArrayHashMap(NamedExport);
pub const ConstValuesMap = std.ArrayHashMapUnmanaged(Ref, Expr, RefHashCtx, false);
pub fn fromParts(parts: []Part) Ast {
return Ast{
.parts = Part.List.init(parts),
.allocator = bun.default_allocator,
.runtime_imports = .{},
};
}
pub fn initTest(parts: []Part) Ast {
return Ast{
.parts = Part.List.init(parts),
.allocator = bun.default_allocator,
.runtime_imports = .{},
};
}
pub const empty = Ast{ .parts = Part.List{}, .runtime_imports = .{}, .allocator = bun.default_allocator };
pub fn toJSON(self: *const Ast, _: std.mem.Allocator, stream: anytype) !void {
const opts = std.json.StringifyOptions{ .whitespace = std.json.StringifyOptions.Whitespace{
.separator = true,
} };
try std.json.stringify(self.parts, opts, stream);
}
/// Do not call this if it wasn't globally allocated!
pub fn deinit(this: *Ast) void {
// TODO: assert mimalloc-owned memory
if (this.parts.len > 0) this.parts.deinitWithAllocator(bun.default_allocator);
if (this.externals.len > 0) bun.default_allocator.free(this.externals);
if (this.symbols.len > 0) this.symbols.deinitWithAllocator(bun.default_allocator);
if (this.import_records.len > 0) this.import_records.deinitWithAllocator(bun.default_allocator);
}
};
/// Like Ast but slimmer and for bundling only.
///
/// On Linux, the hottest function in the bundler is:
/// src.multi_array_list.MultiArrayList(src.js_ast.Ast).ensureTotalCapacity
/// https://share.firefox.dev/3NNlRKt
///
/// So we make a slimmer version of Ast for bundling that doesn't allocate as much memory
pub const BundledAst = struct {
approximate_newline_count: u32 = 0,
nested_scope_slot_counts: SlotCounts = SlotCounts{},
externals: []u32 = &[_]u32{},
exports_kind: ExportsKind = ExportsKind.none,
/// These are stored at the AST level instead of on individual AST nodes so
/// they can be manipulated efficiently without a full AST traversal
import_records: ImportRecord.List = .{},
hashbang: string = "",
directive: string = "",
url_for_css: string = "",
parts: Part.List = Part.List{},
// This list may be mutated later, so we should store the capacity
symbols: Symbol.List = Symbol.List{},
module_scope: Scope = Scope{},
char_freq: CharFreq = undefined,
exports_ref: Ref = Ref.None,
module_ref: Ref = Ref.None,
wrapper_ref: Ref = Ref.None,
require_ref: Ref = Ref.None,
// These are used when bundling. They are filled in during the parser pass
// since we already have to traverse the AST then anyway and the parser pass
// is conveniently fully parallelized.
named_imports: NamedImports = NamedImports.init(bun.failing_allocator),
named_exports: NamedExports = NamedExports.init(bun.failing_allocator),
export_star_import_records: []u32 = &([_]u32{}),
allocator: std.mem.Allocator,
top_level_symbols_to_parts: TopLevelSymbolToParts = .{},
commonjs_named_exports: CommonJSNamedExports = .{},
redirect_import_record_index: u32 = std.math.maxInt(u32),
/// Only populated when bundling
target: bun.options.Target = .browser,
const_values: ConstValuesMap = .{},
flags: BundledAst.Flags = .{},
pub const NamedImports = Ast.NamedImports;
pub const NamedExports = Ast.NamedExports;
pub const TopLevelSymbolToParts = Ast.TopLevelSymbolToParts;
pub const CommonJSNamedExports = Ast.CommonJSNamedExports;
pub const ConstValuesMap = Ast.ConstValuesMap;
pub const Flags = packed struct {
// This is a list of CommonJS features. When a file uses CommonJS features,
// it's not a candidate for "flat bundling" and must be wrapped in its own
// closure.
uses_exports_ref: bool = false,
uses_module_ref: bool = false,
// uses_require_ref: bool = false,
uses_export_keyword: bool = false,
has_char_freq: bool = false,
force_cjs_to_esm: bool = false,
has_lazy_export: bool = false,
};
pub const empty = BundledAst.init(Ast.empty);
pub inline fn uses_exports_ref(this: *const BundledAst) bool {
return this.flags.uses_exports_ref;
}
pub inline fn uses_module_ref(this: *const BundledAst) bool {
return this.flags.uses_module_ref;
}
// pub inline fn uses_require_ref(this: *const BundledAst) bool {
// return this.flags.uses_require_ref;
// }
pub fn toAST(this: *const BundledAst) Ast {
return .{
.approximate_newline_count = this.approximate_newline_count,
.nested_scope_slot_counts = this.nested_scope_slot_counts,
.externals = this.externals,
.exports_kind = this.exports_kind,
.import_records = this.import_records,
.hashbang = this.hashbang,
.directive = this.directive,
// .url_for_css = this.url_for_css,
.parts = this.parts,
// This list may be mutated later, so we should store the capacity
.symbols = this.symbols,
.module_scope = this.module_scope,
.char_freq = if (this.flags.has_char_freq) this.char_freq else null,
.exports_ref = this.exports_ref,
.module_ref = this.module_ref,
.wrapper_ref = this.wrapper_ref,
.require_ref = this.require_ref,
// These are used when bundling. They are filled in during the parser pass
// since we already have to traverse the AST then anyway and the parser pass
// is conveniently fully parallelized.
.named_imports = this.named_imports,
.named_exports = this.named_exports,
.export_star_import_records = this.export_star_import_records,
.allocator = this.allocator,
.top_level_symbols_to_parts = this.top_level_symbols_to_parts,
.commonjs_named_exports = this.commonjs_named_exports,
.redirect_import_record_index = this.redirect_import_record_index,
.target = this.target,
.const_values = this.const_values,
.uses_exports_ref = this.flags.uses_exports_ref,
.uses_module_ref = this.flags.uses_module_ref,
// .uses_require_ref = ast.uses_require_ref,
.export_keyword = .{ .len = if (this.flags.uses_export_keyword) 1 else 0, .loc = .{} },
.force_cjs_to_esm = this.flags.force_cjs_to_esm,
.has_lazy_export = this.flags.has_lazy_export,
};
}
pub fn init(ast: Ast) BundledAst {
return .{
.approximate_newline_count = @as(u32, @truncate(ast.approximate_newline_count)),
.nested_scope_slot_counts = ast.nested_scope_slot_counts,
.externals = ast.externals,
.exports_kind = ast.exports_kind,
.import_records = ast.import_records,
.hashbang = ast.hashbang,
.directive = ast.directive orelse "",
// .url_for_css = ast.url_for_css orelse "",
.parts = ast.parts,
// This list may be mutated later, so we should store the capacity
.symbols = ast.symbols,
.module_scope = ast.module_scope,
.char_freq = ast.char_freq orelse undefined,
.exports_ref = ast.exports_ref,
.module_ref = ast.module_ref,
.wrapper_ref = ast.wrapper_ref,
.require_ref = ast.require_ref,
// These are used when bundling. They are filled in during the parser pass
// since we already have to traverse the AST then anyway and the parser pass
// is conveniently fully parallelized.
.named_imports = ast.named_imports,
.named_exports = ast.named_exports,
.export_star_import_records = ast.export_star_import_records,
.allocator = ast.allocator,
.top_level_symbols_to_parts = ast.top_level_symbols_to_parts,
.commonjs_named_exports = ast.commonjs_named_exports,
.redirect_import_record_index = ast.redirect_import_record_index orelse std.math.maxInt(u32),
.target = ast.target,
.const_values = ast.const_values,
.flags = .{
.uses_exports_ref = ast.uses_exports_ref,
.uses_module_ref = ast.uses_module_ref,
// .uses_require_ref = ast.uses_require_ref,
.uses_export_keyword = ast.export_keyword.len > 0,
.has_char_freq = ast.char_freq != null,
.force_cjs_to_esm = ast.force_cjs_to_esm,
.has_lazy_export = ast.has_lazy_export,
},
};
}
};
pub const Span = struct {
text: string = "",
range: logger.Range = .{},
};
pub const ExportsKind = enum {
// This file doesn't have any kind of export, so it's impossible to say what
// kind of file this is. An empty file is in this category, for example.
none,
// The exports are stored on "module" and/or "exports". Calling "require()"
// on this module returns "module.exports". All imports to this module are
// allowed but may return undefined.
cjs,
// All export names are known explicitly. Calling "require()" on this module
// generates an exports object (stored in "exports") with getters for the
// export names. Named imports to this module are only allowed if they are
// in the set of export names.
esm,
// Some export names are known explicitly, but others fall back to a dynamic
// run-time object. This is necessary when using the "export * from" syntax
// with either a CommonJS module or an external module (i.e. a module whose
// export names are not known at compile-time).
//
// Calling "require()" on this module generates an exports object (stored in
// "exports") with getters for the export names. All named imports to this
// module are allowed. Direct named imports reference the corresponding export
// directly. Other imports go through property accesses on "exports".
esm_with_dynamic_fallback,
// Like "esm_with_dynamic_fallback", but the module was originally a CommonJS
// module.
esm_with_dynamic_fallback_from_cjs,
const dynamic = std.EnumSet(ExportsKind).init(.{
.esm_with_dynamic_fallback = true,
.esm_with_dynamic_fallback_from_cjs = true,
.cjs = true,
});
const with_dynamic_fallback = std.EnumSet(ExportsKind).init(.{
.esm_with_dynamic_fallback = true,
.esm_with_dynamic_fallback_from_cjs = true,
});
pub fn isDynamic(self: ExportsKind) bool {
return dynamic.contains(self);
}
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
pub fn isESMWithDynamicFallback(self: ExportsKind) bool {
return with_dynamic_fallback.contains(self);
}
};
pub const DeclaredSymbol = struct {
ref: Ref,
is_top_level: bool = false,
pub const List = struct {
entries: bun.MultiArrayList(DeclaredSymbol) = .{},
pub fn refs(this: *const List) []Ref {
return this.entries.items(.ref);
}
pub fn toOwnedSlice(this: *List) List {
var new = this.*;
this.* = .{};
return new;
}
pub fn clone(this: *const List, allocator: std.mem.Allocator) !List {
return List{ .entries = try this.entries.clone(allocator) };
}
pub inline fn len(this: List) usize {
return this.entries.len;
}
pub fn append(this: *List, allocator: std.mem.Allocator, entry: DeclaredSymbol) !void {
try this.ensureUnusedCapacity(allocator, 1);
this.appendAssumeCapacity(entry);
}
pub fn appendList(this: *List, allocator: std.mem.Allocator, other: List) !void {
try this.ensureUnusedCapacity(allocator, other.len());
this.appendListAssumeCapacity(other);
}
pub fn appendListAssumeCapacity(this: *List, other: List) void {
this.entries.appendListAssumeCapacity(other.entries);
}
pub fn appendAssumeCapacity(this: *List, entry: DeclaredSymbol) void {
this.entries.appendAssumeCapacity(entry);
}
pub fn ensureTotalCapacity(this: *List, allocator: std.mem.Allocator, count: usize) !void {
try this.entries.ensureTotalCapacity(allocator, count);
}
pub fn ensureUnusedCapacity(this: *List, allocator: std.mem.Allocator, count: usize) !void {
try this.entries.ensureUnusedCapacity(allocator, count);
}
pub fn clearRetainingCapacity(this: *List) void {
this.entries.clearRetainingCapacity();
}
pub fn deinit(this: *List, allocator: std.mem.Allocator) void {
this.entries.deinit(allocator);
}
pub fn initCapacity(allocator: std.mem.Allocator, capacity: usize) !List {
var entries = bun.MultiArrayList(DeclaredSymbol){};
try entries.ensureUnusedCapacity(allocator, capacity);
return List{ .entries = entries };
}
pub fn fromSlice(allocator: std.mem.Allocator, entries: []const DeclaredSymbol) !List {
var this = try List.initCapacity(allocator, entries.len);
errdefer this.deinit(allocator);
for (entries) |entry| {
this.appendAssumeCapacity(entry);
}
return this;
}
};
fn forEachTopLevelSymbolWithType(decls: *List, comptime Ctx: type, ctx: Ctx, comptime Fn: fn (Ctx, Ref) void) void {
var entries = decls.entries.slice();
const is_top_level = entries.items(.is_top_level);
const refs = entries.items(.ref);
// TODO: SIMD
for (is_top_level, refs) |top, ref| {
if (top) {
@call(.always_inline, Fn, .{ ctx, ref });
}
}
}
pub fn forEachTopLevelSymbol(decls: *List, ctx: anytype, comptime Fn: anytype) void {
forEachTopLevelSymbolWithType(decls, @TypeOf(ctx), ctx, Fn);
}
};
pub const Dependency = struct {
source_index: Index = Index.invalid,
part_index: Index.Int = 0,
pub const List = BabyList(Dependency);
};
pub const ExprList = std.ArrayList(Expr);
pub const StmtList = std.ArrayList(Stmt);
pub const BindingList = std.ArrayList(Binding);
// Each file is made up of multiple parts, and each part consists of one or
// more top-level statements. Parts are used for tree shaking and code
// splitting analysis. Individual parts of a file can be discarded by tree
// shaking and can be assigned to separate chunks (i.e. output files) by code
// splitting.
pub const Part = struct {
pub const ImportRecordIndices = BabyList(u32);
pub const List = BabyList(Part);
stmts: []Stmt = &([_]Stmt{}),
scopes: []*Scope = &([_]*Scope{}),
// Each is an index into the file-level import record list
import_record_indices: ImportRecordIndices = .{},
// All symbols that are declared in this part. Note that a given symbol may
// have multiple declarations, and so may end up being declared in multiple
// parts (e.g. multiple "var" declarations with the same name). Also note
// that this list isn't deduplicated and may contain duplicates.
declared_symbols: DeclaredSymbol.List = .{},
// An estimate of the number of uses of all symbols used within this part.
symbol_uses: SymbolUseMap = SymbolUseMap{},
// The indices of the other parts in this file that are needed if this part
// is needed.
dependencies: Dependency.List = .{},
// If true, this part can be removed if none of the declared symbols are
// used. If the file containing this part is imported, then all parts that
// don't have this flag enabled must be included.
can_be_removed_if_unused: bool = false,
// This is used for generated parts that we don't want to be present if they
// aren't needed. This enables tree shaking for these parts even if global
// tree shaking isn't enabled.
force_tree_shaking: bool = false,
// This is true if this file has been marked as live by the tree shaking
// algorithm.
is_live: bool = false,
tag: Tag = Tag.none,
valid_in_development: if (bun.Environment.allow_assert) bool else void = bun.DebugOnlyDefault(true),
pub const Tag = enum {
none,
jsx_import,
runtime,
cjs_imports,
react_fast_refresh,
dirname_filename,
bun_test,
dead_due_to_inlining,
commonjs_named_export,
import_to_convert_from_require,
};
pub const SymbolUseMap = std.ArrayHashMapUnmanaged(Ref, Symbol.Use, RefHashCtx, false);
pub fn jsonStringify(self: *const Part, writer: anytype) !void {
return writer.write(self.stmts);
}
};
pub const Result = union(enum) {
already_bundled: void,
ast: Ast,
};
pub const StmtOrExpr = union(enum) {
stmt: StmtNodeIndex,
expr: ExprNodeIndex,
};
pub const NamedImport = struct {
// Parts within this file that use this import
local_parts_with_uses: BabyList(u32) = BabyList(u32){},
alias: ?string,
alias_loc: ?logger.Loc = null,
namespace_ref: ?Ref,
import_record_index: u32,
// If true, the alias refers to the entire export namespace object of a
// module. This is no longer represented as an alias called "*" because of
// the upcoming "Arbitrary module namespace identifier names" feature:
// https://github.com/tc39/ecma262/pull/2154
alias_is_star: bool = false,
// It's useful to flag exported imports because if they are in a TypeScript
// file, we can't tell if they are a type or a value.
is_exported: bool = false,
};
pub const NamedExport = struct {
ref: Ref,
alias_loc: logger.Loc,
};
pub const StrictModeKind = enum(u4) {
sloppy_mode,
explicit_strict_mode,
implicit_strict_mode_import,
implicit_strict_mode_export,
implicit_strict_mode_top_level_await,
implicit_strict_mode_class,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
};
pub const Scope = struct {
pub const MemberHashMap = bun.StringHashMapUnmanaged(Member);
id: usize = 0,
kind: Kind = Kind.block,
parent: ?*Scope = null,
children: BabyList(*Scope) = .{},
members: MemberHashMap = .{},
generated: BabyList(Ref) = .{},
// This is used to store the ref of the label symbol for ScopeLabel scopes.
label_ref: ?Ref = null,
label_stmt_is_loop: bool = false,
// If a scope contains a direct eval() expression, then none of the symbols
// inside that scope can be renamed. We conservatively assume that the
// evaluated code might reference anything that it has access to.
contains_direct_eval: bool = false,
// This is to help forbid "arguments" inside class body scopes
forbid_arguments: bool = false,
strict_mode: StrictModeKind = StrictModeKind.sloppy_mode,
is_after_const_local_prefix: bool = false,
pub const NestedScopeMap = std.AutoArrayHashMap(u32, bun.BabyList(*Scope));
pub fn getMemberHash(name: []const u8) u64 {
return bun.StringHashMapContext.hash(.{}, name);
}
pub fn getMemberWithHash(this: *const Scope, name: []const u8, hash_value: u64) ?Member {
const hashed = bun.StringHashMapContext.Prehashed{
.value = hash_value,
.input = name,
};
return this.members.getAdapted(name, hashed);
}
pub fn getOrPutMemberWithHash(
this: *Scope,
allocator: std.mem.Allocator,
name: []const u8,
hash_value: u64,
) !MemberHashMap.GetOrPutResult {
const hashed = bun.StringHashMapContext.Prehashed{
.value = hash_value,
.input = name,
};
return this.members.getOrPutContextAdapted(allocator, name, hashed, .{});
}
pub fn reset(this: *Scope) void {
this.children.clearRetainingCapacity();
this.generated.clearRetainingCapacity();
this.members.clearRetainingCapacity();
this.parent = null;
this.id = 0;
this.label_ref = null;
this.label_stmt_is_loop = false;
this.contains_direct_eval = false;
this.strict_mode = .sloppy_mode;
this.kind = .block;
}
// Do not make this a packed struct
// Two hours of debugging time lost to that.
// It causes a crash due to undefined memory
pub const Member = struct {
ref: Ref,
loc: logger.Loc,
pub fn eql(a: Member, b: Member) bool {
return @call(.always_inline, Ref.eql, .{ a.ref, b.ref }) and a.loc.start == b.loc.start;
}
};
pub const SymbolMergeResult = enum {
forbidden,
replace_with_new,
overwrite_with_new,
keep_existing,
become_private_get_set_pair,
become_private_static_get_set_pair,
};
pub fn canMergeSymbols(
scope: *Scope,
existing: Symbol.Kind,
new: Symbol.Kind,
comptime is_typescript_enabled: bool,
) SymbolMergeResult {
if (existing == .unbound) {
return .replace_with_new;
}
if (comptime is_typescript_enabled) {
// In TypeScript, imports are allowed to silently collide with symbols within
// the module. Presumably this is because the imports may be type-only:
//
// import {Foo} from 'bar'
// class Foo {}
//
if (existing == .import) {
return .replace_with_new;
}
// "enum Foo {} enum Foo {}"
// "namespace Foo { ... } enum Foo {}"
if (new == .ts_enum and (existing == .ts_enum or existing == .ts_namespace)) {
return .replace_with_new;
}
// "namespace Foo { ... } namespace Foo { ... }"
// "function Foo() {} namespace Foo { ... }"
// "enum Foo {} namespace Foo { ... }"
if (new == .ts_namespace) {
switch (existing) {
.ts_namespace, .hoisted_function, .generator_or_async_function, .ts_enum, .class => {
return .keep_existing;
},
else => {},
}
}
}
// "var foo; var foo;"
// "var foo; function foo() {}"
// "function foo() {} var foo;"
// "function *foo() {} function *foo() {}" but not "{ function *foo() {} function *foo() {} }"
if (Symbol.isKindHoistedOrFunction(new) and
Symbol.isKindHoistedOrFunction(existing) and
(scope.kind == .entry or scope.kind == .function_body or scope.kind == .function_args or
(new == existing and Symbol.isKindHoisted(existing))))
{
return .replace_with_new;
}
// "get #foo() {} set #foo() {}"
// "set #foo() {} get #foo() {}"
if ((existing == .private_get and new == .private_set) or
(existing == .private_set and new == .private_get))
{
return .become_private_get_set_pair;
}
if ((existing == .private_static_get and new == .private_static_set) or
(existing == .private_static_set and new == .private_static_get))
{
return .become_private_static_get_set_pair;
}
// "try {} catch (e) { var e }"
if (existing == .catch_identifier and new == .hoisted) {
return .replace_with_new;
}
// "function() { var arguments }"
if (existing == .arguments and new == .hoisted) {
return .keep_existing;
}
// "function() { let arguments }"
if (existing == .arguments and new != .hoisted) {
return .overwrite_with_new;
}
return .forbidden;
}
pub const Kind = enum(u8) {
block,
with,
label,
class_name,
class_body,
catch_binding,
// The scopes below stop hoisted variables from extending into parent scopes
entry, // This is a module, TypeScript enum, or TypeScript namespace
function_args,
function_body,
class_static_init,
pub fn jsonStringify(self: @This(), writer: anytype) !void {
return try writer.write(@tagName(self));
}
};
pub fn recursiveSetStrictMode(s: *Scope, kind: StrictModeKind) void {
if (s.strict_mode == .sloppy_mode) {
s.strict_mode = kind;
for (s.children.slice()) |child| {
child.recursiveSetStrictMode(kind);
}
}
}
pub inline fn kindStopsHoisting(s: *const Scope) bool {
return @intFromEnum(s.kind) >= @intFromEnum(Kind.entry);
}
};
pub fn printmem(comptime format: string, args: anytype) void {
defer Output.flush();
Output.initTest();
Output.print(format, args);
}
pub const Macro = struct {
const JavaScript = @import("root").bun.JSC;
const JSCBase = @import("./bun.js/base.zig");
const Resolver = @import("./resolver/resolver.zig").Resolver;
const isPackagePath = @import("./resolver/resolver.zig").isPackagePath;
const ResolveResult = @import("./resolver/resolver.zig").Result;
const DotEnv = @import("./env_loader.zig");
const js = @import("./bun.js/javascript_core_c_api.zig");
const Zig = @import("./bun.js/bindings/exports.zig");
const Bundler = bun.Bundler;
const MacroEntryPoint = bun.bundler.MacroEntryPoint;
const MacroRemap = @import("./resolver/package_json.zig").MacroMap;
pub const MacroRemapEntry = @import("./resolver/package_json.zig").MacroImportReplacementMap;
pub const namespace: string = "macro";
pub const namespaceWithColon: string = namespace ++ ":";
pub fn isMacroPath(str: string) bool {
return strings.hasPrefixComptime(str, namespaceWithColon);
}
pub const MacroContext = struct {
pub const MacroMap = std.AutoArrayHashMap(i32, Macro);
resolver: *Resolver,
env: *DotEnv.Loader,
macros: MacroMap,
remap: MacroRemap,
javascript_object: JSC.JSValue = JSC.JSValue.zero,
pub fn getRemap(this: MacroContext, path: string) ?MacroRemapEntry {
if (this.remap.entries.len == 0) return null;
return this.remap.get(path);
}
pub fn init(bundler: *Bundler) MacroContext {
return MacroContext{
.macros = MacroMap.init(default_allocator),
.resolver = &bundler.resolver,
.env = bundler.env,
.remap = bundler.options.macro_remap,
};
}
pub fn call(
this: *MacroContext,
import_record_path: string,
source_dir: string,
log: *logger.Log,
source: *const logger.Source,
import_range: logger.Range,
caller: Expr,
args: []Expr,
function_name: string,
comptime Visitor: type,
visitor: Visitor,
) anyerror!Expr {
Expr.Data.Store.disable_reset = true;
Stmt.Data.Store.disable_reset = true;
defer Expr.Data.Store.disable_reset = false;
defer Stmt.Data.Store.disable_reset = false;
// const is_package_path = isPackagePath(specifier);
const import_record_path_without_macro_prefix = if (isMacroPath(import_record_path))
import_record_path[namespaceWithColon.len..]
else
import_record_path;
std.debug.assert(!isMacroPath(import_record_path_without_macro_prefix));
const resolve_result = this.resolver.resolve(source_dir, import_record_path_without_macro_prefix, .stmt) catch |err| {
switch (err) {
error.ModuleNotFound => {
log.addResolveError(
source,
import_range,
log.msgs.allocator,
"Macro \"{s}\" not found",
.{import_record_path},
.stmt,
err,
) catch unreachable;
return error.MacroNotFound;
},
else => {
log.addRangeErrorFmt(
source,
import_range,
log.msgs.allocator,
"{s} resolving macro \"{s}\"",
.{ @errorName(err), import_record_path },
) catch unreachable;
return err;
},
}
};
var specifier_buf: [64]u8 = undefined;
var specifier_buf_len: u32 = 0;
const hash = MacroEntryPoint.generateID(
resolve_result.path_pair.primary.text,
function_name,
&specifier_buf,
&specifier_buf_len,
);
var macro_entry = this.macros.getOrPut(hash) catch unreachable;
if (!macro_entry.found_existing) {
macro_entry.value_ptr.* = Macro.init(
default_allocator,
this.resolver,
resolve_result,
log,
this.env,
function_name,
specifier_buf[0..specifier_buf_len],
hash,
) catch |err| {
macro_entry.value_ptr.* = Macro{ .resolver = undefined, .disabled = true };
return err;
};
Output.flush();
}
defer Output.flush();
const macro = macro_entry.value_ptr.*;
if (macro.disabled) {
return caller;
}
macro.vm.enableMacroMode();
defer macro.vm.disableMacroMode();
return try Macro.Runner.run(
macro,
log,
default_allocator,
function_name,
caller,
args,
source,
hash,
comptime Visitor,
visitor,
this.javascript_object,
);
// this.macros.getOrPut(key: K)
}
};
pub const MacroResult = struct {
import_statements: []S.Import = &[_]S.Import{},
replacement: Expr,
};
resolver: *Resolver,
vm: *JavaScript.VirtualMachine = undefined,
resolved: ResolveResult = undefined,
disabled: bool = false,
pub fn init(
_: std.mem.Allocator,
resolver: *Resolver,
resolved: ResolveResult,
log: *logger.Log,
env: *DotEnv.Loader,
function_name: string,
specifier: string,
hash: i32,
) !Macro {
const path = resolved.path_pair.primary;
var vm: *JavaScript.VirtualMachine = if (JavaScript.VirtualMachine.isLoaded())
JavaScript.VirtualMachine.get()
else brk: {
var old_transform_options = resolver.opts.transform_options;
defer resolver.opts.transform_options = old_transform_options;
// JSC needs to be initialized if building from CLI
JSC.initialize();
var _vm = try JavaScript.VirtualMachine.init(.{
.allocator = default_allocator,
.args = resolver.opts.transform_options,
.log = log,
.env_loader = env,
});
_vm.enableMacroMode();
_vm.eventLoop().ensureWaker();
try _vm.bundler.configureDefines();
break :brk _vm;
};
vm.enableMacroMode();
var loaded_result = try vm.loadMacroEntryPoint(path.text, function_name, specifier, hash);
if (loaded_result.status(vm.global.vm()) == JSC.JSPromise.Status.Rejected) {
vm.runErrorHandler(loaded_result.result(vm.global.vm()), null);
vm.disableMacroMode();
return error.MacroLoadError;
}
// We don't need to do anything with the result.
// We just want to make sure the promise is finished.
_ = loaded_result.result(vm.global.vm());
return Macro{
.vm = vm,
.resolved = resolved,
.resolver = resolver,
};
}
pub const Runner = struct {
const VisitMap = std.AutoHashMapUnmanaged(JSC.JSValue, Expr);
threadlocal var args_buf: [3]js.JSObjectRef = undefined;
threadlocal var exception_holder: Zig.ZigException.Holder = undefined;
pub const MacroError = error{ MacroFailed, OutOfMemory } || ToJSError;
pub fn NewRun(comptime Visitor: type) type {
return struct {
const Run = @This();
caller: Expr,
function_name: string,
macro: *const Macro,
global: *JSC.JSGlobalObject,
allocator: std.mem.Allocator,
id: i32,
log: *logger.Log,
source: *const logger.Source,
visited: VisitMap = VisitMap{},
visitor: Visitor,
is_top_level: bool = false,
pub fn runAsync(
macro: Macro,
log: *logger.Log,
allocator: std.mem.Allocator,
function_name: string,
caller: Expr,
args_count: usize,
args_ptr: [*]JSC.JSValue,
source: *const logger.Source,
id: i32,
visitor: Visitor,
) MacroError!Expr {
if (comptime is_bindgen) return undefined;
var macro_callback = macro.vm.macros.get(id) orelse return caller;
var result = js.JSObjectCallAsFunctionReturnValueHoldingAPILock(
macro.vm.global,
macro_callback,
null,
args_count,
@as([*]js.JSObjectRef, @ptrCast(args_ptr)),
);
var runner = Run{
.caller = caller,
.function_name = function_name,
.macro = ¯o,
.allocator = allocator,
.global = macro.vm.global,
.id = id,
.log = log,
.source = source,
.visited = VisitMap{},
.visitor = visitor,
};
defer runner.visited.deinit(allocator);
return try runner.run(
result,
);
}
pub fn run(
this: *Run,
value: JSC.JSValue,
) MacroError!Expr {
return try switch (JSC.ZigConsoleClient.Formatter.Tag.get(value, this.global).tag) {
.Error => this.coerce(value, .Error),
.Undefined => this.coerce(value, .Undefined),
.Null => this.coerce(value, .Null),
.Private => this.coerce(value, .Private),
.Boolean => this.coerce(value, .Boolean),
.Array => this.coerce(value, .Array),
.Object => this.coerce(value, .Object),
.JSON => this.coerce(value, .JSON),
.Integer => this.coerce(value, .Integer),
.Double => this.coerce(value, .Double),
.String => this.coerce(value, .String),
.Promise => this.coerce(value, .Promise),
else => brk: {
this.log.addErrorFmt(
this.source,
this.caller.loc,
this.allocator,
"cannot coerce {s} to Bun's AST. Please return a valid macro using the JSX syntax",
.{@tagName(value.jsType())},
) catch unreachable;
break :brk error.MacroFailed;
},
};
}
pub fn coerce(
this: *Run,
value: JSC.JSValue,
comptime tag: JSC.ZigConsoleClient.Formatter.Tag,
) MacroError!Expr {
switch (comptime tag) {
.Error => {
this.macro.vm.runErrorHandler(value, null);
return this.caller;
},
.Undefined => if (this.is_top_level)
return this.caller
else
return Expr.init(E.Undefined, E.Undefined{}, this.caller.loc),
.Null => return Expr.init(E.Null, E.Null{}, this.caller.loc),
.Private => {
this.is_top_level = false;
var _entry = this.visited.getOrPut(this.allocator, value) catch unreachable;
if (_entry.found_existing) {
return _entry.value_ptr.*;
}
var blob_: ?JSC.WebCore.Blob = null;
var mime_type: ?HTTP.MimeType = null;
if (value.jsType() == .DOMWrapper) {
if (value.as(JSC.WebCore.Response)) |resp| {
mime_type = HTTP.MimeType.init(resp.mimeType(null), null, null);
blob_ = resp.body.use();
} else if (value.as(JSC.WebCore.Request)) |resp| {
mime_type = HTTP.MimeType.init(resp.mimeType(), null, null);
blob_ = resp.body.value.use();
} else if (value.as(JSC.WebCore.Blob)) |resp| {
blob_ = resp.*;
blob_.?.allocator = null;
} else if (value.as(JSC.ResolveMessage) != null or value.as(JSC.BuildMessage) != null) {
this.macro.vm.runErrorHandler(value, null);
return error.MacroFailed;
}
}
if (blob_) |*blob| {
const out_expr = Expr.fromBlob(
blob,
this.allocator,
mime_type,
this.log,
this.caller.loc,
) catch {
blob.deinit();
return error.MacroFailed;
};
if (out_expr.data == .e_string) {
blob.deinit();
}
return out_expr;
}
return Expr.init(E.String, E.String.empty, this.caller.loc);
},
.Boolean => {
return Expr{ .data = .{ .e_boolean = .{ .value = value.toBoolean() } }, .loc = this.caller.loc };
},
JSC.ZigConsoleClient.Formatter.Tag.Array => {
this.is_top_level = false;
var _entry = this.visited.getOrPut(this.allocator, value) catch unreachable;
if (_entry.found_existing) {
switch (_entry.value_ptr.*.data) {
.e_object, .e_array => {
this.log.addErrorFmt(this.source, this.caller.loc, this.allocator, "converting circular structure to Bun AST is not implemented yet", .{}) catch unreachable;
return error.MacroFailed;
},
else => {},
}
return _entry.value_ptr.*;
}
var iter = JSC.JSArrayIterator.init(value, this.global);
if (iter.len == 0) {
const result = Expr.init(
E.Array,
E.Array{
.items = ExprNodeList.init(&[_]Expr{}),
.was_originally_macro = true,
},
this.caller.loc,
);
_entry.value_ptr.* = result;
return result;
}
var array = this.allocator.alloc(Expr, iter.len) catch unreachable;
var out = Expr.init(
E.Array,
E.Array{
.items = ExprNodeList.init(array[0..0]),
.was_originally_macro = true,
},
this.caller.loc,
);
_entry.value_ptr.* = out;
errdefer this.allocator.free(array);
var i: usize = 0;
while (iter.next()) |item| {
array[i] = try this.run(item);
if (array[i].isMissing())
continue;
i += 1;
}
out.data.e_array.items = ExprNodeList.init(array);
_entry.value_ptr.* = out;
return out;
},
// TODO: optimize this
JSC.ZigConsoleClient.Formatter.Tag.Object => {
this.is_top_level = false;
var _entry = this.visited.getOrPut(this.allocator, value) catch unreachable;
if (_entry.found_existing) {
switch (_entry.value_ptr.*.data) {
.e_object, .e_array => {
this.log.addErrorFmt(this.source, this.caller.loc, this.allocator, "converting circular structure to Bun AST is not implemented yet", .{}) catch unreachable;
return error.MacroFailed;
},
else => {},
}
return _entry.value_ptr.*;
}
var object = value.asObjectRef();
var object_iter = JSC.JSPropertyIterator(.{
.skip_empty_name = false,
.include_value = true,
}).init(this.global, object);
defer object_iter.deinit();
var properties = this.allocator.alloc(G.Property, object_iter.len) catch unreachable;
errdefer this.allocator.free(properties);
var out = Expr.init(
E.Object,
E.Object{
.properties = BabyList(G.Property).init(properties),
.was_originally_macro = true,
},
this.caller.loc,
);
_entry.value_ptr.* = out;
while (object_iter.next()) |prop| {
properties[object_iter.i] = G.Property{
.key = Expr.init(E.String, E.String.init(prop.toOwnedSlice(this.allocator) catch unreachable), this.caller.loc),
.value = try this.run(object_iter.value),
};
}
out.data.e_object.properties = BabyList(G.Property).init(properties[0..object_iter.i]);
_entry.value_ptr.* = out;
return out;
},
.JSON => {
this.is_top_level = false;
// if (console_tag.cell == .JSDate) {
// // in the code for printing dates, it never exceeds this amount
// var iso_string_buf = this.allocator.alloc(u8, 36) catch unreachable;
// var str = JSC.ZigString.init("");
// value.jsonStringify(this.global, 0, &str);
// var out_buf: []const u8 = std.fmt.bufPrint(iso_string_buf, "{}", .{str}) catch "";
// if (out_buf.len > 2) {
// // trim the quotes
// out_buf = out_buf[1 .. out_buf.len - 1];
// }
// return Expr.init(E.New, E.New{.target = Expr.init(E.Dot{.target = E}) })
// }
},
.Integer => {
return Expr.init(E.Number, E.Number{ .value = @as(f64, @floatFromInt(value.toInt32())) }, this.caller.loc);
},
.Double => {
return Expr.init(E.Number, E.Number{ .value = value.asNumber() }, this.caller.loc);
},
.String => {
var bun_str = value.toBunString(this.global);
// encode into utf16 so the printer escapes the string correctly
var utf16_bytes = this.allocator.alloc(u16, bun_str.length()) catch unreachable;
var out_slice = utf16_bytes[0 .. (bun_str.encodeInto(std.mem.sliceAsBytes(utf16_bytes), .utf16le) catch 0) / 2];
return Expr.init(E.String, E.String.init(out_slice), this.caller.loc);
},
.Promise => {
var _entry = this.visited.getOrPut(this.allocator, value) catch unreachable;
if (_entry.found_existing) {
return _entry.value_ptr.*;
}
var promise_result = JSC.JSValue.zero;
var rejected = false;
if (value.asAnyPromise()) |promise| {
this.macro.vm.waitForPromise(promise);
promise_result = promise.result(this.global.vm());
rejected = promise.status(this.global.vm()) == .Rejected;
} else {
@panic("Unexpected promise type");
}
if (promise_result.isUndefined() and this.is_top_level) {
this.is_top_level = false;
return this.caller;
}
if (rejected or promise_result.isError() or promise_result.isAggregateError(this.global) or promise_result.isException(this.global.vm())) {
this.macro.vm.runErrorHandler(promise_result, null);
return error.MacroFailed;
}
this.is_top_level = false;
const result = try this.run(promise_result);
_entry.value_ptr.* = result;
return result;
},
else => {},
}
this.log.addErrorFmt(
this.source,
this.caller.loc,
this.allocator,
"cannot coerce {s} to Bun's AST. Please return a valid macro using the JSX syntax",
.{@tagName(value.jsType())},
) catch unreachable;
return error.MacroFailed;
}
};
}
pub fn run(
macro: Macro,
log: *logger.Log,
allocator: std.mem.Allocator,
function_name: string,
caller: Expr,
_: []Expr,
source: *const logger.Source,
id: i32,
comptime Visitor: type,
visitor: Visitor,
javascript_object: JSC.JSValue,
) MacroError!Expr {
if (comptime Environment.isDebug) Output.prettyln("[macro] call {s}", .{function_name});
exception_holder = Zig.ZigException.Holder.init();
var js_args: []JSC.JSValue = &.{};
defer {
for (js_args[0 .. js_args.len - @as(usize, @intFromBool(!javascript_object.isEmpty()))]) |arg| {
arg.unprotect();
}
allocator.free(js_args);
}
var globalObject = JSC.VirtualMachine.get().global;
switch (caller.data) {
.e_call => |call| {
const call_args: []Expr = call.args.slice();
js_args = try allocator.alloc(JSC.JSValue, call_args.len + @as(usize, @intFromBool(!javascript_object.isEmpty())));
for (call_args, js_args[0..call_args.len]) |in, *out| {
const value = try in.toJS(
allocator,
globalObject,
);
value.protect();
out.* = value;
}
},
.e_template => {
@panic("TODO: support template literals in macros");
},
else => {
@panic("Unexpected caller type");
},
}
if (!javascript_object.isEmpty()) {
if (js_args.len == 0) {
js_args = try allocator.alloc(JSC.JSValue, 1);
}
js_args[js_args.len - 1] = javascript_object;
}
const Run = NewRun(Visitor);
const CallFunction = @TypeOf(Run.runAsync);
const CallArgs = std.meta.ArgsTuple(CallFunction);
const CallData = struct {
threadlocal var call_args: CallArgs = undefined;
threadlocal var result: MacroError!Expr = undefined;
pub fn callWrapper(args: CallArgs) MacroError!Expr {
JSC.markBinding(@src());
call_args = args;
Bun__startMacro(&call, JSC.VirtualMachine.get().global);
return result;
}
pub fn call() callconv(.C) void {
const call_args_copy = call_args;
const local_result = @call(.auto, Run.runAsync, call_args_copy);
result = local_result;
}
};
// TODO: can change back to `return CallData.callWrapper(.{`
// when https://github.com/ziglang/zig/issues/16242 is fixed
return CallData.callWrapper(CallArgs{
macro,
log,
allocator,
function_name,
caller,
js_args.len,
js_args.ptr,
source,
id,
visitor,
});
}
extern "C" fn Bun__startMacro(function: *const anyopaque, *anyopaque) void;
};
};
pub const ASTMemoryAllocator = struct {
stack_allocator: std.heap.StackFallbackAllocator(
if (std.mem.page_size > 8096) 8096 else std.mem.page_size,
) = undefined,
bump_allocator: std.mem.Allocator = undefined,
allocator: std.mem.Allocator,
previous: ?*ASTMemoryAllocator = null,
pub fn reset(this: *ASTMemoryAllocator) void {
this.stack_allocator.fallback_allocator = this.allocator;
this.bump_allocator = this.stack_allocator.get();
}
pub fn push(this: *ASTMemoryAllocator) void {
Stmt.Data.Store.memory_allocator = this;
Expr.Data.Store.memory_allocator = this;
}
pub fn pop(this: *ASTMemoryAllocator) void {
var prev = this.previous;
std.debug.assert(prev != this);
Stmt.Data.Store.memory_allocator = prev;
Expr.Data.Store.memory_allocator = prev;
this.previous = null;
}
pub fn append(this: ASTMemoryAllocator, comptime ValueType: type, value: anytype) *ValueType {
const ptr = this.bump_allocator.create(ValueType) catch unreachable;
ptr.* = value;
return ptr;
}
};
pub const UseDirective = enum {
none,
@"use client",
@"use server",
pub const Flags = struct {
is_client: bool = false,
is_server: bool = false,
};
pub fn isBoundary(this: UseDirective, other: UseDirective) bool {
if (this == other or other == .none)
return false;
return true;
}
pub fn boundering(this: UseDirective, other: UseDirective) ?UseDirective {
if (this == other or other == .none)
return null;
return other;
}
pub const EntryPoint = struct {
source_index: Index.Int,
use_directive: UseDirective,
};
pub const List = std.MultiArrayList(UseDirective.EntryPoint);
// TODO: remove this, add an onModuleDirective() callback to the parser
pub fn parse(contents: []const u8) UseDirective {
const truncated = std.mem.trimLeft(u8, contents, " \t\n\r;");
if (truncated.len < "'use client';".len)
return .none;
const directive_string = truncated[0.."'use client';".len].*;
const first_quote = directive_string[0];
const last_quote = directive_string[directive_string.len - 2];
if (first_quote != last_quote or (first_quote != '"' and first_quote != '\'' and first_quote != '`'))
return .none;
const unquoted = directive_string[1 .. directive_string.len - 2];
if (strings.eqlComptime(
unquoted,
"use client",
)) {
return .@"use client";
}
if (strings.eqlComptime(
unquoted,
"use server",
)) {
return .@"use server";
}
return .none;
}
pub fn target(this: UseDirective, default: bun.options.Target) bun.options.Target {
return switch (this) {
.none => default,
.@"use client" => .browser,
.@"use server" => .bun,
};
}
};
pub const GlobalStoreHandle = struct {
prev_memory_allocator: ?*ASTMemoryAllocator = null,
var global_store_ast: ?*ASTMemoryAllocator = null;
var global_store_threadsafe: std.heap.ThreadSafeAllocator = undefined;
pub fn get() ?*ASTMemoryAllocator {
if (global_store_ast == null) {
var global = bun.default_allocator.create(ASTMemoryAllocator) catch unreachable;
global.allocator = bun.default_allocator;
global.bump_allocator = bun.default_allocator;
global_store_ast = global;
}
var prev = Stmt.Data.Store.memory_allocator;
Stmt.Data.Store.memory_allocator = global_store_ast;
Expr.Data.Store.memory_allocator = global_store_ast;
return prev;
}
pub fn unget(handle: ?*ASTMemoryAllocator) void {
Stmt.Data.Store.memory_allocator = handle;
Expr.Data.Store.memory_allocator = handle;
}
};
// test "Binding.init" {
// var binding = Binding.alloc(
// std.heap.page_allocator,
// B.Identifier{ .ref = Ref{ .source_index = 0, .innerIndex() = 10 } },
// logger.Loc{ .start = 1 },
// );
// std.testing.expect(binding.loc.start == 1);
// std.testing.expect(@as(Binding.Tag, binding.data) == Binding.Tag.b_identifier);
// printmem("-------Binding: {d} bits\n", .{@bitSizeOf(Binding)});
// printmem("B.Identifier: {d} bits\n", .{@bitSizeOf(B.Identifier)});
// printmem("B.Array: {d} bits\n", .{@bitSizeOf(B.Array)});
// printmem("B.Property: {d} bits\n", .{@bitSizeOf(B.Property)});
// printmem("B.Object: {d} bits\n", .{@bitSizeOf(B.Object)});
// printmem("B.Missing: {d} bits\n", .{@bitSizeOf(B.Missing)});
// printmem("-------Binding: {d} bits\n", .{@bitSizeOf(Binding)});
// }
// test "Stmt.init" {
// var stmt = Stmt.alloc(
// std.heap.page_allocator,
// S.Continue{},
// logger.Loc{ .start = 1 },
// );
// std.testing.expect(stmt.loc.start == 1);
// std.testing.expect(@as(Stmt.Tag, stmt.data) == Stmt.Tag.s_continue);
// printmem("-----Stmt {d} bits\n", .{@bitSizeOf(Stmt)});
// printmem("StmtNodeList: {d} bits\n", .{@bitSizeOf(StmtNodeList)});
// printmem("StmtOrExpr: {d} bits\n", .{@bitSizeOf(StmtOrExpr)});
// printmem("S.Block {d} bits\n", .{@bitSizeOf(S.Block)});
// printmem("S.Comment {d} bits\n", .{@bitSizeOf(S.Comment)});
// printmem("S.Directive {d} bits\n", .{@bitSizeOf(S.Directive)});
// printmem("S.ExportClause {d} bits\n", .{@bitSizeOf(S.ExportClause)});
// printmem("S.Empty {d} bits\n", .{@bitSizeOf(S.Empty)});
// printmem("S.TypeScript {d} bits\n", .{@bitSizeOf(S.TypeScript)});
// printmem("S.Debugger {d} bits\n", .{@bitSizeOf(S.Debugger)});
// printmem("S.ExportFrom {d} bits\n", .{@bitSizeOf(S.ExportFrom)});
// printmem("S.ExportDefault {d} bits\n", .{@bitSizeOf(S.ExportDefault)});
// printmem("S.Enum {d} bits\n", .{@bitSizeOf(S.Enum)});
// printmem("S.Namespace {d} bits\n", .{@bitSizeOf(S.Namespace)});
// printmem("S.Function {d} bits\n", .{@bitSizeOf(S.Function)});
// printmem("S.Class {d} bits\n", .{@bitSizeOf(S.Class)});
// printmem("S.If {d} bits\n", .{@bitSizeOf(S.If)});
// printmem("S.For {d} bits\n", .{@bitSizeOf(S.For)});
// printmem("S.ForIn {d} bits\n", .{@bitSizeOf(S.ForIn)});
// printmem("S.ForOf {d} bits\n", .{@bitSizeOf(S.ForOf)});
// printmem("S.DoWhile {d} bits\n", .{@bitSizeOf(S.DoWhile)});
// printmem("S.While {d} bits\n", .{@bitSizeOf(S.While)});
// printmem("S.With {d} bits\n", .{@bitSizeOf(S.With)});
// printmem("S.Try {d} bits\n", .{@bitSizeOf(S.Try)});
// printmem("S.Switch {d} bits\n", .{@bitSizeOf(S.Switch)});
// printmem("S.Import {d} bits\n", .{@bitSizeOf(S.Import)});
// printmem("S.Return {d} bits\n", .{@bitSizeOf(S.Return)});
// printmem("S.Throw {d} bits\n", .{@bitSizeOf(S.Throw)});
// printmem("S.Local {d} bits\n", .{@bitSizeOf(S.Local)});
// printmem("S.Break {d} bits\n", .{@bitSizeOf(S.Break)});
// printmem("S.Continue {d} bits\n", .{@bitSizeOf(S.Continue)});
// printmem("-----Stmt {d} bits\n", .{@bitSizeOf(Stmt)});
// }
// test "Expr.init" {
// var allocator = std.heap.page_allocator;
// const ident = Expr.init(E.Identifier, E.Identifier{}, logger.Loc{ .start = 100 });
// var list = [_]Expr{ident};
// var expr = Expr.init(
// E.Array,
// E.Array{ .items = list[0..] },
// logger.Loc{ .start = 1 },
// );
// try std.testing.expect(expr.loc.start == 1);
// try std.testing.expect(@as(Expr.Tag, expr.data) == Expr.Tag.e_array);
// try std.testing.expect(expr.data.e_array.items[0].loc.start == 100);
// printmem("--Ref {d} bits\n", .{@bitSizeOf(Ref)});
// printmem("--LocRef {d} bits\n", .{@bitSizeOf(LocRef)});
// printmem("--logger.Loc {d} bits\n", .{@bitSizeOf(logger.Loc)});
// printmem("--logger.Range {d} bits\n", .{@bitSizeOf(logger.Range)});
// printmem("----------Expr: {d} bits\n", .{@bitSizeOf(Expr)});
// printmem("ExprNodeList: {d} bits\n", .{@bitSizeOf(ExprNodeList)});
// printmem("E.Array: {d} bits\n", .{@bitSizeOf(E.Array)});
// printmem("E.Unary: {d} bits\n", .{@bitSizeOf(E.Unary)});
// printmem("E.Binary: {d} bits\n", .{@bitSizeOf(E.Binary)});
// printmem("E.Boolean: {d} bits\n", .{@bitSizeOf(E.Boolean)});
// printmem("E.Super: {d} bits\n", .{@bitSizeOf(E.Super)});
// printmem("E.Null: {d} bits\n", .{@bitSizeOf(E.Null)});
// printmem("E.Undefined: {d} bits\n", .{@bitSizeOf(E.Undefined)});
// printmem("E.New: {d} bits\n", .{@bitSizeOf(E.New)});
// printmem("E.NewTarget: {d} bits\n", .{@bitSizeOf(E.NewTarget)});
// printmem("E.Function: {d} bits\n", .{@bitSizeOf(E.Function)});
// printmem("E.ImportMeta: {d} bits\n", .{@bitSizeOf(E.ImportMeta)});
// printmem("E.Call: {d} bits\n", .{@bitSizeOf(E.Call)});
// printmem("E.Dot: {d} bits\n", .{@bitSizeOf(E.Dot)});
// printmem("E.Index: {d} bits\n", .{@bitSizeOf(E.Index)});
// printmem("E.Arrow: {d} bits\n", .{@bitSizeOf(E.Arrow)});
// printmem("E.Identifier: {d} bits\n", .{@bitSizeOf(E.Identifier)});
// printmem("E.ImportIdentifier: {d} bits\n", .{@bitSizeOf(E.ImportIdentifier)});
// printmem("E.PrivateIdentifier: {d} bits\n", .{@bitSizeOf(E.PrivateIdentifier)});
// printmem("E.JSXElement: {d} bits\n", .{@bitSizeOf(E.JSXElement)});
// printmem("E.Missing: {d} bits\n", .{@bitSizeOf(E.Missing)});
// printmem("E.Number: {d} bits\n", .{@bitSizeOf(E.Number)});
// printmem("E.BigInt: {d} bits\n", .{@bitSizeOf(E.BigInt)});
// printmem("E.Object: {d} bits\n", .{@bitSizeOf(E.Object)});
// printmem("E.Spread: {d} bits\n", .{@bitSizeOf(E.Spread)});
// printmem("E.String: {d} bits\n", .{@bitSizeOf(E.String)});
// printmem("E.TemplatePart: {d} bits\n", .{@bitSizeOf(E.TemplatePart)});
// printmem("E.Template: {d} bits\n", .{@bitSizeOf(E.Template)});
// printmem("E.RegExp: {d} bits\n", .{@bitSizeOf(E.RegExp)});
// printmem("E.Await: {d} bits\n", .{@bitSizeOf(E.Await)});
// printmem("E.Yield: {d} bits\n", .{@bitSizeOf(E.Yield)});
// printmem("E.If: {d} bits\n", .{@bitSizeOf(E.If)});
// printmem("E.RequireResolveString: {d} bits\n", .{@bitSizeOf(E.RequireResolveString)});
// printmem("E.Import: {d} bits\n", .{@bitSizeOf(E.Import)});
// printmem("----------Expr: {d} bits\n", .{@bitSizeOf(Expr)});
// }
// -- ESBuild bit sizes
// EArray | 256
// EArrow | 512
// EAwait | 192
// EBinary | 448
// ECall | 448
// EDot | 384
// EIdentifier | 96
// EIf | 576
// EImport | 448
// EImportIdentifier | 96
// EIndex | 448
// EJSXElement | 448
// ENew | 448
// EnumValue | 384
// EObject | 256
// EPrivateIdentifier | 64
// ERequire | 32
// ERequireResolve | 32
// EString | 256
// ETemplate | 640
// EUnary | 256
// Expr | 192
// ExprOrStmt | 128
// EYield | 128
// Finally | 256
// Fn | 704
// FnBody | 256
// LocRef | 96
// NamedExport | 96
// NamedImport | 512
// NameMinifier | 256
// NamespaceAlias | 192
// opTableEntry | 256
// Part | 1088
// Property | 640
// PropertyBinding | 512
// Ref | 64
// SBlock | 192
// SBreak | 64
// SClass | 704
// SComment | 128
// SContinue | 64
// Scope | 704
// ScopeMember | 96
// SDirective | 256
// SDoWhile | 384
// SEnum | 448
// SExportClause | 256
// SExportDefault | 256
// SExportEquals | 192
// SExportFrom | 320
// SExportStar | 192
// SExpr | 256
// SFor | 384
// SForIn | 576
// SForOf | 640
// SFunction | 768
// SIf | 448
// SImport | 320
// SLabel | 320
// SLazyExport | 192
// SLocal | 256
// SNamespace | 448
// Span | 192
// SReturn | 64
// SSwitch | 448
// SThrow | 192
// Stmt | 192
// STry | 384
// -- ESBuild bit sizes
const ToJSError = error{
@"Cannot convert argument type to JS",
@"Cannot convert identifier to JS. Try a statically-known value",
MacroError,
OutOfMemory,
};