export interface ShowOpenFilePickerOptions {
	/** A boolean that indicates whether the picker should let the user apply file type filters. By default, this is `false`. */
	excludeAcceptAllOption?: boolean

	/** An ID to be associated with the directory. If the same ID is used for another picker, it will open the same directory. */
	id?: string

	/** A boolean that indicates whether the user can select multiple files. By default, this is `false`. */
	multiple?: boolean

	/** A well known directory ("desktop", "downloads") or `FileSystemHandle` to open the dialog in. */
	startIn?: string | FileSystemDirectoryHandle

	/** An array of file types that can be selected. */
	types?: FilePickerAcceptType[]
}

export interface ShowSaveFilePickerOptions {
	/** A boolean that indicates whether the picker should let the user apply file type filters. By default, this is `false`. */
	excludeAcceptAllOption?: boolean

	/** An ID to be associated with the directory. If the same ID is used for another picker, it will open the same directory. */
	id?: string

	/** A well known directory ("desktop", "downloads") or `FileSystemHandle` to open the dialog in. */
	startIn?: string | FileSystemDirectoryHandle

	/** A string of the suggested file name. */
	suggestedName?: string

	/** An array of file types that can be selected. */
	types?: FilePickerAcceptType[]
}

export interface FilePickerAcceptType {
	/** A string that describes the file type. */
	description?: string

	/**
	 * An array of content types or file extensions that can be selected.
	 * @example
	 * ```js
	 * [
	 *   {
	 *     description: "Images",
	 *     accept: {
	 *       "image/*": [".png", ".gif", ".jpeg", ".jpg"]
	 *     }
	 *   }
	 * ]
	 * ```
	*/
	accept: Record<string, string[]>
}

export interface FileSystemFileHandle {
	/** A method that returns a File object representing the file's contents. */
	getFile(): Promise<File>

	/** A method that creates a writable stream for the file. */
	createWritable(options?: FileSystemCreateWritableOptions): Promise<FileSystemWritableFileStream>

	/** A boolean that indicates whether the handle is for a directory. */
	readonly isDirectory: boolean

	/** A property that indicates whether the handle is for a file. */
	readonly isFile: boolean

	/** The name of the file. */
	readonly name: string

	/** The kind of handle ('file' or 'directory'). */
	readonly kind: 'file'
}

export interface FileSystemCreateWritableOptions {
	/** Whether to keep the existing data and write on top of it (true) or start with an empty file (false). */
	keepExistingData?: boolean
}

export interface FileSystemWritableFileStream {
	/** Writes data to the stream. */
	write(data: BufferSource | Blob | string | WriteParams): Promise<void>

	/** Seeks to a position in the stream. */
	seek(position: number): Promise<void>

	/** Truncates the file to the specified size. */
	truncate(size: number): Promise<void>

	/** Closes the stream. */
	close(): Promise<void>
}

export interface WriteParams {
	type: "write"
	position?: number
	data: BufferSource | Blob | string
}