fomantic-ui 2.9.4-beta.5 → 2.9.4-beta.51

package/types/fomantic-ui-form.d.ts

@@ -15,7 +15,12 @@ declare namespace FomanticUI {
         /**
          * Adds rule to existing rules for field, also aliased as 'add field'.
          */
-        (behavior: 'add rule', field: string, rules: object[]): void;
+        (behavior: 'add rule', field: string, rules: string | string[] | FormField[]): void;
+
+        /**
+         * Adds field object to existing fields.
+         */
+        (behavior: 'add field', name: string, rules: string | string[] | FormRule[]): void;
 
         /**
          * Adds fields object to existing fields.
@@ -25,13 +30,18 @@ declare namespace FomanticUI {
         /**
          * Removes specific rule from field leaving other rules.
          */
-        (behavior: 'remove rule', field: string, rules: object[]): void;
+        (behavior: 'remove rule', field: string, rules?: object[]): void;
 
         /**
          * Remove all validation for a field.
          */
         (behavior: 'remove field', field: string): void;
 
+        /**
+         * Remove all validation for an array of fields.
+         */
+        (behavior: 'remove fields', field: string[]): void;
+
         /**
          * Returns 'true'/'false' whether a field passes its validation rules.
          * If you add 'true' as the second parameter, any failed rule will update the UI.
@@ -41,7 +51,7 @@ declare namespace FomanticUI {
         /**
          * Validates form, updates UI, and calls 'onSuccess' or 'onFailure'.
          */
-        (behavior: 'validate form'): void;
+        (behavior: 'validate form'): boolean;
 
         /**
          * Validates field, updates UI, and calls 'onSuccess' or 'onFailure'.
@@ -62,7 +72,7 @@ declare namespace FomanticUI {
          * Returns object of element values that match array of identifiers.
          * If no IDS are passed will return all fields.
          */
-        (behavior: 'get values', identifiers?: string[]): object;
+        (behavior: 'get values', identifiers?: string[]): Record<string, string>;
 
         /**
          * Sets value of element with id.
@@ -97,23 +107,33 @@ declare namespace FomanticUI {
         /**
          * Adds a custom user prompt for a given element with identifier.
          */
-        (behavior: 'add prompt', identifier: string, errors: object[]): void;
+        (behavior: 'add prompt', identifier: string, errors: string | object[]): void;
 
         /**
          * Empty all fields and remove possible errors.
          */
-        (behavior: 'clear'): void;
+        (behavior: 'clear'): JQuery;
 
         /**
          * Set all fields to their initial value and remove possible errors.
          */
-        (behavior: 'reset'): void;
+        (behavior: 'reset'): JQuery;
 
         /**
          * Set fields actual values as default values.
          */
         (behavior: 'set defaults'): void;
 
+        /**
+         * Returns 'true'/'false' whether a form is dirty.
+         */
+        (behavior: 'is dirty'): boolean;
+
+        /**
+         * Returns 'true'/'false' whether a form is clean.
+         */
+        (behavior: 'is clean'): boolean;
+
         /**
          * Return elements which have been modified since form state was changed to 'dirty'.
          */
@@ -122,10 +142,10 @@ declare namespace FomanticUI {
         /**
          * Set the state of the form to 'clean' and set new values as default.
          */
-        (behavior: 'set as clean'): void;
+        (behavior: 'set as clean'): JQuery;
 
         /**
-         * Automatically adds the "empty" rule or automatically checks a checkbox for all fields with classname or attribute 'required'.
+         * Automatically adds the "notEmpty" rule or automatically checks a checkbox for all fields with classname or attribute 'required'.
          */
         (behavior: 'set auto check'): void;
 
@@ -138,18 +158,39 @@ declare namespace FomanticUI {
          * Destroys instance and removes all events.
          */
         (behavior: 'destroy'): JQuery;
-        <K extends keyof FormSettings>(behavior: 'setting', name: K, value?: undefined, ): Partial<Pick<FormSettings, keyof FormSettings>>;
+        <K extends keyof FormSettings>(behavior: 'setting', name: K, value?: undefined,): Partial<Pick<FormSettings, keyof FormSettings>>;
         <K extends keyof FormSettings>(behavior: 'setting', name: K, value: FormSettings[K]): JQuery;
         (behavior: 'setting', value: Partial<Pick<FormSettings, keyof FormSettings>>): JQuery;
         (settings?: Partial<Pick<FormSettings, keyof FormSettings>>): JQuery;
     }
 
+    type FormFields = Record<string, FormField | string[] | string | {}>;
+
+    interface FormRule {
+        type: string;
+        prompt?: string | ((value: string) => void);
+        value?: string | RegExp;
+    }
+
+    interface FormField {
+        identifier?: string;
+        depends?: string;
+        optional?: boolean;
+        rules: FormRule[];
+    }
+
     /**
      * @see {@link https://fomantic-ui.com/behaviors/form.html#/settings}
      */
     interface FormSettings {
         // region Form Settings
 
+        /**
+         * Adds keyboard shortcuts for enter and escape keys to submit form and blur fields respectively.
+         * @default false
+         */
+        fields: false | FormFields;
+
         /**
          * Adds keyboard shortcuts for enter and escape keys to submit form and blur fields respectively.
          * @default true
@@ -215,7 +256,7 @@ declare namespace FomanticUI {
         preventLeaving: boolean;
 
         /**
-         * Whether fields with classname or attribute 'required' should automatically add the "empty" rule or automatically checks checkbox fields.
+         * Whether fields with classname or attribute 'required' should automatically add the "notEmpty" rule or automatically checks checkbox fields.
          * @default false
          */
         autoCheckRequired: boolean;
@@ -232,6 +273,12 @@ declare namespace FomanticUI {
          */
         errorLimit: number;
 
+        /**
+         *
+         * @default false
+         */
+        noNativeValidation: boolean;
+
         // endregion
 
         // region Form Prompts
@@ -248,6 +295,12 @@ declare namespace FomanticUI {
 
         // endregion
 
+        // region Formatters
+
+        rules: Form.RulesSettings;
+
+        // endregion
+
         // region Callbacks
 
         /**
@@ -258,17 +311,17 @@ declare namespace FomanticUI {
         /**
          * Callback on each invalid field.
          */
-        onInvalid(this: JQuery): void;
+        onInvalid(this: JQuery, fieldErrors: string | string[]): void;
 
         /**
          * Callback if a form is all valid.
          */
-        onSuccess(this: JQuery, event: Event, fields: object[]): void;
+        onSuccess(this: JQuery, event: Event, fields: {[key: string]: any}): void;
 
         /**
          * Callback if any form field is invalid.
          */
-        onFailure(this: JQuery, formErrors: object[], fields: object[]): void;
+        onFailure(this: JQuery, formErrors: {[key: string]: any}, fields: {[key: string]: any}): void;
 
         /**
          * Callback if form state is modified to 'dirty'.
@@ -349,8 +402,9 @@ declare namespace FomanticUI {
 
     namespace Form {
         type TextSettings = Partial<Pick<Settings.Texts, keyof Settings.Texts>>;
-        type PromptSettings = Partial<Pick<Settings.Prompts, keyof Settings.Prompts>>;
+        type PromptSettings = Partial<Pick<Settings.Prompts, keyof Settings.Prompts>> & {[key: string]: string | undefined};
         type FormatterSettings = Partial<Pick<Settings.Formatters, keyof Settings.Formatters>>;
+        type RulesSettings = Partial<Pick<Settings.Rules, keyof Settings.Rules>> & {[key: string]: (value?: any, identifier?: string, module?: any) => boolean};
         type SelectorSettings = Partial<Pick<Settings.Selectors, keyof Settings.Selectors>>;
         type MetadataSettings = Partial<Pick<Settings.Metadatas, keyof Settings.Metadatas>>;
         type ClassNameSettings = Partial<Pick<Settings.ClassNames, keyof Settings.ClassNames>>;
@@ -375,11 +429,32 @@ declare namespace FomanticUI {
             }
 
             interface Prompts {
+                /**
+                 * @default '{name} must be in a range from {min} to {max}'
+                 */
+                range: string;
+
+                /**
+                 * @default '{name} must have a maximum value of {ruleValue}'
+                 */
+                maxValue: string;
+
+                /**
+                 * @default '{name} must have a minimum value of {ruleValue}'
+                 */
+                minValue: string;
+
                 /**
                  * @default '{name} must have a value'
+                 * @deprecated Use notEmpty instead
                  */
                 empty: string;
 
+                /**
+                 * @default '{name} must have a value'
+                 */
+                notEmpty: string;
+
                 /**
                  * @default '{name} must be checked'
                  */
@@ -509,6 +584,39 @@ declare namespace FomanticUI {
                 year(date: string): string;
             }
 
+            interface Rules {
+                empty(value: unknown): boolean;
+                notEmpty(value: unknown): boolean;
+                checked(): boolean;
+                email(value: unknown): boolean;
+                url(value: unknown): boolean;
+                regExp(value: unknown, regExp: RegExp): boolean;
+                minValue(value: unknown, range: string): boolean;
+                maxValue(value: unknown, range: string): boolean;
+                integer(value: unknown, range: string): boolean;
+                range(value: unknown, range: string, regExp: RegExp, testLength: boolean): boolean;
+                decimal(value: unknown, range: string): boolean;
+                number(value: unknown, range: string): boolean;
+                is(value: unknown, text: string): boolean;
+                isExactly(value: unknown, text: string): boolean;
+                not(value: unknown, notValue: unknown): boolean;
+                notExactly(value: unknown, notValue: unknown): boolean;
+                contains(value: unknown, text: string): boolean;
+                containsExactly(value: unknown, text: string): boolean;
+                doesntContain(value: unknown, text: string): boolean;
+                doesntContainExactly(value: unknown, text: string): boolean;
+                minLength(value: unknown, minLength: number): boolean;
+                exactLength(value: unknown, requiredLength: number): boolean;
+                maxLength(value: unknown, maxLength: number): boolean;
+                size(value: unknown, range: string): boolean;
+                match(value: unknown, identifier: string, module: unknown): boolean;
+                different(value: unknown, identifier: string, module: unknown): boolean;
+                creditCard(cardNumber: unknown, cardTypes: string): boolean;
+                minCount(value: unknown, minCount: number): boolean;
+                exactCount(value: unknown, exactCount: number): boolean;
+                maxCount(value: unknown, maxCount: number): boolean;
+            }
+
             interface Selectors {
                 /**
                  * @default 'input[type="checkbox"], input[type="radio"]'

package/types/fomantic-ui-modal.d.ts

@@ -5,12 +5,12 @@ declare namespace FomanticUI {
         /**
          * Shows the modal.
          */
-        (behavior: 'show'): JQuery;
+        (behavior: 'show', callback?: Function): JQuery;
 
         /**
          * Hides the modal.
          */
-        (behavior: 'hide'): JQuery;
+        (behavior: 'hide', callback?: Function): JQuery;
 
         /**
          * Toggles the modal.
@@ -62,8 +62,13 @@ declare namespace FomanticUI {
          */
         (behavior: 'set active'): JQuery;
 
+        /**
+         * Templates handling
+         */
+        (behavior: keyof Modal.TemplatesSettings, ...args: any): Partial<Pick<ModalSettings, keyof ModalSettings>>;
+
         (behavior: 'destroy'): JQuery;
-        <K extends keyof ModalSettings>(behavior: 'setting', name: K, value?: undefined, ): Partial<Pick<ModalSettings, keyof ModalSettings>>;
+        <K extends keyof ModalSettings>(behavior: 'setting', name: K, value?: undefined,): Partial<Pick<ModalSettings, keyof ModalSettings>>;
         <K extends keyof ModalSettings>(behavior: 'setting', name: K, value: ModalSettings[K]): JQuery;
         (behavior: 'setting', value: Partial<Pick<ModalSettings, keyof ModalSettings>>): JQuery;
         (settings?: Partial<Pick<ModalSettings, keyof ModalSettings>>): JQuery;
@@ -166,13 +171,13 @@ declare namespace FomanticUI {
         /**
          * Custom settings to extend UI dimmer.
          */
-        dimmerSettings: DimmerSettings;
+        dimmerSettings: Partial<Pick<DimmerSettings, keyof DimmerSettings>>;
 
         /**
          * Custom settings to extend UI dimmer.
          * @default 'scale'
          */
-        transition: string | TransitionSettings;
+        transition: string | Partial<Pick<TransitionSettings, keyof TransitionSettings>>;
 
         /**
          * Duration of animation.
@@ -194,6 +199,62 @@ declare namespace FomanticUI {
          */
         scrollbarWidth: number;
 
+        // dynamic content
+
+        /**
+         * Title of dynamicly created modal.
+         * @default ''
+         */
+        title: string;
+
+        /**
+         * HTML content of dynamicly created modal.
+         * @default ''
+         */
+        content: string;
+
+        /**
+         * CSS classname(s) of dynamicly created modal.
+         * @default ''
+         */
+        class: string;
+
+        /**
+         * CSS classname(s) of dynamicly created modal's title.
+         * @default ''
+         */
+        classTitle: string;
+
+        /**
+         * CSS classname(s) of dynamicly created modal's content.
+         * @default ''
+         */
+        classContent: string;
+
+        /**
+         * CSS classname(s) of dynamicly created modal's actions.
+         * @default ''
+         */
+        classActions: string;
+
+        /**
+         * Determine if a close icon shoud be displayed on dynamicly created modal.
+         * @default false
+         */
+        closeIcon: boolean;
+
+        /**
+         *
+         * @default false
+         */
+        actions: any;
+
+        /**
+         *
+         * @default true
+         */
+        preserveHTML: boolean;
+
         // endregion
 
         // region Callbacks
@@ -250,6 +311,8 @@ declare namespace FomanticUI {
 
         // region Config Template Settings
 
+        templates: Modal.TemplatesSettings;
+
         // endregion
 
         // region Debug Settings
@@ -299,6 +362,7 @@ declare namespace FomanticUI {
         type SelectorSettings = Partial<Pick<Settings.Selectors, keyof Settings.Selectors>>;
         type ClassNameSettings = Partial<Pick<Settings.ClassNames, keyof Settings.ClassNames>>;
         type ErrorSettings = Partial<Pick<Settings.Errors, keyof Settings.Errors>>;
+        type TemplatesSettings = Partial<Pick<Settings.Templates, keyof Settings.Templates>> & {[key: string]: (...args: any) => Partial<Pick<ModalSettings, keyof ModalSettings>>};
 
         namespace Settings {
             interface Selectors {
@@ -466,6 +530,12 @@ declare namespace FomanticUI {
                  */
                 notFound: string;
             }
+
+            interface Templates {
+                alert(): Partial<Pick<ModalSettings, keyof ModalSettings>>;
+                confirm(): Partial<Pick<ModalSettings, keyof ModalSettings>>;
+                prompt(): Partial<Pick<ModalSettings, keyof ModalSettings>>;
+            }
         }
     }
 }

package/types/fomantic-ui-nag.d.ts

@@ -23,10 +23,10 @@ declare namespace FomanticUI {
         (behavior: 'clear'): JQuery;
 
         (behavior: 'destroy'): JQuery;
-        <K extends keyof NagSettings>(behavior: 'setting', name: K, value?: undefined, ): Partial<Pick<NagSettings, keyof NagSettings>>;
+        <K extends keyof NagSettings>(behavior: 'setting', name: K, value?: undefined,): Partial<Pick<NagSettings, keyof NagSettings>>;
         <K extends keyof NagSettings>(behavior: 'setting', name: K, value: NagSettings[K]): JQuery;
         (behavior: 'setting', value: Partial<Pick<NagSettings, keyof NagSettings>>): JQuery;
-        (settings?: NagSettings): Partial<Pick<NagSettings, keyof NagSettings>>;
+        (settings?: Partial<Pick<NagSettings, keyof NagSettings>>): JQuery;
     }
 
     /**
@@ -231,7 +231,7 @@ declare namespace FomanticUI {
                  */
                 close: string;
             }
-            
+
             interface ClassNames {
                 /**
                  * @default 'bottom'
@@ -243,7 +243,7 @@ declare namespace FomanticUI {
                  */
                 fixed: string;
             }
-        
+
             interface Errors {
                 /**
                  * @default 'Unsupported storage method'

package/types/fomantic-ui-popup.d.ts

@@ -67,7 +67,7 @@ declare namespace FomanticUI {
          */
         (behavior: 'destroy'): JQuery;
 
-        <K extends keyof PopupSettings>(behavior: 'setting', name: K, value?: undefined, ): Partial<Pick<PopupSettings, keyof PopupSettings>>;
+        <K extends keyof PopupSettings>(behavior: 'setting', name: K, value?: undefined,): Partial<Pick<PopupSettings, keyof PopupSettings>>;
         <K extends keyof PopupSettings>(behavior: 'setting', name: K, value: PopupSettings[K]): JQuery;
         (behavior: 'setting', value: Partial<Pick<PopupSettings, keyof PopupSettings>>): JQuery;
         (settings?: Partial<Pick<PopupSettings, keyof PopupSettings>>): JQuery;
@@ -84,7 +84,7 @@ declare namespace FomanticUI {
          * This is useful for including a pre-formatted popup.
          * @default false
          */
-        popup: false | string;
+        popup: false | string | JQuery;
 
         /**
          * Whether all other popups should be hidden when this popup is opened.
@@ -266,39 +266,39 @@ declare namespace FomanticUI {
         /**
          * Callback on popup element creation, with created popup.
          */
-        onCreate(this: JQuery): void;
+        onCreate(this: JQuery, element?: JQuery<HTMLElement>): void;
 
         /**
          * Callback immediately before Popup is removed from DOM.
          */
-        onRemove(this: JQuery): void;
+        onRemove(this: JQuery, element?: JQuery<HTMLElement>): void;
 
         /**
          * Callback before popup is shown.
          * Returning 'false' from this callback will cancel the popup from showing.
          */
-        onShow(this: JQuery): boolean;
+        onShow(this: JQuery, element?: JQuery<HTMLElement>): any;
 
         /**
          * Callback after popup is shown.
          */
-        onVisible(this: JQuery): void;
+        onVisible(this: JQuery, element?: JQuery<HTMLElement>): void;
 
         /**
          * Callback before popup is hidden.
          * Returning 'false' from this callback will cancel the popup from hiding.
          */
-        onHide(this: JQuery): boolean;
+        onHide(this: JQuery, element?: JQuery<HTMLElement>): any;
 
         /**
          * Callback after popup is hidden.
          */
-        onHidden(this: JQuery): void;
+        onHidden(this: JQuery, element?: JQuery<HTMLElement>): void;
 
         /**
          * Callback after popup cannot be placed on screen.
          */
-        onUnplaceable(this: JQuery): void;
+        onUnplaceable(this: JQuery, element?: JQuery<HTMLElement>): void;
 
         // endregion
 
@@ -402,7 +402,7 @@ declare namespace FomanticUI {
                  */
                 popup: string;
             }
-        
+
             interface Metadatas {
                 /**
                  * @default 'activator'
@@ -439,7 +439,7 @@ declare namespace FomanticUI {
                  */
                 variation: string;
             }
-        
+
             interface ClassNames {
                 /**
                  * @default 'active'

package/types/fomantic-ui-progress.d.ts

@@ -158,7 +158,7 @@ declare namespace FomanticUI {
          */
         (behavior: 'destroy'): JQuery;
 
-        <K extends keyof ProgressSettings>(behavior: 'setting', name: K, value?: undefined, ): Partial<Pick<ProgressSettings, keyof ProgressSettings>>;
+        <K extends keyof ProgressSettings>(behavior: 'setting', name: K, value?: undefined,): Partial<Pick<ProgressSettings, keyof ProgressSettings>>;
         <K extends keyof ProgressSettings>(behavior: 'setting', name: K, value: ProgressSettings[K]): JQuery;
         (behavior: 'setting', value: Partial<Pick<ProgressSettings, keyof ProgressSettings>>): JQuery;
         (settings?: Partial<Pick<ProgressSettings, keyof ProgressSettings>>): JQuery;
@@ -208,6 +208,12 @@ declare namespace FomanticUI {
          */
         precision: number;
 
+        /**
+         * Sets current overall percent.
+         * @default false
+         */
+        percent: false | number;
+
         /**
          * Setting a total value will make each call to increment get closer to this total (i.e. 1/20, 2/20 etc).
          * @default false
@@ -349,7 +355,7 @@ declare namespace FomanticUI {
                  */
                 progress: string;
             }
-        
+
             interface ClassNames {
                 /**
                  * @default 'active'
@@ -371,7 +377,7 @@ declare namespace FomanticUI {
                  */
                 warning: string;
             }
-        
+
             interface Texts {
                 /**
                  * @default false
@@ -408,14 +414,14 @@ declare namespace FomanticUI {
                  */
                 bars: string[];
             }
-        
+
             interface RegExps {
                 /**
                  * @default /\{\$*[A-z0-9]+\}/g
                  */
                 variable: RegExp;
             }
-        
+
             interface Metadatas {
                 /**
                  * @default 'percent'
@@ -432,7 +438,7 @@ declare namespace FomanticUI {
                  */
                 value: string;
             }
-        
+
             interface Errors {
                 /**
                  * @default 'The method you called is not defined.'

package/types/fomantic-ui-rating.d.ts

@@ -28,7 +28,7 @@ declare namespace FomanticUI {
         (behavior: 'clear rating'): JQuery;
 
         (behavior: 'destroy'): JQuery;
-        <K extends keyof RatingSettings>(behavior: 'setting', name: K, value?: undefined, ): Partial<Pick<RatingSettings, keyof RatingSettings>>;
+        <K extends keyof RatingSettings>(behavior: 'setting', name: K, value?: undefined,): Partial<Pick<RatingSettings, keyof RatingSettings>>;
         <K extends keyof RatingSettings>(behavior: 'setting', name: K, value: RatingSettings[K]): JQuery;
         (behavior: 'setting', value: Partial<Pick<RatingSettings, keyof RatingSettings>>): JQuery;
         (settings?: Partial<Pick<RatingSettings, keyof RatingSettings>>): JQuery;