Htsl\Parser\Document

Complexity

Total Complexity

87

Size/Duplication

Total Lines	959
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	13

Importance

Changes

0

43 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	13	2
A	execute()	0	9	2
A	__toString()	0	4	1
A	getContent()	0	8	2
A	getLine()	0	8	3
A	getConfig()	0	4	1
A	getDoctype()	0	4	1
A	getIndentation()	0	4	1
A	getIndentLevel()	0	4	1
B	setExtending()	0	18	5
A	lineByLine()	0	20	4
A	parseFirstLine()	0	15	4
A	embeddingParse()	0	10	2
A	startEmbedding()	0	9	2
A	breakEmbedding()	0	7	1
A	parseLine()	0	9	1
A	getLineType()	0	10	2
A	parseHtmlLine()	0	4	1
A	parseStringLine()	0	4	1
A	parseExpressionLine()	0	8	1
A	parseExpressionHtmlLine()	0	6	1
A	parseCommentLine()	0	6	1
A	parseTagLine()	0	10	2
A	parseControlLine()	0	6	1
B	parseDocControlLine()	0	22	5
A	extend()	0	9	1
A	insertIndentations()	0	4	1
A	include()	0	8	2
A	defineSection()	0	8	1
A	showSection()	0	19	3
B	setSection()	0	27	5
A	bubbleSections()	0	12	4
A	htmlEntities()	0	4	1
A	setLevel()	0	14	3
A	openNode()	0	8	2
B	closeNodes()	0	16	6
A	setScope()	0	4	1
A	getScope()	0	4	1
A	removeScope()	0	8	2
A	appendLine()	0	6	2
A	append()	0	10	2
A	getHtsl()	0	4	1
A	throw()	0	4	1

<?php

namespace Htsl\Parser;

use Htsl\Htsl;
use Htsl\ReadingBuffer\Contracts\ABuffer as Buffer;
use Htsl\ReadingBuffer\Line;
use Htsl\Helper\TGetter;
use Htsl\Helper\IConfigProvider;
use Htsl\Parser\Node\TagNode;
use Htsl\Parser\Node\StringNode;
use Htsl\Parser\Node\CommentNode;
use Htsl\Parser\Node\ControlNode;
use Htsl\Parser\Node\SectionNode;
use Htsl\Parser\Node\NamelessSectionNode;
use Htsl\Parser\Node\Contracts\ANode as Node;

////////////////////////////////////////////////////////////////

/**
 * @property-read string                                 $content     Result of document executing.
 * @property-read string                                 $doctype     Type of this document.
 * @property-read string|bool                            $indentation Indentation of document.
 * @property-read \Htsl\Parser\Node\Contracts\ANode|bool $scope       Current scope on top of stack.
 * @property-read \Htsl\Htsl                             $htsl        Htsl main object of document.
 * @property-read int                                    $indentLevel Current indent level.
 */
class Document implements IConfigProvider
{
	use TGetter;

	/**
	 * Htsl main object owns this document.
	 *
	 * @access private
	 *
	 * @var \Htsl\Htsl
	 */
	private $htsl;

	/**
	 * Parent document.
	 *
	 * @access private
	 *
	 * @var \Htsl\Parser\Document | null
	 */
	private $parent;

	/**
	 * Reading buffer of this document.
	 *
	 * @access private
	 *
	 * @var \Htsl\ReadingBuffer\Contracts\ABuffer
	 */
	private $buffer;

	/**
	 * The indentation and whether output with linefeed and indent.
	 *
	 * @access private
	 *
	 * @var string | bool
	 */
	private $indentation;

	/**
	 * Type of this document.
	 *
	 * @access private
	 *
	 * @var string
	 */
	private $docType;

	/**
	 * Current embead script.
	 *
	 * @access private
	 *
	 * @var \Htsl\Embedment\Contract\Embedment
	 */
	private $embedment;

	/**
	 * Current indent level.
	 *
	 * @access private
	 *
	 * @var int
	 */
	private $level= 0;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

	/**
	 * Section indent level.
	 *
	 * @access private
	 *
	 * @var int
	 */
	private $sectionLevel= 0;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

	/**
	 * Opened nodes.
	 *
	 * @access private
	 *
	 * @var [ Htsl\Parser\Node\Contracts\ANode, ]
	 */
	private $openedNodes= [];

Equals sign not aligned correctly; expected 1 space but found 0 spaces

	/**
	 * Current scopes.
	 *
	 * @access private
	 *
	 * @var [ Htsl\Parser\Node\Contracts\ANode, ]
	 */
	private $scopes= [];

Equals sign not aligned correctly; expected 1 space but found 0 spaces

	/**
	 * Current line number.
	 *
	 * @access private
	 *
	 * @var int
	 */
	private $lineNumber= 0;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

	/**
	 * Current line.
	 *
	 * @access private
	 *
	 * @var \Htsl\ReadingBuffer\Line
	 */
	private $currentLine;

	/**
	 * Sections that can be show.
	 *
	 * @access private
	 *
	 * @var [ Htsl\Parser\Section, ]
	 */
	private $sections=[];

Equals sign not aligned correctly; expected 1 space but found 0 spaces

	/**
	 * Whether the document is executed.
	 *
	 * @access private
	 *
	 * @var bool
	 */
	private $isExecuted;

	/**
	 * Current Section.
	 *
	 * @access private
	 *
	 * @var \Htsl\Parser\Section
	 */
	private $currentSection;

	/**
	 * The content of this document.
	 *
	 * @access private
	 *
	 * @var string
	 */
	private $content;

	/**
	 * Constructor of the Document.
	 *
	 * @access public
	 *
	 * @param \Htsl\Htsl                            $htsl
	 * @param \Htsl\ReadingBuffer\Contracts\ABuffer $buffer
	 * @param \Htsl\Parser\Document | null          $parent
	 */
	public function __construct( Htsl$htsl, Buffer$buffer, self$parent=null )
	{
		$this->htsl= $htsl;

Equals sign not aligned with surrounding assignments; expected 3 spaces but found 0 spaces

		$this->buffer= $buffer;

Equals sign not aligned with surrounding assignments; expected 1 space but found 0 spaces

		if( $parent ){
			$this->parent= $parent;

Equals sign not aligned with surrounding assignments; expected 6 spaces but found 0 spaces

			$this->docType= $parent->docType;

Equals sign not aligned with surrounding assignments; expected 5 spaces but found 0 spaces

			$this->indentation= $parent->indentation;

Equals sign not aligned with surrounding assignments; expected 1 space but found 0 spaces

		}else{
			$this->parseFirstLine();
		}
	}

	/**
	 * Executing the document.
	 *
	 * @access public
	 *
	 * @return \Htsl\Parser\Document
	 */
	public function execute():self
	{
		if( $this->isExecuted ){
			return $this;
		}
		return $this->lineByLine()
		            ->bubbleSections()
		;
	}

	/**
	 * Alias of getContent.
	 *
	 * @access public
	 *
	 * @return string
	 */
	public function __toString():string
	{
		return $this->getContent();
	}

	/**
	 * Getting the result of document executing.
	 *
	 * @access protected
	 *
	 * @return string
	 */
	protected function getContent():string
	{
		if( $this->parent ){
			return $this->execute()->parent->getContent();
		}else{
			return $this->execute()->content;
		}
	}

	/**
	 * Getting the next line.
	 *
	 * @access protected
	 *
	 * @return \Htsl\ReadingBuffer\Line
	 */
	protected function getLine():Line
	{
		do{
			$line= $this->buffer->getLine();

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		}while( $line->isEmpty() && $line->hasMore() );

		return $line;
	}

	/**
	 * Getting the config of type of this document.
	 *
	 * @access public
	 *
	 * @param  [ string, ] ...$keys
	 *
	 * @return mixed
	 */
	public function getConfig( string...$keys )
	{
		return $this->htsl->getConfig(array_shift($keys),$this->docType,...$keys);
	}

	/**
	 * Getting the type of this document.
	 *
	 * @access public
	 *
	 * @return string
	 */
	public function getDoctype():string
	{
		return $this->docType;
	}

	/**
	 * Getting the indentation.
	 *
	 * @access public
	 *
	 * @return string | bool
	 */
	public function getIndentation()
	{
		return $this->indentation;
	}

	/**
	 * Getting the indent level.
	 *
	 * @access public
	 *
	 * @return int
	 */
	public function getIndentLevel():int
	{
		return $this->level;
	}

	/**
	 * Parsing the first line.
	 *
	 * @access protected
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function parseFirstLine():self
	{
		$line= $this->getLine();

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		if( '@'===$line->getChar(0) ){
			return $this->setExtending($line);
		}

		$this->docType= $line->content;

Equals sign not aligned with surrounding assignments; expected 2 spaces but found 0 spaces

		$docTypeContent= $this->getConfig('doc_types') or $this->throw("DocType $this->docType is not supported");

Equals sign not aligned with surrounding assignments; expected 1 space but found 0 spaces

As per coding-style, please use concatenation or sprintf for the variable $this instead of interpolation.

		$this->indentation= $this->htsl->getConfig('indentation',$this->docType) ?? ( function( $scalarOrFalse ){ return is_scalar($scalarOrFalse)?$scalarOrFalse:false; } )($this->htsl->getConfig('indentation'));

Equals sign not aligned correctly; expected 1 space but found 0 spaces

It is generally recommended to place each PHP statement on a line by itself.

		return $this->appendLine($docTypeContent);
	}

	/**
	 * Setting that this document extends another document.
	 *
	 * @access protected
	 *
	 * @param \Htsl\ReadingBuffer\Line $firstLine
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function setExtending( Line$firstLine ):self
	{
		switch( $name= $firstLine->pregGet('/(?<=^@)[\w-:]+/') ){
			default:{
				$this->throw("The @$name is not supported.");

As per coding-style, please use concatenation or sprintf for the variable $name instead of interpolation.

			}break;
			case 'extend':{
				$this->extend($firstLine->pregGet('/(?<=\( ).*(?= \))/'));
			}break;
			case 'show':
			case 'include':
			case 'section':{
				$this->throw("The @$name can not be used on first line.");

As per coding-style, please use concatenation or sprintf for the variable $name instead of interpolation.

			}break;
		}

		return $this;
	}

	/**
	 * Parsing this document line by line.
	 *
	 * @access protected
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function lineByLine():self
	{
		while( ($line= $this->getLine())->hasMore() ){
			$this->lineNumber+= 1;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

			if( $this->embedment ){
				$this->embeddingParse($line);
			}else{
				$this->parseLine($line);
			}
		}

		$this->embedment and $this->breakEmbedding();

		$this->closeNodes($this->level);

		$this->isExecuted= true;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this;
	}

	/**
	 * Parsing embedded line.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function embeddingParse( Line$line ):self
	{
		if( $line->content==='<}' ){
			$this->breakEmbedding();
		}else{
			$this->embedment->parseLine($line->getSubIndentLine());
		}

		return $this;
	}

	/**
	 * Starting the embedding.
	 *
	 * @access protected
	 *
	 * @param  string $embedType
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function startEmbedding( string$embedType ):self
	{
		$embedmentClass= '\\Htsl\\Embedment\\'.ucfirst($embedType).'Embedment';

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		class_exists($embedmentClass) or $this->throw("Embed type $embedType not exists.");

As per coding-style, please use concatenation or sprintf for the variable $embedType instead of interpolation.

		$this->embedment= new $embedmentClass($this);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this;
	}

	/**
	 * Ending the embedding.
	 *
	 * @access public
	 *
	 * @return \Htsl\Parser\Document
	 */
	public function breakEmbedding():self
	{
		$this->append($this->embedment->getContent());
		$this->embedment= null;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this;
	}

	/**
	 * Parsing line.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function parseLine( Line$line ):self
	{
		$this->currentLine= $line;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		$this->setLevel($line->getIndentLevel());

		$this->{'parse'.ucfirst($this->getLineType($line))}($line);

		return $this;
	}

	/**
	 * Getting line type by analyzing first or first two characters of line.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return string
	 */
	protected function getLineType( Line$line ):string
	{
		$possibleType= self::POSSIBLE_LINE_TYPES;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		for( $i=0; is_array($possibleType); ++$i ){
			$possibleType= $possibleType[$line->getChar($i)]??$possibleType[' '];

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		}

		return $possibleType;
	}

	/**
	 * Possible line types.
	 *
	 * @access public
	 *
	 * @const array
	 *
	 * @todo Make this const private when php 7.1
	 */
	const POSSIBLE_LINE_TYPES= [

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		'`'=> [
			'='=> 'expressionHtmlLine',
			' '=> 'htmlLine',
		],
		'='=> 'expressionLine',
		'!'=> 'commentLine',
		'-'=> 'tagLine',
		'~'=> 'controlLine',
		'@'=> 'docControlLine',
		' '=> 'stringLine',
	];

	/**
	 * Parsing line as HTML content.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function parseHtmlLine( Line$line ):self
	{
		return $this->openNode(new StringNode($this,$line))->appendLine($line->slice(1));
	}

	/**
	 * Parsing line as string content.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function parseStringLine( Line$line ):self
	{
		return $this->openNode(new StringNode($this,$line))->appendLine($this->htmlEntities(trim($line->getContent())));
	}

	/**
	 * Parsing line as PHP expression.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function parseExpressionLine( Line$line ):self
	{
		$content=  $line->slice(1);

Equals sign not aligned with surrounding assignments; expected 2 spaces but found 0 spaces

		$ent_flag= var_export($this->htsl->getConfig('ENT_flags',$this->docType),true);

Equals sign not aligned with surrounding assignments; expected 1 space but found 0 spaces

		$charset=   var_export($this->htsl->getConfig('charset'),true);

Equals sign not aligned with surrounding assignments; expected 2 spaces but found 0 spaces

		return $this->openNode(new StringNode($this,$line))->appendLine("<?=htmlentities($content,$ent_flag,$charset,false)?>");

As per coding-style, please use concatenation or sprintf for the variable $content instead of interpolation.

As per coding-style, please use concatenation or sprintf for the variable $ent_flag instead of interpolation.

As per coding-style, please use concatenation or sprintf for the variable $charset instead of interpolation.

	}

	/**
	 * Parsing line as PHP expression with HTML result.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function parseExpressionHtmlLine( Line$line ):self
	{
		$content=  $line->slice(1);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this->openNode(new StringNode($this,$line))->appendLine("<?$content?>");

As per coding-style, please use concatenation or sprintf for the variable $content instead of interpolation.

	}

	/**
	 * Parsing line as comment.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function parseCommentLine( Line$line ):self
	{
		$node= new CommentNode($this,$line);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this->openNode($node)->appendLine($node->open());
	}

	/**
	 * Parsing line as HTSL tag.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function parseTagLine( Line$line ):self
	{
		$node= new TagNode($this,$line);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		$this->appendLine($node->open());

		$node->embed and $this->startEmbedding($node->embed);

		return $this->openNode($node);
	}

	/**
	 * Parsing line as control node of Htsl.php.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function parseControlLine( Line$line ):self
	{
		$node= new ControlNode($this,$line);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this->appendLine($node->open())->openNode($node);
	}

	/**
	 * Parsing line as document control node of Htsl.php.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function parseDocControlLine( Line$line ):self
	{
		switch( $name= $line->pregGet('/(?<=^@)[\w-:]+/') ){
			default:{
				$this->throw("The @$name is not supported.");

As per coding-style, please use concatenation or sprintf for the variable $name instead of interpolation.

			}break;
			case 'extend':{
				$this->throw('The @extend can only be used on first line.');
			}break;
			case 'include':{
				$this->include($line);
			}break;
			case 'section':{
				$this->defineSection($line);
			}break;
			case 'show':{
				$this->showSection($line);
			}break;
		}

		return $this;
	}

	/**
	 * Parsing extending defination.
	 *
	 * @access protected
	 *
	 * @param  string $fileName
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function extend( string$fileName ):self
	{
		$this->parent= new static($this->htsl,$this->buffer->goSide($fileName));

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		$this->docType= $this->parent->docType;

Equals sign not aligned with surrounding assignments; expected 5 spaces but found 0 spaces

		$this->indentation= $this->parent->indentation;

Equals sign not aligned with surrounding assignments; expected 1 space but found 0 spaces

		return $this;
	}

	/**
	 * Insert indentations into given paragraph.
	 *
	 * @access protected
	 *
	 * @param  string $input
	 *
	 * @return string
	 */
	protected function insertIndentations( string$input ):string
	{
		return preg_replace('/(?<=^|\\n)(?!$)/',str_repeat($this->indentation,$this->level-$this->sectionLevel),$input);
	}

	/**
	 * Include another document.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function include( Line$line ):self
	{
		$inclued= (new static($this->htsl,$this->buffer->goSide($line->pregGet('/(?<=\( ).*(?= \))/')),$this))->execute()->content??null;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		false===$this->indentation or $inclued= $this->insertIndentations($inclued);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this->openNode(new StringNode($this,$line))->append($inclued);
	}

	/**
	 * Starting to define a section.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function defineSection( Line$line ):self
	{
		$node= new SectionNode($this,$line);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		$node->open();

		return $this->openNode($node);
	}

	/**
	 * Showing a section.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\ReadingBuffer\Line   $line
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function showSection( Line$line ):self
	{
		$sectionName= $line->pregGet('/(?<=\( ).*(?= \))/');

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		if( !isset($this->sections[$sectionName]) ){
			return $this->openNode(new StringNode($this,$line));
		}
		$content= $this->sections[$sectionName]->content;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		false===$this->indentation or $content= $this->insertIndentations($content);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		$this->append($content);

		$node= new NamelessSectionNode($this,$line);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		$node->open();

		return $this->openNode($node);
	}

	/**
	 * Setting document as section definer.
	 *
	 * @access public
	 *
	 * @param Section | null $section
	 */
	public function setSection( Section$section=null ):self
	{
		if( !$section ){
			$this->sectionLevel= 0;

Equals sign not aligned with surrounding assignments; expected 3 spaces but found 0 spaces

			$this->currentSection= null;

Equals sign not aligned with surrounding assignments; expected 1 space but found 0 spaces

			return $this;
		}

		if( $this->currentSection ){
			$this->throw('Nesting definition of section is forbidden.');
		}

		if( isset($this->parent->sections[$section->name]) ){
			$this->throw("Section {$section->name} already defined.");

As per coding-style, please use concatenation or sprintf for the variable $section instead of interpolation.

		}

		$this->currentSection= $section;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		if( $section->name ){
			$this->parent->sections[$section->name]=$section;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		}

		$this->sectionLevel= $this->level+1;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this;
	}

	/**
	 * Bubble the sections to parent document.
	 *
	 * @access protected
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function bubbleSections():self
	{
		if( $this->parent ){
			foreach( $this->sections as $name=>$section ){
				if( !isset($this->parent->sections[$name]) ){
					$this->parent->sections[$name]=$section;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

				};
			}
		}

		return $this;
	}

	/**
	 * Escaping characters to HTML entities.
	 *
	 * @access public
	 *
	 * @param  string $input
	 *
	 * @return string
	 */
	public function htmlEntities( string$input ):string
	{
		return htmlentities($input,$this->htsl->getConfig('ENT_flags',$this->docType),$this->htsl->getConfig('charset'),false);
	}

	/**
	 * Setting indent level of this document.
	 *
	 * @access protected
	 *
	 * @param int $level
	 */
	protected function setLevel( int$level ):self
	{
		$level-= $this->level;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		if( $level<=0 ){
			$this->closeNodes(-$level);
		}elseif( $level==1 ){
			$this->level+= 1;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		}else{
			$this->throw('Indent error.');
		}

		return $this;
	}

	/**
	 * Opening a node.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\Parser\Node\Contracts\ANode $node
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function openNode( Node$node ):self
	{
		array_push($this->openedNodes,$node);

		$node->scope and $this->setScope($node);

		return $this;
	}

	/**
	 * Closing open node or nodes.
	 *
	 * @access protected
	 *
	 * @param  int $level
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function closeNodes( int$level=0 ):self
	{
		if( empty($this->openedNodes) ) return $this;

		while( $level-->=0 ){
			$node= array_pop($this->openedNodes);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

			$node->scope and $this->removeScope($node);

			$closer=$node->close($this->currentLine) and $this->appendLine($closer);

Equals sign not aligned correctly; expected 1 space but found 0 spaces

			$this->level-= $level>=0 ?1:0;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		}

		return $this;
	}

	/**
	 * Pushing a scope to stack.
	 *
	 * @access protected
	 *
	 * @param \Htsl\Parser\Node\Contracts\ANode $scope
	 */
	protected function setScope( Node$scope ):int
	{
		return array_unshift($this->scopes,$scope);
	}

	/**
	 * Getting current scope on top of stack.
	 *
	 * @access public
	 *
	 * @return \Htsl\Parser\Node\Contracts\ANode | null
	 */
	public function getScope()
	{
		return $this->scopes[0]??null;
	}

	/**
	 * Pop a scope from stack.
	 *
	 * @access protected
	 *
	 * @param  \Htsl\Parser\Node\Contracts\ANode $scope
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function removeScope( Node$scope ):self
	{
		if( $scope!==array_shift($this->scopes) ){
			$this->throw('Scope nesting error');
		};

		return $this;
	}

	/**
	 * Appending a line of content to parsing result.
	 *
	 * @access protected
	 *
	 * @param  string $content
	 *
	 * @return \Htsl\Parser\Document

Should the return type not be \self?

	 */
	protected function appendLine( string$content ):self
	{
		false===$this->indentation or $content= str_repeat($this->indentation,$this->level-$this->sectionLevel).$content."\n";

Consider using a different name than the parameter $content. This often makes code more readable.

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		return $this->append($content);
	}

	/**
	 * Appending some content to parsing result.
	 *
	 * @access protected
	 *
	 * @param  string $content
	 *
	 * @return \Htsl\Parser\Document
	 */
	protected function append( string$content ):self
	{
		if( $this->currentSection ){
			$this->currentSection->append($content);
		}else{
			$this->content.=$content;

Equals sign not aligned correctly; expected 1 space but found 0 spaces

		}

		return $this;
	}

	/**
	 * Getting the Htsl main object.
	 *
	 * @access public
	 *
	 * @return \Htsl\Htsl
	 */
	public function getHtsl()
	{
		return $this->htsl;
	}

	/**
	 * Throw exception with document name and line number.
	 *
	 * @access public
	 *
	 * @param  string $message
	 *
	 * @throw \Htsl\Parser\HtslParsingException
	 */
	public function throw( string$message )
	{
		throw new HtslParsingException("$message at file {$this->buffer->filePath} line $this->lineNumber");

As per coding-style, please use concatenation or sprintf for the variable $message instead of interpolation.

As per coding-style, please use concatenation or sprintf for the variable $this instead of interpolation.

	}
}

As per coding style, files should not end with a newline character.