@gjsify/adwaita-app 0.38.1 → 0.40.0

package/README.md

@@ -87,7 +87,11 @@ promise-job queue under `run()`).
 
 ### Interaction helpers
 
-- `confirmDialog(parent, { heading, body?, confirmLabel?, cancelLabel?, destructive? }): Promise<boolean>`
+- `confirmDialog(parent, { heading, body?, confirmLabel?, cancelLabel?, destructive?, defaultResponse? }): Promise<boolean>`
+  — `defaultResponse` (`'confirm' | 'cancel'`, default `'confirm'`) picks the
+  response Enter activates. A destructive question wants both: `destructive: true`
+  for the red button and `defaultResponse: 'cancel'` so the reflex keystroke
+  escapes instead of deleting. An id that is neither throws a `TypeError`.
 - `errorDialog(parent, heading, body?): Promise<void>`
 - `registerToastOverlay(overlay)` + `showToast(title, timeout?)`
 - `pickFile(parent, { title?, filters? }): Promise<string | null>` /

package/lib/esm/dialog-model.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";function isConfirmResponse(e){return e===`confirm`||e===`cancel`}function resolveDefaultResponse(e){if(e===void 0)return`confirm`;if(!isConfirmResponse(e))throw TypeError(`@gjsify/adwaita-app: confirmDialog defaultResponse must be 'confirm' or 'cancel', got ${JSON.stringify(e)}`);return e}export{resolveDefaultResponse};

package/lib/esm/dialogs.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import e from"@girs/adw-1";function confirmDialog(t,n){return new Promise(r=>{let i=new e.AlertDialog({heading:n.heading,body:n.body??``});i.add_response(`cancel`,n.cancelLabel??`Cancel`),i.add_response(`confirm`,n.confirmLabel??`OK`),i.set_response_appearance(`confirm`,n.destructive?e.ResponseAppearance.DESTRUCTIVE:e.ResponseAppearance.SUGGESTED),i.set_default_response(`confirm`),i.set_close_response(`cancel`),i.connect(`response`,(e,t)=>r(t===`confirm`)),i.present(t)})}function errorDialog(t,n,r){return new Promise(i=>{let a=new e.AlertDialog({heading:n,body:r??``});a.add_response(`ok`,`OK`),a.set_default_response(`ok`),a.set_close_response(`ok`),a.connect(`response`,()=>i()),a.present(t)})}export{confirmDialog,errorDialog};
+import"./_virtual/_rolldown/runtime.js";import{resolveDefaultResponse as e}from"./dialog-model.js";import t from"@girs/adw-1";function confirmDialog(n,r){let i=e(r.defaultResponse);return new Promise(e=>{let a=new t.AlertDialog({heading:r.heading,body:r.body??``});a.add_response(`cancel`,r.cancelLabel??`Cancel`),a.add_response(`confirm`,r.confirmLabel??`OK`),a.set_response_appearance(`confirm`,r.destructive?t.ResponseAppearance.DESTRUCTIVE:t.ResponseAppearance.SUGGESTED),a.set_default_response(i),a.set_close_response(`cancel`),a.connect(`response`,(t,n)=>e(n===`confirm`)),a.present(n)})}function errorDialog(e,n,r){return new Promise(i=>{let a=new t.AlertDialog({heading:n,body:r??``});a.add_response(`ok`,`OK`),a.set_default_response(`ok`),a.set_close_response(`ok`),a.connect(`response`,()=>i()),a.present(e)})}export{confirmDialog,errorDialog};

package/lib/types/dialog-model.d.ts

@@ -0,0 +1,16 @@
+import type { ConfirmResponse } from './types.js';
+/**
+ * Resolve which response a confirm dialog opens focused on — the one Enter picks.
+ *
+ * Falls back to `confirm`, which is what every caller of the option-less API
+ * already gets; changing that default would change published behaviour under
+ * consumers who never asked for it.
+ *
+ * The id is checked at RUNTIME, not just by the union: the type is erased, and
+ * `adw_alert_dialog_set_default_response()` takes any string — an id matching no
+ * response stores the quark and never touches the default widget, so a typo
+ * ships as a dialog where Enter quietly does nothing.
+ *
+ * @throws TypeError for an id the dialog has no response for.
+ */
+export declare function resolveDefaultResponse(requested?: string): ConfirmResponse;

package/lib/types/dialog-model.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/dialogs.d.ts

@@ -1,4 +1,5 @@
 import type Gtk from '@girs/gtk-4.0';
+import type { ConfirmResponse } from './types.js';
 /** Options for {@link confirmDialog}. */
 export interface ConfirmOptions {
     /** Dialog heading. */
@@ -11,6 +12,14 @@ export interface ConfirmOptions {
     cancelLabel?: string;
     /** Style the confirm button as destructive (red) instead of suggested. */
     destructive?: boolean;
+    /**
+     * Response the dialog opens focused on, so Enter activates it. Default `confirm`.
+     *
+     * Pair `cancel` with `destructive`: what makes a "really delete this?" dialog
+     * worth showing is the accidental gesture, and a `confirm` default hands the
+     * reflex of dismissing a dialog with Enter the deletion instead of the escape.
+     */
+    defaultResponse?: ConfirmResponse;
 }
 /**
  * Present a confirm/cancel `Adw.AlertDialog`; resolves `true` on confirm, `false`

package/lib/types/index.d.ts

@@ -13,4 +13,4 @@ export type { FileFilterSpec, PickFileOptions } from './file-dialog.js';
 export { readAppDevHooks } from './dev-hooks.js';
 export type { AppDevHooks, ReadAppDevHooksOptions } from './dev-hooks.js';
 export { findNavItem, resolveInitialNavIndex } from './nav-model.js';
-export type { AboutInfo, NavItem } from './types.js';
+export type { AboutInfo, ConfirmResponse, NavItem } from './types.js';

package/lib/types/types.d.ts

@@ -1,3 +1,5 @@
+/** The two response ids a `confirmDialog` adds to its `Adw.AlertDialog`. */
+export type ConfirmResponse = 'confirm' | 'cancel';
 /** A single entry in the navigation sidebar / view stack. */
 export interface NavItem {
     /** Stable id used as the `Gtk.Stack` child name and for `selectById`. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-app",
-    "version": "0.38.1",
+    "version": "0.40.0",
     "description": "Native Adwaita application shell for GJS/GTK apps — Adw.Application lifecycle (runAsync + devtools + CSS), a data-driven NavigationSplitView nav shell, an async-view mounter, and promise dialog/toast/file helpers",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -46,12 +46,12 @@
         "@girs/glib-2.0": "^4.1.0",
         "@girs/gobject-2.0": "^4.1.0",
         "@girs/gtk-4.0": "^4.1.0",
-        "@gjsify/devtools": "^0.38.1"
+        "@gjsify/devtools": "^0.40.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.38.1",
-        "@gjsify/storybook": "^0.38.1",
-        "@gjsify/unit": "^0.38.1",
+        "@gjsify/cli": "^0.40.0",
+        "@gjsify/storybook": "^0.40.0",
+        "@gjsify/unit": "^0.40.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },