feat: expose file creation API

[hankertrix]

Follow up to #1777.

I need some guidance on the last point regarding the file handler interoperating with other APIs. The code currently doesn't compile as I'm not really sure what to return or how to design this return value of the open function.

Closes #1709.

[hankertrix]

@sxyazi What do you think of the bit flags parameter as the options for the open function? Would you rather use a Lua table?

Also, the return value of the open function currently just returns a Yazi File object, as I am not sure how to design a separate structure to interop with the Command plugin API.

On second thought, would the open function be considered unnecessary? Lua already has an io.open function to create files which supports everything from OpenOptions except truncate mode.

I think the main thing for plugin developers is the ability to create directories, which is implemented in the create_dir function, as Lua doesn't implement any built-in method to create directories.

[sxyazi]

Thanks for the PR!

On second thought, would the open function be considered unnecessary? Lua already has an io.open function to create files which supports everything from OpenOptions except truncate mode.

Yeah, Lua already provides io.open(), so reimplementing it in Yazi doesn't seem to be a high priority, how do you feel about separating the fs.open() part from this PR into a standalone one? That way, we can quickly merge fs.create_dir(), while I still have some details I want to discuss about fs.open(), I need to think more about the API design.

Or, if io.open() already meets your needs and fs.open() is no longer valuable to you, you can just discard it. I'll revisit how to add it when I have some time.

[hankertrix]

Yeah, Lua already provides io.open(), so reimplementing it in Yazi doesn't seem to be a high priority, how do you feel about separating the fs.open() part from this PR into a standalone one?

Oh yeah, that would be great. I'll do that.

I need to think more about the API design.

Sure thing, no worries!