From e147c2463e7b5b372ccbe1c418ee771657e3f449 Mon Sep 17 00:00:00 2001
From: Troy McKinnon <troy.t.mckinnon@gmail.com>
Date: Wed, 16 Mar 2016 16:55:01 -0500
Subject: [PATCH] improved typing for bootbox options

---
 bootbox/bootbox-tests.ts | 11 +++---
 bootbox/bootbox.d.ts     | 76 +++++++++++++++++++++++++---------------
 2 files changed, 53 insertions(+), 34 deletions(-)

diff --git a/bootbox/bootbox-tests.ts b/bootbox/bootbox-tests.ts
index 5b3a26edd..83837d41f 100644
--- a/bootbox/bootbox-tests.ts
+++ b/bootbox/bootbox-tests.ts
@@ -17,7 +17,8 @@ bootbox.confirm("Click cancel to pass test", function (result) {
 	console.log(!result);
 });
 bootbox.confirm({
-	message: "Click confirm to pass test",
+	title: "Click confirm to pass test",
+	message: "Please confirm this.",
 	callback: function (result) {
 		console.log(result);
 	}
@@ -27,13 +28,13 @@ bootbox.prompt("Enter 'ok' to pass test", function (result) {
 	console.log(result);
 });
 bootbox.prompt({
-	message: "Enter 'ok' to pass test", callback: function (result) {
+	title: "Enter 'ok' to pass test", callback: function (result) {
 		console.log(result);
 	}
 });
 bootbox.prompt({
 	size: "large",
-	message: "Enter 'ok' to pass test", callback: function (result) {
+	title: "Enter 'ok' to pass test", callback: function (result) {
 		console.log(result);
 	}
 });
@@ -42,7 +43,7 @@ bootbox.prompt({
 bootbox.dialog({
 	title: "Wassup?",
 	message: "Test Dialog",
-	callback: function (result) { }
+	callback: function () { }
 });
 
 // Testing the return object of the call. Using the pointer to disable the animation on success callback.
@@ -103,4 +104,4 @@ var localeOptions: BootboxLocaleValues = {
 
 bootbox.addLocale("Nepali", localeOptions);
 bootbox.setLocale("Nepali");
-bootbox.removeLocale("Nepali");
\ No newline at end of file
+bootbox.removeLocale("Nepali");
diff --git a/bootbox/bootbox.d.ts b/bootbox/bootbox.d.ts
index f253c01b6..9764a6d81 100644
--- a/bootbox/bootbox.d.ts
+++ b/bootbox/bootbox.d.ts
@@ -1,25 +1,56 @@
 // Type definitions for Bootbox 4.4.0
 // Project: https://github.com/makeusabrew/bootbox
-// Definitions by: Vincent Bortone <https://github.com/vbortone/>, Kon Pik <https://github.com/konpikwastaken/>, Anup Kattel <https://github.com/kanup/>, Dominik Schroeter <https://github.com/icereed/>
+// Definitions by: Vincent Bortone <https://github.com/vbortone/>, Kon Pik <https://github.com/konpikwastaken/>, Anup Kattel <https://github.com/kanup/>, Dominik Schroeter <https://github.com/icereed/>, Troy McKinnon <https://github.com/trodi/>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 /// <reference path="../jquery/jquery.d.ts" />
-interface BootboxAlertOptions {
+
+/** Bootbox options shared by all modal types */
+interface BootboxBaseOptions {
+	title?: string | Element;
+	callback?: (result: boolean | string) => any;
+	onEscape?: () => any | boolean;
+	show?: boolean;
+	backdrop?: boolean;
+	closeButton?: boolean;
+	animate?: boolean;
+	className?: string;
 	size?: string;
-	message: string;
+	buttons?: BootboxButtonMap; // complex object where each key is of type BootboxButton
+}
+
+/** Bootbox options available for custom modals */
+interface BootboxDialogOptions extends BootboxBaseOptions {
+	message: string | Element;
+}
+
+/** Bootbox options available for alert modals */
+interface BootboxAlertOptions extends BootboxDialogOptions {
 	callback?: () => any;
+	buttons?: BootboxAlertButtonMap;
 }
 
-interface BootboxConfirmOptions {
-	size?: string;
-	message: string;
+/** Bootbox options available for confirm modals */
+interface BootboxConfirmOptions extends BootboxDialogOptions {
 	callback: (result: boolean) => any;
+	buttons?: BootboxConfirmPromptButtonMap;
 }
 
-interface BootboxPromptOptions {
-	size?: string;
-	message?: string;
+/** Bootbox options available for prompt modals */
+interface BootboxPromptOptions extends BootboxBaseOptions {
+	title: string;
 	callback: (result: string) => any;
+	buttons?: BootboxConfirmPromptButtonMap;
+}
+
+/** Bootbox options available when setting defaults for modals */
+interface BootboxDefaultOptions {
+	locale?: string;
+	show?: boolean;
+	backdrop?: boolean;
+	closeButton?: boolean;
+	animate?: boolean;
+	className?: string;
 }
 
 interface BootboxButton {
@@ -32,28 +63,15 @@ interface BootboxButtonMap {
   [key: string]: BootboxButton | Function;
 }
 
-interface BootboxDialogOptions {
-	message: string | Element;
-	title?: string | Element;
-	locale?: string;
-	callback?: (result: boolean) => any;
-	onEscape?: () => any | boolean;
-	show?: boolean;
-	backdrop?: boolean;
-	closeButton?: boolean;
-	animate?: boolean;
-	className?: string;
-	size?: string;
-	buttons?: BootboxButtonMap; // complex object where each key is of type BootboxButton
+/** ButtonMap options for alerts modals */
+interface BootboxAlertButtonMap extends BootboxButtonMap {
+	ok: BootboxButton | Function;
 }
 
-interface BootboxDefaultOptions {
-	locale?: string;
-	show?: boolean;
-	backdrop?: boolean;
-	closeButton?: boolean;
-	animate?: boolean;
-	className?: string;
+/** ButtonMap options for confirm and prompt modals */
+interface BootboxConfirmPromptButtonMap extends BootboxButtonMap {
+	confirm: BootboxButton | Function;
+	cancel: BootboxButton | Function;
 }
 
 interface BootboxLocaleValues {