instaui 0.1.15__py2.py3-none-any.whl

instaui/runtime/scope.py

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List
+from instaui.common.jsonable import Jsonable
+
+
+if TYPE_CHECKING:
+    from instaui.vars.mixin_types.var_type import VarMixin
+    from instaui.vars.mixin_types.py_binding import CanInputMixin
+    from instaui.vars.web_computed import WebComputed
+    from instaui.vars.js_computed import JsComputed
+    from instaui.vars.vue_computed import VueComputed
+    from instaui.vars.data import ConstData
+    from instaui.watch.web_watch import WebWatch
+    from instaui.watch.js_watch import JsWatch
+    from instaui.watch.vue_watch import VueWatch
+    from instaui.vars.element_ref import ElementRef
+
+
+class Scope(Jsonable):
+    def __init__(self, id: str) -> None:
+        super().__init__()
+        self.id = id
+        self._vars_id_counter = 0
+        self._element_ref_id_counter = 0
+        self._refs: List[VarMixin] = []
+        self._const_data: List[ConstData] = []
+        self._js_computeds: List[JsComputed] = []
+        self._vue_computeds: List[VueComputed] = []
+        self._web_computeds: List[WebComputed] = []
+        self._element_refs: List[ElementRef] = []
+        self._run_method_records: List = []
+        self._web_watchs: List[WebWatch] = []
+        self._js_watchs: List[JsWatch] = []
+        self._vue_watchs: List[VueWatch] = []
+        self._query = {}
+
+    def set_run_method_record(
+        self, scope_id: str, element_ref_id: str, method_name: str, args
+    ):
+        self._run_method_records.append((scope_id, element_ref_id, method_name, args))
+
+    def generate_vars_id(self) -> str:
+        self._vars_id_counter += 1
+        return str(self._vars_id_counter)
+
+    def generate_element_ref_id(self) -> str:
+        self._element_ref_id_counter += 1
+        return str(self._element_ref_id_counter)
+
+    def register_element_ref(self, ref: ElementRef):
+        self._element_refs.append(ref)
+
+    def set_query(self, url: str, key: str, on: List[CanInputMixin]) -> None:
+        self._query = {
+            "url": url,
+            "key": key,
+            "on": [v._to_input_config() for v in on],
+        }
+
+    def register_ref(self, var: VarMixin) -> None:
+        self._refs.append(var)
+
+    def register_data(self, data: ConstData) -> None:
+        self._const_data.append(data)
+
+    def register_js_computed(self, computed: JsComputed) -> None:
+        self._js_computeds.append(computed)
+
+    def register_vue_computed(self, computed: VueComputed) -> None:
+        self._vue_computeds.append(computed)
+
+    def register_web_computed(self, computed: WebComputed) -> None:
+        self._web_computeds.append(computed)
+
+    def register_web_watch(self, watch: WebWatch) -> None:
+        self._web_watchs.append(watch)
+
+    def register_js_watch(self, watch: JsWatch) -> None:
+        self._js_watchs.append(watch)
+
+    def register_vue_watch(self, watch: VueWatch) -> None:
+        self._vue_watchs.append(watch)
+
+    def _to_json_dict(self):
+        data = super()._to_json_dict()
+        if self._refs:
+            data["refs"] = self._refs
+        if self._query:
+            data["query"] = self._query
+        if self._web_watchs:
+            data["py_watch"] = self._web_watchs
+        if self._js_watchs:
+            data["js_watch"] = self._js_watchs
+        if self._vue_watchs:
+            data["vue_watch"] = self._vue_watchs
+        if self._element_refs:
+            data["eRefs"] = self._element_refs
+
+        _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
+        if self._vue_computeds:
+            data["vue_computed"] = self._vue_computeds
+        if self._const_data:
+            data["data"] = self._const_data
+
+        return data
+
+
+class GlobalScope(Scope):
+    def __init__(self, id: str) -> None:
+        super().__init__(id)
+
+    def register_ref(self, var: VarMixin) -> None:
+        raise ValueError("Can not register ref in global scope")
+
+    def register_web_computed(self, computed: WebComputed) -> None:
+        raise ValueError("Can not register web_computeds  in global scope")
+
+    def register_web_watch(self, watch: WebWatch) -> None:
+        raise ValueError("Can not register web_watchs  in global scope")
+
+    def register_js_watch(self, watch: JsWatch) -> None:
+        raise ValueError("Can not register js_watchs  in global scope")
+
+    def register_vue_watch(self, watch: VueWatch) -> None:
+        raise ValueError("Can not register vue_watchs  in global scope")

instaui/runtime/ui_state_scope.py

@@ -0,0 +1,15 @@
+import contextvars
+from typing import Dict
+
+
+_scope_var: contextvars.ContextVar[Dict[type, object]] = contextvars.ContextVar(
+    "_scope_var", default={}
+)
+
+
+def save_state(key, obj: object) -> None:
+    _scope_var.get()[key] = obj
+
+
+def load_state(key) -> object:
+    return _scope_var.get()[key]

instaui/settings/__init__.py

@@ -0,0 +1,4 @@
+from .__settings import use_tailwind
+
+
+__all__ = ["use_tailwind"]

instaui/settings/__settings.py

@@ -0,0 +1,13 @@
+from instaui.runtime import in_default_app_slot, HtmlResource
+
+
+def use_tailwind(value=True):
+    """Use Tailwind CSS framework.
+
+    Args:
+        value (bool, optional):  whether to use Tailwind CSS. Defaults to True.
+    """
+
+    if not in_default_app_slot():
+        raise ValueError("Cannot set use_tailwind outside of ui.page")
+    HtmlResource.use_tailwind = value

instaui/shadcn_classless/_index.py

@@ -0,0 +1,42 @@
+from pathlib import Path
+from instaui.runtime._app import get_app_slot
+
+
+_STATIC_DIR = Path(__file__).parent / "static"
+_CSS_FILE = _STATIC_DIR / "shadcn-classless.css"
+
+
+def use_shadcn_classless(value=True):
+    """Use shadcn-classless.css or not.
+
+    Args:
+        value (bool, optional): Whether to use shadcn-classless.css or not. Defaults to True.
+
+    Example:
+
+    App default use shadcn-classless.css:
+    .. code-block:: python
+
+        @ui.page('/')
+        def index():
+
+            # Create a container with shadcn-classless class
+            with html.div().classes("shadcn-classless"):
+                html.h1("Hello, world!")
+
+                with html.form():
+                    html.input()
+                    html.button("Submit")
+
+    Can be disabled:
+    .. code-block:: python
+        # App does not use shadcn-classless
+        ui.use_shadcn_classless(False)
+
+    """
+
+    if value:
+        get_app_slot()._html_resource.add_css_link(_CSS_FILE)
+
+    else:
+        get_app_slot()._html_resource.remove_css_link(_CSS_FILE)

instaui/shadcn_classless/static/shadcn-classless.css

@@ -0,0 +1,403 @@
+.shadcn-classless {
+  color-scheme: light dark;
+  font-family: ui-monospace, "Menlo", "Monaco", "Consolas", "Liberation Mono", "Courier New", monospace;
+  background-color: var(--background);
+  color: var(--foreground);
+  line-height: 1.5;
+  padding: 1rem;
+  --radius: 0.5rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.141 0.005 285.823);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.141 0.005 285.823);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.141 0.005 285.823);
+  --primary: oklch(0.21 0.006 285.885);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.967 0.001 286.375);
+  --secondary-foreground: oklch(0.21 0.006 285.885);
+  --muted: oklch(0.967 0.001 286.375);
+  --muted-foreground: oklch(0.552 0.016 285.938);
+  --accent: oklch(0.967 0.001 286.375);
+  --accent-foreground: oklch(0.21 0.006 285.885);
+  --destructive: oklch(0.577 0.245 27.325);
+  --border: oklch(0.92 0.004 286.32);
+  --input: oklch(0.92 0.004 286.32);
+  --ring: oklch(0.705 0.015 286.067);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.141 0.005 285.823);
+  --sidebar-primary: oklch(0.21 0.006 285.885);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.967 0.001 286.375);
+  --sidebar-accent-foreground: oklch(0.21 0.006 285.885);
+  --sidebar-border: oklch(0.92 0.004 286.32);
+  --sidebar-ring: oklch(0.705 0.015 286.067);
+}
+.shadcn-classless.dark-mode {
+  --background: oklch(0.141 0.005 285.823);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.21 0.006 285.885);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.21 0.006 285.885);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.92 0.004 286.32);
+  --primary-foreground: oklch(0.21 0.006 285.885);
+  --secondary: oklch(0.274 0.006 286.033);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.274 0.006 286.033);
+  --muted-foreground: oklch(0.705 0.015 286.067);
+  --accent: oklch(0.274 0.006 286.033);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.552 0.016 285.938);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.21 0.006 285.885);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.274 0.006 286.033);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.552 0.016 285.938);
+}
+.shadcn-classless *,
+.shadcn-classless ::after,
+.shadcn-classless ::before {
+  box-sizing: border-box;
+}
+.shadcn-classless * {
+  margin: 0;
+  padding: 0;
+}
+.shadcn-classless h1,
+.shadcn-classless h2,
+.shadcn-classless h3,
+.shadcn-classless h4,
+.shadcn-classless h5,
+.shadcn-classless h6 {
+  margin-bottom: 0.5em;
+  font-weight: 700;
+}
+.shadcn-classless h1 {
+  letter-spacing: -0.025em;
+  font-weight: 700;
+  font-size: 1.875rem;
+  line-height: 2.25rem;
+}
+.shadcn-classless h2 {
+  letter-spacing: -0.025em;
+  font-weight: 600;
+  font-size: 1.25rem;
+  line-height: 1.75rem;
+}
+.shadcn-classless h3 {
+  letter-spacing: -0.025em;
+  font-weight: 600;
+  font-size: 1.125rem;
+  line-height: 1.75rem;
+}
+.shadcn-classless h4 {
+  letter-spacing: -0.025em;
+  font-weight: 600;
+  font-size: 16px;
+  line-height: 1.75rem;
+}
+.shadcn-classless h5 {
+  font-size: 15px;
+}
+.shadcn-classless h6 {
+  font-size: 14px;
+}
+.shadcn-classless p {
+  margin-bottom: 1em;
+}
+.shadcn-classless a {
+  color: var(--primary);
+  text-decoration: none;
+}
+.shadcn-classless a:hover {
+  text-decoration: underline;
+}
+.shadcn-classless ul,
+.shadcn-classless ol {
+  margin-bottom: 1em;
+  padding-left: 1.5em;
+}
+.shadcn-classless header,
+.shadcn-classless main {
+  max-width: 800px;
+  margin: 0 auto;
+}
+.shadcn-classless header {
+  margin-bottom: 2rem;
+}
+.shadcn-classless header h1 {
+  font-size: 2rem;
+}
+.shadcn-classless nav ul {
+  list-style: none;
+  padding: 0;
+  display: flex;
+  gap: 1rem;
+}
+.shadcn-classless section {
+  margin-bottom: 2rem;
+}
+.shadcn-classless form {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+.shadcn-classless input,
+.shadcn-classless select,
+.shadcn-classless textarea {
+  font-weight: 500;
+  font: inherit;
+  padding: 0.5rem 0.75rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background-color: var(--background);
+  color: var(--foreground);
+  font-size: 0.875rem;
+}
+.shadcn-classless select {
+  appearance: none;
+  -webkit-appearance: none;
+  -moz-appearance: none;
+  background: transparent;
+  background-image: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-chevron-down" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z"/></svg>');
+  background-repeat: no-repeat;
+  background-position-x: calc(100% - 0.75rem);
+  background-position-y: 50%;
+}
+.shadcn-classless input[type='submit'],
+.shadcn-classless button {
+  font: inherit;
+  cursor: pointer;
+  font-size: 0.875rem;
+  font-weight: 500;
+  padding: 0.5rem 1rem;
+  background-color: var(--primary);
+  color: var(--primary-foreground);
+  border: none;
+  border-radius: var(--radius);
+  transition: background-color 0.2s ease-in-out;
+}
+.shadcn-classless input[type='submit']:hover,
+.shadcn-classless button:hover {
+  background-color: color-mix(in srgb, var(--primary) 90%, transparent);
+}
+.shadcn-classless fieldset {
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1rem;
+}
+.shadcn-classless legend {
+  padding: 0 0.5rem;
+}
+.shadcn-classless label {
+  display: block;
+}
+.shadcn-classless small {
+  color: var(--muted-foreground);
+}
+.shadcn-classless figure {
+  margin-bottom: 1rem;
+  overflow: hidden;
+}
+.shadcn-classless img {
+  max-width: 100%;
+  height: auto;
+  border-radius: var(--radius);
+}
+.shadcn-classless figcaption {
+  font-size: 0.875rem;
+  margin-top: 0.5rem;
+  color: var(--muted-foreground);
+}
+.shadcn-classless blockquote {
+  border-left: 4px solid var(--border);
+  padding-left: 1rem;
+  font-style: italic;
+}
+.shadcn-classless [type='checkbox'],
+.shadcn-classless [type='radio'] {
+  margin-right: 0.5rem;
+}
+.shadcn-classless progress {
+  width: 100%;
+}
+.shadcn-classless dialog {
+  background-color: var(--background);
+  color: var(--foreground);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 24px;
+  margin: auto;
+}
+.shadcn-classless dialog::backdrop {
+  background-color: rgba(0, 0, 0, 0.8);
+}
+.shadcn-classless details {
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.5rem;
+  margin-bottom: 1rem;
+}
+.shadcn-classless summary {
+  cursor: pointer;
+  font-weight: bold;
+}
+.shadcn-classless article {
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1rem;
+  margin-bottom: 1rem;
+}
+.shadcn-classless footer {
+  margin-top: 2rem;
+  text-align: center;
+  color: var(--muted-foreground);
+}
+.shadcn-classless [aria-busy='true'] {
+  opacity: 0.7;
+  cursor: progress;
+}
+@media (max-width: 600px) {
+  .shadcn-classless body {
+    padding: 0.5rem;
+  }
+  .shadcn-classless nav ul {
+    flex-direction: column;
+  }
+}
+.shadcn-classless input[type='file']::file-selector-button {
+  border: none;
+  background-color: var(--background);
+  font-weight: 600;
+}
+.shadcn-classless *:disabled {
+  cursor: not-allowed;
+}
+.shadcn-classless input[type='radio'],
+.shadcn-classless input[type='checkbox'],
+.shadcn-classless input[type='range'] {
+  accent-color: var(--primary);
+  background-color: var(--background);
+}
+.shadcn-classless kbd {
+  padding: 0.125rem 0.625rem;
+  background-color: var(--primary);
+  color: var(--primary-foreground);
+  border-radius: var(--radius);
+}
+.shadcn-classless table {
+  caption-side: bottom;
+  border-collapse: collapse;
+}
+.shadcn-classless table caption {
+  color: var(--muted-foreground);
+  margin-top: 1rem;
+}
+.shadcn-classless table th {
+  color: var(--muted-foreground);
+}
+.shadcn-classless table tr {
+  border-bottom: 1px solid var(--border);
+}
+.shadcn-classless table tr:hover {
+  background-color: hsl(var(--muted) / 0.5);
+}
+.shadcn-classless table td,
+.shadcn-classless table th {
+  vertical-align: middle;
+  padding: 0.5rem;
+  text-align: start;
+}
+.shadcn-classless table tfoot {
+  background-color: var(--muted);
+}
+.shadcn-classless dialog[drawer] {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+  top: auto;
+  bottom: 0;
+  width: 100vw;
+  max-height: 50vh;
+}
+.shadcn-classless dialog[drawer][open] {
+  animation: slideup 0.2s ease-in forwards;
+}
+.shadcn-classless dialog > header {
+  margin: 0;
+}
+@keyframes slideup {
+  0% {
+    transform: translateY(100%);
+  }
+  100% {
+    transform: translateY(0);
+  }
+}
+.shadcn-classless progress {
+  -webkit-appearance: none;
+  -moz-appearance: none;
+  appearance: none;
+  height: 0.5rem;
+  border-radius: 9999px;
+  background-color: var(--muted);
+  border: 0;
+}
+.shadcn-classless progress[value]::-webkit-progress-value {
+  border-radius: 9999px;
+  background-color: var(--primary);
+}
+.shadcn-classless ::-webkit-progress-bar {
+  border-radius: 9999px;
+  background-color: var(--muted);
+}
+.shadcn-classless ::-moz-progress-bar {
+  border-radius: 9999px;
+  background-color: var(--primary);
+}
+.shadcn-classless progress:indeterminate {
+  background: var(--muted) linear-gradient(to right, var(--primary) 35%, var(--muted) 35%) top left / 150% 150% no-repeat;
+  animation: progress-indeterminate 1.5s linear infinite;
+}
+.shadcn-classless progress:indeterminate::-webkit-progress-bar {
+  background-color: transparent;
+}
+.shadcn-classless progress:indeterminate::-moz-progress-bar {
+  background-color: transparent;
+}
+@keyframes progress-indeterminate {
+  0% {
+    background-position: 200% 0;
+  }
+  100% {
+    background-position: -200% 0;
+  }
+}
+.shadcn-classless hr {
+  border: 0;
+  height: 1px;
+  margin: 1rem 0;
+  background-color: var(--border);
+  flex-shrink: 0;
+}
+.shadcn-classless hr[vertical] {
+  width: 1px;
+  height: 1.25rem;
+  margin: 0 1rem;
+}

instaui/skip.py

@@ -0,0 +1,12 @@
+from typing import Any
+
+
+class _Skip:
+    pass
+
+
+skip_output = _Skip()
+
+
+def is_skip_output(value: Any):
+    return value is skip_output

instaui/spa_router/__init__.py

@@ -0,0 +1,26 @@
+from ._components import RouterLink as link, RouterView as view
+from ._functions import (
+    add_route,
+    config_router,
+    get_params,
+    get_full_path,
+    get_path,
+    push,
+    output,
+)
+from ._route_model import RouteItem
+from ._file_base_utils import build_routes_from_files
+
+__all__ = [
+    "add_route",
+    "config_router",
+    "link",
+    "view",
+    "get_params",
+    "get_full_path",
+    "get_path",
+    "push",
+    "output",
+    "RouteItem",
+    "build_routes_from_files",
+]

instaui/spa_router/_components.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+import typing
+from instaui import html
+from instaui.components.element import Element
+from instaui.vars.types import TMaybeRef
+
+
+class RouterLink(Element):
+    def __init__(self, text: TMaybeRef[str], *, to: str):
+        super().__init__("router-link")
+
+        self.props({"to": to})
+
+        if text is not None:
+            with self.add_slot("default"):
+                html.span(text)
+
+    @classmethod
+    def by_name(
+        cls,
+        text: TMaybeRef[str],
+        *,
+        name: str,
+        params: typing.Optional[typing.Dict[str, typing.Any]] = None,
+    ) -> RouterLink:
+        to: typing.Dict = {"name": name}
+        if params:
+            to["params"] = params
+
+        return cls(text, to=to)  # type: ignore
+
+
+class RouterView(Element):
+    def __init__(self):
+        super().__init__("router-view")