@trackunit/react-form-components 0.0.263 → 0.0.266

package/index.cjs.js

@@ -773,6 +773,31 @@ const OptionCard = React.forwardRef((_a, ref) => {
     return (jsxRuntime.jsxs("div", { "data-testid": dataTestId, className: cvaOptionCardContainer(), children: [jsxRuntime.jsx("input", Object.assign({ ref: ref, id: htmlForId, type: "radio", value: value, className: "peer hidden" }, rest)), jsxRuntime.jsxs("label", { htmlFor: htmlForId, className: cvaOptionCardLabel({ className, disabled }), children: [disabled && icon && React.cloneElement(icon, { className: `${icon.props.className} text-secondary-400` }), !disabled && icon, heading && (jsxRuntime.jsx(reactComponents.Heading, { variant: "secondary", subtle: disabled, children: heading })), (subheading || description) && (jsxRuntime.jsxs("div", { className: cvaOptionCardContent(), children: [subheading && (jsxRuntime.jsx(reactComponents.Text, { type: "span", weight: "thick", align: "center", subtle: disabled, children: subheading })), description && (jsxRuntime.jsx(reactComponents.Text, { type: "span", subtle: true, align: "center", children: description }))] }))] })] }));
 });
 
+/**
+ * A thin wrapper around the `BaseInput` component for password input fields.
+ *
+ * NOTE: If shown with a label, please use the `PasswordField` component instead.
+ */
+const PasswordInput = React.forwardRef((props, ref) => (jsxRuntime.jsx(BaseInput, Object.assign({ ref: ref, type: props.obfuscate ? "text" : "password" }, props))));
+
+/**
+ * Password fields enter a password or other confidential information. Characters are masked as they are typed.
+ *
+ * _**Do use** when the user has to input a password or something that needs to be obfuscated_
+ *
+ * _**Do not use** to confirm user actions, such as deleting. Use a checkbox for such flows._
+ */
+const PasswordField = React.forwardRef((_a, ref) => {
+    var { id, label, tip, helpText, helpAddon, errorMessage, isInvalid, maxLength, onChange, className, value, dataTestId } = _a, rest = __rest(_a, ["id", "label", "tip", "helpText", "helpAddon", "errorMessage", "isInvalid", "maxLength", "onChange", "className", "value", "dataTestId"]);
+    const renderAsInvalid = isInvalid === undefined ? Boolean(errorMessage) : isInvalid;
+    const htmlFor = id ? id : "passwordField-" + uuid.v4();
+    const [showPassword, setShowPassword] = React.useState(false);
+    const handleChange = React.useCallback((event) => {
+        onChange === null || onChange === void 0 ? void 0 : onChange(event);
+    }, [onChange]);
+    return (jsxRuntime.jsx(FormGroup, { htmlFor: htmlFor, label: label, tip: tip, isInvalid: renderAsInvalid, helpText: (renderAsInvalid && errorMessage) || helpText, helpAddon: helpAddon, dataTestId: dataTestId && `${dataTestId}-FormGroup`, children: jsxRuntime.jsx(PasswordInput, Object.assign({}, rest, { obfuscate: showPassword, disabled: rest.readOnly, id: htmlFor, "aria-labelledby": htmlFor + "-label", ref: ref, maxLength: maxLength, value: value, isInvalid: renderAsInvalid, className: className, onChange: handleChange, dataTestId: dataTestId, actions: jsxRuntime.jsx(reactComponents.Icon, { className: "absolute top-0 bottom-0 right-2 h-full content-center", name: showPassword ? "EyeSlash" : "Eye", size: "small", color: "neutral", onClick: () => setShowPassword(prevState => !prevState) }) })) }));
+});
+
 /**
  * @param phoneNumber - a phone number as a string
  * @returns {boolean} true if the phone number starts with a plus sign
@@ -2153,6 +2178,49 @@ const UploadField = React.forwardRef((_a, ref) => {
     return (jsxRuntime.jsx(FormGroup, { htmlFor: htmlForId, label: label, tip: tip, isInvalid: renderAsInvalid, helpText: errorMessage || helpText, dataTestId: `${dataTestId}-FormGroup`, children: jsxRuntime.jsx(UploadInput, Object.assign({ ref: ref, id: htmlForId, "aria-labelledby": htmlForId + "-label", isInvalid: renderAsInvalid }, rest, { className: className, dataTestId: dataTestId })) }));
 });
 
+/**
+ * @description Validate given url id.
+ * @param url The address to validate.
+ * @returns {boolean} Returns true if the url address is valid else false.
+ * @example validateUrlAddress(https://www.example.com) // true
+ */
+const validateUrlAddress = (url) => {
+    if (!url) {
+        return false;
+    }
+    // Using pattern from libs/custom-field/components/src/getValidationRules.ts
+    const urlPattern = new RegExp("^(((https?|ftps?)://)(%[0-9A-Fa-f]{2}|[-()_.!~*';/?:@&=+$,A-Za-z0-9])+)([).!';/?:,][[:blank:|:blank:]])?$");
+    return urlPattern.test(url);
+};
+
+/**
+ * A thin wrapper around the `BaseInput` component for URL input fields.
+ *
+ * NOTE: If shown with a label, please use the `UrlField` component instead.
+ */
+const UrlInput = React.forwardRef((_a, ref) => {
+    var { dataTestId, isInvalid, disabled = false, fieldSize = "medium", disableAction = false, value, defaultValue } = _a, rest = __rest(_a, ["dataTestId", "isInvalid", "disabled", "fieldSize", "disableAction", "value", "defaultValue"]);
+    const [url, setUrl] = React.useState((value === null || value === void 0 ? void 0 : value.toString()) || (defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.toString()));
+    const renderAsInvalid = (url && typeof url === "string" && !validateUrlAddress(url)) || isInvalid;
+    return (jsxRuntime.jsx(BaseInput, Object.assign({ id: "url-input", dataTestId: dataTestId && `${dataTestId}-url-input`, ref: ref, type: "url", placeholder: rest.placeholder || "https://www.example.com", onChange: e => setUrl(e.target.value), isInvalid: renderAsInvalid, value: url, disabled: disabled }, rest, { actions: !disableAction && (jsxRuntime.jsx(ActionButton, { disabled: renderAsInvalid || disabled, value: url, type: "WEB_ADDRESS", dataTestId: (dataTestId && `${dataTestId}-url-input-Icon`) || "url-input-action-icon", iconSize: fieldSize })) })));
+});
+
+/**
+ * The UrlField component is used to enter url.
+ * UrlField validates that user enters a valid web address.
+ *
+ */
+const UrlField = React.forwardRef((_a, ref) => {
+    var { label, id, tip, helpText, errorMessage, helpAddon, className, defaultValue, dataTestId, isInvalid = false, value } = _a, rest = __rest(_a, ["label", "id", "tip", "helpText", "errorMessage", "helpAddon", "className", "defaultValue", "dataTestId", "isInvalid", "value"]);
+    const htmlForId = id ? id : "urlField-" + uuid.v4();
+    // Type guard to check if value is a string
+    function isString(inputValue) {
+        return typeof inputValue === "string";
+    }
+    const renderAsInvalid = !!errorMessage || (value && isString(value) && !validateUrlAddress(value)) || isInvalid;
+    return (jsxRuntime.jsx(FormGroup, { htmlFor: htmlForId, label: label, tip: tip, isInvalid: renderAsInvalid, helpText: renderAsInvalid ? errorMessage : helpText, helpAddon: helpAddon, disabled: rest.disabled, dataTestId: dataTestId && `${dataTestId}-FormGroup`, children: jsxRuntime.jsx(UrlInput, Object.assign({ id: htmlForId, "aria-labelledby": htmlForId + "-label", ref: ref, value: value || defaultValue, isInvalid: renderAsInvalid, disabled: rest.disabled }, rest, { className: className, dataTestId: dataTestId })) }));
+});
+
 /*
  * ----------------------------
  * | SETUP TRANSLATIONS START |
@@ -2181,6 +2249,8 @@ exports.MultiSelectMenuItem = MultiSelectMenuItem;
 exports.NumberField = NumberField;
 exports.NumberInput = NumberInput;
 exports.OptionCard = OptionCard;
+exports.PasswordField = PasswordField;
+exports.PasswordInput = PasswordInput;
 exports.PhoneField = PhoneField;
 exports.PhoneInput = PhoneInput;
 exports.RadioGroup = RadioGroup;
@@ -2198,6 +2268,8 @@ exports.TimeRangeField = TimeRangeField;
 exports.Toggle = Toggle;
 exports.UploadField = UploadField;
 exports.UploadInput = UploadInput;
+exports.UrlField = UrlField;
+exports.UrlInput = UrlInput;
 exports.checkIfPhoneNumberHasPlus = checkIfPhoneNumberHasPlus;
 exports.countryCodeToFlagEmoji = countryCodeToFlagEmoji;
 exports.cvaInput = cvaInput;

package/index.esm.js

@@ -3,7 +3,7 @@ import { useNamespaceTranslation, registerTranslations } from '@trackunit/i18n-l
 import { IconButton, Icon, Tip, Heading, Text, MenuItem, Tag, Spinner } from '@trackunit/react-components';
 import { cvaMerge } from '@trackunit/css-class-variance-utilities';
 import * as React from 'react';
-import React__default, { useMemo, forwardRef, useState, cloneElement, useEffect, useRef } from 'react';
+import React__default, { useMemo, forwardRef, useState, cloneElement, useCallback, useEffect, useRef } from 'react';
 import { v4 } from 'uuid';
 import { format } from 'date-fns';
 import parsePhoneNumberFromString, { getCountries, getCountryCallingCode, isValidPhoneNumber, parsePhoneNumberFromString as parsePhoneNumberFromString$1 } from 'libphonenumber-js';
@@ -743,6 +743,31 @@ const OptionCard = forwardRef((_a, ref) => {
     return (jsxs("div", { "data-testid": dataTestId, className: cvaOptionCardContainer(), children: [jsx("input", Object.assign({ ref: ref, id: htmlForId, type: "radio", value: value, className: "peer hidden" }, rest)), jsxs("label", { htmlFor: htmlForId, className: cvaOptionCardLabel({ className, disabled }), children: [disabled && icon && cloneElement(icon, { className: `${icon.props.className} text-secondary-400` }), !disabled && icon, heading && (jsx(Heading, { variant: "secondary", subtle: disabled, children: heading })), (subheading || description) && (jsxs("div", { className: cvaOptionCardContent(), children: [subheading && (jsx(Text, { type: "span", weight: "thick", align: "center", subtle: disabled, children: subheading })), description && (jsx(Text, { type: "span", subtle: true, align: "center", children: description }))] }))] })] }));
 });
 
+/**
+ * A thin wrapper around the `BaseInput` component for password input fields.
+ *
+ * NOTE: If shown with a label, please use the `PasswordField` component instead.
+ */
+const PasswordInput = forwardRef((props, ref) => (jsx(BaseInput, Object.assign({ ref: ref, type: props.obfuscate ? "text" : "password" }, props))));
+
+/**
+ * Password fields enter a password or other confidential information. Characters are masked as they are typed.
+ *
+ * _**Do use** when the user has to input a password or something that needs to be obfuscated_
+ *
+ * _**Do not use** to confirm user actions, such as deleting. Use a checkbox for such flows._
+ */
+const PasswordField = forwardRef((_a, ref) => {
+    var { id, label, tip, helpText, helpAddon, errorMessage, isInvalid, maxLength, onChange, className, value, dataTestId } = _a, rest = __rest(_a, ["id", "label", "tip", "helpText", "helpAddon", "errorMessage", "isInvalid", "maxLength", "onChange", "className", "value", "dataTestId"]);
+    const renderAsInvalid = isInvalid === undefined ? Boolean(errorMessage) : isInvalid;
+    const htmlFor = id ? id : "passwordField-" + v4();
+    const [showPassword, setShowPassword] = useState(false);
+    const handleChange = useCallback((event) => {
+        onChange === null || onChange === void 0 ? void 0 : onChange(event);
+    }, [onChange]);
+    return (jsx(FormGroup, { htmlFor: htmlFor, label: label, tip: tip, isInvalid: renderAsInvalid, helpText: (renderAsInvalid && errorMessage) || helpText, helpAddon: helpAddon, dataTestId: dataTestId && `${dataTestId}-FormGroup`, children: jsx(PasswordInput, Object.assign({}, rest, { obfuscate: showPassword, disabled: rest.readOnly, id: htmlFor, "aria-labelledby": htmlFor + "-label", ref: ref, maxLength: maxLength, value: value, isInvalid: renderAsInvalid, className: className, onChange: handleChange, dataTestId: dataTestId, actions: jsx(Icon, { className: "absolute top-0 bottom-0 right-2 h-full content-center", name: showPassword ? "EyeSlash" : "Eye", size: "small", color: "neutral", onClick: () => setShowPassword(prevState => !prevState) }) })) }));
+});
+
 /**
  * @param phoneNumber - a phone number as a string
  * @returns {boolean} true if the phone number starts with a plus sign
@@ -2123,6 +2148,49 @@ const UploadField = forwardRef((_a, ref) => {
     return (jsx(FormGroup, { htmlFor: htmlForId, label: label, tip: tip, isInvalid: renderAsInvalid, helpText: errorMessage || helpText, dataTestId: `${dataTestId}-FormGroup`, children: jsx(UploadInput, Object.assign({ ref: ref, id: htmlForId, "aria-labelledby": htmlForId + "-label", isInvalid: renderAsInvalid }, rest, { className: className, dataTestId: dataTestId })) }));
 });
 
+/**
+ * @description Validate given url id.
+ * @param url The address to validate.
+ * @returns {boolean} Returns true if the url address is valid else false.
+ * @example validateUrlAddress(https://www.example.com) // true
+ */
+const validateUrlAddress = (url) => {
+    if (!url) {
+        return false;
+    }
+    // Using pattern from libs/custom-field/components/src/getValidationRules.ts
+    const urlPattern = new RegExp("^(((https?|ftps?)://)(%[0-9A-Fa-f]{2}|[-()_.!~*';/?:@&=+$,A-Za-z0-9])+)([).!';/?:,][[:blank:|:blank:]])?$");
+    return urlPattern.test(url);
+};
+
+/**
+ * A thin wrapper around the `BaseInput` component for URL input fields.
+ *
+ * NOTE: If shown with a label, please use the `UrlField` component instead.
+ */
+const UrlInput = forwardRef((_a, ref) => {
+    var { dataTestId, isInvalid, disabled = false, fieldSize = "medium", disableAction = false, value, defaultValue } = _a, rest = __rest(_a, ["dataTestId", "isInvalid", "disabled", "fieldSize", "disableAction", "value", "defaultValue"]);
+    const [url, setUrl] = useState((value === null || value === void 0 ? void 0 : value.toString()) || (defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.toString()));
+    const renderAsInvalid = (url && typeof url === "string" && !validateUrlAddress(url)) || isInvalid;
+    return (jsx(BaseInput, Object.assign({ id: "url-input", dataTestId: dataTestId && `${dataTestId}-url-input`, ref: ref, type: "url", placeholder: rest.placeholder || "https://www.example.com", onChange: e => setUrl(e.target.value), isInvalid: renderAsInvalid, value: url, disabled: disabled }, rest, { actions: !disableAction && (jsx(ActionButton, { disabled: renderAsInvalid || disabled, value: url, type: "WEB_ADDRESS", dataTestId: (dataTestId && `${dataTestId}-url-input-Icon`) || "url-input-action-icon", iconSize: fieldSize })) })));
+});
+
+/**
+ * The UrlField component is used to enter url.
+ * UrlField validates that user enters a valid web address.
+ *
+ */
+const UrlField = forwardRef((_a, ref) => {
+    var { label, id, tip, helpText, errorMessage, helpAddon, className, defaultValue, dataTestId, isInvalid = false, value } = _a, rest = __rest(_a, ["label", "id", "tip", "helpText", "errorMessage", "helpAddon", "className", "defaultValue", "dataTestId", "isInvalid", "value"]);
+    const htmlForId = id ? id : "urlField-" + v4();
+    // Type guard to check if value is a string
+    function isString(inputValue) {
+        return typeof inputValue === "string";
+    }
+    const renderAsInvalid = !!errorMessage || (value && isString(value) && !validateUrlAddress(value)) || isInvalid;
+    return (jsx(FormGroup, { htmlFor: htmlForId, label: label, tip: tip, isInvalid: renderAsInvalid, helpText: renderAsInvalid ? errorMessage : helpText, helpAddon: helpAddon, disabled: rest.disabled, dataTestId: dataTestId && `${dataTestId}-FormGroup`, children: jsx(UrlInput, Object.assign({ id: htmlForId, "aria-labelledby": htmlForId + "-label", ref: ref, value: value || defaultValue, isInvalid: renderAsInvalid, disabled: rest.disabled }, rest, { className: className, dataTestId: dataTestId })) }));
+});
+
 /*
  * ----------------------------
  * | SETUP TRANSLATIONS START |
@@ -2132,4 +2200,4 @@ const UploadField = forwardRef((_a, ref) => {
  */
 setupLibraryTranslations();
 
-export { ActionButton, BaseInput, Checkbox, CreatableSelect, DateField, DateInput, DropZone, EmailField, EmailInput, FormGroup, Label, MultiSelectMenuItem, NumberField, NumberInput, OptionCard, PhoneField, PhoneInput, RadioGroup, RadioItem, Schedule, ScheduleVariant, Search, Select, SingleSelectMenuItem, TextArea, TextAreaField, TextField, TextInput, TimeRange, TimeRangeField, Toggle, UploadField, UploadInput, checkIfPhoneNumberHasPlus, countryCodeToFlagEmoji, cvaInput, cvaInputAddon, cvaInputAddonAfter, cvaInputAddonBefore, cvaInputBase, cvaInputBaseDisabled, cvaInputBaseInvalid, cvaInputField, cvaInputPrefix, cvaInputSuffix, cvaSelect, cvaSelectCounter, cvaSelectDynamicTagContainer, cvaSelectIcon, cvaSelectMenu, cvaSelectMenuList, cvaSelectPrefix, cvaSelectXIcon, getCountryAbbreviation, getOrderedOptions, getPhoneNumberWithPlus, isInvalidCountryCode, isInvalidPhoneNumber, isMultiValue, parseSchedule, serializeSchedule, useCustomComponents, usePhoneInput, validateEmailAddress, validatePhoneNumber, weekDay };
+export { ActionButton, BaseInput, Checkbox, CreatableSelect, DateField, DateInput, DropZone, EmailField, EmailInput, FormGroup, Label, MultiSelectMenuItem, NumberField, NumberInput, OptionCard, PasswordField, PasswordInput, PhoneField, PhoneInput, RadioGroup, RadioItem, Schedule, ScheduleVariant, Search, Select, SingleSelectMenuItem, TextArea, TextAreaField, TextField, TextInput, TimeRange, TimeRangeField, Toggle, UploadField, UploadInput, UrlField, UrlInput, checkIfPhoneNumberHasPlus, countryCodeToFlagEmoji, cvaInput, cvaInputAddon, cvaInputAddonAfter, cvaInputAddonBefore, cvaInputBase, cvaInputBaseDisabled, cvaInputBaseInvalid, cvaInputField, cvaInputPrefix, cvaInputSuffix, cvaSelect, cvaSelectCounter, cvaSelectDynamicTagContainer, cvaSelectIcon, cvaSelectMenu, cvaSelectMenuList, cvaSelectPrefix, cvaSelectXIcon, getCountryAbbreviation, getOrderedOptions, getPhoneNumberWithPlus, isInvalidCountryCode, isInvalidPhoneNumber, isMultiValue, parseSchedule, serializeSchedule, useCustomComponents, usePhoneInput, validateEmailAddress, validatePhoneNumber, weekDay };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-form-components",
-  "version": "0.0.263",
+  "version": "0.0.266",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/components/PasswordField/PasswordField.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="react" />
+import { FormGroupProps } from "../FormGroup/FormGroup";
+import { PasswordInputProps } from "../PasswordInput/PasswordInput";
+type FormGroupExposedProps = Pick<FormGroupProps, "label" | "tip" | "helpText" | "helpAddon">;
+export interface PasswordFieldProps extends Omit<PasswordInputProps, "obfuscate" | "actions">, FormGroupExposedProps {
+    /**
+     * If a value is set, the field is rendered in its invalid state.
+     */
+    errorMessage?: string;
+}
+/**
+ * Password fields enter a password or other confidential information. Characters are masked as they are typed.
+ *
+ * _**Do use** when the user has to input a password or something that needs to be obfuscated_
+ *
+ * _**Do not use** to confirm user actions, such as deleting. Use a checkbox for such flows._
+ */
+export declare const PasswordField: import("react").ForwardRefExoticComponent<PasswordFieldProps & import("react").RefAttributes<HTMLInputElement>>;
+export {};

package/src/components/PasswordField/index.d.ts

@@ -0,0 +1 @@
+export * from "./PasswordField";

package/src/components/PasswordInput/PasswordInput.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="react" />
+import { BaseInputProps } from "../BaseInput/BaseInput";
+type BaseInputExposedProps = Omit<BaseInputProps, "type">;
+export interface PasswordInputProps extends BaseInputExposedProps {
+    /**
+     * If false the field will show password as plain text.
+     */
+    obfuscate?: boolean;
+}
+/**
+ * A thin wrapper around the `BaseInput` component for password input fields.
+ *
+ * NOTE: If shown with a label, please use the `PasswordField` component instead.
+ */
+export declare const PasswordInput: import("react").ForwardRefExoticComponent<PasswordInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export {};

package/src/components/UrlField/UrlField.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="react" />
+import { FormGroupProps } from "../FormGroup/FormGroup";
+import { UrlInputProps } from "../UrlInput/UrlInput";
+type FormGroupExposedProps = Pick<FormGroupProps, "label" | "tip" | "helpText" | "helpAddon">;
+export interface UrlFieldProps extends FormGroupExposedProps, UrlInputProps {
+    /**
+     * If a value is set, the field is rendered in its invalid state.
+     */
+    errorMessage?: string;
+}
+/**
+ * The UrlField component is used to enter url.
+ * UrlField validates that user enters a valid web address.
+ *
+ */
+export declare const UrlField: import("react").ForwardRefExoticComponent<UrlFieldProps & import("react").RefAttributes<HTMLInputElement>>;
+export {};

package/src/components/UrlInput/UrlInput.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+import { BaseInputProps } from "../BaseInput";
+type BaseInputExposedProps = Omit<BaseInputProps, "type">;
+export interface UrlInputProps extends BaseInputExposedProps {
+    /**
+     * To disable the action button.
+     *
+     * @default false
+     * @memberof UrlInputProps
+     * @example
+     * <UrLInput disableAction />
+     */
+    disableAction?: boolean;
+}
+/**
+ * A thin wrapper around the `BaseInput` component for URL input fields.
+ *
+ * NOTE: If shown with a label, please use the `UrlField` component instead.
+ */
+export declare const UrlInput: import("react").ForwardRefExoticComponent<UrlInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export {};

package/src/index.d.ts

@@ -11,6 +11,8 @@ export * from "./components/Label/Label";
 export * from "./components/NumberField/NumberField";
 export * from "./components/NumberInput/NumberInput";
 export * from "./components/OptionCard/OptionCard";
+export * from "./components/PasswordField";
+export * from "./components/PasswordInput/PasswordInput";
 export * from "./components/PhoneField/PhoneField";
 export * from "./components/PhoneInput/PhoneInput";
 export * from "./components/PhoneInput/PhoneInputValidationUtils";
@@ -29,5 +31,7 @@ export * from "./components/TimeRangeField/TimeRangeField";
 export * from "./components/Toggle";
 export * from "./components/UploadField/UploadField";
 export * from "./components/UploadInput/UploadInput";
+export * from "./components/UrlField/UrlField";
+export * from "./components/UrlInput/UrlInput";
 export * from "./utilities/emailUtils";
 export * from "./utilities/usePhoneInput";

package/src/utilities/urlUtils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description Validate given url id.
+ * @param url The address to validate.
+ * @returns {boolean} Returns true if the url address is valid else false.
+ * @example validateUrlAddress(https://www.example.com) // true
+ */
+export declare const validateUrlAddress: (url: string) => boolean;