Да, конечный путь к файлу.

Юзкейс банальный.

Я использую стороннюю либу для парсинга composer.lock и composer.json в удобный формат. Ей я должен отдать путь к файлу как он есть в реальной файловой системе.

То есть "/home/user/project/composer.json".

У меня, соответственно, есть алиас "@root", который в корень проекта смотрит.

Хочу сконвертировать "@root/composer.json" в "/home/user/project/composer.json" простым вызовом функции, чтобы передать путь сторонней либе.

Если тебе нужно работать с файлами, используй файлы.

Это понятно что резолвит. Но зачем тебе абстракция над файловой системой чтобы алиас резрезолвить и потом использовать без абстракции?

Тут даже core-функции выигрывают по сравнению с FlySystem.

Никто не заставляет использовать flysystem или обертку над ним. Всегда можно отказаться от них и написать is_dir. Flysystem нужен для других целей. Если твои с ними не совпадают - то они не совпадают.

Если какие-то специфичные юзкейсы только возможны, то и опишите честно - наша обёртка урезана и не позволяет полноценно работать с локальной FS, используйте её только в ограниченных случаях, таких как .... и перечисление

Если знаешь, как написать лучше, то всегда можешь сделать PR

Да, слышал об этом. Я даже делал когда-то эти PR )

Реальность опенсурса упирается всегда в мозги авторов репозиториев. Пока авторы уверены, что различие между файлом и папкой - это лишь "мои нерелевантные кейсы", я не хочу браться за это. Тут по ответам уже ясна позиция, что толку с PR не будет (