instaui 0.1.17__py2.py3-none-any.whl → 0.1.18__py2.py3-none-any.whl

instaui/js/fn.py

@@ -0,0 +1,42 @@
+from instaui.common.jsonable import Jsonable
+from instaui.vars.mixin_types.py_binding import CanInputMixin
+from instaui.runtime._app import get_app_slot
+
+
+class JsFn(Jsonable, CanInputMixin):
+    """
+    Creates a JavaScript function object from a raw code string.
+    Valid targets include: `js_computed`, `js_watch`, and similar JS-bound methods.
+
+    Args:
+        code (str): Valid JavaScript function definition string.
+
+    Example:
+    .. code-block:: python
+        a = ui.state(1)
+        add = ui.js_fn(code="(a,b)=> a+b ")
+        result = ui.js_computed(inputs=[add, a], code="(add,a)=>  add(a,10) ")
+
+        html.number(a)
+        ui.label(result)
+    """
+
+    def __init__(self, code: str):
+        self.code = code
+        self.__type = "jsFn"
+        app = get_app_slot()
+        app.register_js_fn(self)
+        self.__id = app.generate_js_fn_id()
+
+    def _to_input_config(self):
+        return {
+            "type": self.__type,
+            "id": self.__id,
+        }
+
+    def _to_json_dict(self):
+        data = super()._to_json_dict()
+        data["type"] = self.__type
+        data["id"] = self.__id
+
+        return data

instaui/runtime/_app.py

@@ -17,6 +17,7 @@ if TYPE_CHECKING:
     from instaui.dependencies.component_dependency import ComponentDependencyInfo
     from instaui.dependencies.plugin_dependency import PluginDependencyInfo
     from instaui.spa_router._route_model import RouteCollector
+    from instaui.js.fn import JsFn
 
 
 class App(Jsonable):
@@ -28,6 +29,7 @@ class App(Jsonable):
         self._scope_id_counter = 0
         self._vfor_id_counter = 0
         self._slot_id_counter = 0
+        self._js_fn_id_counter = 0
         self.mode: _T_App_Mode = mode
         self.items: List[Component] = []
         self.meta = meta
@@ -45,6 +47,7 @@ class App(Jsonable):
         self._page_params: Dict[str, Any] = {}
         self._query_params: Dict[str, Any] = {}
         self._route_collector: Optional[RouteCollector] = None
+        self._js_fns: List[JsFn] = []
 
     @property
     def page_path(self) -> str:
@@ -72,6 +75,13 @@ class App(Jsonable):
         self._slot_id_counter += 1
         return str(self._slot_id_counter)
 
+    def generate_js_fn_id(self) -> str:
+        self._js_fn_id_counter += 1
+        return str(self._js_fn_id_counter)
+
+    def register_js_fn(self, fn: JsFn) -> None:
+        self._js_fns.append(fn)
+
     def reset_html_resource(self):
         self._html_resource = HtmlResource()
 
@@ -127,6 +137,9 @@ class App(Jsonable):
         if self._web_server_info is not None:
             data["webInfo"] = self._web_server_info
 
+        if self._js_fns:
+            data["jsFn"] = self._js_fns
+
         return data
 
     @classmethod