@salla.sa/twilight 2.14.144 → 2.14.146

package/README.md

@@ -1,4 +1,3 @@
-
 <div id="top"></div>
 
 <br />
@@ -49,7 +48,29 @@
 
 ## Overview
 
-**Twilight** comes with a **JavaScript SDK** for the Salla storefront APIs. This is to provide the developers with helper methods, or REST API endpoints, that allow communication between the frontend and backend. As a result, developers may use these methods to make merchants' stores dynamic after using the API features and data. In this documentation, we will be referring to it as **Twilight JS SDK** for short.
+The Twilight JS SDK (`@salla.sa/twilight`) is the core package of the Twilight Framework, providing a comprehensive JavaScript interface for Salla's storefront APIs. It enables theme developers to easily communicate with Salla's backend services, handle events, manage state, and build interactive e-commerce experiences.
+
+### Architecture
+
+The Twilight Framework consists of several packages working together:
+
+1. **@salla.sa/base**: Foundation layer with core utilities and services
+2. **@salla.sa/twilight** (this package): Main SDK for Salla themes
+3. **@salla.sa/twilight-components**: Web components for Salla themes
+4. **@salla.sa/twilight-tailwind-theme**: Tailwind CSS theme for Salla themes
+5. **@salla.sa/applepay**: Apple Pay integration for Salla
+
+This modular architecture allows for better separation of concerns, more maintainable code, and the ability to use only the parts of the framework that are needed for a specific application.
+
+### Key Features
+
+- **API Integration**: Pre-built methods for all Salla API endpoints
+- **Event System**: Powerful event handling for real-time updates
+- **Authentication**: Seamless user authentication and session management
+- **Cart Management**: Complete shopping cart functionality
+- **Multilingual Support**: Built-in localization capabilities
+- **Version Management**: Easy access to package versions via `Salla.versions`
+- **Optimized Bundle**: Tree-shakable modules for minimal production builds
 
 ## Getting Started
 **SDK** stands for "software development kit," and it refers to a library for interacting with a specific REST API using JavaScript. 
@@ -215,6 +236,20 @@ Furthermore, if the required value is nested inside an inner value, such as a cu
 salla.config.get('currencies.SAR.code’)
 ```
 
+#### Accessing Version Information
+
+The Twilight Framework provides easy access to version information for all packages through the `Salla.versions` object:
+
+```js
+// Get the version of the core package
+console.log(Salla.versions.twilight); // e.g., "v2.14.145"
+
+// Get the version of the base package
+console.log(Salla.versions.base); // e.g., "v2.14.143"
+```
+
+This is particularly useful for debugging, support, and ensuring compatibility between different parts of the framework.
+
 <p align="right">(<a href="#top">back to top</a>)</p>
 
 ## Support
@@ -251,4 +286,3 @@ You can also simply open an issue with the tag "enhancement". Don't forget to gi
 The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
 
 <p align="right">(<a href="#top">back to top</a>)</p>
-