Add RFC 8941 structured field parsing

composer.json

@@ -37,9 +37,24 @@
  "require-dev": {
  "phpunit/phpunit": "^9",
  "amphp/php-cs-fixer-config": "^2",
+ "httpwg/structured-field-tests": "1.0",
  "league/uri": "^6.8 | ^7.1",
  "psalm/phar": "^5.4"
  },
+ "repositories": [
+ {
+ "type": "package",
+ "package": {
+ "name": "httpwg/structured-field-tests",
+ "version": "1.0",
+ "source": {
+ "url": "https://github.com/httpwg/structured-field-tests",
+ "type": "git",
+ "reference": "origin/main"
+ }
+ }
+ }
+ ],
  "scripts": {
  "test": "php -dzend.assertions=1 -dassert.exception=1 vendor/bin/phpunit",
  "code-style": "php vendor/bin/php-cs-fixer fix"

src/StructuredFields/Boolean.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Amp\Http\StructuredFields;
+
+/**
+ * @psalm-import-type Rfc8941Parameters from \Amp\Http\StructuredFields\Rfc8941
+ * @property-read bool $item
+ * @template-extends Item<void>
+ */
+class Boolean extends Item
+{
+ /**
+ * @psalm-param Rfc8941Parameters $parameters
+ */
+ public function __construct(bool $item, array $parameters)
+ {
+ parent::__construct($item, $parameters);
+ }
+}

src/StructuredFields/Bytes.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Amp\Http\StructuredFields;
+
+/**
+ * @psalm-import-type Rfc8941Parameters from \Amp\Http\StructuredFields\Rfc8941
+ * @property-read string $item
+ * @template-extends Item<void>
+ */
+class Bytes extends Item
+{
+ /**
+ * @psalm-param Rfc8941Parameters $parameters
+ */
+ public function __construct(string $item, array $parameters)
+ {
+ parent::__construct($item, $parameters);
+ }
+}

src/StructuredFields/Date.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Amp\Http\StructuredFields;
+
+/**
+ * @psalm-import-type Rfc8941Parameters from \Amp\Http\StructuredFields\Rfc8941
+ * @property-read int $item
+ * @template-extends Item<void>
+ */
+class Date extends Item
+{
+ /**
+ * @psalm-param Rfc8941Parameters $parameters
+ */
+ public function __construct(int $item, array $parameters)
+ {
+ parent::__construct($item, $parameters);
+ }
+}

src/StructuredFields/DisplayString.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Amp\Http\StructuredFields;
+
+/**
+ * @psalm-import-type Rfc8941Parameters from \Amp\Http\StructuredFields\Rfc8941
+ * @property-read string $item
+ * @template-extends Item<void>
+ */
+class DisplayString extends Item
+{
+ /**
+ * @psalm-param Rfc8941Parameters $parameters
+ */
+ public function __construct(string $item, array $parameters)
+ {
+ parent::__construct($item, $parameters);
+ }
+}

src/StructuredFields/InnerList.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Amp\Http\StructuredFields;
+
+/**
+ * @psalm-import-type Rfc8941Parameters from \Amp\Http\StructuredFields\Rfc8941
+ * @property-read list<Item<void>> $item
+ * @template-extends Item<list<Item<void>>>
+ */
+class InnerList extends Item
+{
+ /**
+ * @psalm-param list<Item<void>> $item
+ * @psalm-param Rfc8941Parameters $parameters
+ */
+ public function __construct(array $item, array $parameters)
+ {
+ parent::__construct($item, $parameters);
+ }
+}

src/StructuredFields/Item.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Amp\Http\StructuredFields;
+
+/**
+ * @psalm-template Inner
+ * @psalm-import-type Rfc8941Parameters from \Amp\Http\StructuredFields\Rfc8941
+ */
+class Item
+{
+ /**
+ * @psalm-param int|float|string|bool|Inner $item
+ * @psalm-param Rfc8941Parameters $parameters
+ */
+ protected function __construct(public readonly int|float|string|bool|array $item, public readonly array $parameters)
+ {
+ }
+}

src/StructuredFields/Number.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Amp\Http\StructuredFields;
+
+/**
+ * @psalm-import-type Rfc8941Parameters from \Amp\Http\StructuredFields\Rfc8941
+ * @property-read int|float $item
+ * @template-extends Item<void>
+ */
+class Number extends Item
+{
+ /**
+ * @psalm-param Rfc8941Parameters $parameters
+ */
+ public function __construct(int|float $item, array $parameters)
+ {
+ parent::__construct($item, $parameters);
+ }
+}