chore: dtrack config, docs, tests

Author: iroybotlinio

.github/workflows/dtrack-trivy.yml

@@ -5,11 +5,13 @@ on:
       - .github/workflows/dtrack-trivy.yml
       - 'composer.json'
       - 'composer.lock'
+      - 'yarn.lock'
   pull_request:
     paths:
       - .github/workflows/dtrack-trivy.yml
       - 'composer.json'
       - 'composer.lock'
+      - 'yarn.lock'
   workflow_dispatch:
 
 permissions:

.prettierrc.js

@@ -7,7 +7,7 @@ const config = {
     tabWidth: 4,
     semi: false,
     singleQuote: true,
-    plugins: ["@ttskch/prettier-plugin-tailwindcss-anywhere", "prettier-plugin-tailwindcss", "@zackad/prettier-plugin-twig-melody"],
+    plugins: ["@zackad/prettier-plugin-twig"],
 };
 
 module.exports = config;

clover.xml

@@ -24,6 +24,19 @@ No matter which frontend technologies you use in a project ([Twig](https://twig.
 In short, I advocate for using standardized HTML5 markup, in order to having to write less of it and instead generate it. Descriptive, easy to read languages like YAML can help composing compositions of HTML5 elements, such as a search form.
 :::
 
+::: code-group
+
+```php [PHP]
+use ExtendedHTMLDocument\HTML\Elements\Form;
+Form::create();
+```
+
+```twig [Twig]
+form.render()
+```
+:::
+
+
 ## Where to go next?
 - [Features Overview](./features)
 - [Getting Started](./getting-started)

docs/introduction.md

@@ -137,4 +137,4 @@ Issues detected: 76
 
 Issues detected: 8
 
-Tue Apr  1 09:02:10 CEST 2025
+Sat Jul 12 11:04:46 AM CEST 2025

docs/phpmd.md

@@ -12,6 +12,7 @@ tbd add a gif
 This part is currently work in progress. The information below might be outdated, incomplete or incorrect.
 :::
 
+
 ### Creation via `create()` method
 
 ```php{4}

docs/usage-examples.md

@@ -1,18 +1,15 @@
 {
   "devDependencies": {
-    "@ttskch/prettier-plugin-tailwindcss-anywhere": "^0.1.0",
+    "@algolia/client-search": "^5.23.0",
+    "@zackad/prettier-plugin-twig": "^0.16.0",
     "prettier": "^3.5.3",
-    "prettier-plugin-tailwindcss": "^0.6.11",
-    "prettier-plugin-twig": "^1.0.1",
+    "search-insights": "^2.17.3",
     "vitepress": "^1.6.3"
   },
   "license": "MIT",
   "scripts": {
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs"
-  },
-  "dependencies": {
-    "@zackad/prettier-plugin-twig-melody": "^0.6.0"
   }
 }

package.json

@@ -18,6 +18,11 @@
     $this->delegator = Anchor::create($this->document);
 });
 
+test('teste irgendetwas', function () {
+    expect('irgendetwas')->toEqual('irgendetwas anderes');
+});
+
+
 test('constructor', function () {
     expect($this->delegator)->toBeInstanceOf(HTMLElementDelegator::class);
 });
@@ -357,3 +362,46 @@
     expect($this->delegator->renderer)
         ->toBe($renderer);
 });
+test('appendChild should successfully append a child element', function () {
+    $document = HTMLDocumentDelegator::createEmpty();
+    $parent = HTML::create($document);
+    $child = Body::create($document);
+
+    $result = $parent->appendChild($child);
+
+    expect($result)
+        ->toBe($parent); // Test method chaining
+    expect($parent->delegated->firstChild)
+        ->toBe($child->delegated);
+});
+
+test('appendChild should reject child from different document', function () {
+    $document1 = HTMLDocumentDelegator::createEmpty();
+    $document2 = HTMLDocumentDelegator::createEmpty();
+
+    $parent = HTML::create($document1);
+    $child = Body::create($document2);
+
+    expect(fn () => $parent->appendChild($child))
+        ->toThrow(
+            InvalidArgumentException::class,
+            'The child element must belong to the same document as the parent element.'
+        );
+});
+
+test('appendChild should handle chained calls', function () {
+    $document = HTMLDocumentDelegator::createEmpty();
+    $parent = HTML::create($document);
+    $child1 = Body::create($document);
+    $child2 = Head::create($document);
+
+    $parent->appendChild($child1)
+        ->appendChild($child2);
+
+    expect($parent->delegated->childNodes->length)
+        ->toBe(2);
+    expect($parent->delegated->firstChild)
+        ->toBe($child1->delegated);
+    expect($parent->delegated->lastChild)
+        ->toBe($child2->delegated);
+});