@vrcalphabet/web-fs 1.0.2 → 2.0.0

package/dist/main.d.ts

@@ -1,20 +1,41 @@
+import { GlobOptions } from 'web-fs-glob';
+
+declare type FileSystemEntry_2 = FileSystemFileHandle | FileSystemDirectoryHandle;
+export { FileSystemEntry_2 as FileSystemEntry }
+
 /**
- * ディレクトリを`WebFsDirectoryHandle`でラップしたものを返します。
+ * 配列から `WebFsEntry` (`WebFsFileHandle` または `WebFsDirectoryHandle`) のみを取り出します。
  *
- * @param directoryHandle すでに取得しているディレクトリハンドル。
- * @param options ディレクトリのオプション。
- * @returns 成功した場合は`WebFsDirectoryHandle`、エラーが出た場合は`undefined`。
+ * @param handles フィルタリングする配列。
+ * @returns `WebFsEntry` のみからなる配列。
  */
-export declare function mountDirectory(directoryHandle: FileSystemDirectoryHandle, options?: WebFsPermissionOptions): Promise<WebFsDirectoryHandle | undefined>;
+export declare function filterHandle(handles: unknown[]): WebFsEntry[];
+
+/**
+ * 値が `WebFsEntry` (`WebFsFileHandle` または `WebFsDirectoryHandle`) であるかを確認します。
+ *
+ * @param handle 確認する値。
+ * @returns `WebFsEntry` である場合は `true`、そうでない場合は `false`。
+ */
+export declare function isHandle(handle: unknown): handle is WebFsEntry;
 
 /**
  * ファイルを`WebFsFileHandle`でラップしたものを返します。
  *
- * @param fileHandle すでに取得しているファイルハンドル。
- * @param options ファイルのオプション。
- * @returns 成功した場合は`WebFsFileHandle`、エラーが出た場合は`undefined`。
+ * @param fileEntry すでに取得している`FileSystemFileHandle`。
+ * @param options 権限のオプション。
+ * @returns `WebFsFileHandle`、権限が拒否された場合は`WebFsPermissionDenied`。
+ */
+export declare function mount(fileEntry: FileSystemFileHandle, options?: WebFsPermissionOptions): Promise<WebFsFileHandle | WebFsPermissionDenied>;
+
+/**
+ * ファイルを`WebFsDirectoryHandle`でラップしたものを返します。
+ *
+ * @param dirEntry すでに取得している`FileSystemDirectoryHandle`。
+ * @param options 権限のオプション。
+ * @returns `WebFsDirectoryHandle`、権限が拒否された場合は`WebFsPermissionDenied`。
  */
-export declare function mountFile(fileHandle: FileSystemFileHandle, options?: WebFsPermissionOptions): Promise<WebFsFileHandle | undefined>;
+export declare function mount(dirEntry: FileSystemDirectoryHandle, options?: WebFsPermissionOptions): Promise<WebFsDirectoryHandle | WebFsPermissionDenied>;
 
 /**
  * ユーザに単一のディレクトリを選択させ、そのディレクトリを`WebFsDirectoryHandle`でラップしたものを返します。
@@ -22,7 +43,7 @@ export declare function mountFile(fileHandle: FileSystemFileHandle, options?: We
  * @param options ディレクトリ選択のオプション。
  * @returns 成功した場合は`WebFsDirectoryHandle`、選択を取り消した場合やエラーが出た場合は`undefined`。
  */
-export declare function pickDirectory(options?: WebFsDirectoryPickOptions): Promise<WebFsDirectoryHandle | undefined>;
+export declare function pickDirectory(options?: WebFsDirectoryPickOptions): Promise<WebFsDirectoryHandle | WebFsPermissionDenied | undefined>;
 
 /**
  * ユーザに単一のファイルを選択させ、そのファイルを`WebFsFileHandle`でラップしたものを返します。
@@ -30,15 +51,15 @@ export declare function pickDirectory(options?: WebFsDirectoryPickOptions): Prom
  * @param options ファイル選択のオプション。
  * @returns 成功した場合は`WebFsFileHandle`、選択を取り消した場合やエラーが出た場合は`undefined`。
  */
-export declare function pickFile(options?: WebFsFilePickOptions): Promise<WebFsFileHandle | undefined>;
+export declare function pickFile(options?: WebFsFilePickOptions): Promise<WebFsFileHandle | WebFsPermissionDenied | undefined>;
 
 /**
- * ユーザに複数のファイルを選択させ、そのファイルリストを`WebFsFileHandleList`でラップしたものを返します。
+ * ユーザに複数のファイルを選択させ、そのファイルリストを返します。
  *
  * @param options ファイル選択のオプション。
  * @returns 成功した場合は`WebFsFileHandleList`、選択を取り消した場合やエラーが出た場合は`undefined`。
  */
-export declare function pickFiles(options?: WebFsFilePickOptions): Promise<WebFsFileHandleList | undefined>;
+export declare function pickFiles(options?: WebFsFilePickOptions): Promise<(WebFsFileHandle | WebFsPermissionDenied)[] | undefined>;
 
 /**
  * ブラウザが`web-fs`に対応しているかを確認します。\
@@ -48,97 +69,88 @@ export declare function pickFiles(options?: WebFsFilePickOptions): Promise<WebFs
  */
 export declare function supportsWebFs(): boolean;
 
-/**
- * 保存されたディレクトリハンドルを削除します。
- *
- * @param id 削除したいディレクトリハンドルのid。
- */
-export declare function unmountDirectory(id: string): Promise<void>;
-
-/**
- * 保存されたファイルハンドルを削除します。
- *
- * @param id 削除したいファイルハンドルのid。
- */
-export declare function unmountFile(id: string): Promise<void>;
-
 export declare class WebFsDirectoryHandle extends WebFsHandle {
     /**
      * ディレクトリハンドルの種類。常に`"directory"`を返します。
      */
     readonly type = "directory";
-    protected _handle: FileSystemDirectoryHandle;
+    readonly _entry: FileSystemDirectoryHandle;
+    get handle(): FileSystemDirectoryHandle;
     private constructor();
     /**
-     * ファイルを`WebFsFileHandle`でラップしたものを返します。
+     * ディレクトリハンドルを`WebFsDirectoryHandle`でラップします。
      *
-     * @param handle すでに取得しているファイルハンドル。
-     * @param mode ファイルのオプション。
-     * @returns 成功した場合は`WebFsFileHandle`、エラーが出た場合は`undefined`。
+     * @param dirEntry すでに取得しているディレクトリハンドル。
+     * @param mode 取得する権限。
+     * @returns 成功した場合は`WebFsFileHandle`、権限が取得できない場合は`WebFsPermissionDenied`。
      */
-    static create(handle: FileSystemDirectoryHandle, mode?: FileSystemPermissionMode): Promise<WebFsDirectoryHandle | undefined>;
+    static create(dirEntry: FileSystemDirectoryHandle, mode?: FileSystemPermissionMode): Promise<WebFsDirectoryHandle | WebFsPermissionDenied>;
     /**
      * ファイルを取得します。ファイル名またはファイルの相対パスを指定します。
      *
-     * @param filePath 取得するファイルのファイルパス。
-     * @param options ファイルのオプション。
-     * @returns ファイルが取得できた場合は`WebFsFileHandle`、`options.create`が`false`かつファイルが存在しない場合、またはエラーが出た場合は`undefined`。
+     * @param filePath 取得するファイルのパス。例：`package.json`、`src/cli/main.ts`
+     * @param options ファイル取得のオプション。
+     * @returns ファイルが取得できた場合は`WebFsFileHandle`、ファイルが存在しないまたは権限がない場合は`undefined`。
      */
-    file(filePath: string, options?: WebFsGetFileOptions): Promise<WebFsFileHandle | undefined>;
+    getFile(filePath: string, options?: WebFsGetOptions): Promise<WebFsFileHandle | undefined>;
     /**
      * ディレクトリを取得します。ディレクトリ名またはディレクトリの相対パスで指定します。
      *
-     * @param dirPath 取得するディレクトリのファイルパス。
-     * @param options ディレクトリのオプション。
-     * @returns ディレクトリが取得できた場合は`WebFsDirectoryHandle`、`options.create`が`false`かつディレクトリが存在しない場合、またはエラーが出た場合は`undefined`。
-     */
-    dir(dirPath: string, options?: WebFsGetDirectoryOptions): Promise<WebFsDirectoryHandle | undefined>;
-    /**
-     * ファイルを簡易的なglobパターンから取得します。
-     *
-     * @returns globパターンにマッチしたファイルの`WebFsFileHandle`の配列。
+     * @param dirPath 取得するディレクトリのパス。例：`src`、`src/services`
+     * @param options ディレクトリ取得のオプション。
+     * @returns ディレクトリが取得できた場合は`WebFsDirectoryHandle`、ディレクトリが存在しないまたは権限がない場合は`undefined`。
      */
-    glob(pattern: string): Promise<WebFsFileHandle[]>;
-    private _glob;
+    getDir(dirPath: string, options?: WebFsGetOptions): Promise<WebFsDirectoryHandle | undefined>;
     /**
      * ファイルを作成します。ファイル名またはファイルの相対パスで指定します。
      *
-     * @returns ファイルが作成できた場合はそのファイルの`WebFsFileHandle`、エラーが出た場合は`undefined`。
+     * @param filePath 作成するファイルのパス。
+     * @returns ファイルが作成できた場合は`WebFsFileHandle`、書き込み権限がない場合またはエラーの場合は`undefined`。
      */
-    createFile(filePath: string, options?: WebFsPermissionOptions): Promise<WebFsFileHandle | undefined>;
+    createFile(filePath: string): Promise<WebFsFileHandle | undefined>;
     /**
      * ディレクトリを作成します。ディレクトリ名またはディレクトリの相対パスで指定します。
      *
-     * @returns ディレクトリが作成できた場合はそのディレクトリの`WebFsDirectoryHandle`、エラーが出た場合は`undefined`。
+     * @param dirPath 作成するディレクトリのパス。
+     * @returns ディレクトリが作成できた場合は`WebFsDirectoryHandle`、書き込み権限がない場合またはエラーの場合は`undefined`。
      */
-    createDir(dirPath: string, options?: WebFsPermissionOptions): Promise<WebFsDirectoryHandle | undefined>;
+    createDir(dirPath: string): Promise<WebFsDirectoryHandle | undefined>;
     /**
      * ファイルまたはディレクトリを削除します。削除するエントリーがディレクトリであった場合は、その子孫を再帰的に削除します。
      *
-     * @param entryPath 削除するファイルまたはディレクトリの名前。
+     * @param entryPath 削除するファイルまたはディレクトリのパス。
      * @returns 削除に成功した場合は`true`、エントリーが存在しないまたはエラーの場合は`false`。
      */
     remove(entryPath: string): Promise<boolean>;
     /**
-     * 現在の階層にあるファイル名またはディレクトリ名の一覧を取得します。
+     * ファイルやディレクトリの名前の一覧を取得します。
      *
-     * @param [options={}] 一覧のオプション。
-     * @returns ファイル名またはディレクトリ名からなる配列を返します。
+     * @param options 一覧のオプション。
+     * @returns ファイル名またはディレクトリ名からなる配列。
      */
-    names({ file, dir, depth, }?: WebFsEntryListOptions): Promise<string[]>;
+    names(options?: WebFsListOptions): Promise<string[]>;
     /**
      * 現在の階層にあるファイルまたはディレクトリのハンドルの一覧を取得します。
      *
-     * @param [options={}] 一覧のオプション。
-     * @returns ファイルハンドルまたはディレクトリハンドルからなる配列を返します。
+     * @param options 一覧のオプション。
+     * @returns `WebFsFileHandle`または`WebFsDirectoryHandle`からなる配列。
+     */
+    list(options?: WebFsListOptions): Promise<WebFsEntry[]>;
+    /**
+     * globパターンにマッチしたファイルやディレクトリの一覧を取得します。
+     *
+     * @param pattern globパターン。
+     * @param options globのオプション。
+     * @returns globパターンにマッチした`WebFsFileHandle`または`WebFsDirectoryHandle`の配列。
      */
-    list({ file, dir, depth, }?: WebFsEntryListOptions): Promise<(WebFsFileHandle | WebFsDirectoryHandle)[]>;
+    glob(pattern: string, options?: WebFsGlobOptions): Promise<WebFsEntry[]>;
     /**
-     * ファイル構造をツリー形式として取得します。
+     * ファイル構造をツリー形式のオブジェクトとして取得します。
      *
-     * @returns ツリー形式のオブジェクト。
+     * @param options ツリー取得のオプション。
+     * @returns ツリー形式の`WebFsTreeResult`オブジェクト。
      */
-    tree({ file, dir, depth, }?: WebFsEntryListOptions): Promise<WebFsTreeResult>;
+    tree(options?: WebFsTreeOptions): Promise<WebFsTreeResult>;
     /**
      * ファイル構造を文字列のツリー形式として取得します。
      *
@@ -160,45 +172,37 @@ export declare class WebFsDirectoryHandle extends WebFsHandle {
      *
      * @returns ツリー形式の文字列。
      */
-    treeString({ file, dir, depth, }?: WebFsEntryListOptions): Promise<string>;
-    private _tree;
-    private _flat;
-    private _toString;
-    private _filterEntry;
+    stringifyTree(options?: WebFsTreeOptions): Promise<string>;
+    private _shouldSkip;
+    private _treeRecursive;
+    private _stringifyTreeRecursive;
     private _dirByPath;
 }
 
 /** ディレクトリを選択する際のオプションです。 */
-export declare type WebFsDirectoryPickOptions = WebFsPickOptions & {};
+export declare type WebFsDirectoryPickOptions = WebFsPickOptions;
 
-/** エントリーリストを取得する際のオプションです。 */
-export declare interface WebFsEntryListOptions {
-    /** 要素にファイルハンドルを含めるかを指定します。デフォルトは`true`です。 */
-    file?: boolean;
-    /** 要素にディレクトリハンドルを含めるかを指定します。デフォルトは`true`です。 */
-    dir?: boolean;
-    /** 再帰する深さを指定します。デフォルトは`1`です。 */
-    depth?: number;
-}
+export declare type WebFsEntry = WebFsFileHandle | WebFsDirectoryHandle;
 
 export declare class WebFsFileHandle extends WebFsHandle {
     /**
      * ファイルハンドルの種類。常に`"file"`を返します。
      */
     readonly type = "file";
-    protected _handle: FileSystemFileHandle;
+    readonly _entry: FileSystemFileHandle;
+    get handle(): FileSystemFileHandle;
     private constructor();
     /**
      * ファイルを`WebFsFileHandle`でラップしたものを返します。
      *
-     * @param handle すでに取得しているファイルハンドル。
-     * @param mode ファイルのオプション。
-     * @returns 成功した場合は`WebFsFileHandle`、エラーが出た場合は`undefined`。
+     * @param fileEntry すでに取得しているファイルハンドル。
+     * @param mode 取得する権限。
+     * @returns 成功した場合は`WebFsFileHandle`、権限が取得できない場合は`WebFsPermissionDenied`。
      */
-    static create(handle: FileSystemFileHandle, mode?: FileSystemPermissionMode): Promise<WebFsFileHandle | undefined>;
+    static create(fileEntry: FileSystemFileHandle, mode?: FileSystemPermissionMode): Promise<WebFsFileHandle | WebFsPermissionDenied>;
     /**
-     * ファイルの情報を返します。\
-     * これには、ファイル名、ファイルサイズ、MIMEの種類、パス、最終更新日時が含まれます。
+     * ファイルの情報を返します。
+     * これには、ファイル名、ファイルサイズ、MIMEの種類、最終更新日時が含まれます。
      *
      * @returns ファイルの情報。
      */
@@ -228,78 +232,39 @@ export declare class WebFsFileHandle extends WebFsHandle {
      */
     arrayBuffer(): Promise<ArrayBuffer>;
     /**
-     * ファイルのハッシュ値を取得します。\
-     * ハッシュ値のアルゴリズムは、`md5`、`sha256`、`sha512`から選べます。
+     * ファイルのハッシュ値を取得します。
      *
+     * @param algo ハッシュアルゴリズムの種類。
      * @returns ハッシュ化された16進数の文字列。
      */
-    hash(algo?: WebFsFileHashType): Promise<string>;
+    hash(algo: WebFsFileHashType): Promise<string>;
     /**
-     * ファイルの内容を`data`の内容で**上書き**します。
+     * ファイルの内容に`data`の内容を書き込みます。
      *
-     * @returns ファイルの書き込みに成功した場合は`true`、失敗した場合は`false`。
-     */
-    write(data: string): Promise<boolean>;
-    /**
-     * ファイルの内容に`data`の内容を追記します。
+     * `options.append`が`false`の場合は上書き、`true`の場合は追記します。
      *
+     * @param data 書き込む文字列。
+     * @param options 書き込みオプション。
      * @returns ファイルの書き込みに成功した場合は`true`、失敗した場合は`false`。
      */
-    append(data: string): Promise<boolean>;
+    write(data: string, options?: WebFsWriteOptions): Promise<boolean>;
     /**
      * ファイルの読み込みストリームを取得します。
      *
      * @returns ファイルの読み込みストリーム。
      */
-    readStream(): Promise<ReturnType<Blob["stream"]>>;
+    readStream(): Promise<ReadableStream<Uint8Array<ArrayBuffer>>>;
     /**
      * ファイルの書き込みストリームを取得します。
      *
+     * @param options ストリーム作成のオプション。
      * @returns ファイルの書き込みストリーム。
      */
     writeStream(options?: FileSystemCreateWritableOptions): Promise<FileSystemWritableFileStream>;
-    private _write;
-}
-
-declare class WebFsFileHandleList {
-    private _handles;
-    private constructor();
-    /**
-     * ファイルを`WebFsFileHandleList`（`WebFsFileHandle`の配列）でラップしたものを返します。
-     *
-     * @param handles すでに取得しているファイルハンドルの配列。
-     * @param mode ファイルのオプション。
-     * @returns 成功した場合は`WebFsFileHandleList`、エラーが出た場合は`undefined`。
-     */
-    static create(handles: FileSystemFileHandle[], mode?: FileSystemPermissionMode): Promise<WebFsFileHandleList | undefined>;
-    /**
-     * ファイルを取得します。
-     *
-     * @param fileName 取得するファイルのファイル名。
-     * @returns ファイルが取得できた場合は`WebFsFileHandle`、存在しない場合は`undefined`。
-     */
-    file(fileName: string): WebFsFileHandle | undefined;
-    /**
-     * ファイル名の一覧を取得します。
-     *
-     * @returns ファイル名の配列を返します。
-     */
-    names(): string[];
-    /**
-     * ファイルハンドルの一覧を取得します。
-     *
-     * @returns ファイルハンドルの配列を返します。
-     */
-    list(): WebFsFileHandle[];
-    /**
-     * 現在の`WebFsFileHandleList`インスタンスが管理しているファイルハンドルの数を取得します。
-     */
-    get length(): number;
-    [Symbol.iterator](): Generator<WebFsFileHandle, void, unknown>;
 }
 
 /** ハッシュ化するアルゴリズムの種類です。 */
-export declare type WebFsFileHashType = "md5" | "sha256" | "sha512";
+export declare type WebFsFileHashType = 'md5' | 'sha1' | 'sha256' | 'sha384' | 'sha512';
 
 export declare interface WebFsFileInfo {
     /** ファイルの名前です。 */
@@ -310,78 +275,152 @@ export declare interface WebFsFileInfo {
     mimeType: string;
     /** ファイルの最終更新日時です。 */
     lastModified: number;
+    /** Date型のファイルの最終更新日時です。 */
+    lastModifiedDate: Date;
 }
 
 /** ファイルを選択する際のオプションです。 */
 export declare type WebFsFilePickOptions = WebFsPickOptions & {
-    /** 指定されている拡張子とは別に、すべての拡張子を許可する項目を追加します。 */
+    /** 指定されている拡張子とは別に、すべての拡張子を許可する項目を追加します。デフォルトは`false`です。 */
     acceptAllExtensions?: boolean;
+    /** 選択可能なファイルの種類を指定します。 */
+    types?: WebFsFilePickType[];
 };
 
 /** ファイルの種類を定義するオブジェクトです。 */
-export declare interface WebFsFilePickType {
+export declare type WebFsFilePickType = {
     /** ファイルの種類の、ユーザー向けの説明です。 */
     description?: string;
     /** 許可するMIMEタイプと拡張子のリストです。 */
     accept: FileExtension[];
-}
+};
 
-/** ディレクトリを取得する際のオプションです。 */
-export declare interface WebFsGetDirectoryOptions extends FileSystemGetDirectoryOptions, WebFsPermissionOptions {
-}
+/** ファイルやディレクトリを取得する際のオプションです。 */
+export declare type WebFsGetOptions = WebFsPermissionOptions & {
+    /** ファイルやディレクトリが存在しない場合に再帰的にエントリーを作成するかを指定します。デフォルトは`false`です。 */
+    create?: boolean;
+};
 
-/** ファイルを取得する際のオプションです。 */
-export declare interface WebFsGetFileOptions extends FileSystemGetFileOptions, WebFsPermissionOptions {
-}
+/** globでエントリを取得する際のオプションです。 */
+export declare type WebFsGlobOptions = Omit<GlobOptions, 'cwd'> & WebFsPermissionOptions;
 
 export declare abstract class WebFsHandle {
-    abstract readonly type: "file" | "directory";
-    protected _handle: FileSystemHandle;
-    protected constructor(handle: FileSystemHandle);
+    abstract readonly type: 'file' | 'directory';
+    protected readonly _entry: FileSystemHandle;
     /**
      * ファイルハンドルの名前。ファイル名やディレクトリ名を表します。
      */
     get name(): string;
+    /**
+     * ネイティブの`FileSystemHandle`を返します。
+     */
+    get handle(): FileSystemHandle;
+    protected constructor(entry: FileSystemHandle);
+    /**
+     * 指定したモードの権限が現在付与されているかを確認します。
+     *
+     * @param mode 確認する権限のモード。`"read"`または`"readwrite"`を指定します。
+     * @returns 権限が付与されている場合は`true`、そうでない場合は`false`。
+     */
+    can(mode: FileSystemPermissionMode): Promise<boolean>;
+    /**
+     * 指定したモードの権限をリクエストします。\
+     * 権限が未付与の場合はブラウザの確認ダイアログが表示されます。
+     *
+     * @param mode リクエストする権限のモード。`"read"`または`"readwrite"`を指定します。
+     * @returns 権限が付与された場合は`true`、拒否された場合は`false`。
+     */
+    request(mode: FileSystemPermissionMode): Promise<boolean>;
     protected _verifyPermission(mode: FileSystemPermissionMode): Promise<boolean>;
 }
 
-/** 権限に関するオプションです。 */
-export declare interface WebFsPermissionOptions {
-    /** ファイルやディレクトリに対する権限を、`"read"`または`"readwrite"`で指定します。 */
-    mode?: FileSystemPermissionMode;
+export declare type WebFsInnerTreeResult = {
+    /** ハンドルの種類です。 */
+    kind: 'file';
+    /** ハンドルの名前（ファイル名）です。 */
+    name: string;
+    /** ファイルハンドルです。 */
+    handle: FileSystemFileHandle;
+    children: undefined;
+} | {
+    /** ハンドルの種類です。 */
+    kind: 'directory';
+    /** ハンドルの名前（ディレクトリ名）です。 */
+    name: string;
+    /** ディレクトリハンドルです。 */
+    handle: FileSystemDirectoryHandle;
+    /** ディレクトリ内の子要素のリストです。 */
+    children: WebFsInnerTreeResult[];
+};
+
+/** エントリーリストを取得する際のオプションです。 */
+export declare type WebFsListOptions = {
+    /** 要素にファイルハンドルを含めるかを指定します。デフォルトは`true`です。 */
+    file?: boolean;
+    /** 要素にディレクトリハンドルを含めるかを指定します。デフォルトは`true`です。 */
+    dir?: boolean;
+};
+
+/**
+ * ハンドルから読み書き権限が取得できなかったことを示すクラスです。
+ */
+declare class WebFsPermissionDenied {
+    private _handle;
+    /**
+     * 関連付けられたハンドルです。
+     */
+    get handle(): FileSystemEntry_2;
+    constructor(handle: FileSystemEntry_2);
 }
 
-/** ファイルやディレクトリを選択する際の共通オプションです。 */
-export declare type WebFsPickOptions = {
-    /** ファイルやディレクトリに対する権限を、`"read"`または`"readwrite"`で指定します。 */
+/** ファイルハンドルを取得する際の権限モードを指定するオプションです。 */
+export declare type WebFsPermissionOptions = {
+    /** ハンドルに対する権限を、`"read"`または`"readwrite"`で指定します。デフォルトは`"read"`です。 */
     mode?: FileSystemPermissionMode;
+};
+
+/** ファイルやディレクトリを選択する際の共通オプションです。 */
+export declare type WebFsPickOptions = WebFsPermissionOptions & {
     /** ダイアログを開く際の初期ディレクトリを指定します。 */
     startIn?: WellKnownDirectory;
-    /** 選択可能なファイルの種類を指定します。 */
-    types?: WebFsFilePickType[];
+    /**
+     * IDごとに、前回開いたディレクトリを記憶します。**idには、26文字の文字数上限があります。**\
+     * 文字数上限を超えた場合は、`TypeError`がスローされます。
+     *
+     * ネイティブのidの文字数上限は32文字ですが、必ず`webfs_`というプレフィックスがつくため、`32 - 6 = 26`文字となります。
+     */
+    id?: string;
+    /** 取得したハンドルをデータベースに保存して永続化するかどうかを指定します。 */
+    persistence?: boolean;
 } & ({
-    /** 設定を保存するためのIDです。 */
     id: string;
-    /** 永続化するかどうかを指定します。 */
     persistence: true;
 } | {
-    /** 設定を保存するためのIDです。 */
     id?: string;
-    /** 永続化するかどうかを指定します。 */
     persistence?: false;
 });
 
-/** ツリー形式のファイル構造を表すオブジェクトです。 */
+/** ツリー形式でエントリを取得する際のオプションです。 */
+export declare type WebFsTreeOptions = {
+    /** 要素にファイルハンドルを含めるかを指定します。デフォルトは`true`です。 */
+    file?: boolean;
+    /** 再帰する深さを指定します。デフォルトは`1`です。 */
+    maxDepth?: number;
+};
+
 export declare type WebFsTreeResult = {
-    /** ディレクトリハンドルです。 */
-    handle: FileSystemFileHandle;
-    /** ディレクトリ内の子要素のリストです。 */
-    children: undefined;
-} | {
+    kind: 'directory';
+    name: string;
     /** ディレクトリハンドルです。 */
     handle: FileSystemDirectoryHandle;
     /** ディレクトリ内の子要素のリストです。 */
-    children: WebFsTreeResult[];
+    children: WebFsInnerTreeResult[];
+};
+
+/** ファイルに書き込みを行う際のオプションです。 */
+export declare type WebFsWriteOptions = {
+    /** ファイルの書き込みを追記モードにします。`false`の場合は、ファイルを上書きします。デフォルトは`true`です。 */
+    append?: boolean;
 };
 
 export { }