blob: 65306d5a142bca3393b4885e1ca508299fa43d5a [file] [log] [blame]
// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.
import 'fast_hash.dart';
import 'marking_scheme.dart';
/// A single level of expression nesting.
///
/// When a line is split in the middle of an expression, this tracks the
/// context of where in the expression that split occurs. It ensures that the
/// [LineSplitter] obeys the expression nesting when deciding what column to
/// start lines at when split inside an expression.
///
/// Each instance of this represents a single level of expression nesting. If we
/// split at to chunks with different levels of nesting, the splitter ensures
/// they each get assigned to different columns.
///
/// In addition, each level has an indent. This is the number of spaces it is
/// indented relative to the outer expression. It's almost always
/// [Indent.expression], but cascades are special magic snowflakes and use
/// [Indent.cascade].
///
/// NestingLEvels can be marked during processing in an algorithm but should be
/// left unmarked when the algorithm finishes to make marking work in subsequent
/// calls.
class NestingLevel extends FastHash with Markable {
/// The nesting level surrounding this one, or `null` if this is represents
/// top level code in a block.
final NestingLevel? parent;
/// The number of characters that this nesting level is indented relative to
/// the containing level.
///
/// Normally, this is [Indent.expression], but cascades use [Indent.cascade].
final int indent;
/// The total number of characters of indentation from this level and all of
/// its parents, after determining which nesting levels are actually used.
///
/// This is only valid during line splitting.
int get totalUsedIndent => _totalUsedIndent!;
int? _totalUsedIndent;
bool get isNested => parent != null;
NestingLevel()
: parent = null,
indent = 0;
NestingLevel._(this.parent, this.indent);
/// Creates a new deeper level of nesting indented [spaces] more characters
/// that the outer level.
NestingLevel nest(int spaces) => NestingLevel._(this, spaces);
/// Clears the previously calculated total indent of this nesting level.
void clearTotalUsedIndent() {
_totalUsedIndent = null;
parent?.clearTotalUsedIndent();
}
/// Calculates the total amount of indentation from this nesting level and
/// all of its parents assuming only marked levels are in use.
void refreshTotalUsedIndent() {
var totalIndent = _totalUsedIndent;
if (totalIndent != null) return;
totalIndent = 0;
if (parent != null) {
parent!.refreshTotalUsedIndent();
totalIndent += parent!.totalUsedIndent;
}
if (isMarked) totalIndent += indent;
_totalUsedIndent = totalIndent;
}
@override
String toString() {
if (parent == null) return indent.toString();
return '$parent:$indent';
}
}