diff --git a/CHANGELOG.md b/CHANGELOG.md index a46c9d04..36f1f1be 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -21,6 +21,7 @@ Please also have a look at our ### Changed +- Make all non-private properties `@internal` (#886) - Use more native type declarations and strict mode (#641, #772, #774, #778, #804, #841, #873, #875) - Add visibility to all class/interface constants (#469) diff --git a/src/CSSList/CSSList.php b/src/CSSList/CSSList.php index f7be79fd..425ca5ba 100644 --- a/src/CSSList/CSSList.php +++ b/src/CSSList/CSSList.php @@ -35,16 +35,22 @@ abstract class CSSList implements Renderable, Commentable { /** * @var array + * + * @internal since 8.8.0 */ protected $comments; /** * @var array + * + * @internal since 8.8.0 */ protected $contents; /** * @var int + * + * @internal since 8.8.0 */ protected $lineNumber; diff --git a/src/Comment/Comment.php b/src/Comment/Comment.php index bd573eeb..acc0fc34 100644 --- a/src/Comment/Comment.php +++ b/src/Comment/Comment.php @@ -11,11 +11,15 @@ class Comment implements Renderable { /** * @var int + * + * @internal since 8.8.0 */ protected $lineNumber; /** * @var string + * + * @internal since 8.8.0 */ protected $commentText; diff --git a/src/OutputFormat.php b/src/OutputFormat.php index 979f600a..f485d1c5 100644 --- a/src/OutputFormat.php +++ b/src/OutputFormat.php @@ -10,6 +10,8 @@ class OutputFormat * Value format: `"` means double-quote, `'` means single-quote * * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sStringQuotingType = '"'; @@ -17,6 +19,8 @@ class OutputFormat * Output RGB colors in hash notation if possible * * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $bRGBHashNotation = true; @@ -26,6 +30,8 @@ class OutputFormat * Semicolon after the last rule of a declaration block can be omitted. To do that, set this false. * * @var bool + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $bSemicolonAfterLastRule = true; @@ -34,36 +40,52 @@ class OutputFormat * Note that these strings are not sanity-checked: the value should only consist of whitespace * Any newline character will be indented according to the current level. * The triples (After, Before, Between) can be set using a wildcard (e.g. `$oFormat->set('Space*Rules', "\n");`) + * + * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceAfterRuleName = ' '; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceBeforeRules = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceAfterRules = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceBetweenRules = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceBeforeBlocks = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceAfterBlocks = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceBetweenBlocks = "\n"; @@ -71,11 +93,15 @@ class OutputFormat * Content injected in and around at-rule blocks. * * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sBeforeAtRuleBlock = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sAfterAtRuleBlock = ''; @@ -83,11 +109,15 @@ class OutputFormat * This is what’s printed before and after the comma if a declaration block contains multiple selectors. * * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceBeforeSelectorSeparator = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceAfterSelectorSeparator = ' '; @@ -98,6 +128,8 @@ class OutputFormat * To set the spacing for specific separators, use {@see $aSpaceBeforeListArgumentSeparators} instead. * * @var string|array + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceBeforeListArgumentSeparator = ''; @@ -105,6 +137,8 @@ class OutputFormat * Keys are separators (e.g. `,`). Values are the space sequence to insert, or an empty string. * * @var array + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $aSpaceBeforeListArgumentSeparators = []; @@ -115,6 +149,8 @@ class OutputFormat * To set the spacing for specific separators, use {@see $aSpaceAfterListArgumentSeparators} instead. * * @var string|array + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceAfterListArgumentSeparator = ''; @@ -122,11 +158,15 @@ class OutputFormat * Keys are separators (e.g. `,`). Values are the space sequence to insert, or an empty string. * * @var array + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $aSpaceAfterListArgumentSeparators = []; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sSpaceBeforeOpeningBrace = ' '; @@ -134,16 +174,22 @@ class OutputFormat * Content injected in and around declaration blocks. * * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sBeforeDeclarationBlock = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sAfterDeclarationBlockSelectors = ''; /** * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sAfterDeclarationBlock = ''; @@ -151,6 +197,8 @@ class OutputFormat * Indentation character(s) per level. Only applicable if newlines are used in any of the spacing settings. * * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sIndentation = "\t"; @@ -158,6 +206,8 @@ class OutputFormat * Output exceptions. * * @var bool + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $bIgnoreExceptions = false; @@ -165,6 +215,8 @@ class OutputFormat * Render comments for lists and RuleSets * * @var bool + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $bRenderComments = false; diff --git a/src/Property/CSSNamespace.php b/src/Property/CSSNamespace.php index fcce5d08..7ef5e0d5 100644 --- a/src/Property/CSSNamespace.php +++ b/src/Property/CSSNamespace.php @@ -29,6 +29,8 @@ class CSSNamespace implements AtRule /** * @var array + * + * @internal since 8.8.0 */ protected $comments; diff --git a/src/Property/Charset.php b/src/Property/Charset.php index c58f990c..9e848392 100644 --- a/src/Property/Charset.php +++ b/src/Property/Charset.php @@ -25,11 +25,15 @@ class Charset implements AtRule /** * @var int + * + * @internal since 8.8.0 */ protected $lineNumber; /** * @var array + * + * @internal since 8.8.0 */ protected $comments; diff --git a/src/Property/Import.php b/src/Property/Import.php index 636ec58b..68c13f39 100644 --- a/src/Property/Import.php +++ b/src/Property/Import.php @@ -25,11 +25,15 @@ class Import implements AtRule /** * @var int + * + * @internal since 8.8.0 */ protected $lineNumber; /** * @var array + * + * @internal since 8.8.0 */ protected $comments; diff --git a/src/Rule/Rule.php b/src/Rule/Rule.php index 0fb9d494..d863b34c 100644 --- a/src/Rule/Rule.php +++ b/src/Rule/Rule.php @@ -48,11 +48,15 @@ class Rule implements Renderable, Commentable /** * @var int + * + * @internal since 8.8.0 */ protected $iColNo; /** * @var array + * + * @internal since 8.8.0 */ protected $comments; diff --git a/src/RuleSet/RuleSet.php b/src/RuleSet/RuleSet.php index 458f0af5..5f9dc99d 100644 --- a/src/RuleSet/RuleSet.php +++ b/src/RuleSet/RuleSet.php @@ -31,11 +31,15 @@ abstract class RuleSet implements Renderable, Commentable /** * @var int + * + * @internal since 8.8.0 */ protected $lineNumber; /** * @var array + * + * @internal since 8.8.0 */ protected $comments; diff --git a/src/Settings.php b/src/Settings.php index 6dd4d3e4..c684a690 100644 --- a/src/Settings.php +++ b/src/Settings.php @@ -18,6 +18,8 @@ class Settings * and `mb_strpos` functions. Otherwise, the normal (ASCII-Only) functions will be used. * * @var bool + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $bMultibyteSupport; @@ -25,6 +27,8 @@ class Settings * The default charset for the CSS if no `@charset` declaration is found. Defaults to utf-8. * * @var string + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $sDefaultCharset = 'utf-8'; @@ -32,6 +36,8 @@ class Settings * Whether the parser silently ignore invalid rules instead of choking on them. * * @var bool + * + * @internal since 8.8.0, will be made private in 9.0.0 */ public $bLenientParsing = true; diff --git a/src/Value/CSSFunction.php b/src/Value/CSSFunction.php index 8e6372f3..37572615 100644 --- a/src/Value/CSSFunction.php +++ b/src/Value/CSSFunction.php @@ -15,6 +15,8 @@ class CSSFunction extends ValueList { /** * @var string + * + * @internal since 8.8.0 */ protected $sName; diff --git a/src/Value/Value.php b/src/Value/Value.php index 7ba2a7e2..3fa7abd3 100644 --- a/src/Value/Value.php +++ b/src/Value/Value.php @@ -18,6 +18,8 @@ abstract class Value implements Renderable { /** * @var int + * + * @internal since 8.8.0 */ protected $lineNumber; diff --git a/src/Value/ValueList.php b/src/Value/ValueList.php index 445bba26..683ada3d 100644 --- a/src/Value/ValueList.php +++ b/src/Value/ValueList.php @@ -16,11 +16,15 @@ abstract class ValueList extends Value { /** * @var array + * + * @internal since 8.8.0 */ protected $aComponents; /** * @var string + * + * @internal since 8.8.0 */ protected $sSeparator;