>=2.12.0-0 <3.0.0
based on beta release guidelines.SourceSpan.subspan()
extension method which returns a slice of an existing source span.SourceSpan.highlightMultiple()
and SourceSpan.messageMultiple()
(both extension methods), MultiSourceSpanException
, and MultiSourceSpanFormatException
.FileSpan.highlight()
.FileSpan.highlight()
would crash for spans that covered a trailing newline and a single additional empty line.FileSpan.highlight()
now properly highlights point spans at the beginning of lines.FileSpan.highlight()
would put the highlight indicator in the wrong position when highlighting a point span after the end of a file.SourceFile.span()
now goes to the end of the file by default, rather than ending one character before the end of the file. This matches the documented behavior.
FileSpan.context
now includes the full line on which the span appears for empty spans at the beginning and end of lines.
Fix an edge case where FileSpan.highlight()
could crash when highlighting a span that ended with an empty line.
Produce better source span highlights for multi-line spans that cover the entire last line of the span, including the newline.
Produce better source span highlights for spans that contain Windows-style newlines.
Improve the output of SourceSpan.highlight()
and SourceSpan.message()
:
term_glyph.ascii
).<3.0.0
, and adjust other dependencies.The new SourceFile()
constructor is deprecated. This constructed a source file from a string's runes, rather than its code units, which runs counter to the way Dart handles strings otherwise. The new StringFile.fromString()
constructor (see below) should be used instead.
The new SourceFile.fromString()
constructor was added. This works like new SourceFile()
, except it uses code units rather than runes.
The current behavior when characters larger than 0xFFFF
are passed to new SourceFile.decoded()
is now considered deprecated.
SourceSpan.highlight()
and SourceSpan.message()
.SourceSpan.highlight()
, which returns just the highlighted text that would be included in SourceSpan.message()
.SourceSpanException.message
, SourceSpanFormatException.source
, and SourceSpanWithContext.context
to be overridden in strong mode.FileSpan.start
and FileSpan.end
. In 1.2.0 these were mistakenly changed from FileLocation
to SourceLocation
.Deprecated: Extending SourceLocation
directly is deprecated. Instead, extend the new SourceLocationBase
class or mix in the new SourceLocationMixin
mixin.
Dramatically improve the performance of FileLocation
.
getLine()
in SourceFile
when repeatedly called.FileSpan.union
could throw an exception for external implementations of FileSpan
.==
, but not hashCode
.FileSpan.compareTo
, FileSpan.==
, FileSpan.union
, and FileSpan.expand
no longer throw exceptions for external implementations of FileSpan
.
FileSpan.hashCode
now fully agrees with FileSpan.==
.
SourceSpanWithContext
to allow multiple occurrences of text
within context
.FileSpan
's context to include the full span text, not just the first line of it.SourceSpanWithContext
: a span that also includes the full line of text that contains the span.SourceLocation
.Avoid unintentionally allocating extra objects for internal FileSpan
operations.
Ensure that SourceSpan.operator==
works on arbitrary Object
s.
FileSpan
.This package was extracted from the source_maps
package, but the API has many differences. Among them:
Span
has been renamed to SourceSpan
and Location
has been renamed to SourceLocation
to clarify their purpose and maintain consistency with the package name. Likewise, SpanException
is now SourceSpanException
and SpanFormatException
is not SourceSpanFormatException
.
FixedSpan
and FixedLocation
have been rolled into the Span
and Location
classes, respectively.
SourceFile
is more aggressive about validating its arguments. Out-of-bounds lines, columns, and offsets will now throw errors rather than be silently clamped.
SourceSpan.sourceUrl
, SourceLocation.sourceUrl
, and SourceFile.url
now return Uri
objects rather than String
s. The constructors allow either String
s or Uri
s.
Span.getLocationMessage
and SourceFile.getLocationMessage
are now SourceSpan.message
and SourceFile.message
, respectively. Rather than taking both a useColor
and a color
parameter, they now take a single color
parameter that controls both whether and which color is used.
Span.isIdentifier
has been removed. This property doesn't make sense outside of a source map context.
SourceFileSegment
has been removed. This class wasn't widely used and was inconsistent in its choice of which parameters were considered relative and which absolute.