Add os info component

Author: SerafimArts

Writerside/boson.tree

@@ -50,6 +50,9 @@
         </toc-element>
         <toc-element topic="events.md" />
     </toc-element>
+    <toc-element topic="components.md">
+        <toc-element topic="os-info.md" />
+    </toc-element>
     <toc-element toc-title="Integrations">
         <toc-element topic="static-files.md" />
         <toc-element topic="symfony-adapter.md"

Writerside/topics/components.md

@@ -0,0 +1,14 @@
+# Components
+
+<show-structure for="chapter" depth="2"/>
+
+Boson's architecture is built on a collection of versatile components that can 
+be used independently of the main framework. These components are designed to 
+be flexible and adaptable, allowing developers to integrate them into any web 
+project or framework of their choice. 
+
+Whether you're building with Boson or working on a standalone website, these 
+components provide powerful functionality without imposing any architectural 
+constraints or technical limitations. This modular approach ensures that you 
+can use exactly what you need, when you need it, while maintaining complete 
+freedom in how you structure and implement your application.

Writerside/topics/components/os-info.md

@@ -0,0 +1,116 @@
+# Operating System Info
+
+<show-structure for="chapter" depth="2"/>
+
+The OS Info component provides a robust and flexible way to detect and work with
+operating system information in your applications. It offers a comprehensive 
+set of features for identifying operating systems, their families, and 
+supported standards.
+
+## Installation
+
+<tldr>
+    <p>
+        Via <a href="https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies">Composer</a>:
+    </p>
+    <p>
+        <code lang="bash">composer require boson-php/os-info</code>
+    </p>
+</tldr>
+
+**Requirements:**
+
+* `PHP ^8.4`
+* `ext-ffi` (optional, provides more detailed and accurate information about the OS)
+* `ext-com_dotnet` (optional, provides more detailed and accurate information about the OS)
+
+## Usage
+
+### Basic Detection
+
+```php
+use Boson\Component\OsInfo\OperatingSystem;
+
+// Get current operating system information
+$os = OperatingSystem::createFromGlobals();
+
+// Access basic information
+echo 'Family: ' . $os->family . "\n";
+echo 'Name: ' . $os->name . "\n";
+echo 'Version: ' . $os->version . "\n";
+echo 'Codename: ' . ($os->codename ?? '~') . "\n";
+echo 'Edition: ' . ($os->edition ?? '~') . "\n";
+echo 'Standards: ' . implode(', ', $os->standards) . "\n";
+```
+
+This code will output something like the following information
+
+<tabs>
+    <tab title="Windows">
+        <code-block>
+        Family: Windows
+        Name: Windows 10 Pro
+        Version: 10.0.19045
+        Codename: 22H2
+        Edition: Professional
+        Standards: ~ 
+        </code-block>
+    </tab>
+    <tab title="Linux">
+        <code-block>
+        Family: Linux
+        Name: Ubuntu
+        Version: 20.04.6
+        Codename: Focal Fossa
+        Edition: ~
+        Standards: POSIX
+        </code-block>
+    </tab>
+</tabs>
+
+### OS Families
+
+You can get the OS family information from the OS information 
+object (`$os->family`). However, if you do not need all the OS information, 
+it is enough to get the family separately using the `Family::createFromGlobals()`
+method.
+
+```php
+use Boson\Component\OsInfo\Family;
+
+// Get current OS family
+$family = Family::createFromGlobals();
+
+// Check for specific family
+if ($family->is(Family::Windows)) {
+    // Windows-specific (or windows-like) code
+}
+```
+
+Please note that the `$family->is()` check includes the check of the family 
+itself and its parents.
+
+```php
+if ($family->is(Family::Unix)) {
+    // All operating systems from the Unix family 
+    // will be subject to this check:
+    // - Darwin (macOS)
+    // - Linux
+    // - BSD
+    // - ...and other Unix-like
+}
+```
+
+### Standards Support
+
+```php
+use Boson\Component\OsInfo\OperatingSystem;
+use Boson\Component\OsInfo\Standard;
+
+$os = OperatingSystem::createFromGlobals();
+
+// Check if OS supports a specific standard
+if ($os->isSupports(Standard::Posix)) {
+    // Standard is supported
+}
+```