@djangocfg/ui-core 2.1.415 → 2.1.416

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ui-core",
-  "version": "2.1.415",
+  "version": "2.1.416",
   "description": "Pure React UI component library without Next.js dependencies - for Electron, Vite, CRA apps",
   "keywords": [
     "ui-components",
@@ -95,7 +95,7 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/i18n": "^2.1.415",
+    "@djangocfg/i18n": "^2.1.416",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
     "moment": "^2.30.1",
@@ -166,8 +166,8 @@
     "vaul": "1.1.2"
   },
   "devDependencies": {
-    "@djangocfg/i18n": "^2.1.415",
-    "@djangocfg/typescript-config": "^2.1.415",
+    "@djangocfg/i18n": "^2.1.416",
+    "@djangocfg/typescript-config": "^2.1.416",
     "@types/node": "^25.2.3",
     "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",

package/src/lib/dialog-service/getDialog.ts

@@ -0,0 +1,59 @@
+'use client';
+
+import type { DialogAPI } from './types';
+
+/**
+ * Lazy accessor for the global `window.dialog` API installed by
+ * `<DialogProvider />`. Use this in any library code that needs to call
+ * `dialog.confirm` / `dialog.alert` / `dialog.prompt` from a non-React
+ * context (e.g. event handlers in `ui-tools` tools).
+ *
+ * Returns `null` (and warns once in dev) when:
+ *   - we're rendering on the server (`typeof window === 'undefined'`)
+ *   - the host app has not mounted `<DialogProvider />`, so `window.dialog`
+ *     is missing.
+ *
+ * The caller must handle the `null` case — usually by bailing out of the
+ * action with a console warning. Library code must never throw if the
+ * provider is missing; consumers without it should still be able to
+ * import / render the component (just without CRUD flows).
+ *
+ * @example
+ * const dialog = getDialog();
+ * if (!dialog) return;
+ * const ok = await dialog.confirm({ title: 'Delete?', message: '…', variant: 'destructive' });
+ * if (ok) await onDelete();
+ */
+export function getDialog(): DialogAPI | null {
+  if (typeof window === 'undefined') return null;
+  const api = (window as Window & { dialog?: DialogAPI }).dialog;
+  if (!api) {
+    if (process.env.NODE_ENV !== 'production' && !warnedMissing) {
+      warnedMissing = true;
+      // eslint-disable-next-line no-console
+      console.warn(
+        '[getDialog] window.dialog is not available — mount <DialogProvider /> at the app root.',
+      );
+    }
+    return null;
+  }
+  return api;
+}
+
+let warnedMissing = false;
+
+/**
+ * Like `getDialog()` but throws when unavailable. Use sparingly — only in
+ * code paths where missing `window.dialog` is a developer error (e.g. an
+ * action explicitly triggered by user interaction in a feature that
+ * unconditionally requires dialogs).
+ */
+export function requireDialog(): DialogAPI {
+  const api = getDialog();
+  if (!api) {
+    throw new Error(
+      'requireDialog(): window.dialog is not available. Mount <DialogProvider /> at the app root.',
+    );
+  }
+  return api;
+}

package/src/lib/dialog-service/index.ts

@@ -10,6 +10,9 @@ export type {
 // Store
 export { dialogStore, useDialogStore, initDialogAPI, showDialog } from './store';
 
+// Imperative accessors for non-React code (library helpers, event handlers).
+export { getDialog, requireDialog } from './getDialog';
+
 // Provider
 export { DialogProvider } from './DialogProvider';