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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dars-framework
-Version: 1.9.1
+Version: 1.9.2
 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>

{dars_framework-1.9.1 → dars_framework-1.9.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.1 → dars_framework-1.9.2}/dars/components/basic/page.py

@@ -15,8 +15,8 @@ class Page(Component):
     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 CSS utility classes (e.g., `"min-h-screen bg-slate-50 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`).
     - **Events**: Handlers like `on_click`, `on_mouse_enter`, etc.
     
     Example:

{dars_framework-1.9.1 → dars_framework-1.9.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.
     

{dars_framework-1.9.1 → dars_framework-1.9.2}/dars/components/visualization/chart.py

@@ -12,8 +12,8 @@ class Chart(Component):
     - **height** (int/str): Height of the chart container (defaults to `400px`).
     - **config** (dict): Plotly configuration options (e.g., `{'responsive': True}`).
     - **id** (str): Unique identifier for the component.
-    - **class_name** (str): String containing CSS utility classes (e.g., `"rounded-xl shadow-lg border p-4"`).
-    - **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 typical for Chart).
     - **Events**: Handlers (not typical for Chart).
     

{dars_framework-1.9.1 → dars_framework-1.9.2}/dars/components/visualization/table.py

@@ -17,8 +17,8 @@ class DataTable(Component):
     - **theme** (str/dict): Predefined theme (`"light"`, `"dark"`) or a custom color dictionary.
     - **formatters** (dict): Custom value formatters for specific columns.
     - **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 (not rendered).
     - **Events**: Handlers (not typical for static DataTable).
     

{dars_framework-1.9.1 → dars_framework-1.9.2}/dars/core/app.py

@@ -7,6 +7,7 @@
 # Copyright (c) 2025 ZtaDev
 from typing import Optional, List, Dict, Any
 
+from dars.core.routing import RouteNode, SPARoute
 from dars.exporters.base import Exporter
 from dars.scripts.script import Script
 from .component import Component
@@ -142,7 +143,117 @@ class Page:
             return {'type': 'dscript', 'value': obj, **kwargs}
 
 class App:
-    """Main class that represents a Dars application"""
+    """
+    Main application class for building Dars web and desktop applications.
+    
+    This class represents the root container for a Dars application and handles all
+    application-level configuration, routing, pages, and metadata. It supports both
+    Single-Page Application (SPA) and Multi-Page Application (MPA) modes.
+    
+    **Modes of Operation:**
+    
+    - **Single-Page App (SPA)**: Set a root Component for client-side routing.
+    - **Multi-Page App (MPA)**: Add multiple pages with the `add_page()` method.
+    - **Desktop App**: Deploy as a desktop application using Electron or similar.
+    
+    **Props:**
+    
+    - **title** (str): Application title (default: "Dars App").
+    - **description** (str): Meta description for SEO.
+    - **author** (str): Author name for meta tags.
+    - **version** (str): Application version (used in package.json for desktop).
+    - **keywords** (list): List of SEO keywords.
+    - **language** (str): Document language code (default: "en").
+    - **favicon** (str): Path to favicon file.
+    - **icon** (str): Path to app icon (used for PWA and meta tags).
+    - **apple_touch_icon** (str): Path to Apple touch icon.
+    - **apple_mobile_web_app_capable** (bool): Enable Apple mobile web app mode.
+    - **apple_mobile_web_app_status_bar_style** (str): Status bar style for Apple devices ("default", "black", "black-translucent").
+    - **apple_mobile_web_app_title** (str): Title for Apple home screen.
+    - **manifest** (str): Path to PWA manifest.json file.
+    - **theme_color** (str): Primary theme color for PWA (default: "#000000").
+    - **background_color** (str): Background color for PWA splash screen (default: "#ffffff").
+    - **service_worker_path** (str): Path to service worker file.
+    - **service_worker_enabled** (bool): Enable service worker registration.
+    - **desktop** (bool): Flag for desktop application mode.
+    - **devtools** (bool): Auto-open DevTools in desktop development mode (default: True).
+    - **ssr_url** (str): URL for Server-Side Rendering backend (optional).
+    - **meta** (dict): Custom meta tags and attributes.
+    
+    **Internal Attributes:**
+    
+    - **root** (Component): Root component for SPA mode.
+    - **_pages** (dict): Dictionary of pages for MPA mode.
+    - **_spa_routes** (dict): SPA route definitions.
+    - **_spa_404_page** (Page): Custom 404 error page.
+    - **_spa_403_page** (Page): Custom 403 forbidden page.
+    - **_spa_loading_page** (Component): Loading page during route transitions.
+    - **_spa_error_page** (Component): Error page for runtime errors.
+    - **scripts** (list): Global scripts to inject into the app.
+    - **global_styles** (dict): Global CSS styles.
+    - **event_manager** (EventManager): Application-wide event manager.
+    
+    **SEO & Social Media:**
+    
+    - **og_title, og_description, og_image, og_url**: Open Graph meta tags.
+    - **twitter_card, twitter_site, twitter_creator**: Twitter Card meta tags.
+    - **robots**: Robots meta tag for search engines.
+    - **canonical_url**: Canonical URL for SEO.
+    
+    **PWA Configuration:**
+    
+    - **pwa_enabled** (bool): Enable Progressive Web App support.
+    - **pwa_name** (str): PWA display name.
+    - **pwa_short_name** (str): PWA short name (max 12 chars).
+    - **pwa_display** (str): PWA display mode ("standalone", "fullscreen", "minimal-ui", "browser").
+    - **pwa_orientation** (str): PWA orientation ("portrait", "landscape", "portrait-primary", etc.).
+    
+    **Examples:**
+    
+    Single-Page Application (SPA):
+    ```python
+    from dars.all import *
+    
+    @route("/")
+    def home():
+        return Container(
+            Text("Welcome to Dars!", class_name="text-4xl font-bold"),
+            class_name="flex flex-col items-center justify-center min-h-screen"
+        )
+    
+    app = App(
+        title="My Dars App",
+        description="A beautiful Dars application",
+        icon="public/icon.png"
+    )
+    
+    app.add_page("home", home()) = home()
+    
+    if __name__ == "__main__":
+        app.rTimeCompile()
+    ```
+    
+    Multi-Page Application (MPA):
+    ```python
+    app = App(title="My Multi-Page App")
+    
+    app.add_page("home", Page("home", home_component, title="Home"))
+    app.add_page("about", Page("about", about_component, title="About Us"))
+    app.add_page("contact", Page("contact", contact_component, title="Contact"))
+    
+    if __name__ == "__main__":
+        app.rTimeCompile()
+    ```
+    
+    Desktop Application:
+    ```python
+    app = App(
+        title="My Desktop App",
+        desktop=True,
+        devtools=True
+    )
+    ```
+    """
 
     def __init__(
         self,

{dars_framework-1.9.1 → dars_framework-1.9.2}/dars/version.py

@@ -6,5 +6,5 @@
 #
 # Copyright (c) 2025 ZtaDev
 
-__version__ = "1.9.1"
-__release_url__ = "https://github.com/ZtaMDev/Dars-Framework/releases/tag/1.9.1"
+__version__ = "1.9.2"
+__release_url__ = "https://github.com/ZtaMDev/Dars-Framework/releases/tag/1.9.2"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dars-framework
-Version: 1.9.1
+Version: 1.9.2
 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>

{dars_framework-1.9.1 → dars_framework-1.9.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dars-framework"
-version = "1.9.1"
+version = "1.9.2"
 description = "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."
 dependencies = [ "rich==15.0.0", "bs4==0.0.2", "uvicorn==0.46.0", "markdown2==2.5.5", "requests==2.33.1", "plotly==6.7.0", "fastapi==0.136.1", "rjsmin==1.2.5", "rcssmin==1.2.2",]
 license = "MPL-2.0"