@qingflow-tech/qingflow-app-user-mcp 1.0.10 → 1.0.11

package/src/qingflow_mcp/solution/compiler/icon_utils.py

@@ -5,6 +5,215 @@ import re
 
 
 DEFAULT_ICON_COLOR = "qing-orange"
+WORKSPACE_ICON_COLORS: tuple[str, ...] = (
+    "qing-orange",
+    "yellow",
+    "green",
+    "emerald",
+    "blue",
+    "azure",
+    "indigo",
+    "qing-purple",
+    "purple",
+    "pink",
+    "red",
+    "orange",
+)
+WORKSPACE_ICON_NAMES: tuple[str, ...] = (
+    "user",
+    "user-group",
+    "user-remove",
+    "user-add",
+    "user-circle",
+    "base-camera",
+    "view-grid",
+    "inbox",
+    "inbox-in",
+    "share",
+    "sitemap",
+    "airplane",
+    "template",
+    "music-note",
+    "movie-play",
+    "clock",
+    "document",
+    "document-search",
+    "clipboard-check",
+    "document-download",
+    "document-text",
+    "clipboard-copy",
+    "presentation-chart-bar",
+    "chart-square-bar",
+    "database",
+    "server",
+    "calendar",
+    "mail",
+    "annotation",
+    "chat",
+    "bell",
+    "key",
+    "shopping-bag",
+    "download",
+    "eye",
+    "eye-off",
+    "emoji-happy",
+    "emoji-sad",
+    "sun",
+    "moon",
+    "cloud",
+    "lightning-bolt",
+    "fire",
+    "star",
+    "sparkles",
+    "heart",
+    "cake",
+    "gift",
+    "light-bulb",
+    "exclamation",
+    "cog",
+    "thumb-up",
+    "thumb-down",
+    "cloud-download",
+    "cloud-upload",
+    "printer",
+    "phone-incoming",
+    "phone-missed-call",
+    "terminal",
+    "search-circle",
+    "x-circle",
+    "check-circle",
+    "exclamation-circle",
+    "question-mark-circle",
+    "information-circle",
+    "academic-cap",
+    "briefcase",
+    "home",
+    "phone",
+    "photograph",
+    "puzzle",
+    "color-swatch",
+    "lock-open",
+    "lock-closed",
+    "shield-check",
+    "shield-exclamation",
+    "currency-dollar",
+    "currency-yen",
+    "globe",
+    "at-symbol",
+    "slack",
+    "microphone",
+    "speakerphone",
+    "trash",
+    "book-open",
+    "truck",
+    "filter",
+    "essetional-filter-search",
+    "essetional-filter-tick",
+    "table",
+    "calculator",
+    "location-radar",
+    "essetional-weight",
+    "school-award",
+    "comp-cloud-connection",
+    "comp-cloud-remove",
+    "comp-cpu-charge",
+    "comp-cpu-setting",
+    "comp-cpu",
+    "comp-devices",
+    "comp-driver-2",
+    "comp-driver-refresh",
+    "location-global",
+    "location-location",
+    "location-map",
+    "location-gps",
+    "essetional-ranking",
+    "chart-bar",
+    "business-graph",
+    "business-status-up",
+    "business-trend-down",
+    "business-trend-up",
+    "business-presention-chart",
+    "business-favorite-chart",
+    "business-health",
+    "receipt-refund",
+    "receipt-tax",
+    "money-receipt-2-1",
+    "money-transaction-minus",
+    "action-hourglass-full",
+    "action-work",
+    "bug-f",
+    "essetional-pet",
+    "files-folder",
+    "badge-check",
+    "money-wallet-1",
+    "money-ticket",
+    "money-money",
+    "money-tag",
+    "money-wallet-2",
+    "business-personalcard",
+    "car-airplane",
+    "car-bus",
+    "car-car",
+    "car-driving",
+    "car-gas-station",
+    "car-smart-car",
+    "car-ship",
+    "location-map-1",
+    "location-route-square",
+    "cone",
+    "design-brush-4",
+    "paint-roll",
+    "wrench-f",
+    "essetional-reserve",
+    "essetional-broom",
+    "design-brush-2",
+    "essetional-judge",
+    "design-bucket",
+    "palette",
+    "comp-electricity",
+    "vial",
+    "beaker",
+    "leaf-f",
+    "cursor-click",
+    "solid-search-alt-2",
+    "md-library",
+    "building-3",
+    "office-building",
+    "building-hospital",
+    "school",
+    "store",
+    "video-camera-vintage-f",
+    "comp-monitor",
+    "delivery-truck",
+    "delivery-box-1",
+    "delivery-box-add",
+    "delivery-box-remove",
+    "settings-setting-3",
+    "document-duplicate",
+    "essetional-flag-2",
+    "flag",
+    "icon-currency-dollar",
+    "clipboard-list",
+    "save-as",
+    "wifi",
+    "status-online",
+    "scissors",
+    "globe-alt",
+    "ban",
+    "finger-print",
+    "qrcode",
+    "paper-clip",
+    "translate",
+    "cube-transparent",
+    "variable",
+    "switch-vertical",
+    "sports-baseball",
+    "sports-basketball",
+    "sports-soccer",
+    "sports-football",
+    "sports-volleyball",
+)
+GENERIC_WORKSPACE_ICON_NAMES: tuple[str, ...] = ("template",)
 DEFAULT_ICON_STYLE_POOL: tuple[tuple[str, str], ...] = (
     ("briefcase", "qing-orange"),
     ("calendar", "emerald"),
@@ -115,6 +324,91 @@ def parse_workspace_icon(value: str | None) -> tuple[str | None, str | None, str
     return normalize_workspace_icon_name(stripped), None, None
 
 
+def workspace_icon_config(value: str | None) -> dict[str, str | None]:
+    icon_name, icon_color, icon_text = parse_workspace_icon(value)
+    raw = str(value).strip() if value not in (None, "") else None
+    return {
+        "icon_name": icon_name,
+        "icon_color": icon_color,
+        "icon_text": icon_text,
+        "raw": raw,
+    }
+
+
+def workspace_icon_catalog_payload() -> dict[str, object]:
+    return {
+        "icon_names": list(WORKSPACE_ICON_NAMES),
+        "icon_colors": list(WORKSPACE_ICON_COLORS),
+        "generic_icon_names": list(GENERIC_WORKSPACE_ICON_NAMES),
+        "notes": [
+            "Use explicit icon + color for app/package/portal creation.",
+            "Do not use template for newly created workspace resources.",
+            "The CLI validates candidates only; it does not infer an icon from business names.",
+        ],
+        "common_examples": {
+            "employee": ["business-personalcard", "user-group", "user"],
+            "task": ["clipboard-check", "action-work"],
+            "worklog": ["clock", "action-hourglass-full"],
+            "order": ["delivery-box-1", "shopping-bag"],
+            "payment": ["money-receipt-2-1", "money-wallet-1"],
+            "opportunity": ["business-graph", "business-trend-up"],
+            "dashboard": ["view-grid", "chart-square-bar", "presentation-chart-bar"],
+        },
+    }
+
+
+def validate_workspace_icon_choice(
+    *,
+    icon: str | None,
+    color: str | None,
+    require_explicit: bool,
+    disallow_generic: bool,
+) -> tuple[bool, str | None, str | None, dict[str, object]]:
+    normalized_icon = _normalize_workspace_icon_candidate(icon)
+    normalized_color = str(color or "").strip() or None
+    details: dict[str, object] = {
+        "icon": icon,
+        "normalized_icon": normalized_icon,
+        "color": color,
+        "icon_catalog_command": "qingflow --json builder icon catalog",
+    }
+    if require_explicit and not normalized_icon:
+        return False, "WORKSPACE_ICON_REQUIRED", "icon is required when creating a workspace resource", details
+    if require_explicit and not normalized_color:
+        return False, "WORKSPACE_ICON_COLOR_REQUIRED", "color is required when creating a workspace resource", details
+    if normalized_icon and normalized_icon not in WORKSPACE_ICON_NAMES:
+        details["allowed_icon_names"] = list(WORKSPACE_ICON_NAMES)
+        return False, "WORKSPACE_ICON_NOT_FOUND", "icon is not in the workspace icon catalog", details
+    if normalized_color and normalized_color not in WORKSPACE_ICON_COLORS:
+        details["allowed_icon_colors"] = list(WORKSPACE_ICON_COLORS)
+        return False, "WORKSPACE_ICON_COLOR_NOT_FOUND", "color is not in the workspace icon color catalog", details
+    if disallow_generic and normalized_icon in GENERIC_WORKSPACE_ICON_NAMES:
+        details["generic_icon_names"] = list(GENERIC_WORKSPACE_ICON_NAMES)
+        return False, "GENERIC_WORKSPACE_ICON_NOT_ALLOWED", "template is a generic icon and is not allowed for new workspace resources", details
+    return True, None, None, details
+
+
+def _normalize_workspace_icon_candidate(icon: str | None) -> str | None:
+    if not icon:
+        return None
+    raw = str(icon).strip()
+    if not raw:
+        return None
+    if _looks_like_icon_json(raw):
+        try:
+            payload = json.loads(raw)
+        except Exception:
+            return None
+        return _normalize_workspace_icon_candidate(payload.get("iconName"))
+    normalized = raw.lower()
+    if normalized in WORKSPACE_ICON_NAMES:
+        return normalized
+    legacy = LEGACY_EX_ICON_MAP.get(normalized)
+    if legacy in WORKSPACE_ICON_NAMES:
+        return legacy
+    return normalized
+
+
 def encode_workspace_icon_with_defaults(
     *,
     icon: str | None,