@domicile-desktop/sdk 0.0.0-alpha-eac3f852668d → 0.0.0-alpha-dfd80a336b89

package/dist/portal.d.ts

@@ -4,8 +4,10 @@ export declare enum PortalKind {
     Access = 0,
     /** Pick an application to open a file or URI with. */
     AppChooser = 1,
+    /** Files to open, or where to save. */
+    FileChooser = 2,
     /** A kind this SDK cannot parse. Answer it with {@link PortalAnswer.Refused}. */
-    Unknown = 2
+    Unknown = 3
 }
 /** What every request carries. */
 export type PortalRequestBase = {
@@ -36,6 +38,67 @@ export type AppChooserBody = {
     /** The file's name, without its directory. */
     filename: string | undefined;
 };
+/** Which `FileChooser` method asked. */
+export declare enum FileChooserMode {
+    /** Existing files, or a folder when `directory` is set. */
+    Open = 0,
+    /** One new path. */
+    Save = 1,
+    /** A folder to save `files` into. */
+    SaveFiles = 2
+}
+/** A named group of accepted extensions, such as "Images". */
+export type FileChooserFilter = {
+    /** Lowercase and without the dot; empty accepts any file. */
+    extensions: readonly string[];
+    name: string;
+};
+/**
+ * A question asked beside the files. No options means a checkbox, answered
+ * `"true"` or `"false"`.
+ */
+export type FileChoice = {
+    id: string;
+    /** The option id, or `"true"`/`"false"`, selected at first. */
+    initial: string;
+    label: string;
+    options: readonly {
+        id: string;
+        label: string;
+    }[];
+};
+/** A file chooser's request. Paths are absolute. */
+export type FileChooserBody = {
+    /** The confirm button's label; the shell's own when absent. */
+    acceptLabel: string | undefined;
+    choices: readonly FileChoice[];
+    /** The index in `filters` to start with. */
+    currentFilter: number | undefined;
+    /** The folder to start in; the home when absent. */
+    currentFolder: string | undefined;
+    /** The suggested name for {@link FileChooserMode.Save}. */
+    currentName: string | undefined;
+    /** Open a folder rather than a file. */
+    directory: boolean;
+    /** The names {@link FileChooserMode.SaveFiles} saves into the folder. */
+    files: readonly string[];
+    /** Empty accepts any file. */
+    filters: readonly FileChooserFilter[];
+    /** The user's home directory, where the picker's places are. */
+    home: string;
+    mode: FileChooserMode;
+    multiple: boolean;
+    title: string;
+};
+/** What the user chose in a file chooser. */
+export type FileChosen = {
+    /** Each {@link FileChoice}'s answer, by id. */
+    choices: ReadonlyMap<string, string>;
+    /** The index in the request's `filters` in use. */
+    currentFilter: number | undefined;
+    /** Absolute paths: the files, or the folder for `SaveFiles`. */
+    paths: readonly string[];
+};
 export declare const PortalRequest: {
     Access: (base: PortalRequestBase, body: AccessBody) => {
         /** The id {@link answerPortalRequest} takes. */
@@ -57,6 +120,16 @@ export declare const PortalRequest: {
         body: AppChooserBody;
         kind: PortalKind.AppChooser;
     };
+    FileChooser: (base: PortalRequestBase, body: FileChooserBody) => {
+        /** The id {@link answerPortalRequest} takes. */
+        id: number;
+        /** The asking application's desktop file id. Empty when unknown. */
+        appId: string;
+        /** The `<app>` to show the dialog over, or the focused screen when absent. */
+        parentAppId: string | undefined;
+        body: FileChooserBody;
+        kind: PortalKind.FileChooser;
+    };
     Unknown: (base: PortalRequestBase, wireKind: string) => {
         /** The id {@link answerPortalRequest} takes. */
         id: number;
@@ -74,10 +147,12 @@ export declare enum PortalAnswerKind {
     Access = 0,
     /** The application the user picked in an {@link PortalKind.AppChooser}. */
     AppChooser = 1,
+    /** The user chose in a {@link PortalKind.FileChooser}. */
+    FileChooser = 2,
     /** The user dismissed or denied the dialog. */
-    Canceled = 2,
+    Canceled = 3,
     /** The shell has no dialog for this kind. */
-    Refused = 3
+    Refused = 4
 }
 export declare const PortalAnswer: {
     Access: () => {
@@ -91,6 +166,10 @@ export declare const PortalAnswer: {
     Canceled: () => {
         kind: PortalAnswerKind.Canceled;
     };
+    FileChooser: (chosen: FileChosen) => {
+        chosen: FileChosen;
+        kind: PortalAnswerKind.FileChooser;
+    };
     Refused: () => {
         kind: PortalAnswerKind.Refused;
     };

package/dist/portal.js

@@ -11,9 +11,21 @@ export var PortalKind;
     PortalKind[PortalKind["Access"] = 0] = "Access";
     /** Pick an application to open a file or URI with. */
     PortalKind[PortalKind["AppChooser"] = 1] = "AppChooser";
+    /** Files to open, or where to save. */
+    PortalKind[PortalKind["FileChooser"] = 2] = "FileChooser";
     /** A kind this SDK cannot parse. Answer it with {@link PortalAnswer.Refused}. */
-    PortalKind[PortalKind["Unknown"] = 2] = "Unknown";
+    PortalKind[PortalKind["Unknown"] = 3] = "Unknown";
 })(PortalKind || (PortalKind = {}));
+/** Which `FileChooser` method asked. */
+export var FileChooserMode;
+(function (FileChooserMode) {
+    /** Existing files, or a folder when `directory` is set. */
+    FileChooserMode[FileChooserMode["Open"] = 0] = "Open";
+    /** One new path. */
+    FileChooserMode[FileChooserMode["Save"] = 1] = "Save";
+    /** A folder to save `files` into. */
+    FileChooserMode[FileChooserMode["SaveFiles"] = 2] = "SaveFiles";
+})(FileChooserMode || (FileChooserMode = {}));
 export const PortalRequest = {
     Access: (base, body) => ({
         ...base,
@@ -25,6 +37,11 @@ export const PortalRequest = {
         body,
         kind: PortalKind.AppChooser,
     }),
+    FileChooser: (base, body) => ({
+        ...base,
+        body,
+        kind: PortalKind.FileChooser,
+    }),
     Unknown: (base, wireKind) => ({
         ...base,
         kind: PortalKind.Unknown,
@@ -37,10 +54,12 @@ export var PortalAnswerKind;
     PortalAnswerKind[PortalAnswerKind["Access"] = 0] = "Access";
     /** The application the user picked in an {@link PortalKind.AppChooser}. */
     PortalAnswerKind[PortalAnswerKind["AppChooser"] = 1] = "AppChooser";
+    /** The user chose in a {@link PortalKind.FileChooser}. */
+    PortalAnswerKind[PortalAnswerKind["FileChooser"] = 2] = "FileChooser";
     /** The user dismissed or denied the dialog. */
-    PortalAnswerKind[PortalAnswerKind["Canceled"] = 2] = "Canceled";
+    PortalAnswerKind[PortalAnswerKind["Canceled"] = 3] = "Canceled";
     /** The shell has no dialog for this kind. */
-    PortalAnswerKind[PortalAnswerKind["Refused"] = 3] = "Refused";
+    PortalAnswerKind[PortalAnswerKind["Refused"] = 4] = "Refused";
 })(PortalAnswerKind || (PortalAnswerKind = {}));
 export const PortalAnswer = {
     Access: () => ({ kind: PortalAnswerKind.Access }),
@@ -50,6 +69,10 @@ export const PortalAnswer = {
         kind: PortalAnswerKind.AppChooser,
     }),
     Canceled: () => ({ kind: PortalAnswerKind.Canceled }),
+    FileChooser: (chosen) => ({
+        chosen,
+        kind: PortalAnswerKind.FileChooser,
+    }),
     Refused: () => ({ kind: PortalAnswerKind.Refused }),
 };
 /**
@@ -102,6 +125,40 @@ const appChooserSchema = z
     lastChoice: body.last_choice,
     uri: body.uri,
 }));
+const fileChooserSchema = z
+    .object({
+    accept_label: z.string().optional(),
+    choices: z.array(z.object({
+        id: z.string(),
+        initial: z.string(),
+        label: z.string(),
+        options: z.array(z.object({ id: z.string(), label: z.string() })),
+    })),
+    current_filter: z.number().optional(),
+    current_folder: z.string().optional(),
+    current_name: z.string().optional(),
+    directory: z.boolean(),
+    files: z.array(z.string()),
+    filters: z.array(z.object({ extensions: z.array(z.string()), name: z.string() })),
+    home: z.string(),
+    mode: z.enum(["open", "save", "save_files"]),
+    multiple: z.boolean(),
+    title: z.string(),
+})
+    .transform((body) => ({
+    acceptLabel: body.accept_label,
+    choices: body.choices,
+    currentFilter: body.current_filter,
+    currentFolder: body.current_folder,
+    currentName: body.current_name,
+    directory: body.directory,
+    files: body.files,
+    filters: body.filters,
+    home: body.home,
+    mode: chooserMode(body.mode),
+    multiple: body.multiple,
+    title: body.title,
+}));
 /** Each kind's wire name, and how to read its body into a request. */
 const KINDS = new Map([
     [
@@ -112,6 +169,10 @@ const KINDS = new Map([
         "app_chooser",
         (base, body) => PortalRequest.AppChooser(base, appChooserSchema.parse(body)),
     ],
+    [
+        "file_chooser",
+        (base, body) => PortalRequest.FileChooser(base, fileChooserSchema.parse(body)),
+    ],
 ]);
 const itemSchema = z.object({
     app_id: z.string(),
@@ -135,6 +196,16 @@ const parseRequest = (item) => {
         ? PortalRequest.Unknown(base, item.kind)
         : parse(base, item.body);
 };
+const chooserMode = (mode) => {
+    switch (mode) {
+        case "open":
+            return FileChooserMode.Open;
+        case "save":
+            return FileChooserMode.Save;
+        case "save_files":
+            return FileChooserMode.SaveFiles;
+    }
+};
 /** `answer` as the compositor reads it. */
 const wireAnswer = (answer) => {
     switch (answer.kind) {
@@ -144,6 +215,13 @@ const wireAnswer = (answer) => {
             return { choice: answer.choice, kind: "app_chooser" };
         case PortalAnswerKind.Canceled:
             return { kind: "canceled" };
+        case PortalAnswerKind.FileChooser:
+            return {
+                choices: Object.fromEntries(answer.chosen.choices),
+                current_filter: answer.chosen.currentFilter,
+                kind: "file_chooser",
+                paths: answer.chosen.paths,
+            };
         case PortalAnswerKind.Refused:
             return { kind: "refused" };
     }

package/package.json

@@ -95,7 +95,7 @@
     "test:unit": "bun test"
   },
   "type": "module",
-  "version": "0.0.0-alpha-eac3f852668d",
+  "version": "0.0.0-alpha-dfd80a336b89",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cprussin/domicile.git",