flowchart TB
    START([User requests release]) --> PROVIDED{Version provided?}
    
    PROVIDED -->|Yes| PARSE
    PROVIDED -->|No| AUTO
    
    AUTO["Auto-detect Version
    ∙ Read SKIASHARP_VERSION from main
    ∙ Check existing release branches
    ∙ Calculate next preview number"]
    
    AUTO --> CONFIRM{User confirms?}
    CONFIRM -->|No| ABORT([Abort])
    CONFIRM -->|Yes| PARSE
    
    PARSE["Parse Version String"] --> TYPE{Release type?}
    
    TYPE -->|Preview| BASE_MAIN["Base: main"]
    TYPE -->|Stable| BASE_PREVIEW["Base: preview branch"]
    TYPE -->|Hotfix Preview| BASE_TAG["Base: tag"]
    TYPE -->|Hotfix Stable| BASE_HOTFIX["Base: hotfix preview"]
    
    BASE_PREVIEW --> EXISTS{Base exists?}
    BASE_TAG --> EXISTS
    BASE_HOTFIX --> EXISTS
    EXISTS -->|No| ERROR([Error])
    
    BASE_MAIN --> CREATE
    EXISTS -->|Yes| CREATE
    
    CREATE["Create Branch
    ∙ Checkout base
    ∙ Create release branch
    ∙ Set PREVIEW_LABEL
    ∙ Commit and push"]
    
    CREATE --> CI([CI Build Started])
    
    CI --> IS_PREVIEW{Preview from main?}
    IS_PREVIEW -->|No| DONE([Done - wait 2-4 hours])
    IS_PREVIEW -->|Yes| BUMP
    
    BUMP["Bump Main Version
    ∙ Edit SKIASHARP_VERSION
    ∙ Edit VERSIONS.txt
    ∙ Increment HarfBuzzSharp
    ∙ Create and merge PR"]
    
    BUMP --> DONE

    classDef error fill:#ffebee,stroke:#c62828
    classDef endpoint fill:#f3e5f5,stroke:#7b1fa2
    class ABORT,ERROR error
    class START,CI,DONE endpoint

flowchart TB
    START([CI Build Complete]) --> RESOLVE
    
    RESOLVE["Resolve Package Versions
    ∙ Fetch release branch
    ∙ Read VERSIONS.txt (both packages)
    ∙ Search preview feed
    ∙ Pick latest build"]
    
    RESOLVE --> FOUND{Packages found?}
    FOUND -->|No| WAIT([Wait - CI not done])
    FOUND -->|Yes| REPORT[Report versions to user]
    
    REPORT --> STABLE{Stable release?}
    STABLE -->|No| TESTS
    STABLE -->|Yes| SOURCE{Test source?}
    
    SOURCE -->|Preview feed| TESTS
    SOURCE -->|Local artifacts| SETUP
    
    SETUP["Setup Local Testing
    ∙ Create local nuget.config
    ∙ Clear NuGet cache"]
    
    SETUP --> TESTS
    
    TESTS["Run Integration Tests
    ∙ Console, Blazor, MAUI
    ∙ iOS, Android, Mac, Windows"]
    
    TESTS --> RESULT{All pass?}
    RESULT -->|No| FIX([Fix and retest])
    RESULT -->|Yes| CHECK{Stable release?}
    
    CHECK -->|No| READY([Ready for publish])
    CHECK -->|Yes| CHECKLIST
    
    CHECKLIST["Stable Checklist
    ∙ Verify packages
    ∙ Check native assets
    ∙ Validate metadata"]
    
    CHECKLIST --> OK{Passes?}
    OK -->|No| FIX2([Fix issues])
    OK -->|Yes| READY

    classDef error fill:#ffebee,stroke:#c62828
    classDef endpoint fill:#f3e5f5,stroke:#7b1fa2
    class WAIT,FIX,FIX2 error
    class START,READY endpoint

flowchart TB
    START([Tests Passed]) --> REQ{Publish to NuGet.org?}
    
    REQ -->|Stable - Required| PUBLISH
    REQ -->|Preview| SKIP{Skip NuGet.org?}
    SKIP -->|Yes| TAG
    SKIP -->|No| PUBLISH
    
    PUBLISH["Publish to NuGet.org
    ∙ Trigger publish pipeline
    ∙ Wait for completion
    ∙ Verify packages visible"]
    
    PUBLISH --> STATUS{Success?}
    STATUS -->|No| FAILED([Fix and retry])
    STATUS -->|Yes| TAG
    
    TAG["Create Git Tag
    ∙ Preview: vX.Y.Z-preview.N.build
    ∙ Stable: vX.Y.Z
    ∙ Push tag to origin"]
    
    TAG --> RELEASE
    
    RELEASE["Create GitHub Release
    ∙ Set title and notes
    ∙ Mark pre-release if preview
    ∙ Attach samples if stable"]
    
    RELEASE --> FINAL{Stable release?}
    FINAL -->|No| DONE([Complete])
    FINAL -->|Yes| MILESTONE[Close GitHub milestone]
    MILESTONE --> DONE

    classDef error fill:#ffebee,stroke:#c62828
    classDef endpoint fill:#f3e5f5,stroke:#7b1fa2
    class FAILED error
    class START,DONE endpoint