jsuites 5.0.15 → 5.0.17

package/dist/jsuites.js

@@ -5998,6 +5998,8 @@ function Dropdown() {
                 onblur: null,
                 oninsert: null,
                 onbeforeinsert: null,
+                onsearch: null,
+                onbeforesearch: null,
                 sortResults: false,
                 autofocus: false,
             }
@@ -6808,11 +6810,13 @@ function Dropdown() {
                 // Reset results
                 obj.results = null;
                 // URL
-                var url = obj.options.url + (obj.options.url.indexOf('?') > 0 ? '&' : '?') + 'q=' + str;
-                // Remote search
-                ajax({
+                var url = obj.options.url;
+
+                // Ajax call
+                let o = {
                     url: url,
                     method: 'GET',
+                    data: { q: str },
                     dataType: 'json',
                     success: function (result) {
                         // Reset items
@@ -6839,8 +6843,24 @@ function Dropdown() {
                         } else {
                             content.style.display = '';
                         }
+
+                        if (typeof(obj.options.onsearch) === 'function') {
+                            obj.options.onsearch(obj, result);
+                        }
                     }
-                });
+                }
+
+                if (typeof(obj.options.onbeforesearch) === 'function') {
+                    let ret = obj.options.onbeforesearch(obj, o);
+                    if (ret === false) {
+                        return;
+                    } else if (typeof(ret) === 'object') {
+                        o = ret;
+                    }
+                }
+
+                // Remote search
+                ajax(o);
             } else {
                 // Search terms
                 str = new RegExp(str, 'gi');
@@ -12529,7 +12549,7 @@ var sha512_default = /*#__PURE__*/__webpack_require__.n(sha512);
 
 var jSuites = {
     /** Current version */
-    version: '5.0.15',
+    version: '5.0.17',
     /** Bind new extensions to Jsuites */
     setExtensions: function(o) {
         if (typeof(o) == 'object') {

package/dist/types/calendar.d.ts

@@ -41,7 +41,9 @@ interface Options {
     // Data type
     dataType: null,
     // Controls
-    controls: true
+    controls: boolean,
+    /** Auto select confirms the current date as the new value onblur. Default: true */
+    autoSelect: boolean;
 }
 
 /** Toast Plugin */

package/dist/types/dropdown.d.ts

@@ -1,4 +1,4 @@
-interface Item {
+interface DropdownItem {
     /** Value of the selected item. */
     id?: string | number;
     /** Label for the selected item. */
@@ -17,62 +17,66 @@ interface Item {
     color?: string;
 }
 
-interface Options {
-    /** Load the data from a remove server URL */
-    url: string,
-    /** Load data to the dropdown */
-    data: Item[],
-    /** Legacy format { id: name } or { value: text } */
-    format: number,
-    /** Accept multiple item selection */
-    multiple: boolean,
-    /** Enable the suggestion option */
-    autocomplete: boolean,
-    /** Search for an option remotely */
-    remoteSearch: boolean,
-    /** Enable the lazyloading option when you are dealing with too much options */
-    lazyLoading: boolean,
-    /** Internal type */
-    type: 'dropdown',
-    /** Width of the dropdown */
-    width: number,
-    /** Max width of the dropdown */
-    maxWidth: number,
-    /** Start the dropdown opened */
-    opened: boolean,
-    /** Initial value */
-    value: string,
-    /** Dropdown place holder */
-    placeholder: string,
-    /** Accept the user to add new options */
-    newOptions: boolean,
-    /** Internal position controller. */
-    position: boolean,
-    /** When the value chnaged */
-    onchange: () => void,
-    /** When the dropdown is ready */
-    onload: () => void,
-    /** When the dropdown is opened */
-    onopen: () => void,
-    /** When the dropdown is closed */
-    onclose: () => void,
-    /** When the dropdown is focused */
-    onfocus: () => void,
-    /** When the dropdown is blur */
-    onblur: () => void,
-    /** When the user add a new option to the dropdown. */
-    oninsert: () => void,
-    /** Just before a new option is added to the dropdown */
-    onbeforeinsert: () => void,
-    /** Sort the elements of the dropdown */
-    sortResults: boolean,
-    /** Focus when the dropdown is created */
-    autofocus: boolean,
+interface DropdownOptions {
+    /** Endpoint to fetch data from a remote server */
+    url?: string;
+    /** Preloaded data items for the dropdown */
+    data?: DropdownItem[];
+    /** Format type of the data, typically { id: name } or { value: text } */
+    format?: number;
+    /** Indicates if multiple item selection is allowed */
+    multiple?: boolean;
+    /** Enables the autocomplete feature for user input */
+    autocomplete?: boolean;
+    /** Allows remote search for options */
+    remoteSearch?: boolean;
+    /** Enables the lazy loading feature for handling a large number of options */
+    lazyLoading?: boolean;
+    /** Rendering style of the dropdown: 'default', 'picker', or 'searchbar' */
+    type?: 'default' | 'picker' | 'searchbar',
+    /** Defines the dropdown's width */
+    width?: number;
+    /** Sets the maximum width of the dropdown */
+    maxWidth?: number;
+    /** Determines if the dropdown is opened when initialized */
+    opened?: boolean;
+    /** The initial value of the dropdown */
+    value?: string;
+    /** Placeholder text for the dropdown */
+    placeholder?: string;
+    /** Allows the user to add new options */
+    newOptions?: boolean;
+    /** Internal controller for the dropdown's position */
+    position?: boolean;
+    /** Event handler for value changes */
+    onchange?: (el: HTMLElement, obj: Dropdown, oldValue: string, newValue: string) => void;
+    /** Event handler for when the dropdown is ready */
+    onload?: (el: HTMLElement, obj: Dropdown, data: any, val: any) => void;
+    /** Event handler for when the dropdown opens */
+    onopen?: (el: HTMLElement) => void;
+    /** Event handler for when the dropdown closes */
+    onclose?: (el: HTMLElement) => void;
+    /** Event handler for when the dropdown receives focus */
+    onfocus?: (el: HTMLElement) => void;
+    /** Event handler for when the dropdown loses focus */
+    onblur?: (el: HTMLElement) => void;
+    /** Event handler for when a new option is added to the dropdown */
+    oninsert?: (obj: Dropdown, item: DropdownItem, newItem: DropdownItem) => void;
+    /** Event handler for just before a new option is added to the dropdown */
+    onbeforeinsert?: (obj: Dropdown, item: DropdownItem) => void;
+    /** Event handler for before a search on autocomplete is performed */
+    onbeforesearch?: (obj: Dropdown, ajaxRequest: object) => boolean | null;
+    /** Event handler for processing search results */
+    onsearch?: (obj: Dropdown, result: object) => void;
+    /** Toggles the sorting of dropdown elements */
+    sortResults?: boolean;
+    /** Indicates if the dropdown should automatically receive focus upon creation */
+    autofocus?: boolean;
 }
 
 interface ItemContainer {
     /** Data for the item */
-    data: Item;
+    data: DropdownItem;
     /** HTML container for the element */
     element: HTMLElement;
     /** HTML container for the group */
@@ -80,11 +84,11 @@ interface ItemContainer {
 }
 
 /** Toast Plugin */
-export type Dropdown = (el: HTMLElement, options: Options) => {
+export type Dropdown = (el: HTMLElement, options: DropdownOptions) => {
     /** Add a new item to the dropdown */
-    add: (title: string, id: string|number) => Item;
+    add: (title: string, id: string|number) => DropdownItem;
     /** Append new data to the dropdown */
-    appendData: (data: Item[]) => void
+    appendData: (data: DropdownItem[]) => void
     /** Close the dropdown picker */
     closeItem: (ignoreEvents?: boolean) => void
     /** Current selectIndex */
@@ -94,7 +98,7 @@ export type Dropdown = (el: HTMLElement, options: Options) => {
     /** Select the first item */
     first: () => void;
     /** Get all data */
-    getData: () => Item[];
+    getData: () => DropdownItem[];
     /** Get the index position of a item by its value */
     getPosition: (value: string) => number | boolean;
     /** Get the text from the selected options */
@@ -124,7 +128,7 @@ export type Dropdown = (el: HTMLElement, options: Options) => {
     /** Open the dropdown */
     open: () => void;
     /** Dropdown configuration */
-    options: Options;
+    options: DropdownOptions;
     /** Move index to the previous element in the dropdown */
     prev: () => void;
     /** Reset the value of the dropdown */
@@ -134,21 +138,21 @@ export type Dropdown = (el: HTMLElement, options: Options) => {
     /** Set the value to null */
     resetSelected: () => void;
     /** Array of results when filtering */
-    results: Item[];
+    results: DropdownItem[];
     /** Search term */
     search: string;
     /** Select an index */
     selectIndex: (index: number, force?: boolean) => void
     /** Select an item */
-    selectItem: (item: Item) => void;
+    selectItem: (item: DropdownItem) => void;
     /** Set the cursor to a specified element index */
     setCursor: (index: number, setPosition?: boolean) => void
     /** Set new data for the dropdown */
-    setData: (items: Item[]) => void;
+    setData: (items: DropdownItem[]) => void;
     /** Set the id or value for one item */
-    setId: (item: number|Item, newId: number) => void;
+    setId: (item: number|DropdownItem, newId: number) => void;
     /** Change the dropdown options */
-    setOptions: (newOptions: Options, reset?: boolean) => void;
+    setOptions: (newOptions: DropdownOptions, reset?: boolean) => void;
     /** Change the dropdown data from a URL */
     setUrl: (newUrl: string, callback?: Function) => void;
     /** Set the value for a dropdown */

package/dist/types/validations.d.ts

@@ -1,16 +1,25 @@
 interface Options {
-    // Validation type
-    type: 'url' | 'email' | 'required' | 'empty' | 'notEmpty' | 'number' | 'login' | 'list' | 'date' | 'text' | 'textLength'
+    /** Validation type */
+    type: 'number' | 'text' | 'date' | 'list' | 'textLength' | 'empty' | 'notEmpty';
     // Ignore the validation when is blank
     allowBlank?: boolean;
-    // Criteria
-    criteria: string
+    /** Criteria to be match */
+    criteria:
+        | '='
+        | '!='
+        | '>='
+        | '>'
+        | '<='
+        | '<'
+        | 'between'
+        | 'not between'
+        | 'valid date'
+        | 'valid email'
+        | 'valid url'
+        | 'contains'
+        | 'not contains'
+        | 'begins with'
+        | 'ends with'
 }
 
-interface Number {
-    criteria: 'between' | 'not between' | '<' | '<=' | '>' | '>=' | '=' | '!='
-}
-
-export type Validations = (value: string | number, options) => {
-
-}
+export type Validations = (value: string | number, options: Options) => boolean;

package/package.json

@@ -25,7 +25,7 @@
     },
     "main": "dist/jsuites.js",
     "types": "dist/jsuites.d.ts",
-    "version": "5.0.15",
+    "version": "5.0.17",
     "bugs": "https://github.com/jsuites/jsuites/issues",
     "homepage": "https://github.com/jsuites/jsuites",
     "docs": "https://jsuites.net",