instaui 0.1.15__tar.gz → 0.1.16__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: instaui
-Version: 0.1.15
+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

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.15 → 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.15 → 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.15 → 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.15 → 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.15 → 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.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.15 → 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.15 → 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.15 → instaui-0.1.16}/instaui/event/web_event.py

@@ -4,7 +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 ElementBindingMixin
+from instaui.vars.mixin_types.element_binding import _try_mark_inputs_used
 from instaui.handlers import event_handler
 from .event_mixin import EventMixin
 
@@ -47,9 +47,7 @@ class WebEvent(Jsonable, EventMixin, typing.Generic[P, R]):
     def _to_json_dict(self):
         app = get_app_slot()
 
-        for _input in self._inputs:
-            if isinstance(_input, ElementBindingMixin):
-                _input._mark_used()
+        _try_mark_inputs_used(self._inputs)
 
         hkey = event_handler.create_handler_key(
             page_path=app.page_path, handler=self._fn

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

@@ -97,14 +97,23 @@ class Scope(Jsonable):
         if self._element_refs:
             data["eRefs"] = self._element_refs
 
+        # web computeds
         _web_computeds = [
             computed for computed in self._web_computeds if computed._is_used()
         ]
 
         if _web_computeds:
             data["web_computed"] = _web_computeds
-        if self._js_computeds:
-            data["js_computed"] = self._js_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:

{instaui-0.1.15 → instaui-0.1.16}/instaui/ui/__init__.py

@@ -61,7 +61,6 @@ __all__ = [
     "skip_output",
     "js_output",
     "str_format",
-    "url_location",
     "on_page_request_lifespan",
     "webview",
     "code",
@@ -69,6 +68,7 @@ __all__ = [
     "echarts",
     "use_shadcn_classless",
     "mermaid",
+    "timer",
 ]
 
 # -- static imports
@@ -107,6 +107,7 @@ from instaui.components.vif import VIf as vif
 from instaui.components.match import Match as match
 from instaui.components.content import Content as content
 from instaui.components.label import label
+from instaui.components.timer.timer import Timer as timer
 
 from instaui.event.web_event import event, WebEvent as TEventFn
 from instaui.event.js_event import js_event
@@ -126,7 +127,6 @@ import instaui.experimental as experimental
 
 from instaui.ui_functions.server import create_server as server
 from instaui.ui_functions.ui_page import page
-from instaui.ui_functions.url_location import UrlLocation as url_location
 from instaui.ui_functions.str_format import str_format
 from instaui.ui_functions.ui_types import TBindable, is_bindable
 

{instaui-0.1.15 → instaui-0.1.16}/instaui/ui/__init__.pyi

@@ -61,7 +61,6 @@ __all__ = [
     "skip_output",
     "js_output",
     "str_format",
-    "url_location",
     "on_page_request_lifespan",
     "webview",
     "code",
@@ -69,6 +68,7 @@ __all__ = [
     "echarts",
     "use_shadcn_classless",
     "mermaid",
+    "timer",
 ]
 
 # -- static imports
@@ -107,6 +107,7 @@ from instaui.components.vif import VIf as vif
 from instaui.components.match import Match as match
 from instaui.components.content import Content as content
 from instaui.components.label import label
+from instaui.components.timer.timer import Timer as timer
 
 from instaui.event.web_event import event, WebEvent as TEventFn
 from instaui.event.js_event import js_event
@@ -126,7 +127,6 @@ import instaui.experimental as experimental
 
 from instaui.ui_functions.server import create_server as server
 from instaui.ui_functions.ui_page import page
-from instaui.ui_functions.url_location import UrlLocation as url_location
 from instaui.ui_functions.str_format import str_format
 from instaui.ui_functions.ui_types import TBindable, is_bindable
 

{instaui-0.1.15 → instaui-0.1.16}/instaui/vars/js_computed.py

@@ -6,7 +6,10 @@ from instaui.common.jsonable import Jsonable
 from instaui.runtime._app import get_current_scope
 from instaui.vars.path_var import PathVar
 from instaui.vars.mixin_types.var_type import VarMixin
-from instaui.vars.mixin_types.element_binding import ElementBindingMixin
+from instaui.vars.mixin_types.element_binding import (
+    ElementBindingMixin,
+    _try_mark_inputs_used,
+)
 from instaui.vars.mixin_types.py_binding import CanInputMixin
 from instaui.vars.mixin_types.pathable import CanPathPropMixin
 from instaui.vars.mixin_types.str_format_binding import StrFormatBindingMixin
@@ -55,6 +58,7 @@ class JsComputed(
         deep_compare_on_input: bool = False,
     ) -> None:
         self.code = code
+        self._org_inputs = inputs or []
 
         scope = get_current_scope()
         scope.register_js_computed(self)
@@ -67,6 +71,7 @@ class JsComputed(
 
         self._async_init_value = async_init_value
         self._deep_compare_on_input = deep_compare_on_input
+        self.__be_used = False
 
     def __to_binding_config(self):
         return {
@@ -90,6 +95,16 @@ class JsComputed(
     def _to_observable_config(self):
         return self.__to_binding_config()
 
+    def _mark_used(self):
+        if self.__be_used:
+            return
+
+        self.__be_used = True
+        _try_mark_inputs_used(self._org_inputs)
+
+    def _is_used(self):
+        return self.__be_used
+
     def _to_json_dict(self):
         data = super()._to_json_dict()
 

{instaui-0.1.15 → instaui-0.1.16}/instaui/vars/mixin_types/element_binding.py

@@ -1,4 +1,4 @@
-from typing import Dict, Generic, TypeVar
+from typing import Dict, Generic, Iterable, TypeVar
 from abc import ABC, abstractmethod
 
 T = TypeVar("T")
@@ -14,3 +14,9 @@ class ElementBindingMixin(ABC, Generic[T]):
 
     def _is_used(self):
         return True
+
+
+def _try_mark_inputs_used(inputs: Iterable):
+    for input_ in inputs:
+        if isinstance(input_, ElementBindingMixin):
+            input_._mark_used()

{instaui-0.1.15 → instaui-0.1.16}/instaui/vars/path_var.py

@@ -13,8 +13,8 @@ class PathVar(PathableMixin):
     def __getitem__(self, item: Union[str, int, CanPathPropMixin]):
         return PathTrackerBindable(self)[item]
 
-    def inverse(self):
-        return PathTrackerBindable(self).inverse()
+    def not_(self):
+        return PathTrackerBindable(self).not_()
 
     def __add__(self, other: str):
         return PathTrackerBindable(self) + other
@@ -33,7 +33,7 @@ class PathTracker:
     def __getattr__(self, key) -> Self:
         return self.__new_self__([*self.paths, key])
 
-    def inverse(self) -> Self:
+    def not_(self) -> Self:
         return self.__new_self__([*self.paths, ["!"]])
 
     def __add__(self, other: str) -> Self:

{instaui-0.1.15 → instaui-0.1.16}/instaui/vars/vue_computed.py

@@ -6,7 +6,10 @@ from instaui.common.jsonable import Jsonable
 from instaui.runtime._app import get_current_scope
 from instaui.vars.path_var import PathVar
 from instaui.vars.mixin_types.var_type import VarMixin
-from instaui.vars.mixin_types.element_binding import ElementBindingMixin
+from instaui.vars.mixin_types.element_binding import (
+    ElementBindingMixin,
+    _try_mark_inputs_used,
+)
 from instaui.vars.mixin_types.py_binding import CanInputMixin
 from instaui.vars.mixin_types.pathable import CanPathPropMixin
 from instaui.vars.mixin_types.str_format_binding import StrFormatBindingMixin
@@ -31,11 +34,13 @@ class VueComputed(
         bindings: Optional[Mapping[str, Union[ElementBindingMixin, Any]]] = None,
     ) -> None:
         self.code = fn_code
+        self._bindings = bindings
         scope = get_current_scope()
         scope.register_vue_computed(self)
 
         self._sid = scope.id
         self._id = scope.generate_vars_id()
+        self.__be_used = False
 
         if bindings:
             const_bind = []
@@ -71,10 +76,21 @@ class VueComputed(
     def _to_observable_config(self):
         return self.__to_binding_config()
 
+    def _mark_used(self):
+        if self.__be_used:
+            return
+
+        self.__be_used = True
+        _try_mark_inputs_used((self._bindings or {}).values())
+
+    def _is_used(self):
+        return self.__be_used
+
     def _to_json_dict(self):
         data = super()._to_json_dict()
         data["sid"] = self._sid
         data["id"] = self._id
+        _try_mark_inputs_used((self._bindings or {}).values())
         return data
 
 

{instaui-0.1.15 → instaui-0.1.16}/instaui/vars/web_computed.py

@@ -17,7 +17,10 @@ from instaui.handlers import watch_handler
 
 from instaui.vars.path_var import PathVar
 from instaui.vars.mixin_types.py_binding import CanInputMixin, CanOutputMixin
-from instaui.vars.mixin_types.element_binding import ElementBindingMixin
+from instaui.vars.mixin_types.element_binding import (
+    ElementBindingMixin,
+    _try_mark_inputs_used,
+)
 from instaui.vars.mixin_types.pathable import CanPathPropMixin
 from instaui.vars.mixin_types.str_format_binding import StrFormatBindingMixin
 from instaui.vars.mixin_types.observable import ObservableMixin
@@ -146,9 +149,7 @@ class WebComputed(
             return
 
         self.__be_used = True
-        for input_ in self._org_inputs:
-            if isinstance(input_, ElementBindingMixin):
-                input_._mark_used()
+        _try_mark_inputs_used(self._org_inputs)
 
     def _is_used(self):
         return self.__be_used

{instaui-0.1.15 → instaui-0.1.16}/instaui/watch/js_watch.py

@@ -6,6 +6,7 @@ from instaui.common.jsonable import Jsonable
 from instaui.runtime._app import get_current_scope
 
 from instaui.vars.mixin_types.py_binding import CanOutputMixin
+from instaui.vars.mixin_types.element_binding import _try_mark_inputs_used
 from instaui.vars.mixin_types.common_type import TObservableInput
 from instaui._helper import observable_helper
 
@@ -21,6 +22,7 @@ class JsWatch(Jsonable):
         once: bool = False,
         flush: typing.Optional[_types.TFlush] = None,
     ) -> None:
+        _try_mark_inputs_used(inputs or [])
         inputs = observable_helper.auto_made_inputs_to_slient(inputs, outputs)
 
         get_current_scope().register_js_watch(self)