Better namespaces. (#328)

php-forge · Feb 21, 2024 · 5f1bf2f · 5f1bf2f
1 parent 6da944f
commit 5f1bf2f
Show file tree

Hide file tree

Showing 38 changed files with 87 additions and 82 deletions.
diff --git a/docs/README.md b/docs/README.md
@@ -27,12 +27,19 @@ The repository can generate basic `HTML` tags, allowing you to create `HTML` ele
 - [a](/docs/tag/A.md)
 - [button](/docs/tag/Button.md)
 - [button toggle](/docs/tag/ButtonToggle.md)
-- [h](/docs/tag/H.md)
 - [i](/docs/tag/I.md)
 - [img](/docs/tag/Img.md)
 - [span](/docs/tag/Span.md)
 - [svg](/docs/tag/Svg.md)
 
+## Document
+
+The `Document` section of a web page contains elements that are used to define the structure and content of the page.
+
+- [body](/docs/document/Body.md)
+- [head](/docs/document/Head.md)
+- [html](/docs/document/Html.md)
+
 ## Form control
 
 Provide a comprehensive set of `form` elements and components for building user-friendly and accessible web forms.
@@ -83,6 +90,7 @@ way.
 
 - [div](/docs/group/Div.md)
 - [li](/docs/group/Li.md)
+- [main](/docs/group/Main.md)
 - [ol](/docs/group/Ol.md)
 - [p](/docs/group/P.md)
 - [ul](/docs/group/Ul.md)
@@ -94,19 +102,13 @@ The `Metadata` section of a web page contains information about the page, such a
 - [meta](/docs/metadata/Meta.md)
 - [title](/docs/metadata/Title.md)
 
-## Layout
+## Semantic 
 
-In web design, the `Layout` section typically refers to a collection of files or components that define the overall
-structure and arrangement of a web page. This includes elements such as headers, footers, navigation bars, sidebars, and
-other structural components that help organize and present content on the page. The `Layout` section is essential for
-creating consistent and visually appealing designs across the entire website, as it establishes the framework
-within which individual pages are constructed.
+ A `semantic` tag is an element that clearly describes its meaning to both the browser and the developer. These tags
+ make it easier for search engines and browsers to understand the structure and content of web pages.
 
-- [body](/docs/layout/Body.md)
-- [footer](/docs/layout/Footer.md)
-- [head](/docs/layout/Head.md)
-- [header](/docs/layout/Header.md)
-- [html](/docs/layout/Html.md)
-- [main](/docs/group/Main.md)
-- [nav](/docs/layout/Nav.md)
-- [section](/docs/layout/Section.md)
+- [footer](/docs/semantic/Footer.md)
+- [h](/docs/semantic/H.md)
+- [header](/docs/semantic/Header.md)
+- [nav](/docs/semantic/Nav.md)
+- [section](/docs/semantic/Section.md)
diff --git a/docs/layout/Body.md → docs/document/Body.md b/docs/layout/Body.md → docs/document/Body.md
@@ -87,7 +87,7 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Body/AttributeTest.php) for
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Document/Body/AttributeTest.php) for
 comprehensive examples.
 
 The following methods are available for setting attributes:
@@ -106,7 +106,7 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Body/CustomMethodTest.php)
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Document/Body/CustomMethodTest.php)
 for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:

diff --git a/docs/layout/Head.md → docs/document/Head.md b/docs/layout/Head.md → docs/document/Head.md
@@ -86,7 +86,7 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Head/AttributeTest.php) for
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Document/Head/AttributeTest.php) for
 comprehensive examples.
 
 The following methods are available for setting attributes:
@@ -105,7 +105,7 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Head/CustomMethodTest.php)
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Document/Head/CustomMethodTest.php)
 for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:

diff --git a/docs/layout/Html.md → docs/document/Html.md b/docs/layout/Html.md → docs/document/Html.md
@@ -86,7 +86,7 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Html/AttributeTest.php) for
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Document/Html/AttributeTest.php) for
 comprehensive examples.
 
 The following methods are available for setting attributes:
@@ -105,7 +105,7 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Html/CustomMethodTest.php)
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Document/Html/CustomMethodTest.php)
 for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:

diff --git a/docs/layout/Main.md → docs/group/Main.md b/docs/layout/Main.md → docs/group/Main.md
@@ -87,7 +87,7 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Main/AttributeTest.php) for
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Group/Main/AttributeTest.php) for
 comprehensive examples.
 
 The following methods are available for setting attributes:
@@ -106,7 +106,7 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Main/CustomMethodTest.php)
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Group/Main/CustomMethodTest.php)
 for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:

diff --git a/docs/layout/Footer.md → docs/semantic/Footer.md b/docs/layout/Footer.md → docs/semantic/Footer.md
@@ -87,7 +87,7 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Footer/AttributeTest.php) for
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/Footer/AttributeTest.php) for
 comprehensive examples.
 
 The following methods are available for setting attributes:
@@ -106,7 +106,7 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Footer/CustomMethodTest.php)
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/Footer/CustomMethodTest.php)
 for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:

diff --git a/docs/tag/H.md → docs/semantic/H.md b/docs/tag/H.md → docs/semantic/H.md
@@ -90,8 +90,8 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/H/AttributeTest.php) for comprehensive
-examples.
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/H/AttributeTest.php) for
+comprehensive examples.
 
 The following methods are available for setting attributes:
 
@@ -109,8 +109,8 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/H/CustomMethodTest.php) for
-comprehensive examples.
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/H/CustomMethodTest.php)
+for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:
 

diff --git a/docs/layout/Header.md → docs/semantic/Header.md b/docs/layout/Header.md → docs/semantic/Header.md
@@ -87,7 +87,7 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Header/AttributeTest.php) for
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/Header/AttributeTest.php) for
 comprehensive examples.
 
 The following methods are available for setting attributes:
@@ -106,7 +106,7 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Header/CustomMethodTest.php)
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/Header/CustomMethodTest.php)
 for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:

diff --git a/docs/layout/Nav.md → docs/semantic/Nav.md b/docs/layout/Nav.md → docs/semantic/Nav.md
@@ -87,7 +87,7 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Nav/AttributeTest.php) for
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/Nav/AttributeTest.php) for
 comprehensive examples.
 
 The following methods are available for setting attributes:
@@ -106,7 +106,7 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Nav/CustomMethodTest.php)
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/Nav/CustomMethodTest.php)
 for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:

diff --git a/docs/layout/Section.md → docs/semantic/Section.md b/docs/layout/Section.md → docs/semantic/Section.md
@@ -86,7 +86,7 @@ Explore additional methods for setting various attributes such as `lang`, `name`
 
 ## Attributes
 
-Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Section/AttributeTest.php) for
+Refer to the [Attribute Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/Section/AttributeTest.php) for
 comprehensive examples.
 
 The following methods are available for setting attributes:
@@ -105,7 +105,7 @@ The following methods are available for setting attributes:
 
 ## Custom methods
 
-Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Layout/Section/CustomMethodTest.php)
+Refer to the [Custom Methods Tests](https://github.com/php-forge/html/blob/main/tests/Semantic/Section/CustomMethodTest.php)
 for comprehensive examples.
 
 The following methods are available for customizing the `HTML` output:

diff --git a/src/Layout/Body.php → src/Document/Body.php b/src/Layout/Body.php → src/Document/Body.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Layout;
+namespace PHPForge\Html\Document;
 
 use PHPForge\Html\Base\AbstractBlockElement;
 

diff --git a/src/Layout/Head.php → src/Document/Head.php b/src/Layout/Head.php → src/Document/Head.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Layout;
+namespace PHPForge\Html\Document;
 
 use PHPForge\Html\Base\AbstractBlockElement;
 

diff --git a/src/Layout/Html.php → src/Document/Html.php b/src/Layout/Html.php → src/Document/Html.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Layout;
+namespace PHPForge\Html\Document;
 
 use PHPForge\Html\Base\AbstractBlockElement;
 

diff --git a/src/Layout/Main.php → src/Group/Main.php b/src/Layout/Main.php → src/Group/Main.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Layout;
+namespace PHPForge\Html\Group;
 
 use PHPForge\Html\Base\AbstractBlockElement;
 

diff --git a/src/Layout/Footer.php → src/Semantic/Footer.php b/src/Layout/Footer.php → src/Semantic/Footer.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Layout;
+namespace PHPForge\Html\Semantic;
 
 use PHPForge\Html\Base\AbstractBlockElement;
 

diff --git a/src/H.php → src/Semantic/H.php b/src/H.php → src/Semantic/H.php
@@ -2,7 +2,10 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html;
+namespace PHPForge\Html\Semantic;
+
+use PHPForge\Html\Attribute;
+use PHPForge\Html\Base;
 
 /**
  * The `<h1>` to `<h6>` HTML elements represent six levels of section headings.

diff --git a/src/Layout/Header.php → src/Semantic/Header.php b/src/Layout/Header.php → src/Semantic/Header.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Layout;
+namespace PHPForge\Html\Semantic;
 
 use PHPForge\Html\Base\AbstractBlockElement;
 

diff --git a/src/Layout/Nav.php → src/Semantic/Nav.php b/src/Layout/Nav.php → src/Semantic/Nav.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Layout;
+namespace PHPForge\Html\Semantic;
 
 use PHPForge\Html\Base\AbstractBlockElement;
 

diff --git a/src/Layout/Section.php → src/Semantic/Section.php b/src/Layout/Section.php → src/Semantic/Section.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Layout;
+namespace PHPForge\Html\Semantic;
 
 use PHPForge\Html\Base\AbstractBlockElement;
 

diff --git a/tests/Layout/Body/AttributeTest.php → tests/Document/Body/AttributeTest.php b/tests/Layout/Body/AttributeTest.php → tests/Document/Body/AttributeTest.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Tests\Layout\Body;
+namespace PHPForge\Html\Tests\Document\Body;
 
-use PHPForge\Html\Layout\Body;
+use PHPForge\Html\Document\Body;
 use PHPForge\Support\Assert;
 use PHPUnit\Framework\TestCase;
 

diff --git a/tests/Layout/Body/CustomMethodTest.php → tests/Document/Body/CustomMethodTest.php b/tests/Layout/Body/CustomMethodTest.php → tests/Document/Body/CustomMethodTest.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Tests\Layout\Body;
+namespace PHPForge\Html\Tests\Document\Body;
 
-use PHPForge\Html\Layout\Body;
+use PHPForge\Html\Document\Body;
 use PHPForge\Support\Assert;
 use PHPUnit\Framework\TestCase;
 

diff --git a/tests/Layout/Head/AttributeTest.php → tests/Document/Head/AttributeTest.php b/tests/Layout/Head/AttributeTest.php → tests/Document/Head/AttributeTest.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Tests\Layout\Head;
+namespace PHPForge\Html\Tests\Document\Head;
 
-use PHPForge\Html\Layout\Head;
+use PHPForge\Html\Document\Head;
 use PHPForge\Support\Assert;
 use PHPUnit\Framework\TestCase;
 

diff --git a/tests/Layout/Head/CustomMethodTest.php → tests/Document/Head/CustomMethodTest.php b/tests/Layout/Head/CustomMethodTest.php → tests/Document/Head/CustomMethodTest.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Tests\Layout\Head;
+namespace PHPForge\Html\Tests\Document\Head;
 
-use PHPForge\Html\Layout\Head;
+use PHPForge\Html\Document\Head;
 use PHPForge\Support\Assert;
 use PHPUnit\Framework\TestCase;
 

diff --git a/tests/Layout/Html/AttributeTest.php → tests/Document/Html/AttributeTest.php b/tests/Layout/Html/AttributeTest.php → tests/Document/Html/AttributeTest.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Tests\Layout\Html;
+namespace PHPForge\Html\Tests\Document\Html;
 
-use PHPForge\Html\Layout\Html;
+use PHPForge\Html\Document\Html;
 use PHPForge\Support\Assert;
 use PHPUnit\Framework\TestCase;
 

diff --git a/tests/Layout/Html/CustomMethodTest.php → tests/Document/Html/CustomMethodTest.php b/tests/Layout/Html/CustomMethodTest.php → tests/Document/Html/CustomMethodTest.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Tests\Layout\Html;
+namespace PHPForge\Html\Tests\Document\Html;
 
-use PHPForge\Html\Layout\Html;
+use PHPForge\Html\Document\Html;
 use PHPForge\Support\Assert;
 use PHPUnit\Framework\TestCase;
 

diff --git a/tests/Layout/Main/AttributeTest.php → tests/Group/Main/AttributeTest.php b/tests/Layout/Main/AttributeTest.php → tests/Group/Main/AttributeTest.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Html\Tests\Layout\Main;
+namespace PHPForge\Html\Tests\Group\Main;
 
-use PHPForge\Html\Layout\Main;
+use PHPForge\Html\Group\Main;
 use PHPForge\Support\Assert;
 use PHPUnit\Framework\TestCase;