@tauri-apps/plugin-dialog 2.0.0-alpha.4 → 2.0.0-beta.0

package/README.md

@@ -18,7 +18,7 @@ Install the Core plugin by adding the following to your `Cargo.toml` file:
 
 ```toml
 [dependencies]
-tauri-plugin-dialog = "2.0.0-alpha"
+tauri-plugin-dialog = "2.0.0-beta"
 # alternatively with Git:
 tauri-plugin-dialog = { git = "https://github.com/tauri-apps/plugins-workspace", branch = "v2" }
 ```

package/dist-js/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var primitives = require('@tauri-apps/api/primitives');
+var core = require('@tauri-apps/api/core');
 
 // Copyright 2019-2023 Tauri Programme within The Commons Conservancy
 // SPDX-License-Identifier: Apache-2.0
@@ -61,7 +61,7 @@ async function open(options = {}) {
     if (typeof options === "object") {
         Object.freeze(options);
     }
-    return primitives.invoke("plugin:dialog|open", { options });
+    return core.invoke("plugin:dialog|open", { options });
 }
 /**
  * Open a file/directory save dialog.
@@ -91,7 +91,7 @@ async function save(options = {}) {
     if (typeof options === "object") {
         Object.freeze(options);
     }
-    return primitives.invoke("plugin:dialog|save", { options });
+    return core.invoke("plugin:dialog|save", { options });
 }
 /**
  * Shows a message dialog with an `Ok` button.
@@ -112,7 +112,7 @@ async function save(options = {}) {
  */
 async function message(message, options) {
     const opts = typeof options === "string" ? { title: options } : options;
-    return primitives.invoke("plugin:dialog|message", {
+    return core.invoke("plugin:dialog|message", {
         message: message.toString(),
         title: opts?.title?.toString(),
         type_: opts?.type,
@@ -137,7 +137,7 @@ async function message(message, options) {
  */
 async function ask(message, options) {
     const opts = typeof options === "string" ? { title: options } : options;
-    return primitives.invoke("plugin:dialog|ask", {
+    return core.invoke("plugin:dialog|ask", {
         message: message.toString(),
         title: opts?.title?.toString(),
         type_: opts?.type,
@@ -163,7 +163,7 @@ async function ask(message, options) {
  */
 async function confirm(message, options) {
     const opts = typeof options === "string" ? { title: options } : options;
-    return primitives.invoke("plugin:dialog|confirm", {
+    return core.invoke("plugin:dialog|confirm", {
         message: message.toString(),
         title: opts?.title?.toString(),
         type_: opts?.type,

package/dist-js/index.d.ts

@@ -86,22 +86,60 @@ interface ConfirmDialogOptions {
     /** The label of the cancel button. */
     cancelLabel?: string;
 }
-declare function open(options?: OpenDialogOptions & {
-    multiple?: false;
-    directory?: false;
-}): Promise<null | FileResponse>;
-declare function open(options?: OpenDialogOptions & {
-    multiple?: true;
-    directory?: false;
-}): Promise<null | FileResponse[]>;
-declare function open(options?: OpenDialogOptions & {
-    multiple?: false;
-    directory?: true;
-}): Promise<null | string>;
-declare function open(options?: OpenDialogOptions & {
-    multiple?: true;
-    directory?: true;
-}): Promise<null | string[]>;
+type OpenDialogReturn<T extends OpenDialogOptions> = T["directory"] extends true ? T["multiple"] extends true ? string[] | null : string | null : T["multiple"] extends true ? FileResponse[] | null : FileResponse | null;
+/**
+ * Open a file/directory selection dialog.
+ *
+ * The selected paths are added to the filesystem and asset protocol scopes.
+ * When security is more important than the easy of use of this API,
+ * prefer writing a dedicated command instead.
+ *
+ * Note that the scope change is not persisted, so the values are cleared when the application is restarted.
+ * You can save it to the filesystem using [tauri-plugin-persisted-scope](https://github.com/tauri-apps/tauri-plugin-persisted-scope).
+ * @example
+ * ```typescript
+ * import { open } from '@tauri-apps/plugin-dialog';
+ * // Open a selection dialog for image files
+ * const selected = await open({
+ *   multiple: true,
+ *   filters: [{
+ *     name: 'Image',
+ *     extensions: ['png', 'jpeg']
+ *   }]
+ * });
+ * if (Array.isArray(selected)) {
+ *   // user selected multiple files
+ * } else if (selected === null) {
+ *   // user cancelled the selection
+ * } else {
+ *   // user selected a single file
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { open } from '@tauri-apps/plugin-dialog';
+ * import { appDir } from '@tauri-apps/api/path';
+ * // Open a selection dialog for directories
+ * const selected = await open({
+ *   directory: true,
+ *   multiple: true,
+ *   defaultPath: await appDir(),
+ * });
+ * if (Array.isArray(selected)) {
+ *   // user selected multiple directories
+ * } else if (selected === null) {
+ *   // user cancelled the selection
+ * } else {
+ *   // user selected a single directory
+ * }
+ * ```
+ *
+ * @returns A promise resolving to the selected path(s)
+ *
+ * @since 2.0.0
+ */
+declare function open<T extends OpenDialogOptions>(options?: T): Promise<OpenDialogReturn<T>>;
 /**
  * Open a file/directory save dialog.
  *
@@ -179,5 +217,5 @@ declare function ask(message: string, options?: string | ConfirmDialogOptions):
  * @since 2.0.0
  */
 declare function confirm(message: string, options?: string | ConfirmDialogOptions): Promise<boolean>;
-export type { DialogFilter, OpenDialogOptions, SaveDialogOptions, MessageDialogOptions, ConfirmDialogOptions, };
+export type { DialogFilter, FileResponse, OpenDialogOptions, OpenDialogReturn, SaveDialogOptions, MessageDialogOptions, ConfirmDialogOptions, };
 export { open, save, message, ask, confirm };

package/dist-js/index.js

@@ -1,4 +1,4 @@
-import { invoke } from '@tauri-apps/api/primitives';
+import { invoke } from '@tauri-apps/api/core';
 
 // Copyright 2019-2023 Tauri Programme within The Commons Conservancy
 // SPDX-License-Identifier: Apache-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tauri-apps/plugin-dialog",
-  "version": "2.0.0-alpha.4",
+  "version": "2.0.0-beta.0",
   "license": "MIT or APACHE-2.0",
   "authors": [
     "Tauri Programme within The Commons Conservancy"
@@ -20,7 +20,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@tauri-apps/api": "2.0.0-alpha.12"
+    "@tauri-apps/api": "2.0.0-beta.0"
   },
   "scripts": {
     "build": "rollup -c"