"""Extension marketplace — UX Atelier : studio UI/UX pour l’agent. Outils : - ``ux_audit_html`` — audit structure / hiérarchie / accessibilité de base ; - ``ux_design_system`` — génère tokens CSS (couleurs, type, spacing) ; - ``ux_critique`` — critique structurée d’une page ou d’un CSS ; - ``ux_wireframe_spec`` — spécification wireframe JSON pour une intention. """ from __future__ import annotations import json import re from html.parser import HTMLParser from pathlib import Path _SKIP = {".git", "node_modules", "__pycache__", ".venv", "venv", "dist", "build"} class _DomProbe(HTMLParser): """Extracteur léger de signaux UX depuis du HTML.""" def __init__(self) -> None: super().__init__() self.tags: list[str] = [] self.headings: list[tuple[str, str]] = [] self.images_missing_alt = 0 self.images_total = 0 self.links = 0 self.buttons = 0 self.forms = 0 self.has_nav = False self.has_main = False self.has_footer = False self.has_h1 = False self.inline_styles = 0 self._capture: str | None = None self._buf: list[str] = [] def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None: self.tags.append(tag) ad = {k: (v or "") for k, v in attrs} if tag in {"h1", "h2", "h3", "h4", "h5", "h6"}: self._capture = tag self._buf = [] if tag == "h1": self.has_h1 = True if tag == "img": self.images_total += 1 if not ad.get("alt", "").strip(): self.images_missing_alt += 1 if tag == "a": self.links += 1 if tag == "button" or ad.get("role") == "button": self.buttons += 1 if tag == "form": self.forms += 1 if tag == "nav": self.has_nav = True if tag == "main": self.has_main = True if tag == "footer": self.has_footer = True if "style" in ad: self.inline_styles += 1 def handle_endtag(self, tag: str) -> None: if self._capture == tag: text = " ".join("".join(self._buf).split())[:120] self.headings.append((tag, text)) self._capture = None self._buf = [] def handle_data(self, data: str) -> None: if self._capture: self._buf.append(data) def register(workspace: Path) -> list: """Enregistre les outils UX Atelier.""" def _resolve(path: str) -> Path: p = Path(path).expanduser() return p.resolve() if p.is_absolute() else (workspace / path).resolve() def ux_audit_html(path: str = "index.html") -> str: """Audit UX/UI d’un fichier HTML (structure, a11y, densité, CTA). Args: path: Fichier HTML relatif au workspace ou absolu. """ target = _resolve(path) if not target.is_file(): return json.dumps({"error": f"fichier introuvable: {target}"}, ensure_ascii=False) html = target.read_text(encoding="utf-8", errors="replace") probe = _DomProbe() try: probe.feed(html) except Exception as exc: # noqa: BLE001 return json.dumps({"error": f"HTML illisible: {exc}"}, ensure_ascii=False) issues: list[dict] = [] score = 100 if not probe.has_h1: issues.append({"severity": "high", "code": "no_h1", "msg": "Aucun H1 — hiérarchie absente."}) score -= 15 h1s = [h for h in probe.headings if h[0] == "h1"] if len(h1s) > 1: issues.append({"severity": "med", "code": "multi_h1", "msg": f"{len(h1s)} H1 — un seul landmark titre."}) score -= 8 if not probe.has_main: issues.append({"severity": "med", "code": "no_main", "msg": "Pas de
— landmark sémantique manquant."}) score -= 8 if not probe.has_nav: issues.append({"severity": "low", "code": "no_nav", "msg": "Pas de