From 108bd8fc9a48430c92b7eb395bc773615e5d9b49 Mon Sep 17 00:00:00 2001
From: Oliver Klee <github@oliverklee.de>
Date: Thu, 5 Sep 2024 18:01:13 +0200
Subject: [PATCH] [TASK] Mark parsing-internal classes and methods as
 `@internal`

Code that uses this library is not expected to call internal parsing
functionality. Communicate this with the corresponding `@internal`
annotation.

This allows us to boldly refactor the parser code.

This is the backport of #674.

Part of #668
---
 CHANGELOG.md                | 1 +
 src/Parsing/Anchor.php      | 3 +++
 src/Parsing/ParserState.php | 3 +++
 3 files changed, 7 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0c66fbf3..ab4ecb9b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Changed
 
+- Mark parsing-internal classes and methods as `@internal` (#711)
 - Block installations on unsupported higher PHP versions (#691)
 
 ### Deprecated
diff --git a/src/Parsing/Anchor.php b/src/Parsing/Anchor.php
index 93789e26..9060b54e 100644
--- a/src/Parsing/Anchor.php
+++ b/src/Parsing/Anchor.php
@@ -2,6 +2,9 @@
 
 namespace Sabberworm\CSS\Parsing;
 
+/**
+ * @internal
+ */
 class Anchor
 {
     /**
diff --git a/src/Parsing/ParserState.php b/src/Parsing/ParserState.php
index 07578461..82e9006f 100644
--- a/src/Parsing/ParserState.php
+++ b/src/Parsing/ParserState.php
@@ -5,6 +5,9 @@
 use Sabberworm\CSS\Comment\Comment;
 use Sabberworm\CSS\Settings;
 
+/**
+ * @internal
+ */
 class ParserState
 {
     /**