Finish the documentation

[Copilot]

The README had several gaps between the documented API and the actual implementation.

Changes

• Fixed destructuring example — read was used in the snippet but missing from the destructured parameters
• Documented variadic path() — added path("a", "b", "c") example to reflect the actual ...relativePaths signature
• Multiple callbacks — new section documenting that usingTemporaryFiles() accepts N callbacks sharing the same temp directory, executed in order
• Debug mode — new section documenting USING_TEMPORARY_FILES_DEBUG=1, which retains the temp directory under CWD for post-run inspection
• Improved inline comments — noted that add/addDirectory create parent directories, that read defaults to utf8, and added a base64 encoding example

await usingTemporaryFiles(async ({ path, add, addDirectory, read, remove }) => {
  path("a", "b", "c");                        // variadic segments joined
  await add("nested/file.txt", "content");     // creates parent dirs automatically
  const text = await read("nested/file.txt"); // defaults to utf8
  const bin  = await read("img.png", "base64");
});

[changeset-bot]

⚠️ No Changeset found

Latest commit: 3fc13d1

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR