inputs:
  - User goals and context
  - Business requirements
  - Technical constraints

outputs:
  - User flow diagram
  - Key screen list
  - Interaction requirements

fidelity_levels:
  sketch: Quick paper drawings for ideation
  low_fi: Basic shapes, grayscale, placeholder content
  mid_fi: More detail, basic interactions noted
  high_fi: Near-final layout with annotations

prototype_types:
  paper: Physical mockups for early testing
  clickable: Linked screens for flow validation
  interactive: Functional interactions, animations
  code: Working implementations for technical validation

flowchart TB
    subgraph Research["1. Research"]
        UR[User Goals]
        CA[Constraints]
        PR[Problem Definition]
    end

    subgraph Define["2. Define"]
        UF[User Flows]
        SC[Screen List]
        ST[State Requirements]
    end

    subgraph Design["3. Design"]
        SK[Sketching]
        WF[Wireframing]
        AN[Annotations]
    end

    subgraph Prototype["4. Prototype"]
        LP[Low-fi Prototype]
        HP[High-fi Prototype]
        MI[Micro-interactions]
    end

    subgraph Validate["5. Validate"]
        UT[Usability Testing]
        IT[Iterate]
        HO[Handoff]
    end

    Research --> Define --> Design --> Prototype --> Validate
    Validate -->|Iterate| Design

flowchart TD
    START([User Opens App]) --> CHECK{Has Account?}

    CHECK -->|Yes| LOGIN[Login Screen]
    CHECK -->|No| SIGNUP[Signup Screen]
    CHECK -->|Unknown| LANDING[Landing Screen]

    LANDING --> CHOOSE{User Choice}
    CHOOSE -->|Login| LOGIN
    CHOOSE -->|Sign Up| SIGNUP

    LOGIN --> CRED[Enter Credentials]
    CRED --> VALIDATE{Valid?}
    VALIDATE -->|No| ERROR[Show Error]
    ERROR --> CRED
    VALIDATE -->|Yes| MFA{MFA Required?}

    MFA -->|Yes| CODE[Enter MFA Code]
    CODE --> VERIFY{Code Valid?}
    VERIFY -->|No| CODE
    VERIFY -->|Yes| HOME
    MFA -->|No| HOME

    SIGNUP --> FORM[Registration Form]
    FORM --> SUBMIT{Valid Data?}
    SUBMIT -->|No| FORMERR[Validation Errors]
    FORMERR --> FORM
    SUBMIT -->|Yes| EMAIL[Verification Email]
    EMAIL --> CONFIRM[User Clicks Link]
    CONFIRM --> HOME

    HOME([Home Dashboard])

    LOGIN -->|Forgot| FORGOT[Password Reset]
    FORGOT --> EMAIL2[Reset Email]
    EMAIL2 --> RESET[New Password]
    RESET --> LOGIN

stateDiagram-v2
    [*] --> Idle

    Idle --> Hover: mouseenter
    Hover --> Idle: mouseleave

    Hover --> Focus: tab / click
    Focus --> Hover: blur (mouse over)
    Focus --> Idle: blur (mouse left)

    Focus --> Active: mousedown / keydown
    Active --> Focus: mouseup / keyup

    Idle --> Disabled: setDisabled(true)
    Hover --> Disabled: setDisabled(true)
    Focus --> Disabled: setDisabled(true)
    Disabled --> Idle: setDisabled(false)

    Active --> Loading: async action
    Loading --> Success: complete
    Loading --> Error: fail

    Success --> Idle: timeout (2s)
    Error --> Idle: timeout (3s)
    Error --> Active: retry

    note right of Loading
        Show spinner
        Disable interactions
    end note

    note right of Success
        Show checkmark
        Green highlight
    end note

    note right of Error
        Show error icon
        Allow retry
    end note