documented workaround for frameworks that extend optional libraries