@gjsify/adwaita-app 0.42.0 → 0.43.0

package/lib/esm/dialogs.js

@@ -1 +1 @@
-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};
+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,i){return new Promise(a=>{let o=new t.AlertDialog({heading:n,body:r??``});o.add_response(`ok`,i??`OK`),o.set_default_response(`ok`),o.set_close_response(`ok`),o.connect(`response`,()=>a()),o.present(e)})}export{confirmDialog,errorDialog};

package/lib/esm/index.js

@@ -1 +1 @@
-import{AdwaitaApp as e,runAdwaitaApp as t,runApplication as n}from"./application.js";import{readAppDevHooks as r}from"./dev-hooks.js";import{confirmDialog as i,errorDialog as a}from"./dialogs.js";import{pickFile as o,saveFile as s}from"./file-dialog.js";import{createNavShell as c}from"./nav-shell.js";import{LoadToken as l,loadIntoStack as u}from"./view-loader.js";import{LoadingStack as d}from"./loading-stack.js";import{registerToastOverlay as f,showToast as p}from"./toast.js";import{findNavItem as m,resolveInitialNavIndex as h}from"./nav-model.js";export{e as AdwaitaApp,l as LoadToken,d as LoadingStack,i as confirmDialog,c as createNavShell,a as errorDialog,m as findNavItem,u as loadIntoStack,o as pickFile,r as readAppDevHooks,f as registerToastOverlay,h as resolveInitialNavIndex,t as runAdwaitaApp,n as runApplication,s as saveFile,p as showToast};
+import{AdwaitaApp as e,runAdwaitaApp as t,runApplication as n}from"./application.js";import{readAppDevHooks as r}from"./dev-hooks.js";import{confirmDialog as i,errorDialog as a}from"./dialogs.js";import{pickFile as o,saveFile as s}from"./file-dialog.js";import{createNavShell as c}from"./nav-shell.js";import{LoadToken as l,loadIntoStack as u}from"./view-loader.js";import{LoadingStack as d}from"./loading-stack.js";import{registerToastOverlay as f,showToast as p}from"./toast.js";import{SYSTEM_LOCALE_DIR as m,resolveLocaleDir as h}from"./locale-dir.js";import{initLocale as g}from"./locale.js";import{findNavItem as _,resolveInitialNavIndex as v}from"./nav-model.js";export{e as AdwaitaApp,l as LoadToken,d as LoadingStack,m as SYSTEM_LOCALE_DIR,i as confirmDialog,c as createNavShell,a as errorDialog,_ as findNavItem,g as initLocale,u as loadIntoStack,o as pickFile,r as readAppDevHooks,f as registerToastOverlay,v as resolveInitialNavIndex,h as resolveLocaleDir,t as runAdwaitaApp,n as runApplication,s as saveFile,p as showToast};

package/lib/esm/locale-dir.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";const e=`/usr/share/locale`;function resolveLocaleDir(e={}){return nonEmpty(e.localeDir)??nonEmpty(e.env?.GJSIFY_LOCALE_DIR)??nonEmpty(e.fallbackDir)??`/usr/share/locale`}function nonEmpty(e){if(e===void 0)return;let t=e.trim();return t===``?void 0:t}export{e as SYSTEM_LOCALE_DIR,resolveLocaleDir};

package/lib/esm/locale.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";import{resolveLocaleDir as e}from"./locale-dir.js";import t from"@girs/glib-2.0";import n from"gettext";function initLocale(r,i={}){let a=e({...i,env:{GJSIFY_LOCALE_DIR:t.getenv(`GJSIFY_LOCALE_DIR`)??void 0}});return n.setlocale(n.LocaleCategory.ALL,``),n.bindtextdomain(r,a),n.textdomain(r),Object.assign(e=>n.dgettext(r,e),{plural:(e,t,i)=>n.dngettext(r,e,t,i),context:(e,t)=>n.dpgettext(r,e,t),localeDir:a,domain:r})}export{initLocale};

package/lib/types/dialogs.d.ts

@@ -26,5 +26,12 @@ export interface ConfirmOptions {
  * on cancel/dismiss. `parent` anchors the dialog (typically the window).
  */
 export declare function confirmDialog(parent: Gtk.Widget, options: ConfirmOptions): Promise<boolean>;
-/** Present a single-button error `Adw.AlertDialog`; resolves when dismissed. */
-export declare function errorDialog(parent: Gtk.Widget, heading: string, body?: string): Promise<void>;
+/**
+ * Present a single-button error `Adw.AlertDialog`; resolves when dismissed.
+ *
+ * `okLabel` exists for the same reason {@link ConfirmOptions} carries `cancelLabel` and
+ * `confirmLabel`: this is library code with no text domain of its own, so a caption it hardcodes is
+ * one no application can translate. The English default stays as the fallback — an app that passes
+ * nothing gets "OK", which is at least honest about being untranslated rather than untranslatable.
+ */
+export declare function errorDialog(parent: Gtk.Widget, heading: string, body?: string, okLabel?: string): Promise<void>;

package/lib/types/index.d.ts

@@ -10,6 +10,10 @@ export type { ConfirmOptions } from './dialogs.js';
 export { registerToastOverlay, showToast } from './toast.js';
 export { pickFile, saveFile } from './file-dialog.js';
 export type { FileFilterSpec, PickFileOptions } from './file-dialog.js';
+export { initLocale } from './locale.js';
+export type { InitLocaleOptions, Translator } from './locale.js';
+export { SYSTEM_LOCALE_DIR, resolveLocaleDir } from './locale-dir.js';
+export type { ResolveLocaleDirOptions } from './locale-dir.js';
 export { readAppDevHooks } from './dev-hooks.js';
 export type { AppDevHooks, ReadAppDevHooksOptions } from './dev-hooks.js';
 export { findNavItem, resolveInitialNavIndex } from './nav-model.js';

package/lib/types/locale-dir.d.ts

@@ -0,0 +1,18 @@
+/** `bindtextdomain`'s directory for a system install, when nothing else names one. */
+export declare const SYSTEM_LOCALE_DIR = "/usr/share/locale";
+export interface ResolveLocaleDirOptions {
+    /** Wins over everything — a dev tree (`dist/locale`), or a test fixture. */
+    localeDir?: string;
+    /** Environment to read `GJSIFY_LOCALE_DIR` from. */
+    env?: Record<string, string | undefined>;
+    /** Used when neither the option nor the environment names a directory. */
+    fallbackDir?: string;
+}
+/**
+ * Resolve the directory to bind a text domain to.
+ *
+ * Precedence: explicit option, then `GJSIFY_LOCALE_DIR` (exported by the `gjsify ship` launcher,
+ * which is the only party that knows whether the payload became `/usr`, a `--prefix` tree or
+ * `/app`), then the caller's fallback, then the system directory.
+ */
+export declare function resolveLocaleDir(options?: ResolveLocaleDirOptions): string;

package/lib/types/locale-dir.spec.d.ts

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

package/lib/types/locale.d.ts

@@ -0,0 +1,20 @@
+import { type ResolveLocaleDirOptions } from './locale-dir.js';
+export type InitLocaleOptions = Omit<ResolveLocaleDirOptions, 'env'>;
+/** A domain-bound lookup. Callable for the common case; `plural`/`context` for the rest. */
+export interface Translator {
+    (msgid: string): string;
+    /** `n`-aware lookup. Pass the untranslated singular and plural. */
+    plural(singular: string, plural: string, n: number): string;
+    /** Disambiguating lookup, for a msgid whose meaning depends on where it appears. */
+    context(context: string, msgid: string): string;
+    /** The bound directory and domain — for a diagnostic line, never for a lookup. */
+    readonly localeDir: string;
+    readonly domain: string;
+}
+/**
+ * Bind `domain` and return its lookup function.
+ *
+ * Safe to call when no catalogue exists: gettext then returns each msgid unchanged, which is why
+ * the msgids themselves must be the source language rather than keys.
+ */
+export declare function initLocale(domain: string, options?: InitLocaleOptions): Translator;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-app",
-    "version": "0.42.0",
+    "version": "0.43.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.42.0"
+        "@gjsify/devtools": "^0.43.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.42.0",
-        "@gjsify/storybook": "^0.42.0",
-        "@gjsify/unit": "^0.42.0",
+        "@gjsify/cli": "^0.43.0",
+        "@gjsify/storybook": "^0.43.0",
+        "@gjsify/unit": "^0.43.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },