File dialogs

Add bytes after a selected file's existing contents. This suits a log that lives outside the workspace.

Delete the selected document at its storage location. It also invalidates this handle, so discard the handle after a successful call.

Read the display name of a selected file or folder. Show it in a confirmation or import list; keep the Document handle for actual file work.

Check whether a Document points to a file before reading its contents. This matters when you obtained handles by listing a folder.

Check whether a Document points to a directory before asking for its children or creating a subfolder.

Get Document handles for the contents of a selected folder. Choose recursive listing when you need descendants beyond its direct children.

Create a child directory inside the selected folder and keep the returned handle for the new location. It is useful for grouping a set of exports.

Read all bytes from a file chosen through a system dialog. Decode the resulting string yourself if the file contains JSON or another structured format.

Replace the entire contents of a selected file. This is appropriate when the user has approved updating an export in place.

Let the user choose one file through Android's picker. This is the right entry point for importing a document outside Kawaii's workspace.

Ask the user to select several files at once. Each selected file comes back as its own Document handle for a batch import.

Ask the user for a folder, then browse or add children through the returned handle. Use it when the import or export location should be their choice.

Give the user a save picker and write the supplied bytes at their chosen location. Prepare the complete export before opening the dialog.