@vonage/vivid-react 3.4.1 → 3.5.0

package/v3/VwcTimePicker/index.js

@@ -7,32 +7,6 @@ Code in this file were generated using following JSON:
  "kind": "class",
  "description": "",
  "name": "TimePicker",
- "cssProperties": [
-  {
-   "name": "--vvd-time-picker-accent-primary",
-   "default": "var(--vvd-color-canvas-text)"
-  },
-  {
-   "name": "--vvd-time-picker-accent-firm",
-   "default": "var(--vvd-color-canvas-text)"
-  },
-  {
-   "name": "--vvd-time-picker-accent-faint",
-   "default": "var(--vvd-color-neutral-50)"
-  },
-  {
-   "name": "--vvd-time-picker-accent-soft",
-   "default": "var(--vvd-color-neutral-100)"
-  },
-  {
-   "name": "--vvd-time-picker-accent-dim",
-   "default": "var(--vvd-color-neutral-200)"
-  },
-  {
-   "name": "--vvd-time-picker-accent-pale",
-   "default": "var(--vvd-color-neutral-300)"
-  }
- ],
  "slots": [
   {
    "description": "Describes how to use the time-picker. Alternative to the `helper-text` attribute.",
@@ -42,13 +16,39 @@ Code in this file were generated using following JSON:
  "members": [
   {
    "kind": "field",
-   "name": "readOnly",
+   "name": "min",
    "type": {
-    "text": "boolean"
+    "text": "string"
    },
-   "default": "false",
-   "description": "Whether the time-picker is readonly.",
-   "privacy": "public"
+   "description": "The earliest accepted time of the time-picker.",
+   "privacy": "public",
+   "default": "''"
+  },
+  {
+   "kind": "field",
+   "name": "max",
+   "type": {
+    "text": "string"
+   },
+   "description": "The latest accepted time of the time-picker.",
+   "privacy": "public",
+   "default": "''"
+  },
+  {
+   "kind": "field",
+   "name": "type",
+   "type": {
+    "text": "string"
+   },
+   "default": "'time'"
+  },
+  {
+   "kind": "field",
+   "name": "step",
+   "type": {
+    "text": "string"
+   },
+   "default": "'1'"
   },
   {
    "kind": "field",
@@ -58,7 +58,11 @@ Code in this file were generated using following JSON:
    },
    "default": "null",
    "description": "Distance between presented minute options.",
-   "privacy": "public"
+   "privacy": "public",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
   },
   {
    "kind": "field",
@@ -68,7 +72,11 @@ Code in this file were generated using following JSON:
    },
    "default": "null",
    "description": "Distance between presented seconds options. If null, seconds are not presented.",
-   "privacy": "public"
+   "privacy": "public",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
   },
   {
    "kind": "field",
@@ -76,136 +84,437 @@ Code in this file were generated using following JSON:
    "type": {
     "text": "'12h' | '24h' | undefined"
    },
-   "description": "Forces the time-picker to use a 12h or 24h clock.",
-   "privacy": "public"
+   "description": "Forces a 12h or 24h clock to be used.",
+   "privacy": "public",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "min",
+   "name": "#clockChangeHandler",
+   "privacy": "private",
    "type": {
-    "text": "string"
+    "text": "object"
    },
-   "description": "The earliest accepted time of the time-picker.",
-   "privacy": "public",
-   "default": "''"
+   "default": "{\n\t\t\thandleChange: () => {\n\t\t\t\tif (this.value) {\n\t\t\t\t\tthis._presentationValue = this._toPresentationValue(this.value);\n\t\t\t\t}\n\t\t\t},\n\t\t}",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "max",
+   "name": "#clockChangeObserver",
+   "privacy": "private",
    "type": {
-    "text": "string"
+    "text": "BindingObserver"
    },
-   "description": "The latest accepted time of the time-picker.",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
+  },
+  {
+   "kind": "method",
+   "name": "#startObservingClockChanges",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
+  },
+  {
+   "kind": "method",
+   "name": "#stopObservingClockChanges",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "readOnly",
+   "type": {
+    "text": "boolean"
+   },
+   "default": "false",
+   "description": "Whether the date-picker is readonly.",
    "privacy": "public",
-   "default": "''"
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "#clockChangeHandler",
+   "name": "#onFocusIn",
+   "privacy": "private",
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "#onFocusOut",
+   "privacy": "private",
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "#localeChangeHandler",
    "privacy": "private",
    "type": {
     "text": "object"
    },
-   "default": "{\n\t\thandleChange: () => {\n\t\t\tif (this.value) {\n\t\t\t\tthis._presentationValue = formatPresentationTime(\n\t\t\t\t\tthis.value,\n\t\t\t\t\tthis._displaySeconds,\n\t\t\t\t\tthis._use12hClock\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\t}"
+   "default": "{\n\t\thandleChange: () => {\n\t\t\tthis._updatePresentationValue();\n\t\t},\n\t}",
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "#clockChangeObserver",
+   "name": "#localeChangeObserver",
    "privacy": "private",
    "type": {
     "text": "BindingObserver"
+   },
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
+  },
+  {
+   "kind": "method",
+   "name": "#startObservingLocaleChanges",
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
+  },
+  {
+   "kind": "method",
+   "name": "#stopObservingLocaleChanges",
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
    }
   },
   {
    "kind": "field",
-   "name": "#getFocusableEls",
-   "privacy": "private"
+   "name": "#dismissOnClickOutside",
+   "privacy": "private",
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
   },
   {
    "kind": "method",
-   "name": "#updateValueDueToUserInteraction",
-   "parameters": [
-    {
-     "name": "newValue",
-     "type": {
-      "text": "TimeStr"
-     }
-    }
-   ]
+   "name": "#openPopupIfPossible",
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "#onFocusIn",
-   "privacy": "private"
+   "name": "value",
+   "type": {
+    "text": "string"
+   },
+   "description": "The current value of the element.",
+   "default": "''",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "#onFocusOut",
-   "privacy": "private"
+   "name": "helperText",
+   "type": {
+    "text": "string | undefined"
+   },
+   "description": "Provides additional information to help the user enter the correct information.\nTo add HTML to the helper text, use the helper-text slot instead.",
+   "privacy": "public",
+   "inheritedFrom": {
+    "name": "WithFeedback",
+    "module": "src/shared/feedback/mixins.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "#dismissOnClickOutside",
-   "privacy": "private"
+   "name": "errorText",
+   "type": {
+    "text": "string | undefined"
+   },
+   "description": "Provides a custom error message. Any current error state will be overridden.",
+   "privacy": "public",
+   "inheritedFrom": {
+    "name": "WithErrorText",
+    "module": "src/shared/patterns/form-elements/with-error-text.ts"
+   }
   },
   {
-   "kind": "method",
-   "name": "#openPopupIfPossible"
+   "kind": "field",
+   "name": "#blockValidateCalls",
+   "privacy": "private",
+   "type": {
+    "text": "boolean"
+   },
+   "default": "false",
+   "inheritedFrom": {
+    "name": "WithErrorText",
+    "module": "src/shared/patterns/form-elements/with-error-text.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "#originalValidateFn",
+   "privacy": "private",
+   "type": {
+    "text": "() => void"
+   },
+   "inheritedFrom": {
+    "name": "WithErrorText",
+    "module": "src/shared/patterns/form-elements/with-error-text.ts"
+   }
   },
   {
    "kind": "method",
-   "name": "#scrollToItem",
+   "name": "#forceCustomError",
    "parameters": [
     {
-     "name": "picker",
-     "type": {
-      "text": "string"
-     }
-    },
-    {
-     "name": "selectedValue",
+     "name": "errorMessage",
      "type": {
       "text": "string"
      }
-    },
-    {
-     "name": "position",
-     "type": {
-      "text": "'nearest' | 'start'"
-     }
     }
-   ]
+   ],
+   "inheritedFrom": {
+    "name": "WithErrorText",
+    "module": "src/shared/patterns/form-elements/with-error-text.ts"
+   }
+  },
+  {
+   "kind": "method",
+   "name": "#clearCustomErrorAndRevalidate",
+   "inheritedFrom": {
+    "name": "WithErrorText",
+    "module": "src/shared/patterns/form-elements/with-error-text.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "value",
+   "name": "validate",
+   "inheritedFrom": {
+    "name": "WithErrorText",
+    "module": "src/shared/patterns/form-elements/with-error-text.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "label",
+   "type": {
+    "text": "string | undefined"
+   },
+   "description": "The label for the form element.",
+   "inheritedFrom": {
+    "name": "FormElement",
+    "module": "src/shared/patterns/form-elements/form-element.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "#handleInvalidEvent",
+   "privacy": "private",
+   "inheritedFrom": {
+    "name": "FormElement",
+    "module": "src/shared/patterns/form-elements/form-element.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "validity",
+   "type": {
+    "text": "ValidityState"
+   },
+   "description": "Returns the validity state of the element",
+   "readonly": true,
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "form",
+   "type": {
+    "text": "HTMLFormElement | null"
+   },
+   "description": "Retrieve a reference to the associated form.\nReturns null if not associated to any form.",
+   "readonly": true,
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "validationMessage",
    "type": {
     "text": "string"
    },
-   "default": "''"
+   "description": "Retrieve the localized validation message,\nor custom validation message if set.",
+   "readonly": true,
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "type",
+   "name": "willValidate",
+   "type": {
+    "text": "boolean"
+   },
+   "description": "Whether the element will be validated when the\nform is submitted",
+   "readonly": true,
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "labels",
+   "type": {
+    "text": "ReadonlyArray<Node>"
+   },
+   "description": "A reference to all associated label elements",
+   "readonly": true,
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "currentValue",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "initialValue",
    "type": {
     "text": "string"
    },
-   "default": "'time'"
+   "description": "The default value of the element. This value sets the `value` property\nonly when the `value` property has not been explicitly set.",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "step",
+   "name": "disabled",
+   "type": {
+    "text": "boolean"
+   },
+   "default": "false",
+   "description": "Sets the element's disabled state. A disabled element will not be included during form submission.",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "name",
    "type": {
     "text": "string"
    },
-   "default": "'1'"
+   "description": "The name of the element. This element's value will be surfaced during form submission under the provided name.",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "required",
+   "type": {
+    "text": "boolean"
+   },
+   "description": "Require the field to be completed prior to form submission.",
+   "default": "false",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "method",
+   "name": "checkValidity",
+   "return": {
+    "type": {
+     "text": "boolean"
+    }
+   },
+   "description": "Return the current validity of the element.",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "kind": "method",
+   "name": "reportValidity",
+   "return": {
+    "type": {
+     "text": "boolean"
+    }
+   },
+   "description": "Return the current validity of the element.\nIf false, fires an invalid event at the element.",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
   },
   {
    "kind": "field",
-   "name": "proxy",
+   "name": "VIVID_VERSION",
+   "static": true,
+   "default": "__PACKAGE_VERSION__",
+   "description": "The current version of the Vivid library, which is useful for debugging.\nIt can be accessed from any Vivid element via `<el>.constructor.VIVID_VERSION`.",
+   "type": {
+    "text": "string"
+   },
    "inheritedFrom": {
-    "name": "FormAssociatedTimePicker",
-    "module": "libs/components/src/lib/time-picker/time-picker.form-associated.ts"
+    "name": "VividElement",
+    "module": "src/shared/foundation/vivid-element/vivid-element.ts"
+   }
+  },
+  {
+   "kind": "field",
+   "name": "componentName",
+   "type": {
+    "text": "string"
+   },
+   "static": true,
+   "description": "Core component name, without prefix",
+   "inheritedFrom": {
+    "name": "VividElement",
+    "module": "src/shared/foundation/vivid-element/vivid-element.ts"
    }
   }
  ],
@@ -227,13 +536,22 @@ Code in this file were generated using following JSON:
  ],
  "attributes": [
   {
-   "name": "readonly",
+   "name": "min",
    "type": {
-    "text": "boolean"
+    "text": "string"
    },
-   "default": "false",
-   "description": "Whether the time-picker is readonly.",
-   "fieldName": "readOnly"
+   "description": "The earliest accepted time of the time-picker.",
+   "default": "''",
+   "fieldName": "min"
+  },
+  {
+   "name": "max",
+   "type": {
+    "text": "string"
+   },
+   "description": "The latest accepted time of the time-picker.",
+   "default": "''",
+   "fieldName": "max"
   },
   {
    "name": "minutes-step",
@@ -242,7 +560,11 @@ Code in this file were generated using following JSON:
    },
    "default": "null",
    "description": "Distance between presented minute options.",
-   "fieldName": "minutesStep"
+   "fieldName": "minutesStep",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
   },
   {
    "name": "seconds-step",
@@ -251,36 +573,149 @@ Code in this file were generated using following JSON:
    },
    "default": "null",
    "description": "Distance between presented seconds options. If null, seconds are not presented.",
-   "fieldName": "secondsStep"
+   "fieldName": "secondsStep",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
   },
   {
    "name": "clock",
    "type": {
     "text": "'12h' | '24h' | undefined"
    },
-   "description": "Forces the time-picker to use a 12h or 24h clock.",
-   "fieldName": "clock"
+   "description": "Forces a 12h or 24h clock to be used.",
+   "fieldName": "clock",
+   "inheritedFrom": {
+    "name": "TimeSelectionPicker",
+    "module": "src/shared/picker-field/mixins/time-selection-picker.ts"
+   }
+  },
+  {
+   "name": "readonly",
+   "type": {
+    "text": "boolean"
+   },
+   "default": "false",
+   "description": "Whether the date-picker is readonly.",
+   "fieldName": "readOnly",
+   "inheritedFrom": {
+    "name": "PickerField",
+    "module": "src/shared/picker-field/picker-field.ts"
+   }
+  },
+  {
+   "name": "helper-text",
+   "type": {
+    "text": "string | undefined"
+   },
+   "description": "Provides additional information to help the user enter the correct information.\nTo add HTML to the helper text, use the helper-text slot instead.",
+   "fieldName": "helperText",
+   "inheritedFrom": {
+    "name": "WithFeedback",
+    "module": "src/shared/feedback/mixins.ts"
+   }
   },
   {
+   "name": "error-text",
+   "type": {
+    "text": "string | undefined"
+   },
+   "description": "Provides a custom error message. Any current error state will be overridden.",
+   "fieldName": "errorText",
+   "inheritedFrom": {
+    "name": "WithErrorText",
+    "module": "src/shared/patterns/form-elements/with-error-text.ts"
+   }
+  },
+  {
+   "name": "label",
+   "type": {
+    "text": "string | undefined"
+   },
+   "description": "The label for the form element.",
+   "fieldName": "label",
+   "inheritedFrom": {
+    "name": "FormElement",
+    "module": "src/shared/patterns/form-elements/form-element.ts"
+   }
+  },
+  {
+   "name": "current-value",
    "type": {
     "text": "string"
    },
-   "description": "The earliest accepted time of the time-picker.",
-   "default": "''",
-   "fieldName": "min"
+   "description": "The current value of the element.",
+   "fieldName": "value",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
   },
   {
+   "name": "value",
    "type": {
     "text": "string"
    },
-   "description": "The latest accepted time of the time-picker.",
-   "default": "''",
-   "fieldName": "max"
+   "description": "The default value of the element. This value sets the `value` property\nonly when the `value` property has not been explicitly set.",
+   "fieldName": "initialValue",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "name": "disabled",
+   "type": {
+    "text": "boolean"
+   },
+   "default": "false",
+   "description": "Sets the element's disabled state. A disabled element will not be included during form submission.",
+   "fieldName": "disabled",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "name": "name",
+   "type": {
+    "text": "string"
+   },
+   "description": "The name of the element. This element's value will be surfaced during form submission under the provided name.",
+   "fieldName": "name",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  },
+  {
+   "name": "required",
+   "type": {
+    "text": "boolean"
+   },
+   "description": "Require the field to be completed prior to form submission.",
+   "default": "false",
+   "fieldName": "required",
+   "inheritedFrom": {
+    "name": "FormAssociated",
+    "module": "src/shared/foundation/form-associated/form-associated.ts"
+   }
+  }
+ ],
+ "mixins": [
+  {
+   "name": "TimeSelectionPicker",
+   "module": "/src/shared/picker-field/mixins/time-selection-picker"
+  },
+  {
+   "name": "SingleValuePicker",
+   "module": "/src/shared/picker-field/mixins/single-value-picker"
   }
  ],
  "superclass": {
-  "name": "FormAssociatedTimePicker",
-  "module": "/libs/components/src/lib/time-picker/time-picker.form-associated"
+  "name": "PickerField",
+  "module": "/src/shared/picker-field/picker-field"
  },
  "vividComponent": {
   "public": true,
@@ -288,11 +723,11 @@ Code in this file were generated using following JSON:
   "vueModels": [
    {
     "name": "modelValue",
-    "attributeName": "value",
+    "propName": "value",
     "eventNames": [
      "input"
     ],
-    "valueMapping": "(event.target as HTMLInputElement).value"
+    "valueMapping": "event.currentTarget.value"
    }
   ]
  }
@@ -306,7 +741,7 @@ registerTimePicker('vvd3')
 const VwcTimePicker = wrapper(`vvd3-time-picker`,  {
     events: [{"name":"change","propName":"onChange"},{"name":"input","propName":"onInput"}],
     attributes: [],
-    properties: ['readOnly', 'minutesStep', 'secondsStep', 'clock', 'min', 'max', 'value', 'type', 'step', 'proxy']
+    properties: ['min', 'max', 'type', 'step', 'minutesStep', 'secondsStep', 'clock', 'readOnly', 'value', 'helperText', 'errorText', 'validate', 'label', 'currentValue', 'initialValue', 'disabled', 'name', 'required', 'VIVID_VERSION', 'componentName']
 })
 
 VwcTimePicker.displayName = 'VwcTimePicker'