@verdocs/web-sdk 1.0.22 → 1.1.0

package/dist/collection/components/elements/verdocs-field-date/verdocs-field-date.js

@@ -0,0 +1,245 @@
+// @ts-ignore
+import { Datepicker } from 'vanillajs-datepicker';
+import { Component, Event, h, Host, Method, Prop, State } from '@stencil/core';
+/**
+ * Displays a date field. When tapped or clicked, the input element will display a date picker component.
+ */
+export class VerdocsFieldDate {
+  constructor() {
+    /**
+     * A placeholder to assist the user in completing the field.
+     */
+    this.placeholder = 'Select Date';
+    /**
+     * Sets the tabIndex of the input element.
+     */
+    this.order = 1;
+    /**
+     * Sets the value of the input element.
+     */
+    this.value = '';
+    /**
+     * If true, the field will be marked required.
+     */
+    this.required = false;
+    /**
+     * Sets the disabled attribute of the input element.
+     */
+    this.disabled = false;
+    this.focused = false;
+  }
+  async focusField() {
+    this.focused = true;
+    this.el.focus();
+    this.fieldFocus.emit(true);
+  }
+  componentDidLoad() {
+    new Datepicker(this.el, {
+      autohide: true,
+      todayHighlight: true,
+    });
+    this.el.addEventListener('changeDate', (e) => {
+      console.log('changeDate', e.detail.date.toISOString());
+    });
+  }
+  handleBlur() {
+    this.focused = false;
+    this.fieldBlur.emit(true);
+  }
+  handleFocus() {
+    this.focused = true;
+    this.fieldFocus.emit(true);
+  }
+  handleChange(e) {
+    this.fieldChange.emit(e.target.value);
+  }
+  handleInput(e) {
+    this.fieldInput.emit(e.target.value);
+  }
+  // NOTE: We don't use a "date" field here because browsers vary widely in their formatting of it.
+  render() {
+    return (h(Host, { class: { focused: this.focused, required: this.required, storybook: !!(window === null || window === void 0 ? void 0 : window['STORYBOOK_ENV']) } },
+      h("input", { type: "text", value: "", placeholder: this.placeholder, required: this.required, ref: el => (this.el = el), onBlur: () => this.handleBlur(), onFocus: () => this.handleFocus(), onChange: e => this.handleChange(e), onInput: e => this.handleInput(e) })));
+  }
+  static get is() { return "verdocs-field-date"; }
+  static get originalStyleUrls() { return {
+    "$": ["verdocs-field-date.scss"]
+  }; }
+  static get styleUrls() { return {
+    "$": ["verdocs-field-date.css"]
+  }; }
+  static get properties() { return {
+    "placeholder": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "A placeholder to assist the user in completing the field."
+      },
+      "attribute": "placeholder",
+      "reflect": false,
+      "defaultValue": "'Select Date'"
+    },
+    "order": {
+      "type": "number",
+      "mutable": false,
+      "complexType": {
+        "original": "number",
+        "resolved": "number",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Sets the tabIndex of the input element."
+      },
+      "attribute": "order",
+      "reflect": false,
+      "defaultValue": "1"
+    },
+    "value": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Sets the value of the input element."
+      },
+      "attribute": "value",
+      "reflect": false,
+      "defaultValue": "''"
+    },
+    "required": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "If true, the field will be marked required."
+      },
+      "attribute": "required",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "disabled": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Sets the disabled attribute of the input element."
+      },
+      "attribute": "disabled",
+      "reflect": false,
+      "defaultValue": "false"
+    }
+  }; }
+  static get states() { return {
+    "focused": {}
+  }; }
+  static get events() { return [{
+      "method": "fieldFocus",
+      "name": "fieldFocus",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": "Event fired when the input field loses focus."
+      },
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      }
+    }, {
+      "method": "fieldBlur",
+      "name": "fieldBlur",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": "Event fired when the input field gains focus."
+      },
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      }
+    }, {
+      "method": "fieldChange",
+      "name": "fieldChange",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": "Event fired when the input field value changes. Note that this will only be fired on blur, tab-out, ENTER key press, etc.\nIt is generally the best event to subscribe to than `input` for most cases EXCEPT autocomplete fields that need to see every\nkeypress."
+      },
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      }
+    }, {
+      "method": "fieldInput",
+      "name": "fieldInput",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": "Event fired on every character entered into / deleted from the field."
+      },
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      }
+    }]; }
+  static get methods() { return {
+    "focusField": {
+      "complexType": {
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "references": {
+          "Promise": {
+            "location": "global"
+          }
+        },
+        "return": "Promise<void>"
+      },
+      "docs": {
+        "text": "",
+        "tags": []
+      }
+    }
+  }; }
+}

package/dist/collection/components/elements/verdocs-field-date/verdocs-field-date.stories.js

@@ -0,0 +1,31 @@
+import { html } from 'lit-html';
+export default {
+  title: 'Elements/Document Fields/Date',
+  component: 'verdocs-field-date',
+  args: {
+    placeholder: 'Select Date',
+    order: 1,
+    value: '',
+    disabled: false,
+    required: false,
+  },
+  argTypes: {
+    fieldFocus: {
+      action: 'fieldFocus',
+      table: { disable: true },
+    },
+    fieldBlur: {
+      action: 'fieldBlur',
+      table: { disable: true },
+    },
+    fieldChange: {
+      action: 'fieldChange',
+      table: { disable: true },
+    },
+    fieldInput: {
+      action: 'fieldInput',
+      table: { disable: true },
+    },
+  },
+};
+export const Date = ({ placeholder, order, value, required, disabled }) => html `<verdocs-field-textbox .placeholder="${placeholder}" .order="${order}" .required="${required}" .value="${value}" .disabled="${disabled}" />`;

package/dist/collection/components/elements/verdocs-field-dropdown/verdocs-field-dropdown.css

@@ -0,0 +1,40 @@
+verdocs-field-dropdown {
+  /* Fallback font for old browsers */
+  font-family: sans-serif;
+  font-family: var(--verdocs-font);
+  width: 85px;
+  height: 20px;
+  display: block;
+  font-size: 11px;
+  position: relative;
+  background-color: transparent;
+  transform-origin: bottom left;
+}
+verdocs-field-dropdown select {
+  position: absolute;
+  background: linear-gradient(55deg, transparent 50%, #333 50%), linear-gradient(125deg, #333 50%, transparent 50%), linear-gradient(to right, transparent, transparent);
+  background-position: calc(100% - 7px) 4px, calc(100% - 3px) 4px, 100% 0;
+  background-size: 5px 5px, 5px 5px, 2.5em 2.5em;
+  background-repeat: no-repeat;
+  appearance: none;
+  box-sizing: border-box;
+  color: rgba(0, 0, 0, 0.87);
+  font-weight: 500;
+  transform-origin: 0 0;
+  height: 100%;
+  width: 100%;
+  font-size: 11px;
+  border: 1px solid rgba(0, 0, 0, 0.2);
+}
+verdocs-field-dropdown select:focus {
+  outline: none;
+}
+verdocs-field-dropdown select.hide {
+  display: none;
+}
+verdocs-field-dropdown.required select {
+  border: 1px solid var(--verdocs-required-color);
+}
+verdocs-field-dropdown.focused {
+  animation: verdocs-field-pulse 0.75s 2;
+}

package/dist/collection/components/elements/verdocs-field-dropdown/verdocs-field-dropdown.js

@@ -0,0 +1,216 @@
+import { Component, Event, h, Host, Method, Prop, State } from '@stencil/core';
+/**
+ * Displays a signature field. Various field types are supported, including traditional Signature and Initials types as well as
+ * input types like text and checkbox.
+ */
+export class VerdocsFieldDropdown {
+  constructor() {
+    /**
+     * The optoins to choose from.
+     */
+    this.options = [];
+    /**
+     * If true, the field will be marked required.
+     */
+    this.required = false;
+    /**
+     * Sets the tabIndex of the input element.
+     */
+    this.order = 1;
+    /**
+     * Sets the disabled attribute of the input element.
+     */
+    this.disabled = false;
+    /**
+     * The currently selected value.
+     */
+    this.value = '';
+    this.focused = false;
+  }
+  async focusField() {
+    this.focused = true;
+    this.el.focus();
+    this.fieldFocus.emit(true);
+  }
+  handleBlur() {
+    this.focused = false;
+    this.fieldBlur.emit(true);
+  }
+  handleFocus() {
+    this.focused = true;
+    this.fieldFocus.emit(true);
+  }
+  handleChange(e) {
+    this.fieldChange.emit(e.target.value);
+  }
+  render() {
+    return (h(Host, { class: { focused: this.focused, required: this.required } },
+      h("select", { tabIndex: this.order, disabled: this.disabled, ref: el => (this.el = el), onChange: e => this.handleChange(e), onBlur: () => this.handleBlur(), onFocus: () => this.handleFocus() },
+        h("option", { value: "" }, "Select..."),
+        this.options.map(option => (h("option", { value: option.id, selected: option.value === this.value }, option.value))))));
+  }
+  static get is() { return "verdocs-field-dropdown"; }
+  static get originalStyleUrls() { return {
+    "$": ["verdocs-field-dropdown.scss"]
+  }; }
+  static get styleUrls() { return {
+    "$": ["verdocs-field-dropdown.css"]
+  }; }
+  static get properties() { return {
+    "options": {
+      "type": "unknown",
+      "mutable": false,
+      "complexType": {
+        "original": "any[]",
+        "resolved": "any[]",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "The optoins to choose from."
+      },
+      "defaultValue": "[]"
+    },
+    "required": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "If true, the field will be marked required."
+      },
+      "attribute": "required",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "order": {
+      "type": "number",
+      "mutable": false,
+      "complexType": {
+        "original": "number",
+        "resolved": "number",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Sets the tabIndex of the input element."
+      },
+      "attribute": "order",
+      "reflect": false,
+      "defaultValue": "1"
+    },
+    "disabled": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Sets the disabled attribute of the input element."
+      },
+      "attribute": "disabled",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "value": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "The currently selected value."
+      },
+      "attribute": "value",
+      "reflect": false,
+      "defaultValue": "''"
+    }
+  }; }
+  static get states() { return {
+    "focused": {}
+  }; }
+  static get events() { return [{
+      "method": "fieldFocus",
+      "name": "fieldFocus",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": "Event fired when the input field loses focus."
+      },
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      }
+    }, {
+      "method": "fieldBlur",
+      "name": "fieldBlur",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": "Event fired when the input field gains focus."
+      },
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      }
+    }, {
+      "method": "fieldChange",
+      "name": "fieldChange",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": "Event fired when the input field value changes. Note that this will only be fired on blur, tab-out, ENTER key press, etc.\nIt is generally the best event to subscribe to than `input` for most cases EXCEPT autocomplete fields that need to see every\nkeypress."
+      },
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      }
+    }]; }
+  static get methods() { return {
+    "focusField": {
+      "complexType": {
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "references": {
+          "Promise": {
+            "location": "global"
+          }
+        },
+        "return": "Promise<void>"
+      },
+      "docs": {
+        "text": "",
+        "tags": []
+      }
+    }
+  }; }
+}

package/dist/collection/components/elements/verdocs-field-dropdown/verdocs-field-dropdown.stories.js

@@ -0,0 +1,14 @@
+import { html } from 'lit-html';
+export default {
+  title: 'Elements/Document Fields/Dropdown',
+  component: 'verdocs-field-dropdown',
+  args: {
+    order: 1,
+    value: '',
+    disabled: false,
+    required: false,
+    options: [{ id: 'id1', value: 'Option 1' }],
+  },
+  argTypes: {},
+};
+export const Dropdown = ({ order, value, required, disabled, options }) => html `<verdocs-field-dropdown .order="${order}" .required="${required}" .value="${value}" .disabled="${disabled}" .options="${options}" />`;

package/dist/collection/components/elements/verdocs-field-initial/verdocs-field-initial.css

@@ -0,0 +1,38 @@
+verdocs-field-initial {
+  /* Fallback font for old browsers */
+  font-family: sans-serif;
+  font-family: var(--verdocs-font);
+  width: 83px;
+  height: 36px;
+  display: block;
+  font-size: 11px;
+  letter-spacing: 0.3px;
+  background-color: transparent;
+  transform-origin: bottom left;
+  border: 1px solid rgba(0, 0, 0, 0.2);
+}
+verdocs-field-initial img {
+  display: block;
+  max-width: 100%;
+  max-height: 100%;
+}
+verdocs-field-initial button {
+  box-sizing: border-box;
+  border: none;
+  color: rgba(0, 0, 0, 0.87);
+  font-weight: 500;
+  transform-origin: 0 0;
+  height: 100%;
+  width: 100%;
+  background: none;
+  font-size: 11px;
+}
+verdocs-field-initial button.hide {
+  display: none;
+}
+verdocs-field-initial.required {
+  border: 1px solid var(--verdocs-required-color);
+}
+verdocs-field-initial.focused {
+  animation: verdocs-field-pulse 0.75s 2;
+}