Dialogs

Native file pickers and message dialogs.

Config key	dialogs
JS namespace	Dialogs
Core	No
Phases	Bindable
Hard deps	—
Platforms	macOS · Linux · Windows

---

JavaScript API

All methods return a Promise and block until the user dismisses the dialog.

File pickers

import { lune } from "../lunejs/runtime/runtime.js";

// Single file
const path = await lune.Dialogs.openFile({ prompt: "Select a config file" });
if (path) loadConfig(path);

// Directory
const dir = await lune.Dialogs.openDir({ prompt: "Choose output folder" });

// Multiple files
const paths = await lune.Dialogs.openFiles({ prompt: "Select images" });

// Save dialog
const dest = await lune.Dialogs.saveFile({
  prompt: "Save as",
  filename: "output.csv",
});

File pickers return an empty string (or empty array for openFiles) when the user cancels.

File-type filters

openFile, openFiles, and saveFile accept an optional filters array that constrains the picker to specific extensions:

const path = await lune.Dialogs.openFile({
  prompt: "Choose an icon",
  filters: [{ name: "Tray icons", extensions: ["ico", "icns", "png", "svg"] }],
});

const paths = await lune.Dialogs.openFiles({
  prompt: "Pick images",
  filters: [
    { name: "Raster", extensions: ["png", "jpg", "jpeg"] },
    { name: "Vector", extensions: ["svg"] },
  ],
});

const dest = await lune.Dialogs.saveFile({
  prompt: "Export",
  filename: "data.csv",
  filters: [
    { name: "CSV", extensions: ["csv"] },
    { name: "JSON", extensions: ["json"] },
  ],
});

Each filter is { name: string, extensions: string[] } — pass extensions WITHOUT the leading dot ("png", not ".png"). Omitted or empty array = no filtering. Behaviour per platform:

• Windows maps to lpstrFilter on GetOpenFileNameW / GetSaveFileNameW; multiple filters show as a dropdown ("Tray icons (.ico;.icns;…)"). saveFile also sets lpstrDefExt to the first extension of the first filter, so a name typed without an extension auto-gains one.
• macOS maps to NSOpenPanel.allowedFileTypes / NSSavePanel.allowedFileTypes. AppKit's older API is a flat union — multiple groups collapse into a single allowed-extensions set (no in-dialog dropdown).
• Linux adds one GtkFileFilter per group; each extension becomes a *.ext glob. GTK shows a dropdown when multiple filters are present.

Message dialogs

await lune.Dialogs.messageInfo({
  title: "Update available",
  message: "Version 2.0 is ready to install.",
});
await lune.Dialogs.messageWarning({
  title: "Low disk space",
  message: "Less than 1 GB remaining.",
});
await lune.Dialogs.messageError({
  title: "Export failed",
  message: "Could not write to the destination.",
});

// Question — returns the label of the clicked button
const answer = await lune.Dialogs.messageQuestion({
  title: "Confirm",
  message: "Delete all files?",
});
if (answer === "OK") deleteAll();

---

Full API reference

Method	Signature	Returns
openFile	openFile({ prompt, filters? })	Promise<string> — path or ""
openDir	openDir({ prompt })	Promise<string> — path or ""
openFiles	openFiles({ prompt, filters? })	Promise<string[]>
saveFile	saveFile({ prompt, filename, filters? })	Promise<string> — path or ""
messageInfo	messageInfo({ title, message })	Promise<void>
messageWarning	messageWarning({ title, message })	Promise<void>
messageError	messageError({ title, message })	Promise<void>
messageQuestion	messageQuestion({ title, message })	Promise<string> — button label

filters is { name: string; extensions: string[] }[]. Omitted or [] = no filter.

---

Platform notes

• macOS — Verified, including file-type filters via the demo's tray icon picker. Filters map to NSOpenPanel.allowedFileTypes (flat union across groups; no in-dialog dropdown — see API surface above).
• Linux — Untested. File-type filters use one GtkFileFilter per group, glob patterns *.ext.
• Windows — Verified, including file-type filters via the demo's tray icon picker. Filters use lpstrFilter and lpstrDefExt; multiple filters show as a dropdown. Open / save / message icons + buttons correct since v0.11.0.

---

Disabling

plugins:
  disabled:
    - dialogs