update docs content

Author: Machometec

src/app/console/output/output.component.html

@@ -134,16 +134,22 @@ <h3>Console Color</h3>
 &lcub;
    public static function main(array $args = [])
    &lcub;
-      Console::writeLine("The foreground Colors:");
+      Console::$ForegroundColor = ConsoleColor::Black;
+      Console::$BackgroundColor = ConsoleColor::White;
+      Console::writeLine("List of the foreground Colors:");
+      Console::resetColor();
+
       foreach (ConsoleColor::cases() as $color) &lcub;
          Console::$ForegroundColor = $color;
          Console::writeLine("The foreground color &lcub;0} is &lcub;1}", $color->value, $color->name);
       }
 
-      Console::resetColor();
       Console::writeLine();
+      Console::$ForegroundColor = ConsoleColor::Black;
+      Console::$BackgroundColor = ConsoleColor::White;
+      Console::writeLine("List of the background colors:");
+      Console::resetColor();
 
-      Console::writeLine("The background Colors:");
       foreach (ConsoleColor::cases() as $color) &lcub;
          Console::$BackgroundColor = $color;
          Console::writeLine("The background color &lcub;0} is &lcub;1}", $color->value, $color->name);

src/app/console/start/start.component.html

@@ -25,9 +25,10 @@ <h4>Project Structure</h4>
 |   ├── apphost
 |   ├── run.bat
 |   └── run
+├── src/
+|   └── Program.php
 ├── vendor/
-├── devnet.proj
-└── Program.php</code></pre>
+└── devnet.proj</code></pre>
             <br>
             <h4>Entry Point</h4>
             <p>

src/app/core/asynchronous/asynchronous.component.html

@@ -91,14 +91,16 @@ <h3>Async/Await Pattern</h3>
                The async/await pattern is a feature related to the coroutine concept, where the async function can use the await operator to suspend the asynchronous operation until that operation completes and then returns a result. This enables asynchronous non-blocking functions to be structured like normal synchronous functions in the enclosing scope without blocking the main thread during the execution of the async function, which also returns a task object that represents an asynchronous operation and provides a result when the task completes successfully.
             </p>
             <pre><code class="language-php">&lt;?php
-
+           
+use DevNet\System\IO\FileAccess;
+use DevNet\System\IO\FileMode;
 use DevNet\System\IO\FileStream;
 
 use function DevNet\System\async;
 use function DevNet\System\await;
 
 $readJsonAsync = async(function($path): string &lcub;
-   $file = new FileStream($path, 'r');
+   $file = new FileStream($path, FileMode::Open, FileAccess::Read);
    // Await for the async reading to complete without blocking the outside scope.
    $json = await($file->readAsync($file->Length));
    $data = json_decode($json);
@@ -115,6 +117,8 @@ <h3>Async/Await Pattern</h3>
             </p>
             <pre><code class="language-php">&lt;?php
 
+use DevNet\System\IO\FileAccess;
+use DevNet\System\IO\FileMode;
 use DevNet\System\IO\FileStream;
 use DevNet\System\MethodTrait;
 
@@ -126,7 +130,7 @@ <h3>Async/Await Pattern</h3>
 
    public async_readJsonAsync(function($path): string
    &lcub;
-      $file = new FileStream($path, 'r');
+      $file = new FileStream($path, FileMode::Open, FileAccess::Read);
       $json = await($file->readAsync($file->Length));
       $data = json_decode($json);
 

src/app/core/extension/extension.component.html

@@ -51,7 +51,7 @@ <h3>Extension class</h3>
             <br>
             <h3>Calling the extension method</h3>
             <p class="text-justify">
-               To call an extension method as if it were an instance method on a particular extended class, the extension class must be brought into the scope of the same file where that instance calls the extension method, using the keyword <code>use</code>
+               To call an extension method as if it were an instance method on a particular extended class, the extension class must be brought into the same scope where that instance calls the extension method, using the keyword <code>use</code>
             </p>
             <pre><code class="language-php">&lt;?php
 

src/app/core/overview/overview.component.html

@@ -11,7 +11,7 @@ <h1>Overview</h1>
                DevNet Core is the heart of the DevNet framework, and all of its components rely on it. It is a base class library that provides several fundamental features that make it easier to develop applications in PHP. These features include:
             </p>
             <ul>
-               <li>Computed Properties</li>
+               <li>Accessor Properties</li>
                <li>Extension Methods</li>
                <li>LINQ Methods</li>
                <li>Generic Types</li>
@@ -22,7 +22,7 @@ <h1>Overview</h1>
             <br>
             <h3>Installation</h3>
             <p>
-               If you have installed any of the DevNet packages in your system or project, then you already have the DevNet Core. However, you can still install DevNet Core as a third-party library to work with any frameworks by running the following command in the terminal using composer:
+               If you have installed any of the DevNet packages in your system or project, then you already have the DevNet Core. However, you can still install DevNet Core as a third-party library to work with any PHP project by running the following command in the terminal using composer:
             </p>
             <pre><code class="language-shell">composer require devnet/core</code></pre>
          </article>

src/app/core/properties/properties.component.html

@@ -5,17 +5,20 @@
       </div>
       <div id="content" class="flex-grow-1" style="width: 400px;">
          <article>
-            <h1>Computed Properties</h1>
+            <h1>Accessor Properties</h1>
             <hr>
             <p>
-               A computed property is a property that doesn't store a value directly. Instead, it uses a getter and a setter method to retrieve and set other properties indirectly.
+               Accessor properties are methods that look like regular data properties from the outside but are invoked as methods internally when accessed as properties. This allows us to define custom logic for reading and writing the values of an object's properties, with more control over the property's behavior, such as how to validate or modify the input or output, unlike the data properties, which directly store a fixed value.
             </p>
-            <h3>Getter</h3>
             <p>
-               A getter is a function bound to a computed property and returns a value when that property is looked up.
+               To enable the accessor property feature, you need to include the trait <code>DevNet\System\PropertyTrait</code> in your class.
             </p>
+            <h3>Getter Accessor</h3>
             <p>
-               To use a getter for a computed property in DevNet, you need first to include the trait <code>DevNet\System\PropertyTrait</code> in your class to enable this feature, then define the computed property as a method prefixed with <code>get</code> that returns a value.
+               The getter accessor is a function bound to a computed property and returns a value when that property is looked up.
+            </p>
+            <p>
+               Here is an example that shows how to define a getter accessor property, which is a method that has a property name prefixed with <code>get_</code> accessor and return a value.
             </p>
             <pre><code class="language-php">&lt;?php
 
@@ -30,7 +33,7 @@ <h3>Getter</h3>
    public string $FirstName;
    public string $LastName;
 
-   // Defining the getter computed property.
+   // Computed property with getter accessor.
    public function get_FullName(): string
    &lcub;
       return $this->FirstName . ' ' . $this->LastName;
@@ -53,12 +56,12 @@ <h3>Getter</h3>
 print($person->FullName); // Output: John Doe
 </code></pre>
             <br>
-            <h3>Setter</h3>
+            <h3>Setter Accessor</h3>
             <p>
-               A setter is a function bound to a computed property and will be called when there is an attempt to set that property.
+               The setter accessor is a function bound to a computed property and will be called when there is an attempt to set that property.
             </p>
             <p>
-               To use a setter for a computed property, you need to include the trait <code>DevNet\System\PropertyTrait</code> in your class to enable this feature, then define the computed property as a method prefixed with <code>set</code> that has a value as a parameter.
+               The following example shows how to define a setter accessor property as a method prefixed with <code>set_</code> accessor and take a value parameter to set object.
             </p>
             <pre><code class="language-php">&lt;?php
 
@@ -73,7 +76,7 @@ <h3>Setter</h3>
    public string $FirstName;
    public string $LastName;
 
-   // Defining the setter computed property.
+   // Computed property with setter accessor.
    public function set_FullName(string $value): void
    &lcub;
       $segments = explode(' ', $value, 2);
@@ -83,7 +86,7 @@ <h3>Setter</h3>
 }
 </code></pre>
             <p>
-               And here how to set he computed property:
+               And here how to set the computed property:
             </p>
             <pre><code class="language-php">&lt;?php
 

src/app/entity/migrations/migrations.component.html

@@ -26,10 +26,10 @@ <h3>Creating a migration</h3>
 
 namespace Application\Migrations;
 
-use DevNet\Entity\Migration\AbstractMigration;
-use DevNet\Entity\Migration\MigrationBuilder;
+use DevNet\Entity\Migrations\Migration;
+use DevNet\Entity\Migrations\MigrationBuilder;
 
-class InitialMigration extends AbstractMigration
+class InitialMigration extends Migration
 &lcub;  
    /**
    * Schema definitions will be executed when the migration is upgraded.
@@ -64,10 +64,10 @@ <h4>Creating the database Schema</h4>
 
 namespace Application\Migrations;
 
-use DevNet\Entity\Migration\AbstractMigration;
-use DevNet\Entity\Migration\MigrationBuilder;
+use DevNet\Entity\Migrations\Migration;
+use DevNet\Entity\Migrations\MigrationBuilder;
 
-class InitialMigration extends AbstractMigration
+class InitialMigration extends Migration
 &lcub;
    public function up(MigrationBuilder $builder): void
    &lcub;
@@ -98,7 +98,7 @@ <h4>Creating the database Schema</h4>
    public function down(MigrationBuilder $builder): void
    &lcub;
       // if the constraint ON DELETE is configured as "strict" and which is the default configuration,
-      // the child table must be droped before the parent table, otherwise will throw an error.
+      // the child table must be dropped before the parent table, otherwise will throw an error.
       $builder->dropTable('UserRole');
       $builder->dropTable('User');
       $builder->dropTable('Role');
@@ -114,10 +114,10 @@ <h4>Updating the database schema</h4>
 
 namespace Application\Migrations;
 
-use DevNet\Entity\Migration\AbstractMigration;
-use DevNet\Entity\Migration\MigrationBuilder;
+use DevNet\Entity\Migrations\Migration;
+use DevNet\Entity\Migrations\MigrationBuilder;
 
-class AlterMigration extends AbstractMigration
+class AlterMigration extends Migration
 &lcub;
    public function up(MigrationBuilder $builder): void
    &lcub;
@@ -161,10 +161,10 @@ <h4>Seeding the database</h4>
 
 namespace Application\Migrations;
 
-use DevNet\Entity\Migration\AbstractMigration;
-use DevNet\Entity\Migration\MigrationBuilder;
+use DevNet\Entity\Migrations\Migration;
+use DevNet\Entity\Migrations\MigrationBuilder;
 
-class SeedMigration extends AbstractMigration
+class SeedMigration extends Migration
 &lcub;
    public function up(MigrationBuilder $builder): void
    &lcub;
@@ -197,6 +197,9 @@ <h3>Applying migrations</h3>
                And here is an example shows how to run the migrate command targeting the migration that we created earlier:
             </p>
             <pre><code class="language-shell">devnet migrate --target 20230701082859_InitialMigration</code></pre>
+            <blockquote class="alert alert-warning">
+               <b>Important:</b> Make sure to specify the database configuration in the <samp><b>settings.json</b></samp> before running the <code>migrate</code> command or pass it to the command as parameters using the options: <code>--provider</code> and <code>--connection</code>.
+            </blockquote>
             <br>
             <h4>Applying all migrations</h4>
             <p>

src/app/entity/start/start.component.html

@@ -138,12 +138,12 @@ <h3>Connecting to the Database</h3>
             <pre><code class="language-php">&lt;?php
 
 use Application\Models\BlogContext;
-use DevNet\Entity\MySql\MySqlDataProvider;
 use DevNet\Entity\EntityOptions;
+use DevNet\Entity\MySql\MySqlDataProvider;
 
 $options = new EntityOptions();
 $options->ProviderType = MySqlDataProvider::class;
-$options->ConnectionString = "//user:[email protected]/blog";
+$options->ConnectionString = "//username:[email protected]/blog";
 
 $blog = new BlogContext($options);
 $posts = $blog->Posts;
@@ -187,29 +187,29 @@ <h4>Connection String</h4>
             <br>
             <h3>Registering the EntityContext</h3>
             <p>
-               You can register Entity ORM as a reused service that will be injected into your application using the Extension method <code>ServiceCollectionExtensions::addEntityContext()</code> inside the method <code>WebHostBuilder::register()</code>, as shown in the following code example:
+               It is recommended that you register the Entity ORM as a reusable service to be injected into your application using the <code>ServiceCollectionExtensions::addEntityContext()</code> Extension method, which is called within the <code>WebHostBuilder::register()</code> method, with the use of the configuration provider that gets the database configuration from the <samp>"settings.json"</samp> file as shown in the following code example:
             </p>
             <pre><code class="language-php">&lt;?php
 
 namespace Application;
 
+use Application\Models\BlogContext;
 use DevNet\Web\Hosting\WebHost;
 use DevNet\Web\Extensions\ApplicationBuilderExtensions;
 use DevNet\Web\Extensions\ServiceCollectionExtensions;
-use DevNet\Entity\MySql\MySqlDataProvider;
-use Application\Models\BlogContext;
 
 class Program
 &lcub;
    public static function main(array $args = [])
    &lcub;
       $builder = WebHost::createDefaultBuilder($args);
-      $builder->register(function ($services) &lcub;
+      $configuration = $builder->Configuration;
+      $builder->register(function ($services) use ($configuration) &lcub; //;
          // adding EntityContext
          $services->addEntityContext(BlogContext::class,
             function ($options) &lcub;
-               $options->ProviderType = MySqlDataProvider::class;
-               $options->ConnectionString = "//user:[email protected]/blog";
+               $options->ProviderType = $configuration->getValue('Database:ProviderType');
+               $options->ConnectionString = $configuration->getValue('Database:ConnectionString');
             }
          );
       });
@@ -218,18 +218,26 @@ <h3>Registering the EntityContext</h3>
 }
 </code></pre>
             <p>
-               You can then get the EntityContext using the constructor injection to add the EntityContext to the controller class and use it in the controller methods like the following example:
+               In the <samp>"settings.json"</samp> file, you need to set the database configuration, like in the following example:
+            </p>
+            <pre><code class="language-json">"Database": &lcub;
+   "ProviderType": "DevNet\\Entity\\MySql\\MySqlDataProvider",
+   "ConnectionString": "//username:[email protected]/blog"
+}
+</code></pre>
+            <p>
+               Then, you can get the <code>EntityContext</code> using the controller constructor injection, like this:
             </p>
             <pre><code class="language-php">&lt;?php
 
 namespace Application\Controllers;
 
-use DevNet\Web\Endpoint\ActionController;
+use DevNet\Web\Endpoint\Controller;
 use DevNet\Web\Endpoint\IActionResult;
 use DevNet\Web\Endpoint\Route;
 use Application\Models\BlogContext;
 
-class BlogController extends ActionController
+class BlogController extends Controller
 &lcub;
    private BlogContext $blog;
 
@@ -238,7 +246,7 @@ <h3>Registering the EntityContext</h3>
       $this->blog = $blog;
    }
 
-   #[Route("/")]
+   #[Route("/blog")]
    public function index(): IActionResult
    &lcub;
       $this->view(['posts' => $this->blog->Posts]);

src/app/home/home.component.html

@@ -1,14 +1,12 @@
-<div class="container">
-   <div class="d-flex flex-column justify-content-center text-center" style="height: 75vh">
-      <h1 class="display-3 mx-auto">DevNet Framework</h1>
-      <p class="lead w-75 mx-auto">
-         A free open-source software, and cross-platform, inspired by ASP.NET Core, built in PHP for rapid
-         application development, APIs, console and modern web application with high performance.
-      </p>
-      <div class="d-grid gap-2 d-md-flex justify-content-center">
-         <a class="btn btn-danger px-4 me-md-2" routerLink="/docs">Documentation</a>
-         <a class="btn btn-outline-secondary px-4" href="https://github.com/DevNet-Framework">View on
-            GitHub</a>
-      </div>
+<div class="d-flex flex-column justify-content-center text-center py-4 my-5">
+   <h1 class="display-3 mx-auto">DevNet Framework</h1>
+   <p class="lead w-75 mx-auto">
+      A free open-source software, and cross-platform, inspired by ASP.NET Core, built in PHP for rapid
+      application development, APIs, console and modern web application with high performance.
+   </p>
+   <div class="d-grid gap-2 d-md-flex justify-content-center">
+      <a class="btn btn-danger px-4 me-md-2" routerLink="/docs">Documentation</a>
+      <a class="btn btn-outline-secondary px-4" href="https://github.com/DevNet-Framework">View on
+         GitHub</a>
    </div>
 </div>

src/app/security/antiforgery/antiforgery.component.html

@@ -87,14 +87,14 @@ <h3>X-CSRF-TOKEN</h3>
 namespace Application\Controllers;
 
 use DevNet\System\Linq;
+use DevNet\Web\Endpoint\Controller;
 use DevNet\Web\Endpoint\IActionResult;
-use DevNet\Web\Endpoint\ActionController;
 use DevNet\Web\Endpoint\Route;
 use DevNet\Web\Security\Authorization\Authorize;
 use DevNet\Web\Security\Tokens\Csrf\Validate;
 
 #[Authorize]
-class AccountController extends ActionController
+class AccountController extends Controller
 &lcub;
    #[Route(path: '/account/edit/&lcub;id}', method: 'GET')]
    public function edit(int $id): IActionResult