Rich-Harris/magic-string

Features

• Transformation Libraries - Serves as a fundamental library for compilers and bundlers to perform source code transformations and track mapping data.
• Offset Tracking - Tracks character offsets during text modifications to maintain precise alignment between original and transformed source code.
• Sourcemap Management - Generates standardized sourcemaps that link transformed output text back to original source file coordinates.
• String Edit Queues - Implements deferred string materialization to optimize performance by queuing edits before generating the final output.
• Source Map Generators - Creates mapping files with configurable resolution to link generated output back to original source files.
• Source-Aware Transformations - Provides a utility for inserting, replacing, and indenting text without losing the relationship to original source positions.
• Offset-Tracking Text Transformations - Changes content by inserting, removing, or replacing text while tracking original character offsets for consistency.
• Offset-Aware String Modifications - Updates text within strings while tracking original character offsets to ensure accurate source mapping.
• Offset-Preserving Text Insertions - Appends or prepends content at specific character positions to keep insertions associated with the correct original range.
• Source Code Transformation Engines - Modifies JavaScript source code strings by inserting or replacing text while preserving accurate character offset tracking.
• Build Tooling - Provides a low-level utility for compilers and bundlers to merge modified strings into a single output file.
• Range-Aware - Adds or adjusts whitespace prefixes in text files while excluding specific ranges from the modification.
• Range-Aware Indentation Logic - Adds indentation to lines of text while excluding specific character ranges from the process.
• Range-Excluding Source Indentation - Prefixes lines with specific strings or guessed indentation while excluding defined character ranges.
• Range-Excluding Indentations - Allows prefixing lines with indentation strings while ignoring specified character ranges to maintain layout.
• Mapped String Concatenations - Merges multiple modified strings into a single bundle while preserving individual mapping data for each segment.
• Source Bundle Concatenations - Combines several modified strings into a single bundle using unified indentation and a shared mapping file.
• Sourcemap Offset Concatenations - Provides additive mapping concatenation to merge multiple offset maps into a single bundle while shifting coordinates.
• String Pattern Replacements - Executes string or regular expression replacements based on the content of the original source text.
• Immutable Range Awareness - Calculates indentation shifts while ignoring specified character ranges marked as immutable to preserve layout.

Star history