@vantail/api 0.1.0

package/dist/protocol.js

@@ -0,0 +1,26 @@
+/**
+ * The wire protocol, as the browser side sees it.
+ *
+ * Intentionally duplicated from `@vantail/shared` rather than imported:
+ * `@vantail/api` ships into application bundles, and a UI package with zero
+ * dependencies is worth more than one shared file. `packages/shared` holds
+ * the same shapes for the tooling side, and `runtime/src/ipc` for the native
+ * side; all three are checked against each other by the protocol tests.
+ */
+export function isEventMessage(message) {
+    return typeof message.event === "string";
+}
+/** Stable error codes. `NO_RUNTIME` is the only one the SDK raises itself. */
+export const ErrorCode = {
+    NO_RUNTIME: "NO_RUNTIME",
+    UNKNOWN_METHOD: "UNKNOWN_METHOD",
+    INVALID_PARAMS: "INVALID_PARAMS",
+    PERMISSION_DENIED: "PERMISSION_DENIED",
+    NOT_FOUND: "NOT_FOUND",
+    ALREADY_EXISTS: "ALREADY_EXISTS",
+    IO_ERROR: "IO_ERROR",
+    INVALID_UTF8: "INVALID_UTF8",
+    UNSUPPORTED: "UNSUPPORTED",
+    INTERNAL: "INTERNAL",
+};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH,MAAM,UAAU,cAAc,CAC5B,OAAwB;IAExB,OAAO,OAAQ,OAA+B,CAAC,KAAK,KAAK,QAAQ,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;CACZ,CAAC"}

package/dist/screen.d.ts

@@ -0,0 +1,49 @@
+export interface Screen {
+    /** What the operating system calls it, when it says anything. */
+    name: string | null;
+    /**
+     * Where its top-left corner sits in the desktop coordinate space, in
+     * logical pixels. A screen left of the primary one has a negative `x`.
+     */
+    position: {
+        x: number;
+        y: number;
+    };
+    /** Its size in logical pixels - the same units window methods take. */
+    size: {
+        width: number;
+        height: number;
+    };
+    /** 2 on a Retina display, 1 on most others. */
+    scaleFactor: number;
+    primary: boolean;
+}
+/**
+ * The displays a window can be put on.
+ *
+ * A page can see the screen it is on through `window.screen`, but not the
+ * others, and not where they sit relative to each other - so
+ * {@link appWindow.setPosition} is guesswork on a machine with two monitors
+ * without this.
+ *
+ * Everything is in logical pixels, matching the window methods.
+ *
+ * ```ts
+ * const { position, size } = await screen.current();
+ * await appWindow.setPosition(
+ *   position.x + (size.width - 900) / 2,
+ *   position.y + (size.height - 640) / 2,
+ * );
+ * ```
+ */
+export declare const screen: {
+    /** Every connected display. */
+    list(): Promise<Screen[]>;
+    /** The one the system considers primary, if it names one. */
+    primary(): Promise<Screen | null>;
+    /** The one this window is currently on. */
+    current(): Promise<Screen | null>;
+    /** Whichever display contains a desktop coordinate, if any does. */
+    fromPoint(x: number, y: number): Promise<Screen | null>;
+};
+//# sourceMappingURL=screen.d.ts.map

package/dist/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,iEAAiE;IACjE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,uEAAuE;IACvE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM;IACjB,+BAA+B;IAC/B,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzB,6DAA6D;IAC7D,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIjC,2CAA2C;IAC3C,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIjC,oEAAoE;IACpE,SAAS,IAAI,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGxD,CAAC"}

package/dist/screen.js

@@ -0,0 +1,38 @@
+import { invoke } from "./transport.js";
+/**
+ * The displays a window can be put on.
+ *
+ * A page can see the screen it is on through `window.screen`, but not the
+ * others, and not where they sit relative to each other - so
+ * {@link appWindow.setPosition} is guesswork on a machine with two monitors
+ * without this.
+ *
+ * Everything is in logical pixels, matching the window methods.
+ *
+ * ```ts
+ * const { position, size } = await screen.current();
+ * await appWindow.setPosition(
+ *   position.x + (size.width - 900) / 2,
+ *   position.y + (size.height - 640) / 2,
+ * );
+ * ```
+ */
+export const screen = {
+    /** Every connected display. */
+    list() {
+        return invoke("screen.list");
+    },
+    /** The one the system considers primary, if it names one. */
+    primary() {
+        return invoke("screen.primary");
+    },
+    /** The one this window is currently on. */
+    current() {
+        return invoke("screen.current");
+    },
+    /** Whichever display contains a desktop coordinate, if any does. */
+    fromPoint(x, y) {
+        return invoke("screen.fromPoint", { x, y });
+    },
+};
+//# sourceMappingURL=screen.js.map

package/dist/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAiBxC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,+BAA+B;IAC/B,IAAI;QACF,OAAO,MAAM,CAAW,aAAa,CAAC,CAAC;IACzC,CAAC;IAED,6DAA6D;IAC7D,OAAO;QACL,OAAO,MAAM,CAAgB,gBAAgB,CAAC,CAAC;IACjD,CAAC;IAED,2CAA2C;IAC3C,OAAO;QACL,OAAO,MAAM,CAAgB,gBAAgB,CAAC,CAAC;IACjD,CAAC;IAED,oEAAoE;IACpE,SAAS,CAAC,CAAS,EAAE,CAAS;QAC5B,OAAO,MAAM,CAAgB,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC"}

package/dist/secrets.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The operating system's credential store.
+ *
+ * An application that holds an OAuth refresh token has to put it somewhere.
+ * `localStorage` is a plaintext file in the application's data directory,
+ * readable by anything running as the user. This is the Keychain on macOS,
+ * the Credential Manager on Windows, and the Secret Service on Linux.
+ *
+ * Entries are filed under the application's `identifier`, so two Vantail
+ * applications on the same machine cannot read each other's.
+ *
+ * ```ts
+ * await secrets.set("service.refreshToken", token);
+ *
+ * const token = await secrets.get("service.refreshToken");
+ * if (token === null) await signIn();
+ * ```
+ *
+ * There is no `list()`: the platforms disagree about whether enumerating a
+ * store is even possible, and an API that works on one of three is worse than
+ * none. Keep your own index if you need one.
+ */
+export declare const secrets: {
+    set: (key: string, value: string) => Promise<null>;
+    /** `null` when there is nothing stored - a missing secret is an answer. */
+    get: (key: string) => Promise<string | null>;
+    has: (key: string) => Promise<boolean>;
+    /** `true` if something was removed, `false` if there was nothing there. */
+    delete: (key: string) => Promise<boolean>;
+};
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,OAAO;IAClB,GAAG,QAAQ,MAAM,SAAS,MAAM;IAGhC,2EAA2E;IAC3E,GAAG,QAAQ,MAAM;IAEjB,GAAG,QAAQ,MAAM;IAEjB,2EAA2E;IAC3E,MAAM,QAAQ,MAAM;CACrB,CAAC"}

package/dist/secrets.js

@@ -0,0 +1,32 @@
+import { invoke } from "./transport.js";
+/**
+ * The operating system's credential store.
+ *
+ * An application that holds an OAuth refresh token has to put it somewhere.
+ * `localStorage` is a plaintext file in the application's data directory,
+ * readable by anything running as the user. This is the Keychain on macOS,
+ * the Credential Manager on Windows, and the Secret Service on Linux.
+ *
+ * Entries are filed under the application's `identifier`, so two Vantail
+ * applications on the same machine cannot read each other's.
+ *
+ * ```ts
+ * await secrets.set("service.refreshToken", token);
+ *
+ * const token = await secrets.get("service.refreshToken");
+ * if (token === null) await signIn();
+ * ```
+ *
+ * There is no `list()`: the platforms disagree about whether enumerating a
+ * store is even possible, and an API that works on one of three is worse than
+ * none. Keep your own index if you need one.
+ */
+export const secrets = {
+    set: (key, value) => invoke("secrets.set", { key, value }),
+    /** `null` when there is nothing stored - a missing secret is an answer. */
+    get: (key) => invoke("secrets.get", { key }),
+    has: (key) => invoke("secrets.has", { key }),
+    /** `true` if something was removed, `false` if there was nothing there. */
+    delete: (key) => invoke("secrets.delete", { key }),
+};
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,EAAE,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE,CAClC,MAAM,CAAO,aAAa,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAE7C,2EAA2E;IAC3E,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAgB,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC;IAEnE,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAU,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC;IAE7D,2EAA2E;IAC3E,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAU,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC;CACpE,CAAC"}

package/dist/shell.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Handing something to the system's default application.
+ *
+ * Small API, large blast radius: on every platform "open this path" can mean
+ * "run this program". It is denied unless `permissions.shell.open` says
+ * otherwise, and the pattern is matched against the exact string you pass.
+ */
+export declare const shell: {
+    /** A URL, or a path to a file or directory. */
+    open: (target: string, options?: {
+        with?: string;
+    }) => Promise<null>;
+};
+//# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,KAAK;IAChB,+CAA+C;IAC/C,IAAI,WAAW,MAAM,YAAW;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;CAElD,CAAC"}

package/dist/shell.js

@@ -0,0 +1,13 @@
+import { invoke } from "./transport.js";
+/**
+ * Handing something to the system's default application.
+ *
+ * Small API, large blast radius: on every platform "open this path" can mean
+ * "run this program". It is denied unless `permissions.shell.open` says
+ * otherwise, and the pattern is matched against the exact string you pass.
+ */
+export const shell = {
+    /** A URL, or a path to a file or directory. */
+    open: (target, options = {}) => invoke("shell.open", { target, ...options }),
+};
+//# sourceMappingURL=shell.js.map

package/dist/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,+CAA+C;IAC/C,IAAI,EAAE,CAAC,MAAc,EAAE,OAAO,GAAsB,EAAE,EAAE,EAAE,CACxD,MAAM,CAAO,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;CACrD,CAAC"}

package/dist/shortcut.d.ts

@@ -0,0 +1,45 @@
+export interface Shortcut {
+    /** What {@link shortcut.onPressed} reports. The accelerator, unless given. */
+    id: string;
+    /** The combination itself, e.g. `CmdOrCtrl+Shift+K`. */
+    accelerator: string;
+}
+export interface RegisterOptions {
+    /**
+     * A name for this shortcut, if the accelerator is not one you want to
+     * switch on. Handy when the combination is configurable.
+     */
+    id?: string;
+}
+/**
+ * Key combinations that fire while your application is in the background.
+ *
+ * A page only sees keys while it has focus, which is exactly what a global
+ * shortcut is not for - so this is native.
+ *
+ * Registration is system-wide, so it can fail because another application
+ * already owns the combination. That throws `ALREADY_EXISTS`, and it is worth
+ * handling: it is an ordinary thing to happen, not a bug.
+ *
+ * ```ts
+ * await shortcut.register("CmdOrCtrl+Shift+K", { id: "toggle" });
+ * shortcut.onPressed(({ id }) => {
+ *   if (id === "toggle") void appWindow.show();
+ * });
+ * ```
+ */
+export declare const shortcut: {
+    /** Claim a combination system-wide. */
+    register(accelerator: string, options?: RegisterOptions): Promise<Shortcut>;
+    /** Give one back. Throws `NOT_FOUND` if it was never registered. */
+    unregister(accelerator: string): Promise<void>;
+    /** Give all of them back. */
+    unregisterAll(): Promise<void>;
+    /** Whether *this application* holds it. Another one might. */
+    isRegistered(accelerator: string): Promise<boolean>;
+    /** Everything this application currently holds. */
+    list(): Promise<Shortcut[]>;
+    /** Fires on press, wherever the user happens to be. */
+    onPressed(handler: (shortcut: Shortcut) => void): () => void;
+};
+//# sourceMappingURL=shortcut.d.ts.map

package/dist/shortcut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcut.d.ts","sourceRoot":"","sources":["../src/shortcut.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ;IACnB,uCAAuC;IACvC,QAAQ,cACO,MAAM,YACV,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC;IAIpB,oEAAoE;IACpE,UAAU,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,6BAA6B;IAC7B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,8DAA8D;IAC9D,YAAY,cAAc,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,mDAAmD;IACnD,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI3B,uDAAuD;IACvD,SAAS,UAAU,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;CAG7D,CAAC"}

package/dist/shortcut.js

@@ -0,0 +1,45 @@
+import { invoke, listen } from "./transport.js";
+/**
+ * Key combinations that fire while your application is in the background.
+ *
+ * A page only sees keys while it has focus, which is exactly what a global
+ * shortcut is not for - so this is native.
+ *
+ * Registration is system-wide, so it can fail because another application
+ * already owns the combination. That throws `ALREADY_EXISTS`, and it is worth
+ * handling: it is an ordinary thing to happen, not a bug.
+ *
+ * ```ts
+ * await shortcut.register("CmdOrCtrl+Shift+K", { id: "toggle" });
+ * shortcut.onPressed(({ id }) => {
+ *   if (id === "toggle") void appWindow.show();
+ * });
+ * ```
+ */
+export const shortcut = {
+    /** Claim a combination system-wide. */
+    register(accelerator, options = {}) {
+        return invoke("shortcut.register", { accelerator, ...options });
+    },
+    /** Give one back. Throws `NOT_FOUND` if it was never registered. */
+    unregister(accelerator) {
+        return invoke("shortcut.unregister", { accelerator });
+    },
+    /** Give all of them back. */
+    unregisterAll() {
+        return invoke("shortcut.unregisterAll");
+    },
+    /** Whether *this application* holds it. Another one might. */
+    isRegistered(accelerator) {
+        return invoke("shortcut.isRegistered", { accelerator });
+    },
+    /** Everything this application currently holds. */
+    list() {
+        return invoke("shortcut.list");
+    },
+    /** Fires on press, wherever the user happens to be. */
+    onPressed(handler) {
+        return listen("shortcut.pressed", handler);
+    },
+};
+//# sourceMappingURL=shortcut.js.map

package/dist/shortcut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcut.js","sourceRoot":"","sources":["../src/shortcut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAiBhD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,uCAAuC;IACvC,QAAQ,CACN,WAAmB,EACnB,OAAO,GAAoB,EAAE;QAE7B,OAAO,MAAM,CAAW,mBAAmB,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,oEAAoE;IACpE,UAAU,CAAC,WAAmB;QAC5B,OAAO,MAAM,CAAO,qBAAqB,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,6BAA6B;IAC7B,aAAa;QACX,OAAO,MAAM,CAAO,wBAAwB,CAAC,CAAC;IAChD,CAAC;IAED,8DAA8D;IAC9D,YAAY,CAAC,WAAmB;QAC9B,OAAO,MAAM,CAAU,uBAAuB,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,mDAAmD;IACnD,IAAI;QACF,OAAO,MAAM,CAAa,eAAe,CAAC,CAAC;IAC7C,CAAC;IAED,uDAAuD;IACvD,SAAS,CAAC,OAAqC;QAC7C,OAAO,MAAM,CAAW,kBAAkB,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The one place that talks to the runtime.
+ *
+ * Requests go out through the injected bridge and come back matched by id.
+ * Everything else in this package is a typed wrapper around `invoke`.
+ */
+import { type VantailBridge } from "./protocol.js";
+/** Whether this page is running inside a Vantail window. */
+export declare function isVantail(): boolean;
+/**
+ * Static application facts the runtime injected, available synchronously.
+ * Returns `undefined` in a plain browser.
+ */
+export declare function bridgeInfo(): VantailBridge["app"] | undefined;
+/** Version of the native runtime, or `undefined` outside one. */
+export declare function runtimeVersion(): string | undefined;
+/**
+ * The label of the window this code is running in, without awaiting.
+ * `undefined` in a plain browser.
+ */
+export declare function windowLabel(): string | undefined;
+/**
+ * Call a native method.
+ *
+ * Prefer the typed modules (`filesystem`, `dialog`, ...); this is the escape
+ * hatch for methods the SDK does not wrap yet.
+ */
+export declare function invoke<T = unknown>(method: string, params?: unknown): Promise<T>;
+/**
+ * Listen for a runtime event. Returns an unsubscribe function.
+ *
+ * Listening does not require the runtime to be present - outside a Vantail
+ * window the returned function is simply never called.
+ */
+export declare function listen<T = unknown>(event: string, handler: (payload: T) => void): () => void;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,eAAe,CAAC;AAmBvB,4DAA4D;AAC5D,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,SAAS,CAE7D;AAED,iEAAiE;AACjE,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAEhD;AAwCD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,OAAO,EAChC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,OAAO,EAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAC5B,MAAM,IAAI,CAoBZ"}

package/dist/transport.js

@@ -0,0 +1,141 @@
+/**
+ * The one place that talks to the runtime.
+ *
+ * Requests go out through the injected bridge and come back matched by id.
+ * Everything else in this package is a typed wrapper around `invoke`.
+ */
+import { isEventMessage, } from "./protocol.js";
+import { noRuntime, VantailError } from "./error.js";
+const pending = new Map();
+const listeners = new Map();
+let subscription = null;
+let counter = 0;
+function getBridge() {
+    return globalThis.__VANTAIL__;
+}
+/** Whether this page is running inside a Vantail window. */
+export function isVantail() {
+    return getBridge() !== undefined;
+}
+/**
+ * Static application facts the runtime injected, available synchronously.
+ * Returns `undefined` in a plain browser.
+ */
+export function bridgeInfo() {
+    return getBridge()?.app;
+}
+/** Version of the native runtime, or `undefined` outside one. */
+export function runtimeVersion() {
+    return getBridge()?.version;
+}
+/**
+ * The label of the window this code is running in, without awaiting.
+ * `undefined` in a plain browser.
+ */
+export function windowLabel() {
+    return getBridge()?.label;
+}
+function requireBridge() {
+    const bridge = getBridge();
+    if (!bridge)
+        throw noRuntime();
+    subscribe(bridge);
+    return bridge;
+}
+function subscribe(bridge) {
+    if (subscription)
+        return;
+    subscription = bridge.subscribe(receive);
+}
+function receive(message) {
+    if (isEventMessage(message)) {
+        const handlers = listeners.get(message.event);
+        if (!handlers)
+            return;
+        // Copy first: a handler is allowed to unsubscribe itself.
+        for (const handler of [...handlers]) {
+            try {
+                handler(message.payload);
+            }
+            catch (error) {
+                console.error(`[vantail] a "${message.event}" listener threw`, error);
+            }
+        }
+        return;
+    }
+    const entry = pending.get(message.id);
+    if (!entry)
+        return;
+    pending.delete(message.id);
+    if (message.error) {
+        entry.reject(VantailError.from(message.error));
+    }
+    else {
+        entry.resolve(message.result ?? null);
+    }
+}
+/**
+ * Call a native method.
+ *
+ * Prefer the typed modules (`filesystem`, `dialog`, ...); this is the escape
+ * hatch for methods the SDK does not wrap yet.
+ */
+export function invoke(method, params) {
+    let bridge;
+    try {
+        bridge = requireBridge();
+    }
+    catch (error) {
+        return Promise.reject(error);
+    }
+    const id = nextId();
+    return new Promise((resolve, reject) => {
+        pending.set(id, { resolve: resolve, reject });
+        try {
+            bridge.postMessage({ id, method, params });
+        }
+        catch (error) {
+            pending.delete(id);
+            reject(new VantailError("INTERNAL", `Could not send \`${method}\` to the runtime: ${String(error)}`));
+        }
+    });
+}
+/**
+ * Listen for a runtime event. Returns an unsubscribe function.
+ *
+ * Listening does not require the runtime to be present - outside a Vantail
+ * window the returned function is simply never called.
+ */
+export function listen(event, handler) {
+    let handlers = listeners.get(event);
+    if (!handlers) {
+        handlers = new Set();
+        listeners.set(event, handlers);
+    }
+    handlers.add(handler);
+    // Registered before subscribing: subscribing hands over anything that
+    // arrived before this page's script ran, and a handler added afterwards
+    // would miss exactly the message it was written for.
+    const bridge = getBridge();
+    if (bridge)
+        subscribe(bridge);
+    return () => {
+        const current = listeners.get(event);
+        if (!current)
+            return;
+        current.delete(handler);
+        if (current.size === 0)
+            listeners.delete(event);
+    };
+}
+function nextId() {
+    const crypto = globalThis.crypto;
+    if (crypto && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID();
+    }
+    // Only needs to be unique within this page, not unguessable: the channel is
+    // the platform's own IPC, not a network socket.
+    counter += 1;
+    return `vantail-${Date.now().toString(36)}-${counter}`;
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/tray.d.ts

@@ -0,0 +1,59 @@
+import { type MenuItem } from "./menu.js";
+export interface TrayOptions {
+    /** PNG path. Relative paths resolve inside the application's resources. */
+    icon?: string;
+    tooltip?: string;
+    /** Text beside the icon. macOS only. */
+    title?: string;
+    /**
+     * Render the icon as a monochrome template. On macOS this is what makes it
+     * invert correctly against a dark menu bar - usually what you want.
+     */
+    iconAsTemplate?: boolean;
+    menu?: MenuItem[];
+    /**
+     * What a left click on the icon does. A right click always opens the menu.
+     *
+     * - `showWindow` (default) - bring the window back if it is hidden, focus
+     *   it if it is behind something, and open the menu if it is already in
+     *   front. Which is what a tray icon is usually for.
+     * - `menu` - always open the menu, the older macOS convention.
+     * - `event` - do nothing but fire {@link tray.onClick}.
+     */
+    leftClick?: "showWindow" | "menu" | "event";
+    /** Which window `showWindow` brings back. `main` by default. */
+    window?: string;
+}
+export interface TrayClick {
+    button: string;
+    /** Screen coordinates, in physical pixels. */
+    x: number;
+    y: number;
+}
+/**
+ * The menu bar / system tray icon.
+ *
+ * An application that wants to keep running with no window open should also
+ * set `quitOnLastWindowClosed: false` in its config - otherwise closing the
+ * window takes the tray icon with it.
+ */
+export declare const tray: {
+    /** Create the tray icon, or replace the one that is there. */
+    set: (options: TrayOptions) => Promise<null>;
+    remove: () => Promise<null>;
+    exists: () => Promise<boolean>;
+    setIcon: (icon: string, options?: {
+        template?: boolean;
+    }) => Promise<null>;
+    setTooltip: (tooltip: string | null) => Promise<null>;
+    /** macOS only; ignored elsewhere. */
+    setTitle: (title: string | null) => Promise<null>;
+    setVisible: (visible: boolean) => Promise<null>;
+    setMenu: (items: MenuItem[]) => Promise<null>;
+    /** Open the tray menu without waiting for a click on the icon. */
+    showMenu: () => Promise<null>;
+    onClick: (handler: (event: TrayClick) => void) => () => void;
+    /** Windows only. */
+    onDoubleClick: (handler: (event: TrayClick) => void) => () => void;
+};
+//# sourceMappingURL=tray.d.ts.map

package/dist/tray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tray.d.ts","sourceRoot":"","sources":["../src/tray.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrD,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;IAC5C,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI;IACf,8DAA8D;IAC9D,GAAG,YAAY,WAAW;IAM1B,MAAM;IACN,MAAM;IAEN,OAAO,SAAS,MAAM,YAAW;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAEvD,UAAU,YAAY,MAAM,GAAG,IAAI;IAEnC,qCAAqC;IACrC,QAAQ,UAAU,MAAM,GAAG,IAAI;IAC/B,UAAU,YAAY,OAAO;IAE7B,OAAO,UAAU,QAAQ,EAAE;IAG3B,kEAAkE;IAClE,QAAQ;IAER,OAAO,YAAY,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI;IAE7C,oBAAoB;IACpB,aAAa,YAAY,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI;CAEpD,CAAC"}

package/dist/tray.js

@@ -0,0 +1,30 @@
+import { normalize } from "./menu.js";
+import { invoke, listen } from "./transport.js";
+/**
+ * The menu bar / system tray icon.
+ *
+ * An application that wants to keep running with no window open should also
+ * set `quitOnLastWindowClosed: false` in its config - otherwise closing the
+ * window takes the tray icon with it.
+ */
+export const tray = {
+    /** Create the tray icon, or replace the one that is there. */
+    set: (options) => invoke("tray.set", {
+        ...options,
+        ...(options.menu ? { menu: normalize(options.menu) } : {}),
+    }),
+    remove: () => invoke("tray.remove"),
+    exists: () => invoke("tray.exists"),
+    setIcon: (icon, options = {}) => invoke("tray.setIcon", { icon, ...options }),
+    setTooltip: (tooltip) => invoke("tray.setTooltip", { tooltip }),
+    /** macOS only; ignored elsewhere. */
+    setTitle: (title) => invoke("tray.setTitle", { title }),
+    setVisible: (visible) => invoke("tray.setVisible", { visible }),
+    setMenu: (items) => invoke("tray.setMenu", { items: normalize(items) }),
+    /** Open the tray menu without waiting for a click on the icon. */
+    showMenu: () => invoke("tray.showMenu"),
+    onClick: (handler) => listen("tray.click", handler),
+    /** Windows only. */
+    onDoubleClick: (handler) => listen("tray.doubleClick", handler),
+};
+//# sourceMappingURL=tray.js.map

package/dist/tray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tray.js","sourceRoot":"","sources":["../src/tray.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAmChD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,8DAA8D;IAC9D,GAAG,EAAE,CAAC,OAAoB,EAAE,EAAE,CAC5B,MAAM,CAAO,UAAU,EAAE;QACvB,GAAG,OAAO;QACV,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;IAEJ,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAO,aAAa,CAAC;IACzC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAU,aAAa,CAAC;IAE5C,OAAO,EAAE,CAAC,IAAY,EAAE,OAAO,GAA2B,EAAE,EAAE,EAAE,CAC9D,MAAM,CAAO,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;IACpD,UAAU,EAAE,CAAC,OAAsB,EAAE,EAAE,CACrC,MAAM,CAAO,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC;IAC9C,qCAAqC;IACrC,QAAQ,EAAE,CAAC,KAAoB,EAAE,EAAE,CAAC,MAAM,CAAO,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC;IAC5E,UAAU,EAAE,CAAC,OAAgB,EAAE,EAAE,CAC/B,MAAM,CAAO,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC;IAC9C,OAAO,EAAE,CAAC,KAAiB,EAAE,EAAE,CAC7B,MAAM,CAAO,cAAc,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAE3D,kEAAkE;IAClE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAO,eAAe,CAAC;IAE7C,OAAO,EAAE,CAAC,OAAmC,EAAE,EAAE,CAC/C,MAAM,CAAY,YAAY,EAAE,OAAO,CAAC;IAC1C,oBAAoB;IACpB,aAAa,EAAE,CAAC,OAAmC,EAAE,EAAE,CACrD,MAAM,CAAY,kBAAkB,EAAE,OAAO,CAAC;CACjD,CAAC"}