quantum-framework 0.15.0__tar.gz → 0.16.0__tar.gz

{quantum_framework-0.15.0/quantum_framework.egg-info → quantum_framework-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantum-framework
-Version: 0.15.0
+Version: 0.16.0
 Summary: Full-stack declarative framework for building web, desktop, and mobile applications
 Author-email: Daniel Gregorio <danielgregorio2611@gmail.com>
 License: MIT
@@ -42,6 +42,8 @@ Provides-Extra: admin
 Requires-Dist: sqlalchemy>=2.0; extra == "admin"
 Requires-Dist: PyJWT>=2.8; extra == "admin"
 Requires-Dist: cryptography>=42.0; extra == "admin"
+Provides-Extra: desktop
+Requires-Dist: pywebview>=5.0; extra == "desktop"
 Provides-Extra: websocket
 Requires-Dist: websockets>=12.0; extra == "websocket"
 Dynamic: license-file

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quantum-framework"
-version = "0.15.0"
+version = "0.16.0"
 description = "Full-stack declarative framework for building web, desktop, and mobile applications"
 readme = "README.md"
 license = {text = "MIT"}
@@ -58,6 +58,10 @@ admin = [
     "PyJWT>=2.8",
     "cryptography>=42.0",
 ]
+desktop = [
+    # `quantum desktop`: the native window around the application's server.
+    "pywebview>=5.0",
+]
 websocket = [
     # The transport behind q:websocket. Without it the tag registers a
     # connection and opens nothing — and says so, rather than pretending.

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/cli/commands/build.py

@@ -16,12 +16,12 @@ from quantum.cli.utils import get_console, find_project_root, find_q_files
 
 
 # Available build targets
-TARGETS = ['html', 'desktop', 'mobile', 'textual', 'all']
+TARGETS = ['html', 'mobile', 'textual', 'all']
 
 
 @click.command('build')
 @click.option('--target', '-t', type=click.Choice(TARGETS), default='html',
-              help='Build target (html, desktop, mobile, textual, all)')
+              help='Build target (html, mobile, textual, all)')
 @click.option('--output', '-o', type=click.Path(), default='./dist',
               help='Output directory')
 @click.option('--minify', is_flag=True, default=True, help='Minify output')
@@ -53,8 +53,6 @@ def build(
 
         quantum build
 
-        quantum build --target desktop
-
         quantum build --target all --output ./build
 
         quantum build --target mobile --no-minify
@@ -98,7 +96,7 @@ def build(
 
     # Determine targets to build
     if target == 'all':
-        targets_to_build = ['html', 'desktop', 'mobile', 'textual']
+        targets_to_build = ['html', 'mobile', 'textual']
     else:
         targets_to_build = [target]
 
@@ -247,12 +245,11 @@ def _build_application(
         from quantum.runtime.testing_builder import TestingBuilder
         builder = TestingBuilder()
         ext = '.py'
-    elif app_type == 'ui' or target in ('html', 'desktop', 'mobile', 'textual'):
+    elif app_type == 'ui' or target in ('html', 'mobile', 'textual'):
         builder = UIBuilder()
         # Map target to extension
         ext_map = {
             'html': '.html',
-            'desktop': '.py',
             'mobile': '.js',
             'textual': '.py',
         }

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/cli/runner.py

@@ -286,6 +286,7 @@ Examples:
   quantum run hello.q              # Execute component
   quantum admin                    # Start the Quantum Admin
   quantum console                  # The application's pages in the terminal
+  quantum desktop                  # The application's pages in a desktop window
   quantum run game.q --engine godot # Build Godot 4 project
   quantum run backup-job.q         # Execute job
   quantum deploy ./my-app          # Deploy application
@@ -341,6 +342,13 @@ Examples:
     console_parser.add_argument('path', nargs='?', default='/', help='Page to open (default: /)')
     console_parser.add_argument('--config', default='quantum.config.yaml', help='Config file')
 
+    # Desktop: the application's pages in a native window (UI-4)
+    desktop_parser = subparsers.add_parser('desktop', help="Open the application's pages in a desktop window")
+    desktop_parser.add_argument('path', nargs='?', default='/', help='Page to open (default: /)')
+    desktop_parser.add_argument('--config', default='quantum.config.yaml', help='Config file')
+    desktop_parser.add_argument('--width', type=int, default=1024, help='Window width (default: 1024)')
+    desktop_parser.add_argument('--height', type=int, default=720, help='Window height (default: 720)')
+
     # Admin command (the screens need the [admin] extra; checked when run)
     from quantum.cli.admin import create_admin_parser
     create_admin_parser(subparsers)
@@ -411,6 +419,10 @@ Examples:
         from quantum.runtime.ui_console import run_console
         sys.exit(run_console(args.config, args.path))
 
+    elif args.command == 'desktop':
+        from quantum.runtime.ui_desktop import run_desktop
+        sys.exit(run_desktop(args.config, args.path, width=args.width, height=args.height))
+
     elif args.command == 'admin':
         from quantum.cli.admin import handle_admin
         sys.exit(handle_admin(args))

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/core/ast_nodes.py

@@ -676,7 +676,7 @@ class OnEventNode(QuantumNode):
 
 # MIGRATED: SetNode and PersistNode moved to feature-based structure
 # Import from new location (Option C migration)
-from .features.state_management.src.ast_node import SetNode, PersistNode
+from .features.state_management.src.ast_node import SetNode
 
 
 class QueryNode(QuantumNode):

quantum_framework-0.16.0/quantum/core/docs_links.py

@@ -0,0 +1,8 @@
+"""Documentation pages that error messages point to (one place, one spelling)."""
+
+DOCS = 'https://danielgregorio.github.io/quantum'
+
+# EXEC-*: the order in which a page's parts run. The traps — a statement in
+# the markup, a variable the action cannot see, a guard reading the page —
+# all come from that order, so their messages send the reader here.
+HOW_A_PAGE_RUNS = f'{DOCS}/guide/how-a-page-runs'

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/core/features/state_management/src/ast_node.py

@@ -3,11 +3,6 @@ AST Node for State Management (q:set)
 
 This module contains the SetNode class, which represents the <q:set> tag
 for state management in Quantum Language.
-
-State Persistence Support:
-    - persist="local" - localStorage (browser) or file (desktop)
-    - persist="session" - sessionStorage (browser) or memory (desktop)
-    - persist="sync" - synchronized across tabs/windows (browser) or network (desktop)
 """
 
 from typing import Dict, Any, List, Optional
@@ -54,12 +49,6 @@ class SetNode(QuantumNode):
         self.key = None
         self.source = None
 
-        # State Persistence
-        self.persist: Optional[str] = None  # None, "local", "session", "sync"
-        self.persist_key: Optional[str] = None  # Custom storage key (defaults to name)
-        self.persist_encrypt: bool = False  # Encrypt persisted data
-        self.persist_ttl: Optional[int] = None  # TTL in seconds for cached persistence
-
     def to_dict(self) -> Dict[str, Any]:
         result = {
             "type": "set",
@@ -84,14 +73,6 @@ class SetNode(QuantumNode):
                 "maxlength": self.maxlength
             }
         }
-        # Add persistence info if enabled
-        if self.persist:
-            result["persistence"] = {
-                "scope": self.persist,
-                "key": self.persist_key or self.name,
-                "encrypt": self.persist_encrypt,
-                "ttl": self.persist_ttl
-            }
         return result
 
     def validate(self) -> List[str]:
@@ -136,93 +117,5 @@ class SetNode(QuantumNode):
             if self.maxlength and len(str(self.value)) > int(self.maxlength):
                 errors.append(f"Value length {len(str(self.value))} exceeds maxlength {self.maxlength}")
 
-        # Validar persist scope
-        if self.persist:
-            valid_persist_scopes = ['local', 'session', 'sync']
-            if self.persist not in valid_persist_scopes:
-                errors.append(f"Invalid persist scope: {self.persist}. Must be one of {valid_persist_scopes}")
-
-        return errors
-
-
-class PersistNode(QuantumNode):
-    """
-    Represents a <q:persist> - Explicit persistence configuration.
-
-    Allows fine-grained control over state persistence beyond the persist attribute on q:set.
-
-    Examples:
-      <q:persist scope="local" prefix="myapp_">
-        <q:var name="theme" />
-        <q:var name="locale" />
-      </q:persist>
-
-      <q:persist scope="sync" key="user_preferences" encrypt="true">
-        <q:var name="darkMode" />
-        <q:var name="fontSize" />
-      </q:persist>
-
-    Attributes:
-      scope: "local" (localStorage), "session" (sessionStorage), "sync" (cross-tab/network)
-      prefix: Optional prefix for all storage keys
-      key: If set, all vars are stored under this single key as an object
-      encrypt: Whether to encrypt persisted data
-      ttl: Time-to-live in seconds (for cache invalidation)
-      storage: Override storage backend ("localStorage", "indexedDB", "file", "db")
-    """
-
-    def __init__(
-        self,
-        scope: str = "local",
-        prefix: Optional[str] = None,
-        key: Optional[str] = None,
-        encrypt: bool = False,
-        ttl: Optional[int] = None,
-        storage: Optional[str] = None
-    ):
-        self.scope = scope
-        self.prefix = prefix
-        self.key = key
-        self.encrypt = encrypt
-        self.ttl = ttl
-        self.storage = storage
-        self.variables: List[str] = []  # List of variable names to persist
-
-    def add_variable(self, name: str):
-        """Add a variable name to persist."""
-        self.variables.append(name)
-
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            "type": "persist",
-            "scope": self.scope,
-            "prefix": self.prefix,
-            "key": self.key,
-            "encrypt": self.encrypt,
-            "ttl": self.ttl,
-            "storage": self.storage,
-            "variables": self.variables
-        }
-
-    def validate(self) -> List[str]:
-        errors = []
-
-        # Validate scope
-        valid_scopes = ['local', 'session', 'sync']
-        if self.scope not in valid_scopes:
-            errors.append(f"Invalid persist scope: {self.scope}. Must be one of {valid_scopes}")
-
-        # Validate storage backend if specified
-        if self.storage:
-            valid_storage = ['localStorage', 'sessionStorage', 'indexedDB', 'file', 'db']
-            if self.storage not in valid_storage:
-                errors.append(f"Invalid storage backend: {self.storage}. Must be one of {valid_storage}")
-
-        # Validate variables
-        if not self.variables:
-            errors.append("q:persist must contain at least one q:var element")
-
         return errors
 
-    def __repr__(self):
-        return f'<PersistNode scope={self.scope} vars={len(self.variables)}>'

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/core/features/ui_engine/src/ast_nodes.py

@@ -374,7 +374,7 @@ class UIValidatorNode(QuantumNode):
     Can be defined at form level (reusable) or inline in an input.
 
     Examples:
-        <ui:validator name="phone" pattern="^\d{10,11}$" message="Invalid phone number" />
+        <ui:validator name="phone" pattern="^\\d{10,11}$" message="Invalid phone number" />
         <ui:validator name="passwordMatch" field="password" match="confirm_password"
                       message="Passwords must match" />
         <ui:validator name="customEmail" type="email" message="Please enter a valid email" />
@@ -549,6 +549,7 @@ class UIInputNode(QuantumNode, UILayoutMixin):
 
     def __init__(self):
         self.bind: Optional[str] = None
+        self.value: Optional[str] = None  # initial value (UI-6)
         self.placeholder: Optional[str] = None
         self.input_type: str = "text"    # text, password, email, number
         self.on_change: Optional[str] = None
@@ -592,6 +593,7 @@ class UICheckboxNode(QuantumNode, UILayoutMixin):
 
     def __init__(self):
         self.bind: Optional[str] = None
+        self.checked: Optional[str] = None  # "true"/"false" or {expr} (UI-6)
         self.label: Optional[str] = None
         self._init_layout_attrs()
 
@@ -609,6 +611,7 @@ class UIRadioNode(QuantumNode, UILayoutMixin):
 
     def __init__(self):
         self.bind: Optional[str] = None
+        self.value: Optional[str] = None  # selected option (UI-6)
         self.options: Optional[str] = None  # comma-separated or source ref
         self._init_layout_attrs()
 
@@ -626,6 +629,7 @@ class UISwitchNode(QuantumNode, UILayoutMixin):
 
     def __init__(self):
         self.bind: Optional[str] = None
+        self.checked: Optional[str] = None  # "true"/"false" or {expr} (UI-6)
         self.label: Optional[str] = None
         self._init_layout_attrs()
 
@@ -643,6 +647,7 @@ class UISelectNode(QuantumNode, UILayoutMixin):
 
     def __init__(self):
         self.bind: Optional[str] = None
+        self.value: Optional[str] = None  # selected option (UI-6)
         self.options: Optional[str] = None
         self.source: Optional[str] = None
         self.children: List[QuantumNode] = []  # UIOptionNode children
@@ -667,6 +672,7 @@ class UITableNode(QuantumNode, UILayoutMixin):
 
     def __init__(self):
         self.source: Optional[str] = None
+        self.as_var: Optional[str] = None  # row variable for column content (UI-5)
         self.children: List[QuantumNode] = []  # UIColumnNode children
         self._init_layout_attrs()
 
@@ -691,6 +697,11 @@ class UIColumnNode(QuantumNode):
         self.label: Optional[str] = None
         self.column_width: Optional[str] = None
         self.align: Optional[str] = None  # left, center, right
+        # UI-5: a column with content draws it once per row (buttons, links).
+        self.children: List[QuantumNode] = []
+
+    def add_child(self, child: QuantumNode):
+        self.children.append(child)
 
     def to_dict(self) -> Dict[str, Any]:
         return {"type": "ui_column", "key": self.key,
@@ -1862,3 +1873,15 @@ class UIDatePickerNode(QuantumNode, UILayoutMixin):
 def is_ui_node(node) -> bool:
     """A ui:* element (UI-1): markup, drawn by a renderer, never executed."""
     return type(node).__module__ == __name__
+
+
+# UI-7: the elements every renderer draws — browser, console and desktop — with
+# the same meaning, checked by tests/apps/test_ui_paridade.py. The other ui:*
+# tags work in the browser only; the console says it cannot draw them.
+CORE_TAGS = frozenset({
+    'window', 'hbox', 'vbox', 'grid', 'panel', 'section', 'scrollbox', 'spacer', 'rule',
+    'header', 'footer', 'card', 'card-header', 'card-body', 'card-footer', 'tabpanel', 'tab',
+    'text', 'badge', 'alert', 'link', 'image', 'progress',
+    'table', 'column', 'list', 'item',
+    'form', 'formitem', 'input', 'checkbox', 'switch', 'radio', 'select', 'option', 'button',
+})

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/core/features/ui_engine/src/parser.py

@@ -31,6 +31,7 @@ from .ast_nodes import (
     UICalendarNode, UIDatePickerNode,
 )
 from quantum.core.features.theming.src import UIThemeNode, UIColorNode
+from quantum.core.ast_nodes import TextNode
 
 
 class UIParseError(Exception):
@@ -252,11 +253,20 @@ class UIParser:
         return None
 
     def _parse_children(self, element: ET.Element, node):
-        """Parse all children of an element, adding them to node."""
+        """Parse all children of an element, adding them to node.
+
+        UI-1: inside a page, a container's own text is content too
+        (`<ui:card-header>Resumo</ui:card-header>`); it used to vanish. Nodes
+        that keep their text in `content` read it themselves."""
+        texto_e_conteudo = self.page_mode and not hasattr(node, 'content')
+        if texto_e_conteudo and (element.text or '').strip():
+            node.add_child(TextNode(element.text.strip()))
         for child in element:
             parsed = self._parse_child(child)
             if parsed:
                 node.add_child(parsed)
+            if texto_e_conteudo and (child.tail or '').strip():
+                node.add_child(TextNode(child.tail.strip()))
 
     # ------------------------------------------------------------------
     # Containers
@@ -404,6 +414,7 @@ class UIParser:
     def _parse_ui_input(self, element: ET.Element) -> UIInputNode:
         node = UIInputNode()
         node.bind = element.get('bind')
+        node.value = element.get('value')
         node.placeholder = element.get('placeholder')
         node.input_type = element.get('type', 'text')
         node.on_change = element.get('on-change')
@@ -436,6 +447,7 @@ class UIParser:
     def _parse_ui_checkbox(self, element: ET.Element) -> UICheckboxNode:
         node = UICheckboxNode()
         node.bind = element.get('bind')
+        node.checked = element.get('checked')
         node.label = element.get('label')
         self._apply_layout_attrs(node, element)
         return node
@@ -443,6 +455,7 @@ class UIParser:
     def _parse_ui_radio(self, element: ET.Element) -> UIRadioNode:
         node = UIRadioNode()
         node.bind = element.get('bind')
+        node.value = element.get('value')
         node.options = element.get('options')
         self._apply_layout_attrs(node, element)
         return node
@@ -450,6 +463,7 @@ class UIParser:
     def _parse_ui_switch(self, element: ET.Element) -> UISwitchNode:
         node = UISwitchNode()
         node.bind = element.get('bind')
+        node.checked = element.get('checked')
         node.label = element.get('label')
         self._apply_layout_attrs(node, element)
         return node
@@ -457,6 +471,7 @@ class UIParser:
     def _parse_ui_select(self, element: ET.Element) -> UISelectNode:
         node = UISelectNode()
         node.bind = element.get('bind')
+        node.value = element.get('value')
         node.options = element.get('options')
         node.source = element.get('source')
         self._apply_layout_attrs(node, element)
@@ -467,6 +482,7 @@ class UIParser:
     def _parse_ui_table(self, element: ET.Element) -> UITableNode:
         node = UITableNode()
         node.source = element.get('source')
+        node.as_var = element.get('as')
         self._apply_layout_attrs(node, element)
         # Parse child <ui:column> elements
         self._parse_children(element, node)
@@ -478,6 +494,7 @@ class UIParser:
         node.label = element.get('label')
         node.column_width = element.get('width')
         node.align = element.get('align')
+        self._parse_children(element, node)
         return node
 
     def _parse_ui_list(self, element: ET.Element) -> UIListNode:
@@ -586,7 +603,7 @@ class UIParser:
         Parse <ui:validator> custom validation rule.
 
         Examples:
-            <ui:validator name="phone" pattern="^\d{10}$" message="Invalid phone" />
+            <ui:validator name="phone" pattern="^\\d{10}$" message="Invalid phone" />
             <ui:validator name="confirmPassword" match="password"
                           message="Passwords must match" />
             <ui:validator name="custom" expression="value.length > 5"

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/core/parser.py

@@ -31,7 +31,8 @@ from quantum.core.ast_nodes import (
 # Import feature AST nodes from their respective modules
 from quantum.core.features.conditionals.src.ast_node import IfNode
 from quantum.core.features.loops.src.ast_node import LoopNode
-from quantum.core.features.state_management.src.ast_node import SetNode, PersistNode
+from quantum.core.features.state_management.src.ast_node import SetNode
+from quantum.core.docs_links import HOW_A_PAGE_RUNS
 from quantum.core.features.functions.src.ast_node import FunctionNode, RestConfig
 from quantum.core.features.invocation.src.ast_node import InvokeNode
 from quantum.core.features.logging.src import LogNode, parse_log
@@ -109,7 +110,6 @@ def _create_parser_registry(parser: 'QuantumParser') -> ParserRegistry:
     from quantum.core.parsers.composition import ImportParser, SlotParser
     from quantum.core.parsers.functions import FunctionParser, ReturnParser, ParamParser
     from quantum.core.parsers.events import DispatchEventParser
-    from quantum.core.parsers.persistence import PersistParser
     from quantum.core.parsers.routing import RouteParser
     from quantum.core.parsers.messaging import MessageAckParser, MessageNackParser
     from quantum.core.parsers.scripting import PyDecoratorParser
@@ -170,8 +170,6 @@ def _create_parser_registry(parser: 'QuantumParser') -> ParserRegistry:
         # They are internal parsers used by FunctionParser and other parsers
         # Events
         DispatchEventParser(parser),
-        # Persistence
-        PersistParser(parser),
     ]
 
     registry.register_all(parsers)
@@ -482,7 +480,16 @@ class QuantumParser:
                     continue
                 anterior = child if nome == 'if' and self._is_quantum_tag(child) else None
 
+    # Tags that existed and were removed, with what to use instead.
+    REMOVED_TAGS = {
+        'persist': ('was removed in Quantum 0.16 (SET-2): it kept variables in the browser, '
+                    'and a page\'s variables live on the server, for one request. Keep what must '
+                    'last in session.x (per user) or in the database.'),
+    }
+
     def _unknown_tag_message(self, name: str) -> str:
+        if name in self.REMOVED_TAGS:
+            return f"<q:{name}> {self.REMOVED_TAGS[name]}"
         import difflib
         # Only Quantum tags: the registry also holds the HTML tag names, which
         # made <q:try> suggest <q:tr>.
@@ -681,7 +688,7 @@ class QuantumParser:
                         f'redirects, so it also runs before the page\'s q:action — where the page '
                         f'has not run and {{{nome}}} does not exist, and the guard would let the '
                         f'action through. Read the scope directly (e.g. session.x), or protect the '
-                        f'page with require_auth / require_role.')
+                        f'page with require_auth / require_role. See {HOW_A_PAGE_RUNS}')
 
     # Nodes the HTML renderer draws. Anything else inside markup is a statement,
     # and statements run in the execution pass, before the render pass sees
@@ -758,7 +765,8 @@ class QuantumParser:
                         raise QuantumParseError(
                             f'{tag(node)} inside {onde[1]} in <q:component name="{component.name}"> '
                             f'never runs: statements run before the page is rendered, and markup '
-                            f'is only rendered. Move it above the markup (or into a q:action).')
+                            f'is only rendered. Move it above the markup (or into a q:action). '
+                            f'See {HOW_A_PAGE_RUNS}')
                     nome = getattr(node, 'name', None)
                     # A running total read AFTER the loop is fine; a value the
                     # loop's own rows read is not.
@@ -767,7 +775,8 @@ class QuantumParser:
                             f'{tag(node)} inside a q:loop whose rows use {{{nome}}} in '
                             f'<q:component name="{component.name}">: the loop runs for every item '
                             f'before any row is rendered, so every row would show the last value. '
-                            f'Compute it in the expression instead, e.g. {{item.price * item.qty}}.')
+                            f'Compute it in the expression instead, e.g. {{item.price * item.qty}}. '
+                            f'See {HOW_A_PAGE_RUNS}')
                     continue
                 if isinstance(node, HTMLNode):
                     andar(filhos(node), onde if onde and onde[0] == 'markup' else ('markup', f'<{node.tag}>'))

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/core/parsers/control_flow/set_parser.py

@@ -79,16 +79,15 @@ class SetParser(BaseTagParser):
         set_node.key = self.get_attr(element, 'key')
         set_node.source = self.get_attr(element, 'source')
 
-        # State persistence
-        set_node.persist = self.get_attr(element, 'persist')
-        set_node.persist_key = self.get_attr(element, 'persistKey')
-        set_node.persist_encrypt = self.get_bool_attr(element, 'persistEncrypt', False)
-
-        persist_ttl = self.get_attr(element, 'persistTtl')
-        if persist_ttl:
-            try:
-                set_node.persist_ttl = int(persist_ttl)
-            except ValueError:
-                pass
+        # SET-2: browser persistence never ran in a page.
+        persist = [a for a in ('persist', 'persistKey', 'persistTtl', 'persistEncrypt')
+                   if element.get(a) is not None]
+        if persist:
+            from quantum.core.parser import QuantumParseError
+            raise QuantumParseError(
+                f'<q:set name="{set_node.name}"> {persist[0]}= was removed in Quantum 0.16: it '
+                f'kept the variable in the browser, and a page\'s variables live on the server, '
+                f'for one request. Keep what must last in session.{set_node.name} (per user) '
+                f'or in the database.')
 
         return set_node

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/core/tiers.py

@@ -31,7 +31,7 @@ EXPERIMENTAL = frozenset({
     "job", "schedule", "thread",
     "message", "queue", "subscribe", "messageAck", "messageNack",
     "websocket", "websocket-send", "websocket-close",
-    "mail", "file", "log", "dump", "persist",
+    "mail", "file", "log", "dump",
     "python", "pyclass", "pyimport", "class", "decorator", "pydecorator",
     "dispatchEvent", "transaction",
 })
@@ -140,6 +140,25 @@ def warn_app_type(app_type: str) -> None:
         )
 
 
+# UI-8: React Native translates the logic to JavaScript on its own — the
+# opposite of "one runtime, many renderers" — and phones are out of 1.0. It
+# stays to press on the language, like the games.
+LAB_UI_TARGETS = frozenset({"mobile", "react-native"})
+
+
+def warn_ui_target(target: str) -> None:
+    """One-time warning when a LABORATÓRIO UI target is built."""
+    key = f"ui-target:{target}"
+    if target not in LAB_UI_TARGETS or key in _warned:
+        return
+    _warned.add(key)
+    logger.warning(
+        "quantum run --target %s is LABORATÓRIO — it translates q:set and "
+        "q:function to JavaScript with no stability promise (SUPPORT_TIERS.md). "
+        "It may change or break without notice.", target
+    )
+
+
 def reset_warnings() -> None:
     """For tests, and for a reloading server."""
     _warned.clear()

{quantum_framework-0.15.0 → quantum_framework-0.16.0}/quantum/runtime/action_handler.py

@@ -143,8 +143,9 @@ class ActionHandler:
             # page's statements, so a variable the page sets is not here.
             mensagem = str(e)
             if 'is not defined' in mensagem:
+                from quantum.core.docs_links import HOW_A_PAGE_RUNS
                 mensagem += (". A q:action does not run the page's statements: "
-                             "query or compute what it needs inside the action")
+                             f"query or compute what it needs inside the action. See {HOW_A_PAGE_RUNS}")
             logger.exception(
                 "q:action %r failed: %s", getattr(action, 'name', '?'), mensagem
             )

quantum_framework-0.16.0/quantum/runtime/local_server.py

@@ -0,0 +1,28 @@
+"""The application's server on a free local port, for renderers that are not a browser.
+
+`quantum console` (UI-3) and `quantum desktop` (UI-4) open the whole
+application — pages, actions, sessions — through the same server that
+`quantum start` runs. Only the drawing differs; nothing of a page's logic runs
+anywhere else.
+"""
+
+import logging
+import threading
+from contextlib import contextmanager
+from typing import Iterator
+
+
+@contextmanager
+def local_server(config_path: str = 'quantum.config.yaml') -> Iterator[str]:
+    """Serve the application on 127.0.0.1 (a free port) in a thread; yield its base URL."""
+    from werkzeug.serving import make_server
+    from quantum.runtime.web_server import QuantumWebServer
+
+    logging.getLogger('werkzeug').setLevel(logging.ERROR)
+    app = QuantumWebServer(config_path).app
+    servidor = make_server('127.0.0.1', 0, app, threaded=True)
+    threading.Thread(target=servidor.serve_forever, daemon=True).start()
+    try:
+        yield f'http://127.0.0.1:{servidor.server_port}/'
+    finally:
+        servidor.shutdown()