instaui 0.1.14__tar.gz → 0.1.16__tar.gz

{instaui-0.1.14 → instaui-0.1.16}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: instaui
-Version: 0.1.14
+Version: 0.1.16
 Summary: insta-ui is a Python-based UI library for rapidly building user interfaces.
 Author-email: CrystalWindSnake <568166495@qq.com>
 License-Expression: MIT
 License-File: LICENSE
 Keywords: gui,ui,web
-Requires-Python: <3.13,>=3.8
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: orjson>=3.10.15
 Requires-Dist: pydantic>=2.10.6

instaui-0.1.16/instaui/action/__init__.py

@@ -0,0 +1,10 @@
+__all__ = [
+    "url_location",
+    "set_cookie",
+    "cookie_output",
+    "cookie_input",
+]
+
+
+from .url_location import UrlLocation as url_location
+from .cookie import cookie_input, cookie_output, set_cookie

instaui-0.1.16/instaui/action/cookie.py

@@ -0,0 +1,25 @@
+from datetime import datetime
+from typing import Optional, Union
+from instaui.runtime.context import get_context
+
+
+def cookie_output():
+    if not get_context().app_mode == "web":
+        raise ValueError("cookie_output can only be used in web mode")
+
+
+def cookie_input():
+    pass
+
+
+def set_cookie(
+    key: str,
+    value: str,
+    *,
+    max_age: Optional[int] = None,
+    expires: Optional[Union[int, datetime]] = None,
+    secure: bool = False,
+    httponly: bool = False,
+    samesite: Optional[str] = None,
+):
+    pass

{instaui-0.1.14 → instaui-0.1.16}/instaui/arco/components/radio.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 import typing
 from typing_extensions import Unpack
 import pydantic
@@ -6,13 +7,16 @@ from instaui.vars.types import TMaybeRef
 from instaui.vars.state import StateModel
 from instaui.arco import component_types
 from instaui.event.event_mixin import EventMixin
-from ._utils import handle_props, try_setup_vmodel
+from ._utils import handle_props
+from .radio_group import RadioGroup
+
+_TValue = typing.Union[str, float]
 
 
 class Radio(Element):
     def __init__(
         self,
-        value: typing.Optional[TMaybeRef[typing.Union[str, int, bool, float]]] = None,
+        value: typing.Optional[TMaybeRef[_TValue]] = None,
         **kwargs: Unpack[component_types.TRadio],
     ):
         super().__init__("a-radio")
@@ -33,8 +37,17 @@ class Radio(Element):
         )
         return self
 
+    @staticmethod
+    def from_list(options: TMaybeRef[typing.List[_TValue]], value: TMaybeRef[_TValue]):
+        return RadioGroup(value=value, options=options)  # type: ignore
+
+    @staticmethod
+    def from_options(
+        options: TMaybeRef[typing.List[RadioOption]], value: TMaybeRef[_TValue]
+    ):
+        return RadioGroup(value=value, options=options)  # type: ignore
 
-class RadioOption(StateModel):
-    label: str
-    value: typing.Union[str, int]
-    disabled: bool = pydantic.Field(default=False)
+    class RadioOption(StateModel):
+        label: str
+        value: typing.Union[str, int]
+        disabled: bool = pydantic.Field(default=False)

{instaui-0.1.14 → instaui-0.1.16}/instaui/arco/components/radio_group.py

@@ -4,7 +4,6 @@ from instaui.components.element import Element
 from instaui.vars.types import TMaybeRef
 from instaui.event.event_mixin import EventMixin
 from ._utils import handle_props, try_setup_vmodel
-from .radio import RadioOption
 
 
 class TRadioGroup(TypedDict, total=False):
@@ -12,7 +11,7 @@ class TRadioGroup(TypedDict, total=False):
     default_value: typing.Union[str, int, bool]
     type: typing.Literal["radio", "button"]
     size: typing.Literal["mini", "small", "medium", "large"]
-    options: typing.List[typing.Union[str, int, RadioOption]]
+    options: typing.List[typing.Union[str, int]]
     direction: typing.Literal["horizontal", "vertical"]
     disabled: bool
 
@@ -20,7 +19,7 @@ class TRadioGroup(TypedDict, total=False):
 class RadioGroup(Element):
     def __init__(
         self,
-        value: typing.Optional[TMaybeRef[typing.Union[str, int, bool, float]]] = None,
+        value: typing.Optional[TMaybeRef[typing.Union[str, float]]] = None,
         **kwargs: Unpack[TRadioGroup],
     ):
         super().__init__("a-radio-group")

{instaui-0.1.14 → instaui-0.1.16}/instaui/arco/components/slider.py

@@ -6,7 +6,7 @@ from instaui.arco import component_types
 from instaui.event.event_mixin import EventMixin
 from ._utils import handle_props, try_setup_vmodel
 
-_TSliderValue = typing.Union[int, float]
+_TSliderValue = typing.Union[int, float, typing.List[int], typing.List[float]]
 
 
 class Slider(Element):

{instaui-0.1.14 → instaui-0.1.16}/instaui/components/component.py

@@ -29,6 +29,8 @@ class Component(Jsonable):
                 else str(tag)
             )
         )
+        if isinstance(tag, ElementBindingMixin):
+            tag._mark_used()
         self._slot_manager = SlotManager()
 
         get_app_slot().append_component_to_container(self)

{instaui-0.1.14 → instaui-0.1.16}/instaui/components/element.py

@@ -97,10 +97,6 @@ class Element(Component):
         self._proxy_props: List[ElementBindingMixin] = []
 
         self._events: defaultdict[str, List[EventMixin]] = defaultdict(list)
-
-        # self._js_events: defaultdict[str, List[EventMixin]] = defaultdict(list)
-        # self._web_events: defaultdict[str, List[EventMixin]] = defaultdict(list)
-        # self._vue_events: defaultdict[str, List[EventMixin]] = defaultdict(list)
         self._directives: Dict[Directive, None] = {}
 
         self._slot_manager = SlotManager()
@@ -275,18 +271,28 @@ class Element(Component):
 
         if isinstance(add, dict):
             self._dict_classes.update(**add)  # type: ignore
+            for value in (
+                v for v in add.values() if isinstance(v, ElementBindingMixin)
+            ):
+                value._mark_used()
 
         if isinstance(add, ElementBindingMixin):
             self._bind_str_classes.append(add)  # type: ignore
+            add._mark_used()
 
         return self
 
     def style(self, add: Union[str, Dict[str, Any], TMaybeRef[str]]) -> Self:
         if isinstance(add, dict):
             add = {key: value for key, value in add.items()}
+            for value in (
+                v for v in add.values() if isinstance(v, ElementBindingMixin)
+            ):
+                value._mark_used()
 
         if isinstance(add, ElementBindingMixin):
             self._style_str_binds.append(add)
+            add._mark_used()
             return self
 
         new_style = self._parse_style(add)
@@ -296,10 +302,17 @@ class Element(Component):
     def props(self, add: Union[str, Dict[str, Any], TMaybeRef]) -> Self:
         if isinstance(add, ElementBindingMixin):
             self._proxy_props.append(add)
+            add._mark_used()
             return self
 
         if isinstance(add, dict):
             add = {key: value for key, value in add.items() if value is not None}
+
+            for value in (
+                v for v in add.values() if isinstance(v, ElementBindingMixin)
+            ):
+                value._mark_used()
+
         new_props = self._parse_props(add)
         self._props.update(new_props)
         return self

{instaui-0.1.14 → instaui-0.1.16}/instaui/components/html/__init__.py

@@ -6,6 +6,7 @@ __all__ = [
     "number",
     "button",
     "checkbox",
+    "radio",
     "form",
     "select",
     "option",
@@ -32,6 +33,7 @@ from .input import Input as input
 from .number import Number as number
 from .button import Button as button
 from .checkbox import Checkbox as checkbox
+from .radio import Radio as radio
 from .form import Form as form
 from .select import Select as select
 from .ul import Ul as ul

{instaui-0.1.14 → instaui-0.1.16}/instaui/components/html/label.py

@@ -1,5 +1,5 @@
 from __future__ import annotations
-from typing import TYPE_CHECKING, Any, Union
+from typing import TYPE_CHECKING, Any, Optional, Union
 from instaui.components.element import Element
 
 if TYPE_CHECKING:
@@ -10,12 +10,14 @@ class Label(Element):
     def __init__(
         self,
         text: Union[Any, TMaybeRef[Any], None] = None,
+        *,
+        for_: Optional[TMaybeRef[str]] = None,
     ):
         super().__init__("label")
 
-        if text is not None:
-            self.props(
-                {
-                    "innerText": text,
-                }
-            )
+        self.props(
+            {
+                "innerText": text,
+                "for": for_,
+            }
+        )

instaui-0.1.16/instaui/components/html/radio.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING, Optional, Union
+from instaui.components.element import Element
+from instaui.components.value_element import ValueElement
+from ._mixins import InputEventMixin
+
+if TYPE_CHECKING:
+    from instaui.vars.types import TMaybeRef
+
+
+_T_value = str
+
+
+class Radio(InputEventMixin, ValueElement[_T_value]):
+    def __init__(
+        self,
+        value: Optional[TMaybeRef[_T_value]] = None,
+        *,
+        model_value: Optional[_T_value] = None,
+        id: Optional[TMaybeRef[str]] = None,
+        name: Optional[TMaybeRef[str]] = None,
+    ):
+        super().__init__("input", value, is_html_component=True)
+        self.props({"type": "radio"})
+
+        self.props(
+            {
+                "id": id,
+                "name": name,
+            }
+        )
+
+        if model_value is not None:
+            self.props({"value": model_value})
+
+    def _input_event_mixin_element(self) -> Element:
+        return self

{instaui-0.1.14 → instaui-0.1.16}/instaui/components/match.py

@@ -11,6 +11,8 @@ class Match(Component):
     def __init__(self, on: ElementBindingMixin):
         super().__init__("match")
         self._on = on
+        if isinstance(on, ElementBindingMixin):
+            on._mark_used()
         self._default_case = None
 
     def _to_json_dict(self):

instaui-0.1.16/instaui/components/timer/timer.js

@@ -0,0 +1,48 @@
+import { ref, watch, onMounted, onUnmounted, toRef } from 'vue'
+
+
+export default {
+    props: ['intervalSeconds', 'active', 'once', 'immediate'],
+    setup(props, { emit }) {
+        const { intervalSeconds, once = false, immediate = true } = props
+        const intervalId = ref(null)
+        const isActive = toRef(() => props.active ?? true)
+        const emitTick = once ? () => { emit('tick'); stopInterval() } : () => emit('tick')
+
+        if (once === false) {
+            watch(isActive, (value) => {
+                if (value) {
+                    startInterval()
+                } else {
+                    stopInterval()
+                }
+            })
+        }
+
+        const startInterval = () => {
+            if (immediate) {
+                emitTick()
+            }
+
+            intervalId.value = setInterval(() => {
+                emitTick()
+            }, intervalSeconds * 1000)
+        }
+
+        const stopInterval = () => {
+            clearInterval(intervalId.value)
+            emit('stop')
+        }
+
+        onMounted(() => {
+            if (isActive.value) {
+                startInterval()
+            }
+        })
+
+        onUnmounted(() => {
+            stopInterval()
+        })
+    }
+
+}

instaui-0.1.16/instaui/components/timer/timer.py

@@ -0,0 +1,94 @@
+from __future__ import annotations
+from typing import List, Optional
+from instaui.components.element import Element
+from instaui.vars.types import TMaybeRef
+from instaui.event.event_mixin import EventMixin
+
+
+class Timer(Element, esm="./timer.js"):
+    """
+    A timer component that triggers events at specified intervals.
+
+    Args:
+        interval_seconds (float): Time in seconds between repeated events.
+        active (Optional[TMaybeRef[bool]], optional): If True, starts the timer immediately.
+            Accepts reactive values (e.g., state references) for dynamic control. Defaults to None (equivalent to True).
+        immediate (Optional[bool], optional): If True, triggers the first event immediately. Defaults to None (equivalent to True).
+
+    Example:
+    .. code-block:: python
+        from instaui import ui, html
+
+        @ui.page('/')
+        def index():
+            x = ui.state(0)
+            active = ui.state(True)
+
+            @ui.event(inputs=[x], outputs=[x])
+            def on_tick(x):
+                return x + 1
+
+            ui.timer(1, active=active).on_tick(on_tick)
+
+            html.checkbox(active)
+            html.span(x)
+    """
+
+    def __init__(
+        self,
+        interval_seconds: float,
+        *,
+        active: Optional[TMaybeRef[bool]] = None,
+        immediate: Optional[bool] = None,
+    ):
+        super().__init__("template")
+
+        self.props(
+            {
+                "intervalSeconds": interval_seconds,
+                "active": active,
+                "immediate": immediate,
+            }
+        )
+
+    def on_tick(
+        self,
+        handler: EventMixin,
+        *,
+        extends: Optional[List] = None,
+    ):
+        """
+        Registers an event handler for the "tick" event.
+        """
+        return self.on("tick", handler, extends=extends)
+
+    def on_stop(
+        self,
+        handler: EventMixin,
+        *,
+        extends: Optional[List] = None,
+    ):
+        """
+        Registers an event handler for the "stop" event.
+        """
+
+        return self.on("stop", handler, extends=extends)
+
+    @classmethod
+    def once(cls, delay_seconds: float):
+        """
+        Creates a timer that triggers only once.
+
+        Args:
+            delay_seconds (float): Time in seconds before the timer triggers.
+
+        Example:
+        .. code-block:: python
+            msg = ui.state('')
+            on_done = ui.js_event(outputs=[msg],code="()=> 'Done!'")
+
+            ui.timer.once(1).on_tick(on_done)
+            html.span(msg) # will show "Done!" after 1 second
+
+        """
+        return cls(delay_seconds, immediate=False).props({"once": True})

{instaui-0.1.14 → instaui-0.1.16}/instaui/components/vfor.py

@@ -50,6 +50,8 @@ class VFor(Component, Generic[_T]):
 
         super().__init__("vfor")
         self._data = data
+        if isinstance(self._data, ElementBindingMixin):
+            self._data._mark_used()
         self._key = key
         self._fid = get_app_slot().generate_vfor_id()
         self.__scope_manager = new_scope(append_to_app=False)

{instaui-0.1.14 → instaui-0.1.16}/instaui/components/vif.py

@@ -10,6 +10,8 @@ class VIf(Component):
     def __init__(self, on: TMaybeRef[bool]):
         super().__init__("vif")
         self._on = cast(ElementBindingMixin, on)
+        if isinstance(on, ElementBindingMixin):
+            on._mark_used()
         self.__scope_manager = new_scope(append_to_app=False)
         self.__scope = None
 
@@ -24,7 +26,9 @@ class VIf(Component):
     def _to_json_dict(self):
         data = super()._to_json_dict()
         data["props"] = {
-            "on": self._on._to_element_binding_config(),
+            "on": self._on
+            if isinstance(self._on, bool)
+            else self._on._to_element_binding_config(),
         }
         props: Dict = data["props"]
 

{instaui-0.1.14 → instaui-0.1.16}/instaui/event/js_event.py

@@ -1,5 +1,6 @@
 import typing
 from instaui.vars.mixin_types.py_binding import CanInputMixin, CanOutputMixin
+from instaui.vars.mixin_types.element_binding import _try_mark_inputs_used
 from instaui.common.jsonable import Jsonable
 from .event_mixin import EventMixin
 
@@ -26,6 +27,7 @@ class JsEvent(Jsonable, EventMixin):
     def _to_json_dict(self):
         data = super()._to_json_dict()
         data["type"] = self.event_type()
+        _try_mark_inputs_used(self._org_inputs)
 
         if self._inputs:
             data["inputs"] = self._inputs

{instaui-0.1.14 → instaui-0.1.16}/instaui/event/vue_event.py

@@ -1,6 +1,7 @@
 import typing
 from instaui.common.jsonable import Jsonable
 from instaui.vars.mixin_types.observable import ObservableMixin
+from instaui.vars.mixin_types.element_binding import _try_mark_inputs_used
 from .event_mixin import EventMixin
 
 
@@ -59,6 +60,8 @@ class VueEvent(Jsonable, EventMixin):
 
     def _to_json_dict(self):
         data = super()._to_json_dict()
+
+        _try_mark_inputs_used((self._bindings or {}).values())
         data["type"] = self.event_type()
         return data
 

{instaui-0.1.14 → instaui-0.1.16}/instaui/event/web_event.py

@@ -4,6 +4,7 @@ from typing_extensions import ParamSpec
 from instaui.common.jsonable import Jsonable
 from instaui.runtime._app import get_current_scope, get_app_slot
 from instaui.vars.mixin_types.py_binding import CanInputMixin, CanOutputMixin
+from instaui.vars.mixin_types.element_binding import _try_mark_inputs_used
 from instaui.handlers import event_handler
 from .event_mixin import EventMixin
 
@@ -46,6 +47,8 @@ class WebEvent(Jsonable, EventMixin, typing.Generic[P, R]):
     def _to_json_dict(self):
         app = get_app_slot()
 
+        _try_mark_inputs_used(self._inputs)
+
         hkey = event_handler.create_handler_key(
             page_path=app.page_path, handler=self._fn
         )

{instaui-0.1.14 → instaui-0.1.16}/instaui/runtime/scope.py

@@ -96,10 +96,24 @@ class Scope(Jsonable):
             data["vue_watch"] = self._vue_watchs
         if self._element_refs:
             data["eRefs"] = self._element_refs
-        if self._web_computeds:
-            data["web_computed"] = self._web_computeds
-        if self._js_computeds:
-            data["js_computed"] = self._js_computeds
+
+        # web computeds
+        _web_computeds = [
+            computed for computed in self._web_computeds if computed._is_used()
+        ]
+
+        if _web_computeds:
+            data["web_computed"] = _web_computeds
+
+        # js computeds
+        _js_computeds = [
+            computed for computed in self._js_computeds if computed._is_used()
+        ]
+
+        if _js_computeds:
+            data["js_computed"] = _js_computeds
+
+        # vue computeds
         if self._vue_computeds:
             data["vue_computed"] = self._vue_computeds
         if self._const_data: