[w3c/FileAPI] Fold File and Directory Entries API into File API (PR #222)

Incorporates the File-API-bound content from the WICG Entries API (https://wicg.github.io/entries-api/) into this specification:

- Path and entry concepts (names, paths, files, directories, entries) and the resolve/evaluate-a-path algorithms, added to the Terminology and Algorithms section.
- `File.webkitRelativePath` was merged into the `File` IDL.
- New "Files and Directories" section with IDL for `FileSystemEntry`, `FileSystemDirectoryEntry`, `FileSystemDirectoryReader`, `FileSystemFileEntry` and `FileSystem`, along with all associated callbacks, dictionaries, algorithms, and examples.

* [ ] Modified Web platform tests (link to pull request)
* [ ] HTML-bound content (`HTMLInputElement.webkitdirectory` / `webkitEntries` and `DataTransferItem.webkitGetAsEntry()`) remains to be added to the HTML standard.
* [ ] Technical issues are not numbered yet —if the edits are in line with what the WG wants I'll create those and add them.

Implementation commitments are "not applicable" for now since this reflects the current state of implementations.

@marcoscaceres @mkruisselbrink is this directionally correct / what you had in mind?


<!--
    This comment and the below content is programmatically generated.
    You may add a comma-separated list of anchors you'd like a
    direct link to below (e.g. #idl-serializers, #idl-sequence):

    Don't remove this comment or modify anything below this line.
    If you don't want a preview generated for this pull request,
    just replace the whole of this comment's content by "no preview"
    and remove what's below.
-->
***
<a href="https://pr-preview.s3.amazonaws.com/jcayzac/FileAPI/pull/222.html" title="Last updated on Jul 17, 2026, 2:38 AM UTC (0e69ab1)">Preview</a> | <a href="https://pr-preview.s3.amazonaws.com/w3c/FileAPI/222/cd1d1da...jcayzac:0e69ab1.html" title="Last updated on Jul 17, 2026, 2:38 AM UTC (0e69ab1)">Diff</a>
You can view, comment on, or merge this pull request online at:

  https://github.com/w3c/FileAPI/pull/222

-- Commit Summary --

  * Fold File and Directory Entries API into File API

-- File Changes --

    M index.bs (705)

-- Patch Links --

https://github.com/w3c/FileAPI/pull/222.patch
https://github.com/w3c/FileAPI/pull/222.diff

-- 
Reply to this email directly or view it on GitHub:
https://github.com/w3c/FileAPI/pull/222
You are receiving this because you are subscribed to this thread.

Message ID: <w3c/FileAPI/pull/222@github.com>