ourui 0.3.2__tar.gz → 0.3.3__tar.gz

{ourui-0.3.2 → ourui-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ourui
-Version: 0.3.2
+Version: 0.3.3
 Summary: Python-first UI compiler — write intent in Python, emit HTML/CSS/JS
 Author: OurUI contributors
 License: MIT License
@@ -46,7 +46,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# ourui 0.3.2
+# ourui 0.3.3
 
 Python package for the **OurUI** compiler and runtime.
 

{ourui-0.3.2 → ourui-0.3.3}/README.md

@@ -1,4 +1,4 @@
-# ourui 0.3.2
+# ourui 0.3.3
 
 Python package for the **OurUI** compiler and runtime.
 

{ourui-0.3.2 → ourui-0.3.3}/ourui/analysis/__init__.py

@@ -10,7 +10,14 @@ from ourui.analysis.components import (
     component_call_name,
     expand_component_call,
 )
-from ourui.node import FORM_CONTROL_KINDS, INPUT_TYPES, THEME_ATTR_KEYS, Node
+from ourui.node import (
+    FORM_CONTROL_KINDS,
+    INPUT_TYPES,
+    NAV_PLACEMENTS,
+    NAV_TONES,
+    THEME_ATTR_KEYS,
+    Node,
+)
 from ourui.parse import call_kind, literal_value, parse_file, span_for
 from ourui.theme import apply_theme_overrides, default_tokens, theme_kwargs_to_overrides
 
@@ -219,6 +226,39 @@ class _GraphBuilder:
                     if cid:
                         child_ids.append(cid)
                 continue
+            if kind == "Nav" and kw.arg == "brand" and isinstance(kw.value, ast.Call):
+                cid = self.build_call(kw.value, parent_id=nid, expansion_trail=trail)
+                if cid:
+                    attrs["brand"] = cid
+                    child_ids.append(cid)
+                continue
+            if kind == "Nav" and kw.arg in {"items", "actions"}:
+                slot_ids: list[str] = []
+                val_node = kw.value
+                if isinstance(val_node, (ast.List, ast.Tuple)):
+                    for elt in val_node.elts:
+                        if isinstance(elt, ast.Call):
+                            cid = self.build_call(elt, parent_id=nid, expansion_trail=trail)
+                            if cid:
+                                slot_ids.append(cid)
+                                child_ids.append(cid)
+                elif isinstance(val_node, ast.Call):
+                    cid = self.build_call(val_node, parent_id=nid, expansion_trail=trail)
+                    if cid:
+                        slot_ids.append(cid)
+                        child_ids.append(cid)
+                attrs[kw.arg] = slot_ids
+                continue
+            if kind == "Nav" and kw.arg == "placement":
+                place = literal_value(kw.value)
+                if isinstance(place, str):
+                    attrs["placement"] = place if place in NAV_PLACEMENTS else "sticky-top"
+                continue
+            if kind == "Nav" and kw.arg == "tone":
+                tone = literal_value(kw.value)
+                if isinstance(tone, str):
+                    attrs["tone"] = tone if tone in NAV_TONES else "solid"
+                continue
             if kw.arg == "route" and kind == "Page":
                 route_val = literal_value(kw.value)
                 if isinstance(route_val, str):
@@ -255,6 +295,10 @@ class _GraphBuilder:
                     continue
             attrs[kw.arg] = literal_value(kw.value)
 
+        if kind == "Nav":
+            attrs.setdefault("placement", "sticky-top")
+            attrs.setdefault("tone", "solid")
+
         provenance = ["parse:ui_call", "analyze:semantic_graph", *[f"expand:{n}" for n in trail]]
         node = Node(
             id=nid,

{ourui-0.3.2 → ourui-0.3.3}/ourui/emit/html.py

@@ -13,6 +13,7 @@ _ROLE_TAG: dict[str, str] = {
     "hero": "header",
     "section": "section",
     "shell": "div",
+    "nav": "nav",
     "card": "div",
     "grid": "div",
     "text": "span",
@@ -158,10 +159,84 @@ input.ourui-slider {
   max-width: 24rem;
   accent-color: var(--ourui-primary);
 }
+.ourui-nav {
+  display: flex;
+  align-items: center;
+  gap: var(--ourui-space-md);
+  flex-wrap: wrap;
+  width: 100%;
+  box-sizing: border-box;
+  padding: var(--ourui-space-sm) var(--ourui-space-md);
+  z-index: 40;
+}
+.ourui-nav-brand {
+  display: flex;
+  align-items: center;
+  gap: var(--ourui-space-sm);
+  font-weight: 600;
+}
+.ourui-nav-items {
+  display: flex;
+  align-items: center;
+  gap: var(--ourui-space-md);
+  flex: 1 1 auto;
+  flex-wrap: wrap;
+}
+.ourui-nav-actions {
+  display: flex;
+  align-items: center;
+  gap: var(--ourui-space-sm);
+  margin-inline-start: auto;
+}
+.ourui-nav-solid {
+  background: var(--ourui-card);
+  color: var(--ourui-card-fg);
+  border-bottom: 1px solid var(--ourui-border);
+}
+.ourui-nav-glass {
+  background: color-mix(in srgb, var(--ourui-card) 72%, transparent);
+  color: var(--ourui-card-fg);
+  border-bottom: 1px solid var(--ourui-border);
+  backdrop-filter: blur(10px);
+  -webkit-backdrop-filter: blur(10px);
+}
+.ourui-nav-sticky-top {
+  position: sticky;
+  top: 0;
+}
+.ourui-nav-fixed-top {
+  position: fixed;
+  inset-inline: 0;
+  top: 0;
+}
+.ourui-nav-fixed-bottom {
+  position: fixed;
+  inset-inline: 0;
+  bottom: 0;
+  border-bottom: none;
+  border-top: 1px solid var(--ourui-border);
+}
+.ourui-nav-flow {
+  position: static;
+}
+.ourui-nav-overlay {
+  position: absolute;
+  inset-inline: 0;
+  top: 0;
+}
+.ourui-nav-backdrop {
+  position: absolute;
+  inset: 0;
+  z-index: 0;
+  pointer-events: none;
+}
+.ourui-root:has(.ourui-nav-fixed-top) {
+  padding-top: 3.75rem;
+}
 """
 # Tone classes above use CSS vars seeded from Resolved Design (Host Contract).
 # Per-node rules from Resolved Design override for concrete fill/fg/radius/pad.
-# Form control chrome is host-private layout — not Design System.
+# Form control + Nav chrome is host-private layout — not Design System.
 
 def _as_resolved_design(resolved_design: Any) -> dict[str, Any] | None:
     if resolved_design is None:
@@ -247,16 +322,17 @@ def _classes_for(node: dict[str, Any]) -> list[str]:
     shell = attrs.get("shell_layout")
     role = attrs.get("role", "")
     classes: list[str] = []
-    if shell == "split-3":
-        classes.append("ourui-shell-split-3")
-    elif shell == "stack":
-        classes.append("ourui-shell-stack")
-    elif layout == "vertical":
-        classes.append("ourui-col")
-    elif layout == "horizontal":
-        classes.append("ourui-row")
-    elif layout == "grid":
-        classes.append("ourui-grid")
+    if role != "nav":
+        if shell == "split-3":
+            classes.append("ourui-shell-split-3")
+        elif shell == "stack":
+            classes.append("ourui-shell-stack")
+        elif layout == "vertical":
+            classes.append("ourui-col")
+        elif layout == "horizontal":
+            classes.append("ourui-row")
+        elif layout == "grid":
+            classes.append("ourui-grid")
     if role == "card":
         classes.append("ourui-card")
     if role == "link":
@@ -277,6 +353,12 @@ def _classes_for(node: dict[str, Any]) -> list[str]:
         classes.append("ourui-toggle")
     if role == "slider":
         classes.append("ourui-slider")
+    if role == "nav":
+        classes.append("ourui-nav")
+        placement = attrs.get("placement") or "sticky-top"
+        tone = attrs.get("tone") or "solid"
+        classes.append(f"ourui-nav-{placement}")
+        classes.append(f"ourui-nav-{tone}")
     if (
         node["kind"] == "Leaf"
         and "ourui-control" not in classes
@@ -285,6 +367,7 @@ def _classes_for(node: dict[str, Any]) -> list[str]:
         and "ourui-select" not in classes
         and "ourui-toggle" not in classes
         and "ourui-slider" not in classes
+        and "ourui-nav" not in classes
     ):
         classes.append("ourui-leaf")
     return classes
@@ -454,6 +537,42 @@ def _render_node(nid: str, nodes: dict[str, dict[str, Any]], indent: int) -> lis
         attrs = f"{class_attr}{data_role}{data_id}{field}{events}"
         return _wrap_field(pad, node_attrs.get("label"), [f"<input{attrs} />"])
 
+    if role == "nav":
+        attrs = f"{class_attr}{data_role}{data_id}{events}"
+        brand = node_attrs.get("brand")
+        items = node_attrs.get("items") if isinstance(node_attrs.get("items"), list) else []
+        actions = node_attrs.get("actions") if isinstance(node_attrs.get("actions"), list) else []
+        slotted = set()
+        if isinstance(brand, str):
+            slotted.add(brand)
+        slotted.update(i for i in items if isinstance(i, str))
+        slotted.update(a for a in actions if isinstance(a, str))
+
+        def _slot(title: str, ids: list[str]) -> list[str]:
+            if not ids:
+                return []
+            out = [f'{pad}  <div class="ourui-nav-{title}">']
+            for cid in ids:
+                if cid in nodes:
+                    out.extend(_render_node(cid, nodes, indent + 2))
+            out.append(f"{pad}  </div>")
+            return out
+
+        lines = [f"{pad}<nav{attrs}>"]
+        if isinstance(brand, str) and brand in nodes:
+            lines.append(f'{pad}  <div class="ourui-nav-brand">')
+            lines.extend(_render_node(brand, nodes, indent + 2))
+            lines.append(f"{pad}  </div>")
+        lines.extend(_slot("items", [i for i in items if isinstance(i, str)]))
+        lines.extend(_slot("actions", [a for a in actions if isinstance(a, str)]))
+        # Positional children not assigned to slots
+        for child_id in node.get("children", []):
+            if child_id in slotted or child_id not in nodes:
+                continue
+            lines.extend(_render_node(child_id, nodes, indent + 1))
+        lines.append(f"{pad}</nav>")
+        return lines
+
     children = node.get("children", [])
     attrs = f"{class_attr}{data_role}{data_id}{link}{events}"
 

{ourui-0.3.2 → ourui-0.3.3}/ourui/lowering/layout.py

@@ -11,6 +11,7 @@ _LAYOUT_KIND: dict[str, str] = {
     "Hero": "Column",
     "Section": "Column",
     "Shell": "Row",
+    "Nav": "Row",
     "Grid": "Grid",
     "Card": "Box",
     "Button": "Box",
@@ -56,6 +57,11 @@ _PASSTHROUGH_PROPS = (
     "min",
     "max",
     "step",
+    "placement",
+    "tone",
+    "brand",
+    "items",
+    "actions",
 )
 
 

{ourui-0.3.2 → ourui-0.3.3}/ourui/lowering/presentation.py

@@ -12,6 +12,7 @@ _PRESENTATION_KINDS = frozenset(
         "Hero",
         "Section",
         "Shell",
+        "Nav",
         "Button",
         "Text",
         "Card",
@@ -42,6 +43,11 @@ _PASSTHROUGH = (
     "min",
     "max",
     "step",
+    "placement",
+    "tone",
+    "brand",
+    "items",
+    "actions",
 )
 
 

{ourui-0.3.2 → ourui-0.3.3}/ourui/lowering/render.py

@@ -83,6 +83,11 @@ def lower_to_rtr(ltr: Any) -> RTR:
             "min",
             "max",
             "step",
+            "placement",
+            "tone",
+            "brand",
+            "items",
+            "actions",
         ):
             if key in attrs:
                 props[key] = attrs[key]
@@ -149,6 +154,7 @@ def _role_for(from_intent: str) -> str:
         "Hero": "hero",
         "Section": "section",
         "Shell": "shell",
+        "Nav": "nav",
         "Button": "button",
         "Card": "card",
         "Text": "text",

{ourui-0.3.2 → ourui-0.3.3}/ourui/lsp/completions.py

@@ -21,6 +21,7 @@ UI_COMPONENTS: dict[str, str] = {
     "Grid": "Layout grid container.",
     "Link": "Presentation domain navigation anchor (href).",
     "Shell": "Intent domain layout region (layout=stack|row|split-3|grid).",
+    "Nav": "Chrome bar; placement= + tone=solid|glass; brand/items/actions slots.",
     "Theme": "Design token overrides for --ourui-* CSS variables.",
 }
 

{ourui-0.3.2 → ourui-0.3.3}/ourui/node.py

@@ -60,7 +60,7 @@ class Node:
         }
 
 
-INTENT_KINDS = frozenset({"Page", "Hero", "Section", "Shell"})
+INTENT_KINDS = frozenset({"Page", "Hero", "Section", "Shell", "Nav"})
 PRESENTATION_KINDS = frozenset(
     {"Button", "Text", "Card", "Grid", "Link", "Input", "Select", "Toggle", "Slider"}
 )
@@ -75,4 +75,10 @@ FORM_CONTROL_KINDS = frozenset({"Input", "Select", "Toggle", "Slider"})
 # Input type= enum (S2)
 INPUT_TYPES = frozenset({"text", "email", "password", "number", "search", "url", "tel"})
 
+# Nav chrome (S3a)
+NAV_PLACEMENTS = frozenset(
+    {"flow", "sticky-top", "fixed-top", "fixed-bottom", "overlay", "backdrop"}
+)
+NAV_TONES = frozenset({"solid", "glass"})
+
 THEME_ATTR_KEYS = frozenset({"variant", "color", "bg", "theme"})

{ourui-0.3.2 → ourui-0.3.3}/ourui/pipeline.py

@@ -53,7 +53,7 @@ def compile_dump(path: str | Path) -> dict[str, Any]:
     path = Path(path)
     artifacts = compile_to_rtr(path)
     return {
-        "version": 14,
+        "version": 15,
         "source": artifacts["source"],
         "semantic_graph": artifacts["semantic_graph"].to_dict(),
         "dependency_graph": artifacts["dependency_graph"].to_dict(),

{ourui-0.3.2 → ourui-0.3.3}/ourui.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ourui
-Version: 0.3.2
+Version: 0.3.3
 Summary: Python-first UI compiler — write intent in Python, emit HTML/CSS/JS
 Author: OurUI contributors
 License: MIT License
@@ -46,7 +46,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# ourui 0.3.2
+# ourui 0.3.3
 
 Python package for the **OurUI** compiler and runtime.
 

{ourui-0.3.2 → ourui-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ourui"
-version = "0.3.2"
+version = "0.3.3"
 description = "Python-first UI compiler — write intent in Python, emit HTML/CSS/JS"
 readme = "README.md"
 license = { file = "LICENSE" }