dars-framework 1.9.1__tar.gz → 1.9.3__tar.gz

{dars_framework-1.9.1/dars_framework.egg-info → dars_framework-1.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dars-framework
-Version: 1.9.1
+Version: 1.9.3
 Summary: Dars is a Full-Stack multiplatform Python UI framework for building modern, interactive web and desktop apps with Python code. Seamlessly integrated with FastAPI, it allows you to build complete applications with Server-Side Rendering (SSR) and reactive SPA capabilities also classic multipage html and desktop apps in a single codebase.
 Author-email: ztamdev <ztadevs@gmail.com>
 Maintainer-email: ztamdev <ztadevs@gmail.com>
@@ -483,6 +483,7 @@ For complete documentation, see the [Backend API Guide](https://ztamdev.github.i
 | `dars info my_app.py`                    | Show info about your app                      |
 | `dars formats`                           | List supported export formats                 |
 | `dars dev`                               | Run the configured entry file with hot preview (app.rTimeCompile) |
+| `dars dev --port 9000`                   | Run dev server on a custom port (overrides config) |
 | `dars dev --backend`                     | Run only the configured backendEntry (FastAPI/SSR backend) |
 | `dars --help`                            | Show help and all CLI options                 |
 
@@ -516,7 +517,7 @@ Then run your file directly:
 python my_app.py
 ```
 
-This will start a local server at http://localhost:8000 so you can view your app in the browser—no manual export needed. You can change the port with:
+This will start a local server at the port specified in your `dars.config.json` (defaults to http://localhost:8000) so you can view your app in the browser—no manual export needed. You can override the port with:
 
 ```bash
 python my_app.py --port 8088
@@ -554,6 +555,7 @@ Example default:
   "utility_styles": {},
   "markdownHighlight": true,
   "markdownHighlightTheme": "auto",
+  "port": 8000,
   "backendEntry": "backend.api:app"
 }
 ```
@@ -569,6 +571,7 @@ Example default:
 - `utility_styles`: Dictionary defining custom utility classes. Keys are class names, values are lists of utility strings or raw CSS properties.
 - `markdownHighlight`: Auto-inject a client-side syntax highlighter for fenced code blocks in Markdown. Default `true`.
  - `backendEntry`: Python import path for your SSR/backend app (e.g. `"backend.api:app"`). Required when your app uses `RouteType.SSR` routes. Used by `dars dev --backend`.
+- `port`: The port for the development preview server. Default `8000`.
 
 Validate your config:
 

{dars_framework-1.9.1 → dars_framework-1.9.3}/README.md

@@ -442,6 +442,7 @@ For complete documentation, see the [Backend API Guide](https://ztamdev.github.i
 | `dars info my_app.py`                    | Show info about your app                      |
 | `dars formats`                           | List supported export formats                 |
 | `dars dev`                               | Run the configured entry file with hot preview (app.rTimeCompile) |
+| `dars dev --port 9000`                   | Run dev server on a custom port (overrides config) |
 | `dars dev --backend`                     | Run only the configured backendEntry (FastAPI/SSR backend) |
 | `dars --help`                            | Show help and all CLI options                 |
 
@@ -475,7 +476,7 @@ Then run your file directly:
 python my_app.py
 ```
 
-This will start a local server at http://localhost:8000 so you can view your app in the browser—no manual export needed. You can change the port with:
+This will start a local server at the port specified in your `dars.config.json` (defaults to http://localhost:8000) so you can view your app in the browser—no manual export needed. You can override the port with:
 
 ```bash
 python my_app.py --port 8088
@@ -513,6 +514,7 @@ Example default:
   "utility_styles": {},
   "markdownHighlight": true,
   "markdownHighlightTheme": "auto",
+  "port": 8000,
   "backendEntry": "backend.api:app"
 }
 ```
@@ -528,6 +530,7 @@ Example default:
 - `utility_styles`: Dictionary defining custom utility classes. Keys are class names, values are lists of utility strings or raw CSS properties.
 - `markdownHighlight`: Auto-inject a client-side syntax highlighter for fenced code blocks in Markdown. Default `true`.
  - `backendEntry`: Python import path for your SSR/backend app (e.g. `"backend.api:app"`). Required when your app uses `RouteType.SSR` routes. Used by `dars dev --backend`.
+- `port`: The port for the development preview server. Default `8000`.
 
 Validate your config:
 

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/cli/main.py

@@ -1206,6 +1206,7 @@ def create_parser(include_hidden: bool = True) -> argparse.ArgumentParser:
     # Dev command (run entry in dev mode)
     dev_parser = subparsers.add_parser('dev', help='Run the configured entry file in development mode')
     dev_parser.add_argument('--project', '-p', default='.', help='Project root where dars.config.json resides (default: .)')
+    dev_parser.add_argument('--port', '-P', type=int, help='Port to run the dev server on (overrides config)')
     dev_parser.add_argument('--backend', action='store_true', help='Run only the configured backendEntry (SSR/API) instead of the frontend entry')
     # English-only: no language option on subparsers
     
@@ -2296,7 +2297,16 @@ def main():
         # Backend/SSR server can be started in a separate terminal with `dars dev --backend` if needed.
         process = None
         try:
-            process = subprocess.Popen([sys.executable, entry], cwd=os.path.dirname(entry))
+            cmd = [sys.executable, entry]
+            # Prioritize CLI arg, then config, then fallback to 8000
+            port_to_pass = getattr(args, 'port', None)
+            if port_to_pass is None and found and "port" in cfg:
+                port_to_pass = cfg["port"]
+            
+            if port_to_pass:
+                cmd.extend(['--port', str(port_to_pass)])
+            
+            process = subprocess.Popen(cmd, cwd=os.path.dirname(entry))
             process.wait()
             sys.exit(process.returncode or 0)
         except KeyboardInterrupt:

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/accordion.py

@@ -9,8 +9,8 @@ class Accordion(Component):
     - **sections** (list): List of tuples containing `(title, content)`.
     - **open_indices** (list): Optional list of indices that should be open by default.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"divide-y divide-slate-200 border rounded-xl overflow-hidden"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/card.py

@@ -9,8 +9,8 @@ class Card(Component):
     - **children** (list): List of child components to render inside the card.
     - **title** (str): Optional title displayed at the top of the card.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"p-6 bg-white rounded-2xl shadow-xl hover:shadow-2xl transition-shadow"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     
     Example:

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/file_upload.py

@@ -15,8 +15,8 @@ class FileUpload(Component):
     - **max_size** (int): Maximum file size allowed in bytes.
     - **label** (str): Text label for the upload button (defaults to "Choose File").
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"bg-slate-100 border-2 border-dashed p-8 text-center rounded-xl"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change` (triggered when files are selected).
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/head.py

@@ -28,8 +28,8 @@ class Head(Component):
     - **links** (list): List of dictionaries for custom `<link>` tags.
     - **structured_data** (dict): JSON-LD dictionary for structured data.
     - **id** (str): Unique identifier for the component (not rendered).
-    - **class_name** (str): CSS utility classes (not rendered).
-    - **style** (dict): Optional dictionary for direct inline styles (not rendered).
+    - **class_name** (str): String containing regular CSS class names (not rendered).
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`) (not rendered).
     - **children** (list): List of child components (not rendered).
     - **Events**: Handlers (not typical for Head).
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/modal.py

@@ -10,8 +10,8 @@ class Modal(Component):
     - **title** (str): Optional title displayed in the modal header.
     - **is_open** (bool): Whether the modal is currently visible (defaults to False).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes for the modal overlay.
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names for the modal overlay.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **Events**: Handlers like `on_click` (can be used to close the modal by clicking the backdrop).
     
     Example:

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/navbar.py

@@ -9,8 +9,8 @@ class Navbar(Component):
     - ***children** (Component): Positional arguments for navigation links or other components.
     - **brand** (str): Text or logo component for the site branding area.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"bg-white/80 backdrop-blur-md sticky top-0 z-50 border-b border-slate-100"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/outlet.py

@@ -10,8 +10,8 @@ class Outlet(Container):
     - **placeholder** (Component): Component to display while the route content is being loaded.
     - ***children** (Component): Initial content for the outlet if no route is matched.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"flex-1 p-6 bg-slate-50 min-h-screen overflow-y-auto"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **Events**: Handlers for navigation and lifecycle events.
     
     Example:

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/table.py

@@ -10,8 +10,8 @@ class Table(Component):
     - **data** (list): List of row dictionaries where keys match the `field` defined in `columns`.
     - **page_size** (int): Number of rows to display per page (optional).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"w-full text-left border-collapse border border-slate-200"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers for sorting, filtering, and row clicks.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/advanced/tabs.py

@@ -10,8 +10,8 @@ class Tabs(Component):
     - **panels** (list): List of components or strings representing the content of each tab.
     - **selected** (int): Index of the initially active tab (defaults to 0).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"flex flex-col w-full"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change` when the active tab is switched.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/audio.py

@@ -15,8 +15,8 @@ class Audio(Component):
     - **muted** (bool): If True, the audio will be muted by default.
     - **preload** (str): Strategy for preloading ('auto', 'metadata', 'none').
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes.
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_play`, `on_pause`, `on_ended`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/button.py

@@ -13,8 +13,8 @@ class Button(Component):
     - **disabled** (bool): Whether the button is interactive or not.
     - **button_type** (str): HTML type of the button ('button', 'submit', 'reset').
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"bg-blue-500 hover:bg-blue-600 text-white font-bold py-2 px-4 rounded"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components to render inside the button.
     - **Events**: Handlers like `on_click`, `on_double_click`, `on_mouse_enter`, `on_mouse_leave`, `on_mouse_down`, `on_mouse_up`, `on_key_down`, `on_key_up`.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/checkbox.py

@@ -15,8 +15,8 @@ class Checkbox(Component):
     - **disabled** (bool): If True, the checkbox is not interactive.
     - **required** (bool): If True, the checkbox must be checked.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"form-checkbox h-5 w-5 text-indigo-600"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change`, `on_click`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/container.py

@@ -10,8 +10,8 @@ class Container(Component):
     - ***children** (Component): Positional arguments for child components.
     - **additional_children** (list): Optional list of additional child components.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"flex flex-row justify-between p-4 bg-white shadow"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     
     Example:

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/datepicker.py

@@ -22,8 +22,8 @@ class DatePicker(Component):
     - **required** (bool): If True, a date must be selected.
     - **readonly** (bool): If True, the field is read-only.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes.
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change`, `on_open`, `on_close`.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/image.py

@@ -11,8 +11,8 @@ class Image(Component):
     - **width** (str): Width of the image (e.g., `"100px"`, `"50%"`).
     - **height** (str): Height of the image.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"rounded-full object-cover shadow-lg"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, `on_load`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/input.py

@@ -16,8 +16,8 @@ class Input(Component):
     - **required** (bool): If True, the field must be filled.
     - **max_length** (int): Maximum number of characters allowed.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"border-2 border-slate-200 focus:border-indigo-500 p-2 rounded"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change`, `on_input`, `on_focus`, `on_blur`, `on_key_down`, `on_key_up`.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/link.py

@@ -10,8 +10,8 @@ class Link(Component):
     - **href** (str): The URL or path to navigate to.
     - **target** (str): Where to open the link (e.g., `"_self"`, `"_blank"`).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"text-indigo-600 hover:underline font-medium"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/markdown.py

@@ -12,8 +12,8 @@ class Markdown(Component):
     - **dark_theme** (bool): Whether to apply dark theme styles to the markdown container.
     - **lazy** (bool): Enable lazy loading for content that only fetches when visible.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"prose lg:prose-xl max-w-none"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components (not typically used for Markdown).
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     

dars_framework-1.9.3/dars/components/basic/page.py

@@ -0,0 +1,139 @@
+# Dars Framework - Core Source File
+#
+# This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
+# If a copy of the MPL was not distributed with this file, You can obtain one at
+# https://mozilla.org/MPL/2.0/.
+#
+# Copyright (c) 2025 ZtaDev
+from dars.core.component import Component
+from typing import Optional, Dict, Any, List
+
+class Page(Component):
+    """
+    Root component for individual pages in a Dars application.
+    
+    Props:
+    - ***children** (Component): Positional arguments for child components to be rendered in the page.
+    - **id** (str): Unique identifier for the component.
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
+    - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
+    
+    Example:
+    ```python
+    Page(
+        Navbar(),
+        Container(
+            Text("Home Page", class_name="text-4xl font-bold"),
+            class_name="max-w-7xl mx-auto py-12"
+        ),
+        Footer(),
+        class_name="bg-white"
+    )
+    ```
+    """
+    def __init__(self, *children: Component, id: Optional[str] = None, class_name: Optional[str] = None, style: Optional[Dict[str, Any]] = None, **props):
+        super().__init__(id=id, class_name=class_name, style=style, **props)
+        self.scripts = []
+        for child in children:
+            self.add_child(child)
+
+    def add_script(self, script):
+        """
+        Adds a script to this page.
+        
+        Supports multiple script types:
+        
+        - **DScript**: Direct Python function compilation to JavaScript
+        - **String**: Inline JavaScript code
+        - **Dictionary**: Raw script object (fallback)
+        - **Utility Chains**: DAP utility functions with promise-based chaining
+        
+        **Script Types:**
+        
+        1. **DScript** - Compile Python to JavaScript:
+           ```python
+           page.add_script(dScript(file_path="script.js"))
+           ```
+        
+        2. **Inline JavaScript**:
+           ```python
+           page.add_script("console.log('Page loaded');")
+           ```
+        
+        3. **Utility Functions** - Chain DAP commands:
+           ```python
+           from dars.scripts.utils_ds import setTimeout, addClass, log
+           
+           # Sequential animations with promise chaining
+           page.add_script(
+               setTimeout(5, addClass("logo", "show"))
+               .then(setTimeout(350, addClass("title", "show")))
+               .then(setTimeout(650, addClass("description", "show")))
+           )
+           ```
+        
+        4. **useWatch** - React to state changes:
+           ```python
+           page.add_script(
+               useWatch("user.name", log("Name changed!"))
+           )
+           ```
+        
+        **Common Utilities:**
+        
+        - **setTimeout(ms, action)**: Execute action after delay (returns Promise)
+        - **addClass(id, class)**: Add CSS class to element
+        - **removeClass(id, class)**: Remove CSS class
+        - **toggleClass(id, class)**: Toggle CSS class
+        - **log(msg)**: Log to console
+        - **navigate(url)**: Navigate to URL
+        - **createComp(target, root)**: Dynamically create components
+        - **updateComp(id, props)**: Update component properties
+        - **deleteComp(id)**: Remove component from DOM
+        
+        **Promise Chaining:**
+        
+        All timeout/async utilities return Promises, allowing sequential execution:
+        
+        ```python
+        page.add_script(
+            setTimeout(100, log("Step 1"))
+            .then(setTimeout(200, log("Step 2")))
+            .then(setTimeout(300, log("Step 3")))
+        )
+        ```
+        
+        Returns self to allow method chaining.
+        """
+        self.scripts.append(script)
+
+    def useWatch(self, state_path: str, *js_helpers):
+        """
+        Watch a state property and execute callback when it changes.
+        
+        Usage with app.add_script():
+            app.add_script(useWatch("user.name", log("Name changed!")))
+        
+        Usage with page.add_script():
+            page.add_script(useWatch("user.name", log("Name changed!")))
+            
+        Usage with app.useWatch() (convenience):
+            app.useWatch("user.name", log("Name changed!"))
+            
+        Usage with page.useWatch() (convenience):
+            page.useWatch("user.name", log("Name changed!"))
+        
+        The returned WatchMarker has a get_code() method that generates the JavaScript.
+        """
+        from dars.hooks.use_watch import useWatch
+        watcher = useWatch(state_path, *js_helpers)
+        self.add_script(watcher)
+        return self
+
+    def get_scripts(self):
+        return self.scripts
+
+    def render(self, exporter: Any) -> str:
+        # El método render será implementado por el exporter
+        raise NotImplementedError("El método render debe ser implementado por el exporter")

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/progressbar.py

@@ -9,8 +9,8 @@ class ProgressBar(Component):
     - **value** (int): Current progress value (from 0 to `max_value`).
     - **max_value** (int): Maximum value representing 100% (defaults to 100).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"h-4 bg-slate-200 rounded-full overflow-hidden"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/radiobutton.py

@@ -15,8 +15,8 @@ class RadioButton(Component):
     - **disabled** (bool): If True, the radio button is not interactive.
     - **required** (bool): If True, the radio button must be selected.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes.
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change`, `on_click`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/section.py

@@ -10,8 +10,8 @@ class Section(Component):
     - ***children** (Component): Positional arguments for child components.
     - **additional_children** (list): Optional list of additional child components.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"py-12 bg-slate-50 border-b border-slate-200"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     
     Example:

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/select.py

@@ -23,8 +23,8 @@ class Select(Component):
     - **disabled** (bool): If True, the select is not interactive.
     - **required** (bool): If True, a selection is mandatory.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes.
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change`, `on_focus`, `on_blur`.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/slider.py

@@ -17,8 +17,8 @@ class Slider(Component):
     - **orientation** (str): `"horizontal"` or `"vertical"`.
     - **disabled** (bool): If True, the slider is not interactive.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes.
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change`, `on_input`.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/spinner.py

@@ -6,8 +6,8 @@ class Spinner(Component):
     
     Props:
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"w-8 h-8 border-4 border-indigo-500 border-t-transparent animate-spin rounded-full"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/text.py

@@ -9,8 +9,8 @@ class Text(Component):
     Props:
     - **text** (str): The text content to display.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"text-2xl font-bold text-slate-800"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/textarea.py

@@ -15,8 +15,8 @@ class Textarea(Component):
     - **required** (bool): If True, the field must be filled.
     - **max_length** (int): Maximum number of characters allowed.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"w-full p-4 border rounded-xl focus:ring-2 focus:ring-indigo-500"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_change`, `on_input`, `on_focus`, `on_blur`.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/tooltip.py

@@ -10,8 +10,8 @@ class Tooltip(Component):
     - **child** (Component): The component that will trigger the tooltip.
     - **position** (str): Tooltip placement relative to the child (`"top"`, `"right"`, `"bottom"`, `"left"`).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"bg-slate-800 text-white text-xs p-2 rounded"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers for mouse events.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/basic/video.py

@@ -19,8 +19,8 @@ class Video(Component):
     - **preload** (str): Preload strategy (`"auto"`, `"metadata"`, `"none"`).
     - **plays_inline** (bool): If True, the video plays inline on mobile browsers.
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"rounded-xl shadow-lg w-full"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_play`, `on_pause`, `on_ended`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/layout/flex.py

@@ -19,8 +19,8 @@ class FlexLayout(LayoutBase):
     - **align** (str): Cross axis alignment (`"stretch"`, `"center"`, `"flex-start"`, `"flex-end"`, `"baseline"`).
     - **gap** (str): Space between child components (e.g., `"16px"`, `"1rem"`).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"w-full h-full p-4 bg-white"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     

{dars_framework-1.9.1 → dars_framework-1.9.3}/dars/components/layout/grid.py

@@ -33,8 +33,8 @@ class GridLayout(LayoutBase):
     - **cols** (int): Number of grid columns.
     - **gap** (str): Space between grid cells (e.g., `"20px"`, `"1.5rem"`).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"grid grid-cols-3 gap-6 p-8"`).
-    - **style** (dict): Optional dictionary for direct inline styles (prefer `class_name`).
+    - **class_name** (str): String containing regular CSS class names.
+    - **style** (dict): Optional dictionary for CSS utility classes (prefer `style`).
     - **children** (list): List of child components.
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.