Improve documentation v2

README.md

@@ -36,8 +36,7 @@ composer require bakame/http-structured-fields
 
 ## Documentation
 
-- The documentation for [version 2.x](/docs/00-intro.md) for **the upcoming v2 release**
-- The documentation for [version 1.x](https://github.com/bakame-php/http-structured-fields/tree/1.x) for the current stable version.
+- The documentation for **the upcoming [version 2.x](/docs/index) release**
 
 ## Contributing
 

docs/01-basic-usage.md

@@ -65,4 +65,4 @@ process that the package can simplify for you once you read the documentation.
 The goal of the examples are to show that even without dwelling too much into the ins and out
 of the package you can easily and quickly parse or serialize compliant fields in PHP.
 
-← [Intro](00-intro.md)  |  [Parsing and Serializing](02-parsing-serializing.md) →
+← [Intro](index)  |  [Parsing and Serializing](02-parsing-serializing.md) →

docs/04-containers.md

@@ -456,4 +456,4 @@ Item::new($cache->name)
     ->when(null !== $cache->detail, fn (Item $item) => $item->appendParameter('detail', $cache->detail));
 ```
 
-← [Accessing Field Values](03-field-values.md)  |  [Validation](05-validation) →
+← [Accessing Field Values](03-field-values.md)  |  [Validation](05-validation.md) →

docs/08-migration.md

@@ -150,4 +150,4 @@ OuterList::fromPairs([
 > [!NOTE]
 > The v1 syntax is still supported.
 
-← [Extending the package functionalities](07-extensions.md)  |  [Intro](00-intro.md) →
+← [Extending the package functionalities](07-extensions.md)  |  [Intro](index) →

docs/_config.yml

@@ -0,0 +1,8 @@
+---
+permalink: pretty
+remote_theme: pages-themes/hacker@v0.2.0
+plugins:
+    - jekyll-redirect-from
+    - jekyll-remote-theme # add this line to the plugins list if you already have one
+title: bakame/http-structured-fields
+description: is a framework-agnostic PHP library that allows you to parse, serialize, create, update and validate HTTP Structured Fields in PHP

src/Type.php

@@ -11,8 +11,8 @@
  */
 enum Type: string
 {
-    public const MAXIMUM_INT = 999_999_999_999_999;
-    public const MAXIMUM_FLOAT = 999_999_999_999;
+    private const MAXIMUM_INT = 999_999_999_999_999;
+    private const MAXIMUM_FLOAT = 999_999_999_999;
 
     case Integer = 'integer';
     case Decimal = 'decimal';
@@ -45,7 +45,7 @@ public function isOneOf(mixed ...$other): bool
     /**
      * @throws SyntaxError if the value can not be resolved into a supported HTTP structured field data type
      */
-    public static function fromVariable(mixed $value): self
+    public static function fromVariable(Item|Token|DisplayString|Bytes|DateTimeInterface|int|float|bool|string $value): self
     {
         return self::tryFromVariable($value) ?? throw new SyntaxError(match (true) {
             $value instanceof DateTimeInterface => 'The integer representation of a date is limited to 15 digits for a HTTP structured field date type.',

tests/TypeTest.php

@@ -12,12 +12,6 @@
 
 final class TypeTest extends TestCase
 {
-    #[Test]
-    public function it_will_return_null_if_the_type_is_no_supported(): void
-    {
-        self::assertNull(Type::tryFromVariable([]));
-    }
-
     #[Test]
     public function it_will_return_false_if_the_type_is_valid_but_its_value_is_invalid(): void
     {
@@ -35,7 +29,7 @@ public function it_can_tell_the_item_type_from_a_value_instance(): void
     #[DataProvider('itemTypeProvider')]
     public function it_can_tell_the_item_type(mixed $value, Type $expectedType): void
     {
-        self::assertTrue($expectedType->equals(Type::fromVariable($value)));
+        self::assertTrue($expectedType->equals(Type::fromVariable($value))); /* @phpstan-ignore-line */
         self::assertTrue($expectedType->equals(Type::tryFromVariable($value)));
     }