skylib: Improve path.bzl%runfile to better integrate with runfiles li…

[BoleynSu]

@bazel_tools//tools/bash/runfiles won't work properly if BASH_SOURCE contains .. in the path. Maybe we should fix it instead too.

[github-actions[bot]]

This Pull Request has been automatically marked as stale because it has not had any activity for 180 days. It will be closed if no further activity occurs in 30 days. Collaborators can add an assignee to keep this open indefinitely. Thanks for your contributions to rules_docker!