Tests pass

src/Document/Attachable.php → src/Attachable.php

@@ -1,8 +1,11 @@
 <?php
 declare(strict_types=1);
 
-namespace JsonApiPhp\JsonApi\Document;
+namespace JsonApiPhp\JsonApi;
 
+/**
+ * @internal
+ */
 interface Attachable
 {
     function attachTo(object $o);

src/AttachableValue.php

@@ -0,0 +1,25 @@
+<?php
+declare(strict_types=1);
+
+namespace JsonApiPhp\JsonApi;
+
+/**
+ * @internal
+ */
+class AttachableValue
+    extends JsonSerializableValue
+    implements Attachable
+{
+    private $key;
+
+    public function __construct(string $key, $value)
+    {
+        parent::__construct($value);
+        $this->key = $key;
+    }
+
+    function attachTo(object $o)
+    {
+        $o->{$this->key} = $this;
+    }
+}

src/DataDocument.php

@@ -3,10 +3,9 @@
 
 namespace JsonApiPhp\JsonApi;
 
-use JsonApiPhp\JsonApi\Document\JsonSerializableValue;
 use JsonApiPhp\JsonApi\PrimaryData\PrimaryData;
 
-class DataDocument extends JsonSerializableValue
+final class DataDocument extends JsonSerializableValue
 {
     public function __construct(PrimaryData $data, DataDocumentMember ...$documentMembers)
     {

src/DataDocumentMember.php

@@ -1,7 +1,9 @@
 <?php
 namespace JsonApiPhp\JsonApi;
 
+/**
+ * @internal
+ */
 interface DataDocumentMember extends DocumentMember
 {
-
 }

src/DocumentMember.php

@@ -3,8 +3,9 @@
 
 namespace JsonApiPhp\JsonApi;
 
-use JsonApiPhp\JsonApi\Document\Attachable;
-
+/**
+ * @internal
+ */
 interface DocumentMember
     extends \JsonSerializable, Attachable
 {

src/Error/AboutLink.php

@@ -4,9 +4,9 @@
 namespace JsonApiPhp\JsonApi\Error;
 
 use JsonApiPhp\JsonApi\Link\Link;
-use JsonApiPhp\JsonApi\Link\NamedLink;
+use JsonApiPhp\JsonApi\Link\AttachableLink;
 
-class AboutLink extends NamedLink implements ErrorMember
+final class AboutLink extends AttachableLink implements ErrorMember
 {
     public function __construct(Link $link)
     {

src/Error/Code.php

@@ -3,9 +3,9 @@
 
 namespace JsonApiPhp\JsonApi\Error;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 
-class Code
+final class Code
     extends AttachableValue
     implements ErrorMember
 {

src/Error/Detail.php

@@ -3,9 +3,9 @@
 
 namespace JsonApiPhp\JsonApi\Error;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 
-class Detail
+final class Detail
     extends AttachableValue
     implements ErrorMember
 {

src/Error/Error.php

@@ -3,11 +3,11 @@
 
 namespace JsonApiPhp\JsonApi\Error;
 
-use JsonApiPhp\JsonApi\Document\JsonSerializableValue;
+use JsonApiPhp\JsonApi\JsonSerializableValue;
 use JsonApiPhp\JsonApi\MandatoryErrorDocumentMember;
 use function JsonApiPhp\JsonApi\combine;
 
-class Error
+final class Error
     extends JsonSerializableValue
     implements MandatoryErrorDocumentMember
 

src/Error/ErrorMember.php

@@ -3,6 +3,9 @@
 
 use JsonApiPhp\JsonApi\DocumentMember;
 
+/**
+ * @internal 
+ */
 interface ErrorMember extends DocumentMember
 {
 }

src/Error/Id.php

@@ -3,9 +3,9 @@
 
 namespace JsonApiPhp\JsonApi\Error;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 
-class Id
+final class Id
     extends AttachableValue
     implements ErrorMember
 {

src/Error/Source.php

@@ -3,11 +3,11 @@
 
 namespace JsonApiPhp\JsonApi\Error;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 use JsonApiPhp\JsonApi\Error\Source\SourceMember;
 use function JsonApiPhp\JsonApi\combine;
 
-class Source
+final class Source
     extends AttachableValue
     implements ErrorMember
 {

src/Error/Source/Parameter.php

@@ -3,7 +3,7 @@
 
 namespace JsonApiPhp\JsonApi\Error\Source;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 
 final class Parameter
     extends AttachableValue

src/Error/Source/Pointer.php

@@ -3,7 +3,7 @@
 
 namespace JsonApiPhp\JsonApi\Error\Source;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 
 final class Pointer
     extends AttachableValue

src/Error/Source/SourceMember.php

@@ -5,6 +5,9 @@
 
 use JsonApiPhp\JsonApi\DocumentMember;
 
+/**
+ * @internal
+ */
 interface SourceMember extends DocumentMember
 {
 }

src/Error/Status.php

@@ -3,7 +3,7 @@
 
 namespace JsonApiPhp\JsonApi\Error;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 
 final class Status
     extends AttachableValue

src/Error/Title.php

@@ -3,7 +3,7 @@
 
 namespace JsonApiPhp\JsonApi\Error;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 
 class Title
     extends AttachableValue

src/ErrorDocument.php

@@ -3,9 +3,7 @@
 
 namespace JsonApiPhp\JsonApi;
 
-use JsonApiPhp\JsonApi\Document\JsonSerializableValue;
-
-class ErrorDocument
+final class ErrorDocument
     extends JsonSerializableValue
 {
     public function __construct(MandatoryErrorDocumentMember $error, ErrorDocumentMember ...$members)

src/ErrorDocumentMember.php

@@ -3,6 +3,9 @@
 
 namespace JsonApiPhp\JsonApi;
 
+/**
+ * @internal
+ */
 interface ErrorDocumentMember extends DocumentMember
 {
 

src/Document/JsonApi.php → src/JsonApi.php

@@ -1,10 +1,7 @@
 <?php
 declare(strict_types=1);
 
-namespace JsonApiPhp\JsonApi\Document;
-
-use JsonApiPhp\JsonApi\DataDocumentMember;
-use JsonApiPhp\JsonApi\TopLevelDocumentMember;
+namespace JsonApiPhp\JsonApi;
 
 final class JsonApi
     extends AttachableValue

src/Document/JsonSerializableValue.php → src/JsonSerializableValue.php

@@ -1,8 +1,11 @@
 <?php
 declare(strict_types=1);
 
-namespace JsonApiPhp\JsonApi\Document;
+namespace JsonApiPhp\JsonApi;
 
+/**
+ * @internal
+ */
 class JsonSerializableValue implements \JsonSerializable
 {
     private $value;

src/Link/NamedLink.php → src/Link/AttachableLink.php

@@ -3,14 +3,17 @@
 
 namespace JsonApiPhp\JsonApi\Link;
 
-use JsonApiPhp\JsonApi\Document\AttachableValue;
+use JsonApiPhp\JsonApi\AttachableValue;
 
-abstract class NamedLink
+/**
+ * @internal
+ */
+class AttachableLink
     extends AttachableValue
 {
-    public function __construct(string $name, Link $link)
+    public function __construct(string $key, Link $link)
     {
-        parent::__construct($name, $link);
+        parent::__construct($key, $link);
     }
 
     function attachTo(object $o)

src/Link/Link.php

@@ -3,6 +3,9 @@
 
 namespace JsonApiPhp\JsonApi\Link;
 
+/**
+ * @internal
+ */
 interface Link
 {
 

src/Link/LinkObject.php

@@ -3,10 +3,10 @@
 
 namespace JsonApiPhp\JsonApi\Link;
 
-use JsonApiPhp\JsonApi\Document\JsonSerializableValue;
-use JsonApiPhp\JsonApi\Document\Meta;
+use JsonApiPhp\JsonApi\JsonSerializableValue;
+use JsonApiPhp\JsonApi\Meta;
 
-class LinkObject
+final class LinkObject
     extends JsonSerializableValue
     implements Link
 {

src/Link/SelfLink.php

@@ -5,7 +5,7 @@
 
 use JsonApiPhp\JsonApi\DataDocumentMember;
 
-class SelfLink extends NamedLink implements DataDocumentMember
+final class SelfLink extends AttachableLink implements DataDocumentMember
 {
     public function __construct(Link $link)
     {

src/Link/Url.php

@@ -3,9 +3,9 @@
 
 namespace JsonApiPhp\JsonApi\Link;
 
-use JsonApiPhp\JsonApi\Document\JsonSerializableValue;
+use JsonApiPhp\JsonApi\JsonSerializableValue;
 
-class Url
+final class Url
     extends JsonSerializableValue
     implements Link
 {

src/MandatoryErrorDocumentMember.php

@@ -3,6 +3,9 @@
 
 namespace JsonApiPhp\JsonApi;
 
+/**
+ * @internal
+ */
 interface MandatoryErrorDocumentMember extends ErrorDocumentMember
 {