tina4-python 3.13.51__tar.gz → 3.13.52__tar.gz

{tina4_python-3.13.51 → tina4_python-3.13.52}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 3.13.51
+Version: 3.13.52
 Summary: Tina4 Python v3 — Zero-dependency, lightweight web framework
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 License: MIT

{tina4_python-3.13.51 → tina4_python-3.13.52}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tina4-python"
-version = "3.13.51"
+version = "3.13.52"
 description = "Tina4 Python v3 — Zero-dependency, lightweight web framework"
 authors = [
     {name = "Andre van Zuydam", email = "andrevanzuydam@gmail.com"}

{tina4_python-3.13.51 → tina4_python-3.13.52}/tina4_python/core/server.py

@@ -276,6 +276,12 @@ Router.add("GET", _HEALTH_PATH, _health_handler)
 if _HEALTH_PATH != "/health":
     Router.add("GET", "/health", _health_handler)
 
+# Frond live blocks: re-render a registered {% live %} fragment on demand.
+# Always on (production too) - the poll/sse client fetches this; auth re-applies
+# through the normal middleware chain on every refresh.
+from tina4_python.frond import live_endpoint as _live_endpoint
+Router.add("GET", "/__frond/live/{name}", _live_endpoint)
+
 
 def _render_error_page(status_code: int, path: str, request_id: str, error_message: str = "") -> str | None:
     """Render a styled error page using Frond engine.

{tina4_python-3.13.51 → tina4_python-3.13.52}/tina4_python/database/connection.py

@@ -110,6 +110,7 @@ except ImportError:
 from tina4_python.database.postgres import PostgreSQLAdapter
 register_driver("postgresql", PostgreSQLAdapter)
 register_driver("postgres", PostgreSQLAdapter)
+register_driver("pgsql", PostgreSQLAdapter)  # PDO / Laravel / Doctrine scheme name (issue #58)
 
 # Register MySQL (mysql-connector-python — optional)
 from tina4_python.database.mysql import MySQLAdapter

{tina4_python-3.13.51 → tina4_python-3.13.52}/tina4_python/frond/FROND.md

@@ -383,6 +383,85 @@ Macros don't inherit parent context — pass everything explicitly via parameter
 
 ---
 
+## Live Blocks
+
+A live block renders on the server, then keeps itself fresh. The first paint ships with the
+page, so there is no loading flash. After that, the block re-fetches its own HTML and swaps
+it in place. You write server-side Frond and the block stays current, with no hand-written
+JavaScript.
+
+```twig
+{% live "cart" poll 5 %}
+    <strong>{{ count }}</strong> items - {{ total | number_format(2) }}
+{% endlive %}
+```
+
+That block paints once with the page, then re-renders every 5 seconds. `frond.js` (already
+loaded from `/js/frond.js`) finds the marker, calls `GET /__frond/live/cart`, and morphs the
+returned HTML into place. A focused input and its caret survive the swap.
+
+### Transports
+
+Pick how the block refreshes:
+
+```twig
+{% live "cart" poll 5 %}...{% endlive %}          {# re-fetch every 5 seconds #}
+{% live "feed" sse %}...{% endlive %}             {# Server-Sent Events stream #}
+{% live "chat" ws "/ws/chat" %}...{% endlive %}   {# WebSocket on /ws/chat #}
+```
+
+`poll N` pulls every `N` seconds. `sse` and `ws` push: the server decides when to send. All
+three render the same server-side body. Only the delivery changes.
+
+### The data source
+
+A live block needs data on every refresh, not just the first paint. Register a provider by
+name with `@live_source`. It runs on each refresh with the live request, so the block
+re-renders against fresh data and re-applies auth every time. An unauthenticated caller never
+sees another user's numbers.
+
+```python
+from tina4_python.frond import live_source
+
+@live_source("cart")
+def cart_data(request):
+    user = request.session.get("user_id")
+    return {"count": cart_count(user), "total": cart_total(user)}
+```
+
+The provider feeds the always-on endpoint `GET /__frond/live/{name}`. There is no route to
+write. The block name is the route.
+
+### Pushing updates
+
+A `ws` block can update the moment data changes, without waiting for the next poll. Call
+`push_live(name, data)`. It re-renders the block and broadcasts the new HTML to every client
+connected on the block's WebSocket path.
+
+```python
+from tina4_python.frond import push_live
+
+# after an order lands:
+push_live("cart", {"count": 3, "total": 59.97})
+```
+
+### Same-origin only
+
+A block can point at your own route with `src` instead of the auto endpoint:
+
+```twig
+{% live "cart" poll 5 src "/fragments/cart" %}...{% endlive %}
+```
+
+`src` must be a same-origin path. An absolute URL is rejected at render time, so a live block
+never fetches from a host you did not write. Nested live blocks are rejected too.
+
+The marker element is byte-identical across Python, PHP, Ruby, and Node, so the shared
+`frond.js` drives every backend the same way. Write the block once. It renders anywhere
+Tina4 runs.
+
+---
+
 ## Comments
 
 ```twig

tina4_python-3.13.52/tina4_python/frond/__init__.py

@@ -0,0 +1,85 @@
+# Tina4 Frond — Zero-dependency template engine.
+"""
+Twig-like template engine built from scratch.
+
+    from tina4_python.frond import Frond
+
+    engine = Frond(template_dir="src/templates")
+    output = engine.render("page.html", {"name": "World"})
+"""
+import inspect
+
+from tina4_python.frond.engine import Frond
+
+
+async def live_endpoint(name, request, response):
+    """GET /__frond/live/{name} - re-render a registered {% live %} fragment.
+
+    Resolves the @live_source provider for <name>, runs it with the LIVE request
+    so auth and session scoping re-apply on every refresh (a live "my cart"
+    cannot leak another user's data), renders the registered fragment, and
+    returns the HTML. 404 when the name is unknown or its fragment has not been
+    registered yet (the page carrying the block has not rendered).
+    """
+    provider = Frond._class_live_sources.get(name)
+    if name not in Frond._class_live_fragments and provider is None:
+        return response("live block not found: " + str(name), 404)
+    context = {}
+    if provider is not None:
+        result = provider(request)
+        if inspect.isawaitable(result):
+            result = await result
+        context = result or {}
+    html = Frond.render_live(name, context)
+    if html is None:
+        return response("live fragment not registered yet: " + str(name), 404)
+    return response(html)
+
+
+async def push_live(name, data=None):
+    """Re-render the '<name>' live fragment and push it to connected clients.
+
+    Renders via Frond.render_live(name, data) and broadcasts a {type, name, html}
+    envelope over WebSocket: to the ws path the block declared (data-ws), or to a
+    room named <name> if the block declared none. Apps call this after a state
+    change (a new chat message, an order update). Returns the rendered HTML, or
+    None when the fragment is not registered (its page has not rendered).
+    """
+    html = Frond.render_live(name, data or {})
+    if html is None:
+        return None
+    import json
+    envelope = json.dumps({"type": "live", "name": name, "html": html})
+    try:
+        from tina4_python.core.server import _ws_manager
+        ws_path = Frond._class_live_ws_paths.get(name)
+        if ws_path:
+            await _ws_manager.broadcast(envelope, path=ws_path)
+        else:
+            await _ws_manager.broadcast_to_room(name, envelope)
+    except Exception as exc:
+        try:
+            from tina4_python.debug import Log
+            Log.error("push_live(" + str(name) + ") broadcast failed: " + str(exc))
+        except Exception:
+            pass
+    return html
+
+
+def live_source(name: str):
+    """Register a data provider for a {% live %} block.
+
+    The decorated function receives the request and returns the context dict
+    used to re-render the fragment on refresh:
+
+        @live_source("notifications")
+        async def notifications(request):
+            return {"items": Notification.where("user_id = ?", [request.session["uid"]])}
+    """
+    def _wrap(fn):
+        Frond._class_live_sources[name] = fn
+        return fn
+    return _wrap
+
+
+__all__ = ["Frond", "live_source", "live_endpoint", "push_live"]

{tina4_python-3.13.51 → tina4_python-3.13.52}/tina4_python/frond/engine.py

@@ -117,6 +117,15 @@ _FILTER_CMP_RE = re.compile(r"(\w+)\s*(!=|==|>=|<=|>|<)\s*(.+)")
 _FOR_RE = re.compile(r"for\s+(\w+)(?:\s*,\s*(\w+))?\s+in\s+(.+)")
 _SET_RE = re.compile(r"set\s+(\w+)\s*=\s*(.+)", re.DOTALL)
 _INCLUDE_RE = re.compile(r'include\s+["\'](.+?)["\'](?:\s+with\s+(.+))?')
+_LIVE_RE = re.compile(r'live\s+["\'](?P<name>[^"\']+)["\'](?P<rest>.*)$', re.DOTALL)
+_LIVE_WS_RE = re.compile(r'ws\s+["\']([^"\']+)["\']')
+_LIVE_SRC_RE = re.compile(r'src\s+["\']([^"\']+)["\']')
+
+
+def _live_attr(value) -> str:
+    """Escape a value for use inside an HTML attribute on a live marker."""
+    return (str(value).replace("&", "&amp;").replace('"', "&quot;")
+            .replace("<", "&lt;").replace(">", "&gt;"))
 _MACRO_RE = re.compile(r"macro\s+(\w+)\s*\(([^)]*)\)")
 _FROM_IMPORT_RE = re.compile(r'from\s+["\'](.+?)["\']\s+import\s+(.+)')
 _IMPORT_AS_RE = re.compile(r'import\s+["\'](.+?)["\']\s+as\s+(\w+)')
@@ -1309,6 +1318,11 @@ class Frond:
     _class_globals: dict = {}
     _class_filters: dict = {}
     _class_tests: dict = {}
+    # Live blocks: name -> body template source (registered when a {% live %}
+    # block renders); name -> data provider (registered via @live_source).
+    _class_live_fragments: dict = {}
+    _class_live_sources: dict = {}
+    _class_live_ws_paths: dict = {}
 
     @classmethod
     def clear_registry(cls):
@@ -1320,6 +1334,9 @@ class Frond:
         cls._class_globals.clear()
         cls._class_filters.clear()
         cls._class_tests.clear()
+        cls._class_live_fragments.clear()
+        cls._class_live_sources.clear()
+        cls._class_live_ws_paths.clear()
 
     def __init__(self, template_dir: str = "src/templates"):
         self.template_dir = Path(template_dir)
@@ -1766,6 +1783,11 @@ class Frond:
                     output.append(result)
                     i = skip
 
+                elif tag == "live":
+                    result, skip = self._handle_live(tokens, i, context)
+                    output.append(result)
+                    i = skip
+
                 elif tag in ("block", "endblock", "extends"):
                     i += 1  # Already handled
 
@@ -2396,6 +2418,93 @@ class Frond:
         self._fragment_cache[cache_key] = (rendered, time.time() + ttl)
         return rendered, i
 
+    def _handle_live(self, tokens: list, start: int, context: dict) -> tuple[str, int]:
+        """Handle {% live "name" poll N | sse | ws "path" [src "url"] %}...{% endlive %}.
+
+        Server-rendered live region. The body renders once for first paint, is
+        registered under <name> so the /__frond/live/<name> endpoint (or a
+        @live_source provider) can re-render it, and is wrapped in a marker
+        element that frond.js wires to the chosen transport (poll / sse / ws).
+        """
+        content, _, _ = _strip_tag(tokens[start][1])
+        m = _LIVE_RE.match(content)
+        if not m:
+            raise ValueError('live: expected {% live "name" poll N | sse | ws "path" %}')
+        name = m.group("name")
+        rest = (m.group("rest") or "").strip()
+        parts = rest.split()
+        mode = parts[0] if parts else ""
+
+        src = None
+        sm = _LIVE_SRC_RE.search(rest)
+        if sm:
+            src = sm.group(1)
+        if src and (src.startswith("http://") or src.startswith("https://") or src.startswith("//")):
+            raise ValueError("live: src must be a same-origin path, not an absolute URL")
+
+        interval = None
+        ws_path = None
+        if mode == "poll":
+            if len(parts) < 2 or not parts[1].isdigit():
+                raise ValueError('live: poll requires seconds, e.g. {% live "x" poll 5 %}')
+            interval = int(parts[1])
+        elif mode == "sse":
+            pass
+        elif mode == "ws":
+            wm = _LIVE_WS_RE.search(rest)
+            if not wm:
+                raise ValueError('live: ws requires a path, e.g. {% live "x" ws "/ws/x" %}')
+            ws_path = wm.group(1)
+        else:
+            raise ValueError(f'live: unknown transport "{mode}" (use poll N, sse, or ws "path")')
+
+        # Collect body tokens up to {% endlive %}. Nested live is unsupported.
+        body_tokens = []
+        i = start + 1
+        while i < len(tokens):
+            if tokens[i][0] == BLOCK:
+                tag_content, _, _ = _strip_tag(tokens[i][1])
+                tag = tag_content.split()[0] if tag_content.split() else ""
+                if tag == "live":
+                    raise ValueError("live: nested live blocks are not supported")
+                if tag == "endlive":
+                    i += 1
+                    break
+                body_tokens.append(tokens[i])
+            else:
+                body_tokens.append(tokens[i])
+            i += 1
+
+        # Register the body source so the auto endpoint can re-render it.
+        Frond._class_live_fragments[name] = "".join(raw for (_t, raw) in body_tokens)
+
+        endpoint = src or ("/__frond/live/" + name)
+        attrs = [f'data-frond-live="{_live_attr(name)}"', f'id="live-{_live_attr(name)}"']
+        if mode == "poll":
+            attrs += ['data-mode="poll"', f'data-interval="{interval}"',
+                      f'data-src="{_live_attr(endpoint)}"']
+        elif mode == "sse":
+            attrs += ['data-mode="sse"', f'data-src="{_live_attr(endpoint)}"']
+        elif mode == "ws":
+            Frond._class_live_ws_paths[name] = ws_path
+            attrs += ['data-mode="ws"', f'data-ws="{_live_attr(ws_path)}"']
+
+        first_paint = self._render_tokens(list(body_tokens), context)
+        return f'<div {" ".join(attrs)}>{first_paint}</div>', i
+
+    @classmethod
+    def render_live(cls, name: str, data: dict = None):
+        """Re-render a registered {% live %} fragment by name.
+
+        Returns the rendered HTML fragment, or None if no fragment is registered
+        under that name yet (the page carrying the block has not rendered). The
+        /__frond/live/<name> endpoint calls this after resolving the provider data.
+        """
+        source = cls._class_live_fragments.get(name)
+        if source is None:
+            return None
+        return cls().render_string(source, data or {})
+
     def _handle_spaceless(self, tokens: list, start: int, context: dict) -> tuple[str, int]:
         """Handle {% spaceless %}...{% endspaceless %}.
 

{tina4_python-3.13.51 → tina4_python-3.13.52}/tina4_python/public/js/frond.js

@@ -558,6 +558,132 @@ var _frondModule = (() => {
       }
     });
   }
+  function _liveKey(el) {
+    const d = el.dataset;
+    return d && d.key ? d.key : null;
+  }
+  function _liveSyncAttrs(oldNode, newNode) {
+    const na = newNode.attributes;
+    for (let i = 0; i < na.length; i++) {
+      const a = na[i];
+      if (oldNode.getAttribute(a.name) !== a.value) oldNode.setAttribute(a.name, a.value);
+    }
+    const oa = Array.prototype.slice.call(oldNode.attributes);
+    oa.forEach(function(a) {
+      if (!newNode.hasAttribute(a.name)) oldNode.removeAttribute(a.name);
+    });
+  }
+  function _liveMorphNode(oldNode, newNode) {
+    const tag = newNode.tagName;
+    if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return;
+    _liveSyncAttrs(oldNode, newNode);
+    if (oldNode.children.length || newNode.children.length) {
+      _liveReconcile(oldNode, newNode);
+    } else if (oldNode.innerHTML !== newNode.innerHTML) {
+      oldNode.innerHTML = newNode.innerHTML;
+    }
+  }
+  function _liveReconcile(parent, next) {
+    const oldKids = Array.prototype.slice.call(parent.children);
+    const newKids = Array.prototype.slice.call(next.children);
+    const oldByKey = {};
+    oldKids.forEach(function(c) {
+      const k = _liveKey(c);
+      if (k) oldByKey[k] = c;
+    });
+    const order = [];
+    for (let i = 0; i < newKids.length; i++) {
+      const nk = newKids[i];
+      const k = _liveKey(nk);
+      let match = null;
+      if (k && oldByKey[k]) {
+        match = oldByKey[k];
+      } else if (!k && oldKids[i] && !_liveKey(oldKids[i]) && oldKids[i].tagName === nk.tagName) {
+        match = oldKids[i];
+      }
+      if (match && match.tagName === nk.tagName) {
+        _liveMorphNode(match, nk);
+        reused.push(match);
+        order.push(match);
+      } else {
+        order.push(nk);
+      }
+    }
+    let cursor = parent.firstElementChild;
+    for (let i = 0; i < order.length; i++) {
+      const node = order[i];
+      if (node === cursor) {
+        cursor = cursor.nextElementSibling;
+      } else {
+        parent.insertBefore(node, cursor);
+      }
+    }
+    oldKids.forEach(function(c) {
+      if (order.indexOf(c) === -1 && c.parentNode === parent) parent.removeChild(c);
+    });
+    void reused;
+  }
+  function _liveSwap(container, html) {
+    const tmp = document.createElement("div");
+    tmp.innerHTML = html;
+    if (!tmp.children.length || !container.children.length) {
+      container.innerHTML = html;
+      return;
+    }
+    _liveReconcile(container, tmp);
+  }
+  function _liveWsUrl(path) {
+    if (/^wss?:\/\//.test(path)) return path;
+    const proto = typeof location !== "undefined" && location.protocol === "https:" ? "wss" : "ws";
+    return proto + "://" + location.host + path;
+  }
+  function _liveExtract(msg, name) {
+    if (msg && typeof msg === "object") {
+      if (msg.type === "live") {
+        if (name && msg.name && msg.name !== name) return null;
+        return msg.html != null ? String(msg.html) : null;
+      }
+      return null;
+    }
+    return typeof msg === "string" ? msg : null;
+  }
+  function liveInit(root) {
+    if (typeof document === "undefined") return;
+    const scope = root || document;
+    const blocks = scope.querySelectorAll("[data-frond-live]");
+    Array.prototype.slice.call(blocks).forEach(function(el) {
+      if (el.__frondLive) return;
+      el.__frondLive = true;
+      const mode = el.getAttribute("data-mode");
+      const name = el.getAttribute("data-frond-live");
+      if (mode === "poll") {
+        const src = el.getAttribute("data-src");
+        const interval = (parseInt(el.getAttribute("data-interval"), 10) || 5) * 1e3;
+        const timer = setInterval(function() {
+          if (typeof document !== "undefined" && document.hidden) return;
+          request(src, { method: "GET", onSuccess: function(data) {
+            _liveSwap(el, typeof data === "string" ? data : String(data));
+          } });
+        }, interval);
+        el.__frondLiveStop = function() {
+          clearInterval(timer);
+        };
+      } else if (mode === "ws") {
+        const sock = wsConnect(_liveWsUrl(el.getAttribute("data-ws")));
+        sock.on("message", function(msg) {
+          const h = _liveExtract(msg, name);
+          if (h !== null) _liveSwap(el, h);
+        });
+        el.__frondLiveStop = function() {
+          sock.close();
+        };
+      } else if (mode === "sse") {
+        if (typeof console !== "undefined" && console.warn) {
+          console.warn("[frond.live] sse transport is not wired yet (v1 supports poll and ws); block '" + name + "' shows first paint only. Use poll or ws.");
+        }
+      }
+    });
+  }
   var frond = {
     /** Core HTTP request. */
     request,
@@ -573,6 +699,8 @@ var _frondModule = (() => {
     ws: wsConnect,
     /** Server-Sent Events with auto-reconnect. */
     sse: sseConnect,
+    /** Wire {% live %} blocks (poll/ws) with keyed morph. Auto-runs on DOMContentLoaded. */
+    live: liveInit,
     /** Cookie helpers: get, set, remove. */
     cookie,
     /** Display alert message in #message element. */
@@ -593,8 +721,17 @@ var _frondModule = (() => {
   };
   if (typeof window !== "undefined") {
     window.frond = frond;
+    if (typeof document !== "undefined") {
+      if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", function() {
+          liveInit();
+        });
+      } else {
+        liveInit();
+      }
+    }
   }
   return __toCommonJS(frond_exports);
 })();
-/* Frond v2.1.3 — tina4.com */
+/* Frond v2.2.0 - tina4.com */
 //# sourceMappingURL=frond.js.map

tina4_python-3.13.52/tina4_python/public/js/frond.min.js

@@ -0,0 +1,2 @@
+var _frondModule=(()=>{var E=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var H=Object.prototype.hasOwnProperty;var q=(t,s)=>{for(var e in s)E(t,e,{get:s[e],enumerable:!0})},D=(t,s,e,o)=>{if(s&&typeof s=="object"||typeof s=="function")for(let n of A(s))!H.call(t,n)&&n!==e&&E(t,n,{get:()=>s[n],enumerable:!(o=O(s,n))||o.enumerable});return t};var W=t=>D(E({},"__esModule",{value:!0}),t);var z={};q(z,{frond:()=>L});var y=null;function v(t,s){let e;typeof s=="function"?e={onSuccess:s}:e=s||{};let o=(e.method||"GET").toUpperCase(),n=new XMLHttpRequest;if(n.open(o,t,!0),y!==null&&n.setRequestHeader("Authorization","Bearer "+y),e.headers)for(let u in e.headers)Object.prototype.hasOwnProperty.call(e.headers,u)&&n.setRequestHeader(u,e.headers[u]);let c=null;e.body!==void 0&&e.body!==null&&(e.body instanceof FormData?c=e.body:typeof e.body=="object"?(c=JSON.stringify(e.body),n.setRequestHeader("Content-Type","application/json; charset=UTF-8")):typeof e.body=="string"&&(c=e.body,n.setRequestHeader("Content-Type","text/plain; charset=UTF-8"))),n.onload=function(){let u=n.getResponseHeader("FreshToken");u&&u!==""&&(y=u);let r=n.response;try{r=JSON.parse(r)}catch{}if(n.responseURL){let i=new URL(t,window.location.href).href;if(n.responseURL!==i){window.location.href=n.responseURL;return}}n.status>=200&&n.status<400?e.onSuccess&&e.onSuccess(r,n.status,n):e.onError&&e.onError(n.status,n)},n.onerror=function(){e.onError&&e.onError(n.status,n)},n.send(c)}function h(t,s){if(!t)return"";let e=new DOMParser,o=t.includes("<html>")?t:"<body>"+t+"</body></html>",c=e.parseFromString(o,"text/html").querySelector("body"),u=c.querySelectorAll("script");if(u.forEach(function(r){r.remove()}),s!==null){let r=document.getElementById(s);return r&&(c.children.length>0?r.replaceChildren.apply(r,Array.from(c.children)):r.innerHTML=c.innerHTML,u.forEach(function(i){let l=document.createElement("script");l.type="text/javascript",l.async=!0,i.src?l.src=i.src:l.textContent=i.textContent,r.appendChild(l)})),""}return u.forEach(function(r){let i=document.createElement("script");i.type="text/javascript",i.async=!0,i.textContent=r.textContent,document.body.appendChild(i)}),c.innerHTML}function _(t,s,e){let o=s||"content";v(t,{method:"GET",onSuccess:function(n,c){if(document.getElementById(o)){let u=h(n,o);e&&e(u,n)}else e&&e(n)}})}function R(t,s,e,o){let n=e||"content";v(t,{method:"POST",body:s,onSuccess:function(c){let u="";if(c&&c.message!==void 0)u=h(c.message,n);else if(document.getElementById(n))u=h(c,n);else{o&&o(c);return}o&&o(u,c)}})}var x={collect:function(t){let s=new FormData,e=document.querySelectorAll("#"+t+" select, #"+t+" input, #"+t+" textarea");for(let o=0;o<e.length;o++){let n=e[o];if(n.name==="formToken"&&y!==null&&(n.value=y),!!n.name)if(n.type==="file"){let c=n.files;if(c)for(let u=0;u<c.length;u++){let r=c[u];if(r!==void 0){let i=n.name;c.length>1&&!i.includes("[")&&(i=i+"[]"),s.append(i,r,r.name)}}}else n.type==="checkbox"||n.type==="radio"?n.checked?s.append(n.name,n.value):n.type!=="radio"&&s.append(n.name,"0"):s.append(n.name,n.value===""?"":n.value)}return s},submit:function(t,s,e,o){let n=x.collect(t);R(s,n,e||"message",o)},show:function(t,s,e,o){let n=t.toUpperCase();(t==="create"||t==="edit")&&(n="GET"),t==="delete"&&(n="DELETE");let c=e||"form";v(s,{method:n,onSuccess:function(u){let r="";if(u&&u.message!==void 0)r=h(u.message,c);else if(document.getElementById(c))r=h(u,c);else{o&&o(u);return}o&&o(r)}})}};function M(t,s){let e={reconnect:!0,reconnectDelay:1e3,maxReconnectDelay:3e4,maxReconnectAttempts:1/0,protocols:[],onOpen:function(){},onClose:function(){},onError:function(){},...s||{}},o=null,n=!1,c=e.reconnectDelay,u=0,r=null,i={message:[],open:[],close:[],error:[]},l={status:"connecting",send:function(f){if(!o||o.readyState!==WebSocket.OPEN)throw new Error("[frond] WebSocket is not connected");o.send(typeof f=="string"?f:JSON.stringify(f))},on:function(f,a){return i[f]||(i[f]=[]),i[f].push(a),function(){let d=i[f],g=d.indexOf(a);g>=0&&d.splice(g,1)}},close:function(f,a){n=!0,r&&(clearTimeout(r),r=null),o&&o.close(f||1e3,a||""),l.status="closed"}};function p(f){if(typeof f!="string")return f;try{return JSON.parse(f)}catch{return f}}function m(){!e.reconnect||u>=e.maxReconnectAttempts||(u++,l.status="reconnecting",r=setTimeout(function(){r=null,w()},c),c=Math.min(c*2,e.maxReconnectDelay))}function w(){l.status=u>0?"reconnecting":"connecting";try{o=new WebSocket(t,e.protocols)}catch{l.status="closed";return}o.onopen=function(){l.status="open",u=0,c=e.reconnectDelay,e.onOpen();for(let f of i.open)f()},o.onmessage=function(f){let a=p(f.data);for(let d of i.message)d(a)},o.onclose=function(f){l.status="closed",e.onClose(f.code,f.reason);for(let a of i.close)a(f.code,f.reason);n||m()},o.onerror=function(f){e.onError(f);for(let a of i.error)a(f)}}return w(),l}function I(t,s){let e={reconnect:!0,reconnectDelay:1e3,maxReconnectDelay:3e4,maxReconnectAttempts:1/0,events:[],json:!0,onOpen:function(){},onClose:function(){},onError:function(){},...s||{}},o=null,n=!1,c=e.reconnectDelay,u=0,r=null,i={message:[],open:[],close:[],error:[]},l={status:"connecting",on:function(a,d){return i[a]||(i[a]=[]),i[a].push(d),function(){let g=i[a],T=g.indexOf(d);T>=0&&g.splice(T,1)}},close:function(){n=!0,r&&(clearTimeout(r),r=null),o&&(o.close(),o=null),l.status="closed"}};function p(a){if(!e.json)return a;try{return JSON.parse(a)}catch{return a}}function m(a,d){for(let g of i.message)g(a,d||void 0)}function w(){!e.reconnect||u>=e.maxReconnectAttempts||(u++,l.status="reconnecting",r=setTimeout(function(){r=null,f()},c),c=Math.min(c*2,e.maxReconnectDelay))}function f(){l.status=u>0?"reconnecting":"connecting";try{o=new EventSource(t)}catch{l.status="closed";return}o.onopen=function(){l.status="open",u=0,c=e.reconnectDelay,e.onOpen();for(let a of i.open)a(null)},o.onmessage=function(a){m(p(a.data),null)};for(let a of e.events)o.addEventListener(a,function(d){m(p(d.data),a)});o.onerror=function(a){e.onError(a);for(let d of i.error)d(a);if(o&&o.readyState===2){o=null,l.status="closed",e.onClose();for(let d of i.close)d(null);n||w()}}}return f(),l}var U={set:function(t,s,e){let o="";if(e){let n=new Date;n.setTime(n.getTime()+e*24*60*60*1e3),o="; expires="+n.toUTCString()}document.cookie=t+"="+(s||"")+o+"; path=/"},get:function(t){let s=t+"=",e=document.cookie.split(";");for(let o=0;o<e.length;o++){let n=e[o];for(;n.charAt(0)===" ";)n=n.substring(1);if(n.indexOf(s)===0)return n.substring(s.length)}return null},remove:function(t){document.cookie=t+"=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/"}};function j(t,s){let e=document.getElementById("message");if(!e)return;let o=s||"info";e.innerHTML='<div class="alert alert-'+o+' alert-dismissible">'+t+'<button type="button" class="btn-close" data-t4-dismiss="alert">&times;</button></div>'}function B(t,s,e,o){let n=window.screenLeft!==void 0?window.screenLeft:window.screenX,c=window.screenTop!==void 0?window.screenTop:window.screenY,u=window.innerWidth||document.documentElement.clientWidth||screen.width,r=window.innerHeight||document.documentElement.clientHeight||screen.height,i=u/window.screen.availWidth,l=(u-e)/2/i+n,p=(r-o)/2/i+c,m=window.open(t,s,"directories=no,toolbar=no,location=no,status=no,menubar=no,scrollbars=yes,resizable=yes,width="+e/i+",height="+o/i+",top="+p+",left="+l);return window.focus&&m&&m.focus(),m}function P(t){if(t.indexOf("No data available")>=0){window.alert("No data available for this report.");return}window.open(t,"_blank","toolbar=no,scrollbars=yes,resizable=yes,width=800,height=600,top=0,left=0")}function F(t,s,e,o){v(t,{method:"POST",body:{query:s,variables:e||{}},onSuccess:function(n){o&&o(n.data||null,n.errors||void 0)},onError:function(n){o&&o(null,[{message:"GraphQL request failed with status "+n}])}})}function b(t){let s=t.dataset;return s&&s.key?s.key:null}function X(t,s){let e=s.attributes;for(let n=0;n<e.length;n++){let c=e[n];t.getAttribute(c.name)!==c.value&&t.setAttribute(c.name,c.value)}Array.prototype.slice.call(t.attributes).forEach(function(n){s.hasAttribute(n.name)||t.removeAttribute(n.name)})}function G(t,s){let e=s.tagName;e==="INPUT"||e==="TEXTAREA"||e==="SELECT"||(X(t,s),t.children.length||s.children.length?C(t,s):t.innerHTML!==s.innerHTML&&(t.innerHTML=s.innerHTML))}function C(t,s){let e=Array.prototype.slice.call(t.children),o=Array.prototype.slice.call(s.children),n={};e.forEach(function(r){let i=b(r);i&&(n[i]=r)});let c=[];for(let r=0;r<o.length;r++){let i=o[r],l=b(i),p=null;l&&n[l]?p=n[l]:!l&&e[r]&&!b(e[r])&&e[r].tagName===i.tagName&&(p=e[r]),p&&p.tagName===i.tagName?(G(p,i),reused.push(p),c.push(p)):c.push(i)}let u=t.firstElementChild;for(let r=0;r<c.length;r++){let i=c[r];i===u?u=u.nextElementSibling:t.insertBefore(i,u)}e.forEach(function(r){c.indexOf(r)===-1&&r.parentNode===t&&t.removeChild(r)}),reused}function k(t,s){let e=document.createElement("div");if(e.innerHTML=s,!e.children.length||!t.children.length){t.innerHTML=s;return}C(t,e)}function J(t){return/^wss?:\/\//.test(t)?t:(typeof location<"u"&&location.protocol==="https:"?"wss":"ws")+"://"+location.host+t}function N(t,s){return t&&typeof t=="object"?t.type==="live"?s&&t.name&&t.name!==s?null:t.html!=null?String(t.html):null:null:typeof t=="string"?t:null}function S(t){if(typeof document>"u")return;let e=(t||document).querySelectorAll("[data-frond-live]");Array.prototype.slice.call(e).forEach(function(o){if(o.__frondLive)return;o.__frondLive=!0;let n=o.getAttribute("data-mode"),c=o.getAttribute("data-frond-live");if(n==="poll"){let u=o.getAttribute("data-src"),r=(parseInt(o.getAttribute("data-interval"),10)||5)*1e3,i=setInterval(function(){typeof document<"u"&&document.hidden||v(u,{method:"GET",onSuccess:function(l){k(o,typeof l=="string"?l:String(l))}})},r);o.__frondLiveStop=function(){clearInterval(i)}}else if(n==="ws"){let u=M(J(o.getAttribute("data-ws")));u.on("message",function(r){let i=N(r,c);i!==null&&k(o,i)}),o.__frondLiveStop=function(){u.close()}}else n==="sse"&&typeof console<"u"&&console.warn&&console.warn("[frond.live] sse transport is not wired yet (v1 supports poll and ws); block '"+c+"' shows first paint only. Use poll or ws.")})}var L={request:v,load:_,post:R,inject:h,form:x,ws:M,sse:I,live:S,cookie:U,message:j,popup:B,report:P,graphql:F,get token(){return y},set token(t){y=t}};typeof window<"u"&&(window.frond=L,typeof document<"u"&&(document.readyState==="loading"?document.addEventListener("DOMContentLoaded",function(){S()}):S()));return W(z);})();
+/* Frond v2.2.0 - tina4.com */

{tina4_python-3.13.51 → tina4_python-3.13.52}/tina4_python/scss/__init__.py

@@ -348,7 +348,13 @@ def _eval_math(scss: str) -> str:
 
 
 def _resolve_color_functions(scss: str, variables: dict) -> str:
-    """Resolve lighten(), darken(), rgba() functions."""
+    """Resolve lighten(), darken(), rgba()/rgb(), and mix() color functions.
+
+    ``rgba(<hex>, <alpha>)`` is the damaging case (issue #124): the functional
+    ``rgba()`` notation cannot take a hex, so ``rgba(#0f3460, 0.12)`` is invalid
+    CSS and browsers drop the whole declaration. We convert the hex to its
+    ``r, g, b`` components so the output is valid ``rgba(15, 52, 96, 0.12)``.
+    """
     def _lighten(m):
         color = m.group(1).strip()
         amount = float(m.group(2).strip().rstrip("%")) / 100
@@ -359,11 +365,53 @@ def _resolve_color_functions(scss: str, variables: dict) -> str:
         amount = float(m.group(2).strip().rstrip("%")) / 100
         return _adjust_lightness(color, -amount)
 
+    def _rgba(m):
+        rgb = _hex_to_rgb(m.group(1))
+        if rgb is None:
+            return m.group(0)  # not a hex colour — leave verbatim
+        r, g, b = rgb
+        return f"rgba({r}, {g}, {b}, {m.group(2).strip()})"
+
+    def _rgb(m):
+        rgb = _hex_to_rgb(m.group(1))
+        if rgb is None:
+            return m.group(0)
+        r, g, b = rgb
+        return f"rgb({r}, {g}, {b})"
+
+    def _mix(m):
+        c1, c2 = _hex_to_rgb(m.group(1)), _hex_to_rgb(m.group(2))
+        if c1 is None or c2 is None:
+            return m.group(0)
+        w = (float(m.group(3).strip().rstrip("%")) / 100) if m.group(3) else 0.5
+        mixed = tuple(round(a * w + b * (1 - w)) for a, b in zip(c1, c2))
+        return f"#{mixed[0]:02x}{mixed[1]:02x}{mixed[2]:02x}"
+
     scss = re.sub(r'lighten\(\s*([^,]+)\s*,\s*([^)]+)\s*\)', _lighten, scss)
     scss = re.sub(r'darken\(\s*([^,]+)\s*,\s*([^)]+)\s*\)', _darken, scss)
+    # rgba(<hex>, <alpha>) — only the two-arg hex form; leave rgba(r,g,b,a) alone.
+    scss = re.sub(r'rgba\(\s*(#[0-9a-fA-F]{3,8})\s*,\s*([\d.]+)\s*\)', _rgba, scss)
+    scss = re.sub(r'rgb\(\s*(#[0-9a-fA-F]{3,8})\s*\)', _rgb, scss)
+    # mix(<c1>, <c2>[, <weight>]) — Sass weight is c1's proportion (default 50%).
+    scss = re.sub(
+        r'mix\(\s*(#[0-9a-fA-F]{3,8})\s*,\s*(#[0-9a-fA-F]{3,8})\s*(?:,\s*([\d.]+%?)\s*)?\)',
+        _mix, scss)
     return scss
 
 
+def _hex_to_rgb(color: str):
+    """Parse a #rgb / #rrggbb hex string into an (r, g, b) int tuple, or None."""
+    color = color.strip().lstrip("#")
+    if len(color) == 3:
+        color = "".join(c * 2 for c in color)
+    if len(color) != 6:
+        return None
+    try:
+        return int(color[0:2], 16), int(color[2:4], 16), int(color[4:6], 16)
+    except ValueError:
+        return None
+
+
 def _adjust_lightness(color: str, amount: float) -> str:
     """Adjust the lightness of a hex color."""
     color = color.strip().lstrip("#")

tina4_python-3.13.51/tina4_python/frond/__init__.py

@@ -1,12 +0,0 @@
-# Tina4 Frond — Zero-dependency template engine.
-"""
-Twig-like template engine built from scratch.
-
-    from tina4_python.frond import Frond
-
-    engine = Frond(template_dir="src/templates")
-    output = engine.render("page.html", {"name": "World"})
-"""
-from tina4_python.frond.engine import Frond
-
-__all__ = ["Frond"]

tina4_python-3.13.51/tina4_python/public/js/frond.min.js

@@ -1,2 +0,0 @@
-var _frondModule=(()=>{var b=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var O=(o,s)=>{for(var e in s)b(o,e,{get:s[e],enumerable:!0})},M=(o,s,e,t)=>{if(s&&typeof s=="object"||typeof s=="function")for(let n of x(s))!C.call(o,n)&&n!==e&&b(o,n,{get:()=>s[n],enumerable:!(t=k(s,n))||t.enumerable});return o};var q=o=>M(b({},"__esModule",{value:!0}),o);var j={};O(j,{frond:()=>R});var g=null;function w(o,s){let e;typeof s=="function"?e={onSuccess:s}:e=s||{};let t=(e.method||"GET").toUpperCase(),n=new XMLHttpRequest;if(n.open(t,o,!0),g!==null&&n.setRequestHeader("Authorization","Bearer "+g),e.headers)for(let r in e.headers)Object.prototype.hasOwnProperty.call(e.headers,r)&&n.setRequestHeader(r,e.headers[r]);let i=null;e.body!==void 0&&e.body!==null&&(e.body instanceof FormData?i=e.body:typeof e.body=="object"?(i=JSON.stringify(e.body),n.setRequestHeader("Content-Type","application/json; charset=UTF-8")):typeof e.body=="string"&&(i=e.body,n.setRequestHeader("Content-Type","text/plain; charset=UTF-8"))),n.onload=function(){let r=n.getResponseHeader("FreshToken");r&&r!==""&&(g=r);let u=n.response;try{u=JSON.parse(u)}catch{}if(n.responseURL){let c=new URL(o,window.location.href).href;if(n.responseURL!==c){window.location.href=n.responseURL;return}}n.status>=200&&n.status<400?e.onSuccess&&e.onSuccess(u,n.status,n):e.onError&&e.onError(n.status,n)},n.onerror=function(){e.onError&&e.onError(n.status,n)},n.send(i)}function h(o,s){if(!o)return"";let e=new DOMParser,t=o.includes("<html>")?o:"<body>"+o+"</body></html>",i=e.parseFromString(t,"text/html").querySelector("body"),r=i.querySelectorAll("script");if(r.forEach(function(u){u.remove()}),s!==null){let u=document.getElementById(s);return u&&(i.children.length>0?u.replaceChildren.apply(u,Array.from(i.children)):u.innerHTML=i.innerHTML,r.forEach(function(c){let d=document.createElement("script");d.type="text/javascript",d.async=!0,c.src?d.src=c.src:d.textContent=c.textContent,u.appendChild(d)})),""}return r.forEach(function(u){let c=document.createElement("script");c.type="text/javascript",c.async=!0,c.textContent=u.textContent,document.body.appendChild(c)}),i.innerHTML}function H(o,s,e){let t=s||"content";w(o,{method:"GET",onSuccess:function(n,i){if(document.getElementById(t)){let r=h(n,t);e&&e(r,n)}else e&&e(n)}})}function S(o,s,e,t){let n=e||"content";w(o,{method:"POST",body:s,onSuccess:function(i){let r="";if(i&&i.message!==void 0)r=h(i.message,n);else if(document.getElementById(n))r=h(i,n);else{t&&t(i);return}t&&t(r,i)}})}var T={collect:function(o){let s=new FormData,e=document.querySelectorAll("#"+o+" select, #"+o+" input, #"+o+" textarea");for(let t=0;t<e.length;t++){let n=e[t];if(n.name==="formToken"&&g!==null&&(n.value=g),!!n.name)if(n.type==="file"){let i=n.files;if(i)for(let r=0;r<i.length;r++){let u=i[r];if(u!==void 0){let c=n.name;i.length>1&&!c.includes("[")&&(c=c+"[]"),s.append(c,u,u.name)}}}else n.type==="checkbox"||n.type==="radio"?n.checked?s.append(n.name,n.value):n.type!=="radio"&&s.append(n.name,"0"):s.append(n.name,n.value===""?"":n.value)}return s},submit:function(o,s,e,t){let n=T.collect(o);S(s,n,e||"message",t)},show:function(o,s,e,t){let n=o.toUpperCase();(o==="create"||o==="edit")&&(n="GET"),o==="delete"&&(n="DELETE");let i=e||"form";w(s,{method:n,onSuccess:function(r){let u="";if(r&&r.message!==void 0)u=h(r.message,i);else if(document.getElementById(i))u=h(r,i);else{t&&t(r);return}t&&t(u)}})}};function L(o,s){let e={reconnect:!0,reconnectDelay:1e3,maxReconnectDelay:3e4,maxReconnectAttempts:1/0,protocols:[],onOpen:function(){},onClose:function(){},onError:function(){},...s||{}},t=null,n=!1,i=e.reconnectDelay,r=0,u=null,c={message:[],open:[],close:[],error:[]},d={status:"connecting",send:function(l){if(!t||t.readyState!==WebSocket.OPEN)throw new Error("[frond] WebSocket is not connected");t.send(typeof l=="string"?l:JSON.stringify(l))},on:function(l,a){return c[l]||(c[l]=[]),c[l].push(a),function(){let f=c[l],m=f.indexOf(a);m>=0&&f.splice(m,1)}},close:function(l,a){n=!0,u&&(clearTimeout(u),u=null),t&&t.close(l||1e3,a||""),d.status="closed"}};function y(l){if(typeof l!="string")return l;try{return JSON.parse(l)}catch{return l}}function p(){!e.reconnect||r>=e.maxReconnectAttempts||(r++,d.status="reconnecting",u=setTimeout(function(){u=null,v()},i),i=Math.min(i*2,e.maxReconnectDelay))}function v(){d.status=r>0?"reconnecting":"connecting";try{t=new WebSocket(o,e.protocols)}catch{d.status="closed";return}t.onopen=function(){d.status="open",r=0,i=e.reconnectDelay,e.onOpen();for(let l of c.open)l()},t.onmessage=function(l){let a=y(l.data);for(let f of c.message)f(a)},t.onclose=function(l){d.status="closed",e.onClose(l.code,l.reason);for(let a of c.close)a(l.code,l.reason);n||p()},t.onerror=function(l){e.onError(l);for(let a of c.error)a(l)}}return v(),d}function D(o,s){let e={reconnect:!0,reconnectDelay:1e3,maxReconnectDelay:3e4,maxReconnectAttempts:1/0,events:[],json:!0,onOpen:function(){},onClose:function(){},onError:function(){},...s||{}},t=null,n=!1,i=e.reconnectDelay,r=0,u=null,c={message:[],open:[],close:[],error:[]},d={status:"connecting",on:function(a,f){return c[a]||(c[a]=[]),c[a].push(f),function(){let m=c[a],E=m.indexOf(f);E>=0&&m.splice(E,1)}},close:function(){n=!0,u&&(clearTimeout(u),u=null),t&&(t.close(),t=null),d.status="closed"}};function y(a){if(!e.json)return a;try{return JSON.parse(a)}catch{return a}}function p(a,f){for(let m of c.message)m(a,f||void 0)}function v(){!e.reconnect||r>=e.maxReconnectAttempts||(r++,d.status="reconnecting",u=setTimeout(function(){u=null,l()},i),i=Math.min(i*2,e.maxReconnectDelay))}function l(){d.status=r>0?"reconnecting":"connecting";try{t=new EventSource(o)}catch{d.status="closed";return}t.onopen=function(){d.status="open",r=0,i=e.reconnectDelay,e.onOpen();for(let a of c.open)a(null)},t.onmessage=function(a){p(y(a.data),null)};for(let a of e.events)t.addEventListener(a,function(f){p(y(f.data),a)});t.onerror=function(a){e.onError(a);for(let f of c.error)f(a);if(t&&t.readyState===2){t=null,d.status="closed",e.onClose();for(let f of c.close)f(null);n||v()}}}return l(),d}var W={set:function(o,s,e){let t="";if(e){let n=new Date;n.setTime(n.getTime()+e*24*60*60*1e3),t="; expires="+n.toUTCString()}document.cookie=o+"="+(s||"")+t+"; path=/"},get:function(o){let s=o+"=",e=document.cookie.split(";");for(let t=0;t<e.length;t++){let n=e[t];for(;n.charAt(0)===" ";)n=n.substring(1);if(n.indexOf(s)===0)return n.substring(s.length)}return null},remove:function(o){document.cookie=o+"=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/"}};function A(o,s){let e=document.getElementById("message");if(!e)return;let t=s||"info";e.innerHTML='<div class="alert alert-'+t+' alert-dismissible">'+o+'<button type="button" class="btn-close" data-t4-dismiss="alert">&times;</button></div>'}function I(o,s,e,t){let n=window.screenLeft!==void 0?window.screenLeft:window.screenX,i=window.screenTop!==void 0?window.screenTop:window.screenY,r=window.innerWidth||document.documentElement.clientWidth||screen.width,u=window.innerHeight||document.documentElement.clientHeight||screen.height,c=r/window.screen.availWidth,d=(r-e)/2/c+n,y=(u-t)/2/c+i,p=window.open(o,s,"directories=no,toolbar=no,location=no,status=no,menubar=no,scrollbars=yes,resizable=yes,width="+e/c+",height="+t/c+",top="+y+",left="+d);return window.focus&&p&&p.focus(),p}function N(o){if(o.indexOf("No data available")>=0){window.alert("No data available for this report.");return}window.open(o,"_blank","toolbar=no,scrollbars=yes,resizable=yes,width=800,height=600,top=0,left=0")}function U(o,s,e,t){w(o,{method:"POST",body:{query:s,variables:e||{}},onSuccess:function(n){t&&t(n.data||null,n.errors||void 0)},onError:function(n){t&&t(null,[{message:"GraphQL request failed with status "+n}])}})}var R={request:w,load:H,post:S,inject:h,form:T,ws:L,sse:D,cookie:W,message:A,popup:I,report:N,graphql:U,get token(){return g},set token(o){g=o}};typeof window<"u"&&(window.frond=R);return q(j);})();
-/* Frond v2.1.3 — tina4.com */