Interface: RolldownMagicString

Defined in: packages/rolldown/src/binding-magic-string.ts:140, packages/rolldown/src/binding-magic-string.ts:158

Extends

• BindingMagicString

Properties

isRolldownMagicString

• Type: true

Defined in: packages/rolldown/src/binding-magic-string.ts:141

Accessors

filename

Get Signature

• Type: () => string | null

Defined in: packages/rolldown/src/binding.d.cts:1622

Returns

string | null

Inherited from

NativeBindingMagicString.filename

---

ignoreList

Get Signature

• Type: () => boolean

Defined in: packages/rolldown/src/binding.d.cts:1624

Returns

boolean

Inherited from

NativeBindingMagicString.ignoreList

---

indentExclusionRanges

Get Signature

• Type: () => number[] | number[][] | null

Defined in: packages/rolldown/src/binding.d.cts:1623

Returns

number[] | number[][] | null

Inherited from

NativeBindingMagicString.indentExclusionRanges

---

offset

Get Signature

• Type: () => number

Defined in: packages/rolldown/src/binding.d.cts:1625

Returns

number

Set Signature

• Type: (offset: number) => void

Defined in: packages/rolldown/src/binding.d.cts:1626

Parameters

offset

number

Returns

void

Inherited from

NativeBindingMagicString.offset

---

original

Get Signature

• Type: () => string

Defined in: packages/rolldown/src/binding.d.cts:1621

Returns

string

Inherited from

NativeBindingMagicString.original

Methods

append()

• Type: (content: string) => this

Defined in: packages/rolldown/src/binding.d.cts:1636

Parameters

content

string

Returns

this

Inherited from

NativeBindingMagicString.append

---

appendLeft()

• Type: (index: number, content: string) => this

Defined in: packages/rolldown/src/binding.d.cts:1639

Parameters

index

number

content

string

Returns

this

Inherited from

NativeBindingMagicString.appendLeft

---

appendRight()

• Type: (index: number, content: string) => this

Defined in: packages/rolldown/src/binding.d.cts:1640

Parameters

index

number

content

string

Returns

this

Inherited from

NativeBindingMagicString.appendRight

---

clone()

• Type: () => BindingMagicString

Defined in: packages/rolldown/src/binding.d.cts:1670

Returns a clone of the MagicString instance.

Returns

BindingMagicString

Inherited from

NativeBindingMagicString.clone

---

generateDecodedMap()

• Type: (options?: BindingSourceMapOptions | null) => BindingDecodedMap

Defined in: packages/rolldown/src/binding.d.cts:1703

Generates a decoded source map for the transformations applied to this MagicString. Returns a BindingDecodedMap object with mappings as an array of arrays.

Parameters

options?

BindingSourceMapOptions | null

Returns

BindingDecodedMap

Inherited from

NativeBindingMagicString.generateDecodedMap

---

generateMap()

• Type: (options?: BindingSourceMapOptions | null) => BindingSourceMap

Defined in: packages/rolldown/src/binding.d.cts:1698

Generates a source map for the transformations applied to this MagicString. Returns a BindingSourceMap object with version, file, sources, sourcesContent, names, mappings.

Parameters

options?

BindingSourceMapOptions | null

Returns

BindingSourceMap

Inherited from

NativeBindingMagicString.generateMap

---

getIndentString()

• Type: () => string

Defined in: packages/rolldown/src/binding.d.cts:1676

Returns the guessed indentation string, or \t if none is found.

Returns

string

Inherited from

NativeBindingMagicString.getIndentString

---

hasChanged()

• Type: () => boolean

Defined in: packages/rolldown/src/binding.d.cts:1643

Returns

boolean

Inherited from

NativeBindingMagicString.hasChanged

---

indent()

• Type: (indentor?: string | null, options?: BindingIndentOptions | null) => this

Defined in: packages/rolldown/src/binding.d.cts:1655

Parameters

indentor?

string | null

options?

BindingIndentOptions | null

Returns

this

Inherited from

NativeBindingMagicString.indent

---

insert()

• Type: (index: number, content: string) => void

Defined in: packages/rolldown/src/binding.d.cts:1668

Deprecated method that throws an error directing users to use prependRight or appendLeft. This matches the original magic-string API which deprecated this method.

Parameters

index

number

content

string

Returns

void

Inherited from

NativeBindingMagicString.insert

---

isEmpty()

• Type: () => boolean

Defined in: packages/rolldown/src/binding.d.cts:1645

Returns

boolean

Inherited from

NativeBindingMagicString.isEmpty

---

lastChar()

• Type: () => string

Defined in: packages/rolldown/src/binding.d.cts:1672

Returns the last character of the generated string, or an empty string if empty.

Returns

string

Inherited from

NativeBindingMagicString.lastChar

---

lastLine()

• Type: () => string

Defined in: packages/rolldown/src/binding.d.cts:1674

Returns the content after the last newline in the generated string.

Returns

string

Inherited from

NativeBindingMagicString.lastLine

---

length()

• Type: () => number

Defined in: packages/rolldown/src/binding.d.cts:1644

Returns

number

Inherited from

NativeBindingMagicString.length

---

move()

• Type: (start: number, end: number, index: number) => this

Defined in: packages/rolldown/src/binding.d.cts:1654

Alias for relocate to match the original magic-string API. Moves the characters from start to end to index. Returns this for method chaining.

Parameters

start

number

end

number

index

number

Returns

this

Inherited from

NativeBindingMagicString.move

---

overwrite()

• Type: (start: number, end: number, content: string, options?: BindingOverwriteOptions | null) => this

Defined in: packages/rolldown/src/binding.d.cts:1641

Parameters

start

number

end

number

content

string

options?

BindingOverwriteOptions | null

Returns

this

Inherited from

NativeBindingMagicString.overwrite

---

prepend()

• Type: (content: string) => this

Defined in: packages/rolldown/src/binding.d.cts:1635

Parameters

content

string

Returns

this

Inherited from

NativeBindingMagicString.prepend

---

prependLeft()

• Type: (index: number, content: string) => this

Defined in: packages/rolldown/src/binding.d.cts:1637

Parameters

index

number

content

string

Returns

this

Inherited from

NativeBindingMagicString.prependLeft

---

prependRight()

• Type: (index: number, content: string) => this

Defined in: packages/rolldown/src/binding.d.cts:1638

Parameters

index

number

content

string

Returns

this

Inherited from

NativeBindingMagicString.prependRight

---

relocate()

• Type: (start: number, end: number, to: number) => this

Defined in: packages/rolldown/src/binding.d.cts:1648

Parameters

start

number

end

number

to

number

Returns

this

Inherited from

NativeBindingMagicString.relocate

---

remove()

• Type: (start: number, end: number) => this

Defined in: packages/rolldown/src/binding.d.cts:1646

Parameters

start

number

end

number

Returns

this

Inherited from

NativeBindingMagicString.remove

---

replace()

• Type: (from: string | RegExp, to: string) => this

Defined in: packages/rolldown/src/binding-magic-string.ts:143

Accepts a string or RegExp pattern. RegExp supports $&, $$, and $N substitutions.

Parameters

from

string | RegExp

to

string

Returns

this

Overrides

NativeBindingMagicString.replace

---

replaceAll()

• Type: (from: string | RegExp, to: string) => this

Defined in: packages/rolldown/src/binding-magic-string.ts:145

Accepts a string or RegExp pattern. RegExp must have the global (g) flag.

Parameters

from

string | RegExp

to

string

Returns

this

Overrides

NativeBindingMagicString.replaceAll

---

replaceRegex()

• Type: (from: RegExp, to: string) => number

Defined in: packages/rolldown/src/binding.d.cts:1634

Returns the UTF-16 offset past the last match, or -1 if no match was found. The JS wrapper uses this to update lastIndex on the caller's RegExp. Global/sticky behavior is derived from the regex's own flags.

Parameters

from

RegExp

to

string

Returns

number

Inherited from

NativeBindingMagicString.replaceRegex

---

reset()

• Type: (start: number, end: number) => this

Defined in: packages/rolldown/src/binding.d.cts:1684

Resets the portion of the string from start to end to its original content. This undoes any modifications made to that range. Supports negative indices (counting from the end).

Parameters

start

number

end

number

Returns

this

Inherited from

NativeBindingMagicString.reset

---

slice()

• Type: (start?: number | null, end?: number | null) => string

Defined in: packages/rolldown/src/binding.d.cts:1693

Returns the content between the specified UTF-16 code unit positions (JS string indices). Supports negative indices (counting from the end).

When an index falls in the middle of a surrogate pair, the lone surrogate is included in the result (matching the original magic-string / JS behavior). This is done by returning a UTF-16 encoded JS string via napi_create_string_utf16.

Parameters

start?

number | null

end?

number | null

Returns

string

Inherited from

NativeBindingMagicString.slice

---

snip()

• Type: (start: number, end: number) => BindingMagicString

Defined in: packages/rolldown/src/binding.d.cts:1678

Returns a clone with content outside the specified range removed.

Parameters

start

number

end

number

Returns

BindingMagicString

Inherited from

NativeBindingMagicString.snip

---

toString()

• Type: () => string

Defined in: packages/rolldown/src/binding.d.cts:1642

Returns

string

Inherited from

NativeBindingMagicString.toString

---

trim()

• Type: (charType?: string | null) => this

Defined in: packages/rolldown/src/binding.d.cts:1657

Trims whitespace or specified characters from the start and end.

Parameters

charType?

string | null

Returns

this

Inherited from

NativeBindingMagicString.trim

---

trimEnd()

• Type: (charType?: string | null) => this

Defined in: packages/rolldown/src/binding.d.cts:1661

Trims whitespace or specified characters from the end.

Parameters

charType?

string | null

Returns

this

Inherited from

NativeBindingMagicString.trimEnd

---

trimLines()

• Type: () => this

Defined in: packages/rolldown/src/binding.d.cts:1663

Trims newlines from the start and end.

Returns

this

Inherited from

NativeBindingMagicString.trimLines

---

trimStart()

• Type: (charType?: string | null) => this

Defined in: packages/rolldown/src/binding.d.cts:1659

Trims whitespace or specified characters from the start.

Parameters

charType?

string | null

Returns

this

Inherited from

NativeBindingMagicString.trimStart

---

update()

• Type: (start: number, end: number, content: string, options?: BindingUpdateOptions | null) => this

Defined in: packages/rolldown/src/binding.d.cts:1647

Parameters

start

number

end

number

content

string

options?

BindingUpdateOptions | null

Returns

this

Inherited from

NativeBindingMagicString.update