…redits.

Pl38 patch 1

feat(.gitignore): add common directories and files to ignore list

Added patterns to .gitignore to exclude log files, PHP CS Fixer cache,
PHPStorm metadata, build artifacts, node_modules, storage directory,
ray.php, and PHPStan baseline. This prevents unnecessary files from
being tracked in version control, keeping the repository clean.

Ref: composer-updates
```

…composer-updates)

Add a `.php-cs-fixer.php` configuration file to define rules for automatic
code style corrections in the project. This includes PSR-12 compliance and
an assortment of additional rules to ensure a consistent coding standard.```

refactor(tests): update test cases to use Pest PHP

Change test cases to use the Pest PHP testing framework. Refactor existing
test cases in MetricFactoryTest.php, SizeMetricTest.php, and others to use
Pest PHP functions such as test and beforeEach. Remove unnecessary use of
namespaces and class structures for test cases, simplifying the codebase.

Issue: composer-updates
```

```

style: apply PSR-12 formatting and add trailing commas

Apply PSR-12 formatting standards in AbstractKeywordDensityMetric.php,
ensuring consistency in spacing and adding trailing commas to arrays.
Additionally, cast text to string before applying `strtolower` and
`preg_replace` for clarity.
```

style: align class constants and improve whitespace in AbstractMetric

This commit adjusts the alignment of class constants to enhance
readability. It also introduces additional line breaks to separate logical
blocks of code within methods, adhering to coding standards.

Refs: composer-updates
```

style: add space after negation operator in AbstractParser

Ensure consistency in spacing after the negation operator within the
`__construct` method of the `AbstractParser` class.
```

refactor: standardise whitespace in AltsMetric calculation (composer-updates)

Ensure consistent spacing around variable assignments in the AltsMetric.php.
This improves code readability and maintains coding standards.
```

refactor: streamline Analyzer constructors and methods (composer-updates)

- Remove unused parameters in Analyzer constructors.
- Enforce PSR-12 by adding spaces after negation operators.
- Tidy up formatting and remove unnecessary comments for clarity.
```

refactor: remove unused import and improve code readability

Remove the unused InvalidArgumentException import and add blank lines to improve
the readability of the Cache class methods.
```

feat: update header formatting and ensure options merge in Client.php (#composer-updates)

Reformat headers array for consistency and add a newline to separate
the options merging logic.
```

refactor: remove redundant param annotations from ClientInterface

Param annotations for the method in the ClientInterface were removed,
as they are superfluous and the method signature is self-explanatory.
This change is part of the ongoing composer updates. (composer-updates)
```

feat(Parser): add line break in ExampleCustomParser

Add a single line break to enhance code readability in
ExampleCustomParser.php. Relates to the composer-updates branch.
```

refactor: specify property types in Factor class (composer-updates)

Add explicit string type declarations to all class constants.
```

fix: improve readability in HeadersKeywordDensityMetric

Adjust spacing for better readability and maintainability in the
HeadersKeywordDensityMetric class. Update assignment alignments and add
missing line breaks to match coding standards.

Refs: composer-updates
```

style: add trailing commas and improve formatting in HeadersMetric

Ensuring consistent array formatting and trailing commas in the
HeadersMetric.php file. This enhances readability and future diffs.
```

style: add missing commas to array items in HeadersMetric (#composer-updates)

Ensure proper array formatting by adding trailing commas to
multiline array items, improving readability and future diff clarity.
```

refactor: improve readability and structure of keyword density checks

Optimise keyword density metric calculations and update handling of
overused keywords. Adjust spacing for consistency and improve method
structure for better readability and maintainability.
```

feat: add line breaks for better readability in KeywordMetric

A couple of line breaks were introduced after each control structure
in the KeywordMetric.php to enhance code readability and maintainability.
Related to the composer-updates branch.
```

feat: add spacing for readability in LengthMetric.php (#composer-updates)

Whitespace added to improve code structure and readability in the
LengthMetric class.
```

feat: improve readability of LoadTimeMetric messages #composer-updates

Adjust alignment of assignment operators and add line breaks in
LoadTimeMetric.php for better readability of the code.
```

style: ensure consistent array formatting in MetaMetric

Added missing commas and aligned array arrows for better readability
in the MetaMetric class. This change maintains code style consistency
across the project.
```

refactor: update `MetricFactory::get` method signature (#composer-updates)

Change the `$inputData` parameter type to `bool|string|null` and
reformat code for consistency.
```

refactor: add type hints to constants and clean up constructor in Page

Add string type hints to class constants and refactor the Page
constructor for better readability and efficiency. Remove unnecessary
parameter comments and improve conditionals and spacing for consistency.
This update is part of the ongoing efforts to enhance code quality.

Issue found in the branch name: composer-updates.
```

fix(parser): ensure nodeValue is cast to string for robustness

Trim and cast nodeValue to string in getHeaders and getTitle methods.
Add missing line breaks between method blocks for readability.
Related to refactoring on the 'composer-updates' branch.
```

style: improve readability with added line breaks in RatioMetric

Add line breaks after impact assignments in the RatioMetric class to
enhance code readability and maintainability. No functional changes.
```

style: add spacing for readability in RedirectMetric (#composer-updates)

Ensure consistent spacing around control structures for clarity.
```

refactor: streamline conditionals in RobotsMetric.php (composer-updates)

Replace `else if` with separate `if` statement to improve code clarity.
Add missing line breaks after setting impact values.
```

Add line breaks to enhance code readability in the SitemapMetric
evaluation method.

style: standardise array formatting in SizeMetric.php (#composer-updates)

Ensure consistency in array element indentation and add missing commas
after each array item in the $results and $conditions arrays.
```

feat(Page): check SSL usage and impact on SEO #composer-updates

Implement SSL metric evaluation to provide feedback on encryption
use and its potential SEO impact. Ensure lines are separated by
additional spaces for readability.
```

refactor: update type declarations and default handling in AbstractKeywordDensityMetric (#composer-updates)

Update type declarations for class properties and constructor
parameters. Refactor default input data handling to check for empty
array. Simplify calculateKeywordsPercentage and getWords methods.
Remove redundant comments and code cleanup.
```

refactor(tests): move test cases to feature namespace

Moved all test cases from `TestCase` to `Feature` namespace, with
appropriate adjustments to the test infrastructure. This includes
namespace changes, strict type declarations, and renaming of the base
test case class. Also, the example test was amended to be more
expressive.
```

feat: add .phpunit.cache to .gitignore (composer-updates)

Ensure PHPUnit cache is not tracked by adding its directory to the
project's .gitignore file.
```

refactor: type-hint properties and methods in AbstractMetric

Type-hint class properties and methods for better code quality and
maintainability. Remove unused use statement and redundant variable
assignments. Update constructor to use property promotion.
```

refactor(parser): update AbstractParser with typed properties and methods

Replace docblocks with type hints in properties and methods.
Use union types and attributes where applicable.
Ensure compatibility with ParserInterface.
Issue found in branch name: composer-updates.
```

feat(AltsMetric): add typing and override annotation (#composer-updates)

Add strong typing to the $description property and the Override
attribute to the analyze method in the AltsMetric class.
```

refactor: remove redundant docblocks, add type hints in Analyzer (#composer-updates)

- Removed unnecessary docblocks from properties and constructor.
- Added string type hints to getFileContent method parameters.
- Utilised constructor property promotion for $client.
```

feat: add strict types and improve parameter typing for Cache

- Enforce strict typing with `declare(strict_types=1)`.
- Introduce `use DateInterval` to support more precise TTL definitions.
- Refactor `__construct` method to accept `int|null` for `$ttl` and
  default to 300 if not provided.
- Update `set` method signature to accept `mixed` type for `$value` and
  `DateInterval|int|null` for `$ttl`, enhancing flexibility and type safety.
  Related to composer-updates.
```

feat: update Client property and method with type declarations (#composer-updates)

- Add type declaration to `$options` property.
- Replace docblock with #[Override] attribute for `get` method.
```

feat: update PHP and package dependencies (#composer-updates)

Update PHP requirement to >=8.3 and upgrade various package versions.
Introduce new development tools and plugins, reorganise composer.json,
and modify test scripts to use Pest.
```

feat(ExampleCustomParser): add Override attribute to getAlts method

Add the use of Override attribute in ExampleCustomParser to clarify
method overriding. Issue found in the 'composer-updates' branch.
```

feat: add type hint and override attribute to HeadersKeywordDensityMetric

- Include 'use Override' directive.
- Add string type hint to the $description property.
- Annotate the analyze method with #[Override] attribute.
```

refactor: standardise types and annotations in HeadersMetric (#composer-updates)

- Enforce type declarations for class properties and constructor parameter.
- Add Override attribute to analyze and setUpResultsConditions methods.
```

refactor: type hint properties and methods in HeadersMetric (#composer-updates)

- Add type hints to $description and $results properties.
- Specify return type for analyze() and setUpResultsConditions() methods.
- Add Override attribute to analyze() and setUpResultsConditions().
- Ensure type compatibility for $inputData parameter in constructor.
```

feat: add types and override attribute to KeywordDensityMetric (#composer-updates)

Ensure proper typing in KeywordDensityMetric properties and methods.
Also, decorate the analyze method with the Override attribute to
clarify its role in the class hierarchy.
```

feat(KeywordMetric): enforce type declaration and add Override attribute

Use type declaration for `$description` property and add the Override
attribute to `analyze` method in `KeywordMetric`. This change improves
code consistency and readability.

Refs: composer-updates
```

fix: type-hint $description and add Override attribute (#composer-updates)

- Type-hint the `$description` property to `string`.
- Add the `Override` attribute to the `analyze` method.
```

feat: add type declaration and attribute in LoadTimeMetric #composer-updates

- Add string type declaration to $description property.
- Include Override attribute to analyze method.
```

refactor: type-hint properties and methods in MetaMetric (#composer-updates)

- Add type declarations to class properties and method parameters.
- Include `Override` attribute for overriding methods.
```

feat: update MetricFactory to handle SSL metrics #composer-updates

- Update the `get` method signature to allow mixed types.
- Add conditional handling for SSL metrics to use uppercase class names.
```

feat: add override attribute to parser methods (#composer-updates)

Added the #[Override] attribute to methods in the Parser class to
explicitly indicate they override methods of the parent class.
```

feat(ParserInterface): add type hint for `setContent` parameter (#composer-updates)

The `setContent` method in the ParserInterface now accepts a mixed type
parameter, enhancing flexibility and compatibility with various content
types.
```

feat: enforce typing and add attribute in RatioMetric

- Specify string type for $description property.
- Declare parameter type for RatioMetric constructor.
- Add #[Override] attribute to analyze method.
Based on branch name, relates to composer-updates.
```

fix: add types and attributes to RedirectMetric properties (#composer-updates)

Ensure proper typing for class properties and use of the Override
attribute in RedirectMetric for better code clarity and compliance
with PHP 8 standards.
```

feat(RobotsMetric): type-hint $description and add Override annotation

Add type declaration for $description property and Override attribute to
the analyze method in the RobotsMetric class. This improves code
clarity and adherence to best practices. #composer-updates
```

feat: add type hint and attribute in SitemapMetric (#composer-updates)

Add explicit string type hint to $description and Override attribute
to the analyze method in SitemapMetric.
```

feat: upgrade SizeMetric with type declarations (#composer-updates)

Add type declarations for properties and constructor parameter.
Annotate analyze method with #[Override] attribute.
```

feat: add typing and override annotation to SSLMetric (#composer-updates)

Added strict typing to the `$description` property and the override
annotation to the `analyze` method in SSLMetric.php.
```

feat: add phpstan config and rector for code quality (composer-updates)

- Introduced phpstan.neon.dist to configure static analysis.
- Created rector.php for automated code refactor.
- Updated phpunit.xml with stricter testing configurations.
```