imhcode 1.0.0

package/skills/ui-ux-pro-max/scripts/search.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+import sys
+import io
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
+if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/skills/ui-ux-pro-max/skill.json

@@ -0,0 +1,41 @@
+{
+  "name": "ui-ux-pro-max",
+  "displayName": "UI/UX Pro Max",
+  "description": "AI-powered design intelligence with 67 UI styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 15+ tech stacks.",
+  "version": "2.5.0",
+  "author": "NextLevelBuilder",
+  "license": "MIT",
+  "homepage": "https://uupm.cc",
+  "repository": "https://github.com/nextlevelbuilder/ui-ux-pro-max-skill",
+  "keywords": [
+    "ui",
+    "ux",
+    "design",
+    "design-system",
+    "color-palette",
+    "typography",
+    "accessibility",
+    "ai-skill"
+  ],
+  "platforms": [
+    "claude",
+    "cursor",
+    "windsurf",
+    "copilot",
+    "kiro",
+    "roocode",
+    "kilocode",
+    "codex",
+    "qoder",
+    "gemini",
+    "trae",
+    "opencode",
+    "continue",
+    "codebuddy",
+    "droid",
+    "warp",
+    "augment",
+    "antigravity"
+  ],
+  "install": "npx uipro-cli init --ai {{platform}}"
+}

package/skills/ui-ux-pro-max/src/ui-ux-pro-max/data/_sync_all.py

@@ -0,0 +1,414 @@
+#!/usr/bin/env python3
+"""
+Sync colors.csv and ui-reasoning.csv with the updated products.csv (161 entries).
+- Remove deleted product types
+- Rename mismatched entries
+- Add new entries for missing product types
+- Keep colors.csv aligned 1:1 with products.csv
+- Renumber everything
+"""
+import csv, os, json
+
+BASE = os.path.dirname(os.path.abspath(__file__))
+
+# ─── Color derivation helpers ────────────────────────────────────────────────
+def h2r(h):
+    h = h.lstrip("#")
+    return tuple(int(h[i:i+2], 16) for i in (0, 2, 4))
+
+def r2h(r, g, b):
+    return f"#{max(0,min(255,int(r))):02X}{max(0,min(255,int(g))):02X}{max(0,min(255,int(b))):02X}"
+
+def lum(h):
+    r, g, b = [x/255.0 for x in h2r(h)]
+    r, g, b = [(x/12.92 if x<=0.03928 else ((x+0.055)/1.055)**2.4) for x in (r, g, b)]
+    return 0.2126*r + 0.7152*g + 0.0722*b
+
+def is_dark(bg):
+    return lum(bg) < 0.18
+
+def on_color(bg):
+    return "#FFFFFF" if lum(bg) < 0.4 else "#0F172A"
+
+def blend(a, b, f=0.15):
+    ra, ga, ba = h2r(a)
+    rb, gb, bb = h2r(b)
+    return r2h(ra+(rb-ra)*f, ga+(gb-ga)*f, ba+(bb-ba)*f)
+
+def shift(h, n):
+    r, g, b = h2r(h)
+    return r2h(r+n, g+n, b+n)
+
+def derive_row(pt, pri, sec, acc, bg, notes=""):
+    """Generate full 16-token color row from 4 base colors."""
+    dark = is_dark(bg)
+    fg = "#FFFFFF" if dark else "#0F172A"
+    on_pri = on_color(pri)
+    on_sec = on_color(sec)
+    on_acc = on_color(acc)
+    card = shift(bg, 10) if dark else "#FFFFFF"
+    card_fg = "#FFFFFF" if dark else "#0F172A"
+    muted = blend(bg, pri, 0.08) if dark else blend("#FFFFFF", pri, 0.06)
+    muted_fg = "#94A3B8" if dark else "#64748B"
+    border = f"rgba(255,255,255,0.08)" if dark else blend("#FFFFFF", pri, 0.12)
+    destr = "#DC2626"
+    on_destr = "#FFFFFF"
+    ring = pri
+    return [pt, pri, on_pri, sec, on_sec, acc, on_acc, bg, fg, card, card_fg, muted, muted_fg, border, destr, on_destr, ring, notes]
+
+# ─── Rename maps ─────────────────────────────────────────────────────────────
+COLOR_RENAMES = {
+    "Quantum Computing": "Quantum Computing Interface",
+    "Biohacking / Longevity": "Biohacking / Longevity App",
+    "Autonomous Systems": "Autonomous Drone Fleet Manager",
+    "Generative AI Art": "Generative Art Platform",
+    "Spatial / Vision OS": "Spatial Computing OS / App",
+    "Climate Tech": "Sustainable Energy / Climate Tech",
+}
+UI_RENAMES = {
+    "Architecture/Interior": "Architecture / Interior",
+    "Autonomous Drone Fleet": "Autonomous Drone Fleet Manager",
+    "B2B SaaS Enterprise": "B2B Service",
+    "Biohacking/Longevity App": "Biohacking / Longevity App",
+    "Biotech/Life Sciences": "Biotech / Life Sciences",
+    "Developer Tool/IDE": "Developer Tool / IDE",
+    "Education": "Educational App",
+    "Fintech (Banking)": "Fintech/Crypto",
+    "Government/Public": "Government/Public Service",
+    "Home Services": "Home Services (Plumber/Electrician)",
+    "Micro-Credentials/Badges": "Micro-Credentials/Badges Platform",
+    "Music/Entertainment": "Music Streaming",
+    "Quantum Computing": "Quantum Computing Interface",
+    "Real Estate": "Real Estate/Property",
+    "Remote Work/Collaboration": "Remote Work/Collaboration Tool",
+    "Restaurant/Food": "Restaurant/Food Service",
+    "SaaS Dashboard": "Analytics Dashboard",
+    "Space Tech/Aerospace": "Space Tech / Aerospace",
+    "Spatial Computing OS": "Spatial Computing OS / App",
+    "Startup Landing": "Micro SaaS",
+    "Sustainable Energy/Climate": "Sustainable Energy / Climate Tech",
+    "Travel/Tourism": "Travel/Tourism Agency",
+    "Wellness/Mental Health": "Mental Health App",
+}
+
+REMOVE_TYPES = {
+    "Service Landing Page", "Sustainability/ESG Platform",
+    "Cleaning Service", "Coffee Shop",
+    "Consulting Firm", "Conference/Webinar Platform",
+}
+
+# ─── New color definitions: (primary, secondary, accent, bg, notes) ──────────
+# Grouped by category for clarity. Each tuple generates a full 16-token row.
+NEW_COLORS = {
+    # ── Old #97-#116 that never got colors ──
+    "Todo & Task Manager":         ("#2563EB","#3B82F6","#059669","#F8FAFC","Functional blue + progress green"),
+    "Personal Finance Tracker":    ("#1E40AF","#3B82F6","#059669","#0F172A","Trust blue + profit green on dark"),
+    "Chat & Messaging App":        ("#2563EB","#6366F1","#059669","#FFFFFF","Messenger blue + online green"),
+    "Notes & Writing App":         ("#78716C","#A8A29E","#D97706","#FFFBEB","Warm ink + amber accent on cream"),
+    "Habit Tracker":               ("#D97706","#F59E0B","#059669","#FFFBEB","Streak amber + habit green"),
+    "Food Delivery / On-Demand":   ("#EA580C","#F97316","#2563EB","#FFF7ED","Appetizing orange + trust blue"),
+    "Ride Hailing / Transportation":("#1E293B","#334155","#2563EB","#0F172A","Map dark + route blue"),
+    "Recipe & Cooking App":        ("#9A3412","#C2410C","#059669","#FFFBEB","Warm terracotta + fresh green"),
+    "Meditation & Mindfulness":    ("#7C3AED","#8B5CF6","#059669","#FAF5FF","Calm lavender + mindful green"),
+    "Weather App":                 ("#0284C7","#0EA5E9","#F59E0B","#F0F9FF","Sky blue + sun amber"),
+    "Diary & Journal App":         ("#92400E","#A16207","#6366F1","#FFFBEB","Warm journal brown + ink violet"),
+    "CRM & Client Management":     ("#2563EB","#3B82F6","#059669","#F8FAFC","Professional blue + deal green"),
+    "Inventory & Stock Management":("#334155","#475569","#059669","#F8FAFC","Industrial slate + stock green"),
+    "Flashcard & Study Tool":      ("#7C3AED","#8B5CF6","#059669","#FAF5FF","Study purple + correct green"),
+    "Booking & Appointment App":   ("#0284C7","#0EA5E9","#059669","#F0F9FF","Calendar blue + available green"),
+    "Invoice & Billing Tool":      ("#1E3A5F","#2563EB","#059669","#F8FAFC","Navy professional + paid green"),
+    "Grocery & Shopping List":     ("#059669","#10B981","#D97706","#ECFDF5","Fresh green + food amber"),
+    "Timer & Pomodoro":            ("#DC2626","#EF4444","#059669","#0F172A","Focus red on dark + break green"),
+    "Parenting & Baby Tracker":    ("#EC4899","#F472B6","#0284C7","#FDF2F8","Soft pink + trust blue"),
+    "Scanner & Document Manager":  ("#1E293B","#334155","#2563EB","#F8FAFC","Document grey + scan blue"),
+    # ── A. Utility / Productivity ──
+    "Calendar & Scheduling App":   ("#2563EB","#3B82F6","#059669","#F8FAFC","Calendar blue + event green"),
+    "Password Manager":            ("#1E3A5F","#334155","#059669","#0F172A","Vault dark blue + secure green"),
+    "Expense Splitter / Bill Split":("#059669","#10B981","#DC2626","#F8FAFC","Balance green + owe red"),
+    "Voice Recorder & Memo":       ("#DC2626","#EF4444","#2563EB","#FFFFFF","Recording red + waveform blue"),
+    "Bookmark & Read-Later":       ("#D97706","#F59E0B","#2563EB","#FFFBEB","Warm amber + link blue"),
+    "Translator App":              ("#2563EB","#0891B2","#EA580C","#F8FAFC","Global blue + teal + accent orange"),
+    "Calculator & Unit Converter": ("#EA580C","#F97316","#2563EB","#1C1917","Operation orange on dark"),
+    "Alarm & World Clock":         ("#D97706","#F59E0B","#6366F1","#0F172A","Time amber + night indigo on dark"),
+    "File Manager & Transfer":     ("#2563EB","#3B82F6","#D97706","#F8FAFC","Folder blue + file amber"),
+    "Email Client":                ("#2563EB","#3B82F6","#DC2626","#FFFFFF","Inbox blue + priority red"),
+    # ── B. Games ──
+    "Casual Puzzle Game":          ("#EC4899","#8B5CF6","#F59E0B","#FDF2F8","Cheerful pink + reward gold"),
+    "Trivia & Quiz Game":          ("#2563EB","#7C3AED","#F59E0B","#EFF6FF","Quiz blue + gold leaderboard"),
+    "Card & Board Game":           ("#15803D","#166534","#D97706","#0F172A","Felt green + gold on dark"),
+    "Idle & Clicker Game":         ("#D97706","#F59E0B","#7C3AED","#FFFBEB","Coin gold + prestige purple"),
+    "Word & Crossword Game":       ("#15803D","#059669","#D97706","#FFFFFF","Word green + letter amber"),
+    "Arcade & Retro Game":         ("#DC2626","#2563EB","#22C55E","#0F172A","Neon red+blue on dark + score green"),
+    # ── C. Creator Tools ──
+    "Photo Editor & Filters":      ("#7C3AED","#6366F1","#0891B2","#0F172A","Editor violet + filter cyan on dark"),
+    "Short Video Editor":          ("#EC4899","#DB2777","#2563EB","#0F172A","Video pink on dark + timeline blue"),
+    "Drawing & Sketching Canvas":  ("#7C3AED","#8B5CF6","#0891B2","#1C1917","Canvas purple + tool teal on dark"),
+    "Music Creation & Beat Maker": ("#7C3AED","#6366F1","#22C55E","#0F172A","Studio purple + waveform green on dark"),
+    "Meme & Sticker Maker":        ("#EC4899","#F59E0B","#2563EB","#FFFFFF","Viral pink + comedy yellow + share blue"),
+    "AI Photo & Avatar Generator": ("#7C3AED","#6366F1","#EC4899","#FAF5FF","AI purple + generation pink"),
+    "Link-in-Bio Page Builder":    ("#2563EB","#7C3AED","#EC4899","#FFFFFF","Brand blue + creator purple"),
+    # ── D. Personal Life ──
+    "Wardrobe & Outfit Planner":   ("#BE185D","#EC4899","#D97706","#FDF2F8","Fashion rose + gold accent"),
+    "Plant Care Tracker":          ("#15803D","#059669","#D97706","#F0FDF4","Nature green + sun yellow"),
+    "Book & Reading Tracker":      ("#78716C","#92400E","#D97706","#FFFBEB","Book brown + page amber"),
+    "Couple & Relationship App":   ("#BE185D","#EC4899","#DC2626","#FDF2F8","Romance rose + love red"),
+    "Family Calendar & Chores":    ("#2563EB","#059669","#D97706","#F8FAFC","Family blue + chore green"),
+    "Mood Tracker":                ("#7C3AED","#6366F1","#D97706","#FAF5FF","Mood purple + insight amber"),
+    "Gift & Wishlist":             ("#DC2626","#D97706","#EC4899","#FFF1F2","Gift red + gold + surprise pink"),
+    # ── E. Health ──
+    "Running & Cycling GPS":       ("#EA580C","#F97316","#059669","#0F172A","Energetic orange + pace green on dark"),
+    "Yoga & Stretching Guide":     ("#6B7280","#78716C","#0891B2","#F5F5F0","Sage neutral + calm teal"),
+    "Sleep Tracker":               ("#4338CA","#6366F1","#7C3AED","#0F172A","Night indigo + dream violet on dark"),
+    "Calorie & Nutrition Counter": ("#059669","#10B981","#EA580C","#ECFDF5","Healthy green + macro orange"),
+    "Period & Cycle Tracker":      ("#BE185D","#EC4899","#7C3AED","#FDF2F8","Blush rose + fertility lavender"),
+    "Medication & Pill Reminder":  ("#0284C7","#0891B2","#DC2626","#F0F9FF","Medical blue + alert red"),
+    "Water & Hydration Reminder":  ("#0284C7","#06B6D4","#0891B2","#F0F9FF","Refreshing blue + water cyan"),
+    "Fasting & Intermittent Timer":("#6366F1","#4338CA","#059669","#0F172A","Fasting indigo on dark + eating green"),
+    # ── F. Social ──
+    "Anonymous Community / Confession":("#475569","#334155","#0891B2","#0F172A","Protective grey + subtle teal on dark"),
+    "Local Events & Discovery":    ("#EA580C","#F97316","#2563EB","#FFF7ED","Event orange + map blue"),
+    "Study Together / Virtual Coworking":("#2563EB","#3B82F6","#059669","#F8FAFC","Focus blue + session green"),
+    # ── G. Education ──
+    "Coding Challenge & Practice": ("#22C55E","#059669","#D97706","#0F172A","Code green + difficulty amber on dark"),
+    "Kids Learning (ABC & Math)":  ("#2563EB","#F59E0B","#EC4899","#EFF6FF","Learning blue + play yellow + fun pink"),
+    "Music Instrument Learning":   ("#DC2626","#9A3412","#D97706","#FFFBEB","Musical red + warm amber"),
+    # ── H. Transport ──
+    "Parking Finder":              ("#2563EB","#059669","#DC2626","#F0F9FF","Available blue/green + occupied red"),
+    "Public Transit Guide":        ("#2563EB","#0891B2","#EA580C","#F8FAFC","Transit blue + line colors"),
+    "Road Trip Planner":           ("#EA580C","#0891B2","#D97706","#FFF7ED","Adventure orange + map teal"),
+    # ── I. Safety & Lifestyle ──
+    "VPN & Privacy Tool":          ("#1E3A5F","#334155","#22C55E","#0F172A","Shield dark + connected green"),
+    "Emergency SOS & Safety":      ("#DC2626","#EF4444","#2563EB","#FFF1F2","Alert red + safety blue"),
+    "Wallpaper & Theme App":       ("#7C3AED","#EC4899","#2563EB","#FAF5FF","Aesthetic purple + trending pink"),
+    "White Noise & Ambient Sound": ("#475569","#334155","#4338CA","#0F172A","Ambient grey + deep indigo on dark"),
+    "Home Decoration & Interior Design":("#78716C","#A8A29E","#D97706","#FAF5F2","Interior warm grey + gold accent"),
+}
+
+# ─── 1. REBUILD colors.csv ───────────────────────────────────────────────────
+def rebuild_colors():
+    src = os.path.join(BASE, "colors.csv")
+    with open(src, newline="", encoding="utf-8") as f:
+        reader = csv.DictReader(f)
+        headers = reader.fieldnames
+        existing = list(reader)
+
+    # Build lookup: Product Type -> row data
+    color_map = {}
+    for row in existing:
+        pt = row.get("Product Type", "").strip()
+        if not pt:
+            continue
+        # Remove deleted types
+        if pt in REMOVE_TYPES:
+            print(f"  [colors] REMOVE: {pt}")
+            continue
+        # Rename mismatched types
+        if pt in COLOR_RENAMES:
+            new_name = COLOR_RENAMES[pt]
+            print(f"  [colors] RENAME: {pt} → {new_name}")
+            row["Product Type"] = new_name
+            pt = new_name
+        color_map[pt] = row
+
+    # Read products.csv to get the correct order
+    with open(os.path.join(BASE, "products.csv"), newline="", encoding="utf-8") as f:
+        products = list(csv.DictReader(f))
+
+    # Build final rows in products.csv order
+    final_rows = []
+    added = 0
+    for i, prod in enumerate(products, 1):
+        pt = prod["Product Type"]
+        if pt in color_map:
+            row = color_map[pt]
+            row["No"] = str(i)
+            final_rows.append(row)
+        elif pt in NEW_COLORS:
+            pri, sec, acc, bg, notes = NEW_COLORS[pt]
+            new_row = derive_row(pt, pri, sec, acc, bg, notes)
+            d = dict(zip(headers, [str(i)] + new_row))
+            final_rows.append(d)
+            added += 1
+        else:
+            print(f"  [colors] WARNING: No color data for '{pt}' - using defaults")
+            new_row = derive_row(pt, "#2563EB", "#3B82F6", "#059669", "#F8FAFC", "Auto-generated default")
+            d = dict(zip(headers, [str(i)] + new_row))
+            final_rows.append(d)
+            added += 1
+
+    # Write
+    with open(src, "w", newline="", encoding="utf-8") as f:
+        writer = csv.DictWriter(f, fieldnames=headers)
+        writer.writeheader()
+        writer.writerows(final_rows)
+
+    product_count = len(products)
+    print(f"\n  ✅ colors.csv: {len(final_rows)} rows ({product_count} products)")
+    print(f"     Added: {added} new color rows")
+
+# ─── 2. REBUILD ui-reasoning.csv ─────────────────────────────────────────────
+def derive_ui_reasoning(prod):
+    """Generate ui-reasoning row from products.csv row."""
+    pt = prod["Product Type"]
+    style = prod.get("Primary Style Recommendation", "")
+    landing = prod.get("Landing Page Pattern", "")
+    color_focus = prod.get("Color Palette Focus", "")
+    considerations = prod.get("Key Considerations", "")
+    keywords = prod.get("Keywords", "")
+
+    # Typography mood derived from style
+    typo_map = {
+        "Minimalism": "Professional + Clean hierarchy",
+        "Glassmorphism": "Modern + Clear hierarchy",
+        "Brutalism": "Bold + Oversized + Monospace",
+        "Claymorphism": "Playful + Rounded + Friendly",
+        "Dark Mode": "High contrast + Light on dark",
+        "Neumorphism": "Subtle + Soft + Monochromatic",
+        "Flat Design": "Bold + Clean + Sans-serif",
+        "Vibrant": "Energetic + Bold + Large",
+        "Aurora": "Elegant + Gradient-friendly",
+        "AI-Native": "Conversational + Minimal chrome",
+        "Organic": "Warm + Humanist + Natural",
+        "Motion": "Dynamic + Hierarchy-shifting",
+        "Accessible": "Large + High contrast + Clear",
+        "Soft UI": "Modern + Accessible + Balanced",
+        "Trust": "Professional + Serif accents",
+        "Swiss": "Grid-based + Mathematical + Helvetica",
+        "3D": "Immersive + Spatial + Variable",
+        "Retro": "Nostalgic + Monospace + Neon",
+        "Cyberpunk": "Terminal + Monospace + Neon",
+        "Pixel": "Retro + Blocky + 8-bit",
+    }
+    typo_mood = "Professional + Clear hierarchy"
+    for key, val in typo_map.items():
+        if key.lower() in style.lower():
+            typo_mood = val
+            break
+
+    # Key effects from style
+    eff_map = {
+        "Glassmorphism": "Backdrop blur (10-20px) + Translucent overlays",
+        "Neumorphism": "Dual shadows (light+dark) + Soft press 150ms",
+        "Claymorphism": "Multi-layer shadows + Spring bounce + Soft press 200ms",
+        "Brutalism": "No transitions + Hard borders + Instant feedback",
+        "Dark Mode": "Subtle glow + Neon accents + High contrast",
+        "Flat Design": "Color shift hover + Fast 150ms transitions + No shadows",
+        "Minimalism": "Subtle hover 200ms + Smooth transitions + Clean",
+        "Motion-Driven": "Scroll animations + Parallax + Page transitions",
+        "Micro-interactions": "Haptic feedback + Small 50-100ms animations",
+        "Vibrant": "Large section gaps 48px+ + Color shift hover + Scroll-snap",
+        "Aurora": "Flowing gradients 8-12s + Color morphing",
+        "AI-Native": "Typing indicator + Streaming text + Context reveal",
+        "Organic": "Rounded 16-24px + Natural shadows + Flowing SVG",
+        "Soft UI": "Improved shadows + Modern 200-300ms + Focus visible",
+        "3D": "WebGL/Three.js + Parallax 3-5 layers + Physics 300-400ms",
+        "Trust": "Clear focus rings + Badge hover + Metric pulse",
+        "Accessible": "Focus rings 3-4px + ARIA + Reduced motion",
+    }
+    key_effects = "Subtle hover (200ms) + Smooth transitions"
+    for key, val in eff_map.items():
+        if key.lower() in style.lower():
+            key_effects = val
+            break
+
+    # Decision rules
+    rules = {}
+    if "dark" in style.lower() or "oled" in style.lower():
+        rules["if_light_mode_needed"] = "provide-theme-toggle"
+    if "glass" in style.lower():
+        rules["if_low_performance"] = "fallback-to-flat"
+    if "conversion" in landing.lower():
+        rules["if_conversion_focused"] = "add-urgency-colors"
+    if "social" in landing.lower():
+        rules["if_trust_needed"] = "add-testimonials"
+    if "data" in keywords.lower() or "dashboard" in keywords.lower():
+        rules["if_data_heavy"] = "prioritize-data-density"
+    if not rules:
+        rules["if_ux_focused"] = "prioritize-clarity"
+        rules["if_mobile"] = "optimize-touch-targets"
+
+    # Anti-patterns
+    anti_patterns = []
+    if "minimalism" in style.lower() or "minimal" in style.lower():
+        anti_patterns.append("Excessive decoration")
+    if "dark" in style.lower():
+        anti_patterns.append("Pure white backgrounds")
+    if "flat" in style.lower():
+        anti_patterns.append("Complex shadows + 3D effects")
+    if "vibrant" in style.lower():
+        anti_patterns.append("Muted colors + Low energy")
+    if "accessible" in style.lower():
+        anti_patterns.append("Color-only indicators")
+    if not anti_patterns:
+        anti_patterns = ["Inconsistent styling", "Poor contrast ratios"]
+    anti_str = " + ".join(anti_patterns[:2])
+
+    return {
+        "UI_Category": pt,
+        "Recommended_Pattern": landing,
+        "Style_Priority": style,
+        "Color_Mood": color_focus,
+        "Typography_Mood": typo_mood,
+        "Key_Effects": key_effects,
+        "Decision_Rules": json.dumps(rules),
+        "Anti_Patterns": anti_str,
+        "Severity": "HIGH"
+    }
+
+
+def rebuild_ui_reasoning():
+    src = os.path.join(BASE, "ui-reasoning.csv")
+    with open(src, newline="", encoding="utf-8") as f:
+        reader = csv.DictReader(f)
+        headers = reader.fieldnames
+        existing = list(reader)
+
+    # Build lookup
+    ui_map = {}
+    for row in existing:
+        cat = row.get("UI_Category", "").strip()
+        if not cat:
+            continue
+        if cat in REMOVE_TYPES:
+            print(f"  [ui-reason] REMOVE: {cat}")
+            continue
+        if cat in UI_RENAMES:
+            new_name = UI_RENAMES[cat]
+            print(f"  [ui-reason] RENAME: {cat} → {new_name}")
+            row["UI_Category"] = new_name
+            cat = new_name
+        ui_map[cat] = row
+
+    with open(os.path.join(BASE, "products.csv"), newline="", encoding="utf-8") as f:
+        products = list(csv.DictReader(f))
+
+    final_rows = []
+    added = 0
+    for i, prod in enumerate(products, 1):
+        pt = prod["Product Type"]
+        if pt in ui_map:
+            row = ui_map[pt]
+            row["No"] = str(i)
+            final_rows.append(row)
+        else:
+            row = derive_ui_reasoning(prod)
+            row["No"] = str(i)
+            final_rows.append(row)
+            added += 1
+
+    with open(src, "w", newline="", encoding="utf-8") as f:
+        writer = csv.DictWriter(f, fieldnames=headers)
+        writer.writeheader()
+        writer.writerows(final_rows)
+
+    print(f"\n  ✅ ui-reasoning.csv: {len(final_rows)} rows")
+    print(f"     Added: {added} new reasoning rows")
+
+
+# ─── MAIN ────────────────────────────────────────────────────────────────────
+if __name__ == "__main__":
+    print("=== Rebuilding colors.csv ===")
+    rebuild_colors()
+    print("\n=== Rebuilding ui-reasoning.csv ===")
+    rebuild_ui_reasoning()
+    print("\n🎉 Done!")

package/skills/ui-ux-pro-max/src/ui-ux-pro-max/data/app-interface.csv

@@ -0,0 +1,31 @@
+No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Accessibility,Icon Button Labels,icon button accessibilityLabel,iOS/Android/React Native,Icon-only buttons must expose an accessible label,Set accessibilityLabel or label prop on icon buttons,Icon buttons without accessible names,"<Pressable accessibilityLabel=""Close""><XIcon /></Pressable>","<Pressable><XIcon /></Pressable>",Critical
+2,Accessibility,Form Control Labels,form input label accessibilityLabel,iOS/Android/React Native,All inputs must have a visible label and an accessibility label,Pair Text label with input and set accessibilityLabel,Inputs with placeholder only,"<View><Text>Email</Text><TextInput accessibilityLabel=""Email address"" /></View>","<TextInput placeholder=""Email"" /></View>",Critical
+3,Accessibility,Role & Traits,accessibilityRole accessibilityTraits,iOS/Android/React Native,Interactive elements must expose correct roles/traits,Use accessibilityRole/button/link/checkbox etc.,Rely on generic views with no roles,"<Pressable accessibilityRole=""button"">Submit</Pressable>","<View onTouchStart={submit}>Submit</View>",High
+4,Accessibility,Dynamic Updates,accessibilityLiveRegion announce,iOS/Android/React Native,Async status updates should be announced to screen readers,Use accessibilityLiveRegion or announceForAccessibility,Update text silently with no announcement,"<Text accessibilityLiveRegion=""polite"">{status}</Text>","<Text>{status}</Text>",Medium
+5,Accessibility,Decorative Icons,accessible={false} importantForAccessibility,iOS/Android/React Native,Decorative icons should be hidden from screen readers,Mark decorative icons as not accessible,Have screen reader read every icon,"<Icon accessible={false} importantForAccessibility=""no"" />","<Icon />",Medium
+6,Touch,Touch Target Size,touch 44x44 hitSlop,iOS/Android/React Native,Primary touch targets must be at least 44x44pt,Increase hitSlop or padding to meet minimum,Small icons with tiny touch area,"<Pressable hitSlop={10}><Icon /></Pressable>","<Pressable><Icon style={{ width: 16, height: 16 }} /></Pressable>",Critical
+7,Touch,Touch Spacing,touch spacing gap 8px,iOS/Android/React Native,Adjacent touch targets need enough spacing,Keep at least 8dp spacing between touchables,Cluster many buttons with no gap,"<View style={{ gap: 8 }}><Button ... /><Button ... /></View>","<View><Button ... /><Button ... /></View>",Medium
+8,Touch,Gesture Conflicts,scroll swipe back gesture,iOS/Android/React Native,Custom gestures must not break system scroll/back,Reserve horizontal swipes for carousels,Full-screen custom swipe conflicting with back,"HorizontalPager inside vertical ScrollView","PanResponder on full screen blocking back",High
+9,Navigation,Back Behavior,back handler navigation stack,iOS/Android/React Native,Back navigation should be predictable and preserve state,Use navigation.goBack and keep screen state,Reset stack or exit app unexpectedly,onPress={() => navigation.goBack()},"BackHandler.exitApp() on first press",Critical
+10,Navigation,Bottom Tabs,tab bar max items,iOS/Android/React Native,Bottom tab bar should have at most 5 primary items,Use 3–5 tabs and move extras to More/Settings,Overloaded tab bar with many icons,Home/Explore/Profile/Settings,"Home/Explore/Shop/Cart/Profile/Settings/More",Medium
+11,Navigation,Modal Escape,modal dismiss close affordance,iOS/Android/React Native,Modals/sheets must have clear close actions,Provide close button and swipe-down where platform expects,Trapping users in modal with no obvious exit,"<Modal><Button title=""Close"" onPress={onClose} /></Modal>","<Modal><View>{children}</View></Modal>",High
+12,State,Preserve Screen State,navigation preserve state,iOS/Android/React Native,Returning to a screen should restore its scroll and form state,Keep components mounted or persist state,Reset list scroll and form inputs on every visit,"<Tab.Navigator screenOptions={{ unmountOnBlur: false }}>","<Tab.Screen options={{ unmountOnBlur: true }} />",Medium
+13,Feedback,Loading Indicators,activity indicator skeleton,iOS/Android/React Native,Show visible feedback during network operations,Use ActivityIndicator or skeleton for >300ms operations,Leave button and screen frozen,"{loading ? <ActivityIndicator /> : <Button title=""Save"" />}", "<Button title=""Save"" onPress={submit} /> // no loading",High
+14,Feedback,Success Feedback,toast checkmark banner,iOS/Android/React Native,Confirm successful actions with brief feedback,Show toast/checkmark or banner,Complete actions silently with no confirmation,"showToast('Saved successfully')","// silently update state only",Medium
+15,Feedback,Error Feedback,inline error banner,iOS/Android/React Native,Show clear error messages near the problem,input-level error + summary banner,Only change border color with no explanation,"<TextInput ... /><Text style={{color:'red'}}>{error}</Text>","<TextInput style={{borderColor:'red'}} />",High
+16,Forms,Inline Validation,onBlur validation,iOS/Android/React Native,Validate inputs on blur or submit with clear messaging,Validate onBlur and onSubmit,Validate on every keystroke causing jank,"onBlur={() => validateEmail(value)}","onChangeText={v => validateEmail(v)} // every char",Medium
+17,Forms,Keyboard Type,keyboardType returnKeyType,iOS/Android/React Native,Use appropriate keyboardType and returnKeyType,Match email/tel/number/search types,Use default keyboard for all inputs,"<TextInput keyboardType=""email-address"" />","<TextInput keyboardType=""default"" />",Medium
+18,Forms,Auto Focus & Next,autoFocus blurOnSubmit onSubmitEditing,iOS/Android/React Native,Guide users through form fields with Next/Done flows,Use onSubmitEditing to focus next input,Force users to tap each field manually,"onSubmitEditing={() => nextRef.current?.focus()}","// no onSubmitEditing, manual tap only",Low
+19,Forms,Password Visibility,secureTextEntry toggle,iOS/Android/React Native,Allow toggling password visibility securely,Provide Show/Hide icon toggling secureTextEntry,Force users to type blind with no option,"<TextInput secureTextEntry={secure} /><Icon onPress={toggle} />","<TextInput secureTextEntry /> // no toggle",Medium
+20,Performance,Virtualize Long Lists,FlatList SectionList virtualization,iOS/Android/React Native,Use FlatList/SectionList for lists over ~50 items,Use keyExtractor and initialNumToRender appropriately,Render hundreds of items with ScrollView,"<FlatList data={items} renderItem={...} />","<ScrollView>{items.map(renderItem)}</ScrollView>",High
+21,Performance,Image Size & Cache,Image resize cache,iOS/Android/React Native,Use correctly sized and cached images,Use Image component with proper resizeMode and caching,Load full-resolution images everywhere,"<Image source={{uri}} resizeMode=""cover"" />","<Image source={require('4k.png')} /> // small avatar",Medium
+22,Performance,Debounce High-Freq Events,debounce scroll search,iOS/Android/React Native,Debounce scroll/search callbacks to avoid jank,Wrap handlers with debounce/throttle,Run heavy logic on every event,"onScroll={debouncedHandleScroll}","onScroll={handleScrollHeavy}",Medium
+23,Animation,Duration & Easing,animation duration easing,iOS/Android/React Native,Micro-interactions should be 150–300ms with native-like easing,Use ease-out for enter/ease-in for exit,Use long or linear animations for core UI,"Animated.timing(..., { duration: 200, easing: Easing.out(Easing.quad) })","Animated.timing(..., { duration: 800, easing: Easing.linear })",Medium
+24,Animation,Respect Reduced Motion,reduced motion accessibility,iOS/Android/React Native,Respect OS reduced-motion accessibility setting,Check reduceMotionEnabled and simplify animations,Ignore user motion preferences,"if (reduceMotionEnabled) skipAnimation()","Always run complex parallax animations",Critical
+25,Animation,Limited Continuous Motion,loop animation loader,iOS/Android/React Native,Reserve infinite animations for loaders and live data,Use looping only where necessary,Keep decorative elements looping forever,"Animated.loop(loaderAnim) for ActivityIndicator","Animated.loop(bounceAnim) on background icons",Medium
+26,Typography,Base Font Size,fontScale dynamic type,iOS/Android/React Native,Body text must be readable and support Dynamic Type,Use platform fontScale and at least 14–16pt base,Render critical text below 12pt,"<Text style={{ fontSize: 16 }}>Body</Text>","<Text style={{ fontSize: 10 }}>Body</Text>",High
+27,Typography,Dynamic Type Support,allowFontScaling adjustsFontSizeToFit,iOS/Android/React Native,Support system text scaling without breaking layout,Set allowFontScaling and test large text,Disable scaling on all text globally,"<Text allowFontScaling>{label}</Text>","<Text allowFontScaling={false}>{label}</Text>",High
+28,Safe Areas,Safe Area Insets,safe area insets notch gesture,iOS/Android/React Native,Content must not overlap notches/gesture bars,Wrap screens in SafeAreaView or apply insets,Place tappable content under system bars,"<SafeAreaView style={{ flex: 1 }}><Screen /></SafeAreaView>","<View style={{ flex: 1 }}><Screen /></View>",High
+29,Theming,Light/Dark Contrast,dark mode contrast tokens,iOS/Android/React Native,Ensure sufficient contrast in both light and dark themes,Use semantic tokens and test both themes,Reuse light-theme grays directly in dark mode,"colors.textPrimaryDark = '#F9FAFB'","colors.textPrimaryDark = '#9CA3AF' on '#111827'",High
+30,Anti-Pattern,No Gesture-Only Actions,gesture only hidden controls,iOS/Android/React Native,Don't rely solely on hidden gestures for core actions,Provide visible buttons in addition to gestures,Rely on swipe/shake only with no UI affordance,"Swipe to delete + visible Delete button","Only shake device to undo with no UI",Critical