@vonage/vivid 4.14.1 → 4.14.3

package/shared/definition34.js

@@ -1,245 +1,24 @@
 import { B as Button, b as buttonDefinition } from './definition11.js';
 import { D as Divider, d as dividerDefinition } from './definition22.js';
-import { a as attr, n as nullableNumberConverter, o as observable, D as DOM, V as VividElement, h as html, d as defineVividComponent, f as createRegisterFunction } from './vivid-element.js';
+import { V as VividElement, D as DOM, a as attr, o as observable, n as nullableNumberConverter, h as html, d as defineVividComponent, f as createRegisterFunction } from './vivid-element.js';
 import { i as iconDefinition } from './definition27.js';
+import { D as DelegatesARIATextbox } from './text-field2.js';
 import { a as applyMixinsWithObservables } from './applyMixinsWithObservables.js';
-import { F as FormAssociated$1 } from './form-associated.js';
-import { F as FoundationElement, _ as __decorate, S as StartEnd } from './key-codes2.js';
-import { a as applyMixins } from './apply-mixins2.js';
-import { F as FormAssociated } from './form-associated2.js';
-import { A as ARIAGlobalStatesAndProperties } from './aria-global2.js';
+import { F as FormAssociated } from './form-associated.js';
 import { f as keyArrowDown, e as keyArrowUp } from './key-codes.js';
 import { e as errorText, f as formElements, F as FormElementSuccessText, a as FormElementHelperText, b as FormElementCharCount, g as getFeedbackTemplate } from './form-elements.js';
-import { A as AffixIcon } from './affix.js';
+import { b as AffixIcon } from './affix.js';
 import { L as Localized } from './localized.js';
 import { S as Shape } from './enums.js';
 import { w as when } from './when.js';
 import { r as ref } from './ref.js';
 import { c as classNames } from './class-names.js';
 
-class _TextField extends FoundationElement {
-}
-/**
- * A form-associated base class for the {@link @microsoft/fast-foundation#(TextField:class)} component.
- *
- * @internal
- */
-class FormAssociatedTextField extends FormAssociated(_TextField) {
-    constructor() {
-        super(...arguments);
-        this.proxy = document.createElement("input");
-    }
-}
-
-/**
- * Text field sub-types
- * @public
- */
-const TextFieldType = {
-    /**
-     * An email TextField
-     */
-    email: "email",
-    /**
-     * A password TextField
-     */
-    password: "password",
-    /**
-     * A telephone TextField
-     */
-    tel: "tel",
-    /**
-     * A text TextField
-     */
-    text: "text",
-    /**
-     * A URL TextField
-     */
-    url: "url",
-};
-
-/**
- * A Text Field Custom HTML Element.
- * Based largely on the {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/text | <input type="text" /> element }.
- *
- * @slot start - Content which can be provided before the number field input
- * @slot end - Content which can be provided after the number field input
- * @slot - The default slot for the label
- * @csspart label - The label
- * @csspart root - The element wrapping the control, including start and end slots
- * @csspart control - The text field element
- * @fires change - Fires a custom 'change' event when the value has changed
- *
- * @public
- */
-class TextField extends FormAssociatedTextField {
-    constructor() {
-        super(...arguments);
-        /**
-         * Allows setting a type or mode of text.
-         * @public
-         * @remarks
-         * HTML Attribute: type
-         */
-        this.type = TextFieldType.text;
-    }
-    readOnlyChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.readOnly = this.readOnly;
-            this.validate();
-        }
-    }
-    autofocusChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.autofocus = this.autofocus;
-            this.validate();
-        }
-    }
-    placeholderChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.placeholder = this.placeholder;
-        }
-    }
-    typeChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.type = this.type;
-            this.validate();
-        }
-    }
-    listChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.setAttribute("list", this.list);
-            this.validate();
-        }
-    }
-    maxlengthChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.maxLength = this.maxlength;
-            this.validate();
-        }
-    }
-    minlengthChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.minLength = this.minlength;
-            this.validate();
-        }
-    }
-    patternChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.pattern = this.pattern;
-            this.validate();
-        }
-    }
-    sizeChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.size = this.size;
-        }
-    }
-    spellcheckChanged() {
-        if (this.proxy instanceof HTMLInputElement) {
-            this.proxy.spellcheck = this.spellcheck;
-        }
-    }
-    /**
-     * @internal
-     */
-    connectedCallback() {
-        super.connectedCallback();
-        this.proxy.setAttribute("type", this.type);
-        this.validate();
-        if (this.autofocus) {
-            DOM.queueUpdate(() => {
-                this.focus();
-            });
-        }
-    }
-    /**
-     * Selects all the text in the text field
-     *
-     * @public
-     */
-    select() {
-        this.control.select();
-        /**
-         * The select event does not permeate the shadow DOM boundary.
-         * This fn effectively proxies the select event,
-         * emitting a `select` event whenever the internal
-         * control emits a `select` event
-         */
-        this.$emit("select");
-    }
-    /**
-     * Handles the internal control's `input` event
-     * @internal
-     */
-    handleTextInput() {
-        this.value = this.control.value;
-    }
-    /**
-     * Change event handler for inner control.
-     * @remarks
-     * "Change" events are not `composable` so they will not
-     * permeate the shadow DOM boundary. This fn effectively proxies
-     * the change event, emitting a `change` event whenever the internal
-     * control emits a `change` event
-     * @internal
-     */
-    handleChange() {
-        this.$emit("change");
-    }
-    /** {@inheritDoc (FormAssociated:interface).validate} */
-    validate() {
-        super.validate(this.control);
-    }
-}
-__decorate([
-    attr({ attribute: "readonly", mode: "boolean" })
-], TextField.prototype, "readOnly", void 0);
-__decorate([
-    attr({ mode: "boolean" })
-], TextField.prototype, "autofocus", void 0);
-__decorate([
-    attr
-], TextField.prototype, "placeholder", void 0);
-__decorate([
-    attr
-], TextField.prototype, "type", void 0);
-__decorate([
-    attr
-], TextField.prototype, "list", void 0);
-__decorate([
-    attr({ converter: nullableNumberConverter })
-], TextField.prototype, "maxlength", void 0);
-__decorate([
-    attr({ converter: nullableNumberConverter })
-], TextField.prototype, "minlength", void 0);
-__decorate([
-    attr
-], TextField.prototype, "pattern", void 0);
-__decorate([
-    attr({ converter: nullableNumberConverter })
-], TextField.prototype, "size", void 0);
-__decorate([
-    attr({ mode: "boolean" })
-], TextField.prototype, "spellcheck", void 0);
-__decorate([
-    observable
-], TextField.prototype, "defaultSlottedNodes", void 0);
-/**
- * Includes ARIA states and properties relating to the ARIA textbox role
- *
- * @public
- */
-class DelegatesARIATextbox {
-}
-applyMixins(DelegatesARIATextbox, ARIAGlobalStatesAndProperties);
-applyMixins(TextField, StartEnd, DelegatesARIATextbox);
-
 const styles = ":host{display:inline-block}.base{--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-canvas);--_appearance-color-outline: var(--_connotation-color-intermediate)}.base.appearance-ghost{--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.base:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-canvas);--_appearance-color-outline: var(--_connotation-color-fierce)}.base:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)).appearance-ghost{--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: var(--_connotation-color-faint);--_appearance-color-outline: transparent}.base:where(.disabled,:disabled){--_appearance-color-text: var(--vvd-color-neutral-300);--_appearance-color-fill: var(--vvd-color-neutral-100);--_appearance-color-outline: var(--vvd-color-neutral-300)}.base:where(.disabled,:disabled).appearance-ghost{--_appearance-color-text: var(--vvd-color-neutral-300);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.base:where(.readonly):where(:not(.disabled,:disabled)){--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-neutral-200);--_appearance-color-outline: var(--vvd-color-neutral-400)}.base:where(.readonly):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: var(--vvd-color-neutral-600);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.base:where(.error):where(:not(.disabled,:disabled)){--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-alert-50);--_appearance-color-outline: var(--vvd-color-alert-500)}.base:where(.error):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-alert-50);--_appearance-color-outline: transparent}.base:where(.success):where(:not(.disabled,:disabled)){--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-success-50);--_appearance-color-outline: var(--vvd-color-success-500)}.base:where(.success):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-success-50);--_appearance-color-outline: transparent}.base{--_connotation-color-primary: var(--vvd-text-field-accent-primary, var(--vvd-color-canvas-text));--_connotation-color-primary-text: var(--vvd-text-field-accent-primary-text, var(--vvd-color-canvas));--_connotation-color-primary-increment: var(--vvd-text-field-accent-primary-increment, var(--vvd-color-neutral-800));--_connotation-color-intermediate: var(--vvd-text-field-accent-intermediate, var(--vvd-color-neutral-500));--_connotation-color-firm: var(--vvd-text-field-accent-firm, var(--vvd-color-canvas-text));--_connotation-color-fierce: var(--vvd-text-field-accent-fierce, var(--vvd-color-neutral-700));--_connotation-color-faint: var(--vvd-text-field-accent-faint, var(--vvd-color-neutral-50));--_connotation-color-soft: var(--vvd-text-field-accent-soft, var(--vvd-color-neutral-100))}.base{--_text-field-gutter-start: calc(1px*(40 + 4*clamp(-1, var(--vvd-size-density, 0), 2))*.4) ;--_text-field-gutter-end: calc(1px*(40 + 4*clamp(-1, var(--vvd-size-density, 0), 2))*.4) ;--_text-field-icon-size: calc(1px*(40 + 4*clamp(-1, var(--vvd-size-density, 0), 2))/2) ;--_text-field-block-size: calc(1px*(40 + 4*clamp(-1, var(--vvd-size-density, 0), 2))) ;--_text-field-border-radius: 8px;--_text-field-pill-border-radius: 24px;display:inline-grid;width:100%;gap:4px;grid-template-columns:min-content 1fr max-content}.base.size-condensed{--_text-field-gutter-start: calc(1px*(24 + 4*clamp(-1, var(--vvd-size-density, 0), 2))/2) ;--_text-field-gutter-end: calc(1px*(24 + 4*clamp(-1, var(--vvd-size-density, 0), 2))/2) ;--_text-field-icon-size: calc(1px*(32 + 4*clamp(-1, var(--vvd-size-density, 0), 2))/2) ;--_text-field-block-size: calc(1px*(32 + 4*clamp(-1, var(--vvd-size-density, 0), 2))) ;--_text-field-border-radius: 4px}@supports (user-select: none){.base{user-select:none}}.base:not(.disabled){--_low-ink-color: var(--vvd-color-neutral-600)}.base.disabled{--_low-ink-color: var(--_appearance-color-text)}.label:not(slot),.label::slotted(label){box-sizing:initial!important;padding:initial!important;margin:initial!important;color:var(--vvd-color-canvas-text)!important;contain:inline-size!important;font:var(--vvd-typography-base);grid-column:1/4;grid-row:1}.char-count+.label:not(slot),.char-count+.label::slotted(label){grid-column:1/3}.char-count{color:var(--_low-ink-color);font:var(--vvd-typography-base);grid-column:3/4}.fieldset{position:relative;display:flex;align-items:center;background-color:var(--_appearance-color-fill);font:var(--vvd-typography-base);grid-column:1/4;padding-block:0;transition:color .2s,background-color .2s}.fieldset:after{position:absolute;display:block;border-radius:inherit;block-size:100%;box-shadow:inset 0 0 0 1px var(--_appearance-color-outline);content:\"\";inline-size:100%;pointer-events:none;transition:box-shadow .2s}.fieldset:focus-visible{outline:none}.base>.fieldset{block-size:var(--_text-field-block-size)}.base:not(.shape-pill) .fieldset{border-radius:var(--_text-field-border-radius)}.base.shape-pill .fieldset{border-radius:var(--_text-field-pill-border-radius)}.wrapper{border-radius:inherit;block-size:100%;inline-size:100%}.control{border-radius:inherit;text-align:start}.control:not(slot),.control::slotted(input){width:100%!important;box-sizing:border-box!important;border:0 none!important;border-radius:inherit!important;margin:initial!important;appearance:none!important;background-color:transparent!important;block-size:100%!important;color:inherit!important;font:inherit;outline:transparent;padding-block:0!important;padding-inline:var(--_text-field-gutter-start) var(--_text-field-gutter-end)!important;text-align:inherit}.control:not(slot):disabled,.control::slotted(input:disabled){cursor:not-allowed!important;opacity:1!important;-webkit-text-fill-color:var(--_appearance-color-text)!important}.control:not(slot)::placeholder{opacity:1!important;-webkit-text-fill-color:var(--_low-ink-color)!important}.control::slotted(input:-webkit-autofill),.control:not(slot):-webkit-autofill{-webkit-box-shadow:0 0 0 1000px var(--_appearance-color-fill) inset;-webkit-text-fill-color:var(--_appearance-color-text)!important}.has-icon .control:not(slot),.has-icon .control::slotted(input){padding-inline-start:calc(var(--_text-field-icon-size) + var(--_text-field-gutter-start) * 2)!important}.icon{position:absolute;z-index:1;color:var(--_low-ink-color);font-size:var(--_text-field-icon-size);inset-block-start:50%;inset-inline-start:calc(100% + var(--_text-field-gutter-start));line-height:1;transform:translateY(-50%)}.leading-items-wrapper{position:relative}.base.no-leading .leading-items-wrapper{display:none}.action-items-wrapper{margin-inline-end:4px}.base:not(.action-items) .action-items-wrapper{display:none}@supports selector(:has(*)){.fieldset:has(.wrapper .control:focus-within):after{--focus-stroke-gap-color: transparent;box-shadow:inset 0 0 0 3px var(--focus-stroke-gap-color, currentColor);outline:2px solid var(--focus-stroke-color, var(--vvd-color-canvas-text));outline-offset:calc(-2px - var(--focus-inset, 0px))}}@supports not selector(:has(*)){.wrapper:focus-within:after{box-shadow:inset 0 0 0 3px var(--focus-stroke-gap-color, currentColor);outline:2px solid var(--focus-stroke-color, var(--vvd-color-canvas-text));outline-offset:calc(-2px - var(--focus-inset, 0px));--focus-stroke-gap-color: transparent;position:absolute;z-index:1;display:block;border-radius:inherit;content:\"\";inset:0;pointer-events:none}}:host([internal-part]) .fieldset{background-color:transparent;font:var(--vvd-typography-heading-4);line-height:1.1}:host([internal-part]) .fieldset:not(:focus-within):after{block-size:1px;inset-block-end:0}@supports selector(:has(*)){:host([internal-part]) .fieldset:has(.action-items-wrapper:focus-within):after{block-size:1px;inset-block-end:0}}:host([internal-part]) .control{text-align:center}slot[name=_mirrored-helper-text]{display:none}.base{--_text-field-gutter-end: 70px}.control::-webkit-outer-spin-button,.control::-webkit-inner-spin-button{appearance:none}.control-buttons{position:absolute;z-index:1;right:3px;display:flex}.readonly .control-buttons,.disabled .control-buttons{pointer-events:none}.control-buttons .divider{margin-block:8px}.control-buttons>*{flex-shrink:0}";
 
 class _NumberField extends VividElement {
 }
-class FormAssociatedNumberField extends FormAssociated$1(_NumberField) {
+class FormAssociatedNumberField extends FormAssociated(_NumberField) {
   constructor() {
     super(...arguments);
     this.proxy = document.createElement("input");

package/shared/definition35.cjs

@@ -2,208 +2,11 @@
 
 const definition = require('./definition27.cjs');
 const vividElement = require('./vivid-element.cjs');
-const applyMixins = require('./apply-mixins.cjs');
+const option = require('./option.cjs');
 const affix = require('./affix.cjs');
-const ariaGlobal = require('./aria-global.cjs');
-const dom = require('./dom.cjs');
 const when = require('./when.cjs');
 const classNames = require('./class-names.cjs');
 
-var __defProp = Object.defineProperty;
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = void 0 ;
-  for (var i = decorators.length - 1, decorator; i >= 0; i--)
-    if (decorator = decorators[i])
-      result = (decorator(target, key, result) ) || result;
-  if (result) __defProp(target, key, result);
-  return result;
-};
-function isListboxOption(el) {
-  return dom.isHTMLElement(el) && (el.getAttribute("role") === "option" || el instanceof HTMLOptionElement);
-}
-class ListboxOption extends vividElement.VividElement {
-  constructor(text, value, defaultSelected, selected) {
-    super();
-    this.defaultSelected = false;
-    /**
-     * Tracks whether the "selected" property has been changed.
-     * @internal
-     */
-    this.dirtySelected = false;
-    this.selected = this.defaultSelected;
-    /**
-     * Track whether the value has been changed from the initial value
-     */
-    this.dirtyValue = false;
-    this._highlighted = false;
-    this._displayCheckmark = false;
-    this._matchedRange = null;
-    if (text) {
-      this.text = text;
-    }
-    if (value) {
-      this.initialValue = value;
-    }
-    if (defaultSelected) {
-      this.defaultSelected = defaultSelected;
-    }
-    if (selected) {
-      this.selected = selected;
-    }
-    this.proxy = new Option(
-      this.text,
-      // @ts-expect-error Propery is used before it is assigned
-      this.initialValue,
-      this.defaultSelected,
-      this.selected
-    );
-    this.proxy.disabled = this.disabled;
-  }
-  /**
-   * Updates the ariaChecked property when the checked property changes.
-   *
-   * @param _ - the previous checked value
-   * @param next - the current checked value
-   *
-   * @public
-   */
-  checkedChanged(_, next) {
-    if (typeof next === "boolean") {
-      this.ariaChecked = next ? "true" : "false";
-      return;
-    }
-    this.ariaChecked = null;
-  }
-  defaultSelectedChanged() {
-    if (!this.dirtySelected) {
-      this.selected = this.defaultSelected;
-      if (this.proxy instanceof HTMLOptionElement) {
-        this.proxy.selected = this.defaultSelected;
-      }
-    }
-  }
-  disabledChanged() {
-    this.ariaDisabled = this.disabled ? "true" : "false";
-    if (this.proxy instanceof HTMLOptionElement) {
-      this.proxy.disabled = this.disabled;
-    }
-  }
-  selectedAttributeChanged() {
-    this.defaultSelected = this.selectedAttribute;
-    if (this.proxy instanceof HTMLOptionElement) {
-      this.proxy.defaultSelected = this.defaultSelected;
-    }
-  }
-  selectedChanged() {
-    this.ariaSelected = this.selected ? "true" : "false";
-    if (!this.dirtySelected) {
-      this.dirtySelected = true;
-    }
-    if (this.proxy instanceof HTMLOptionElement) {
-      this.proxy.selected = this.selected;
-    }
-  }
-  initialValueChanged() {
-    if (!this.dirtyValue) {
-      this.value = this.initialValue;
-      this.dirtyValue = false;
-    }
-  }
-  get label() {
-    return this._label ?? this.text;
-  }
-  set label(value) {
-    this._label = value;
-  }
-  set text(value) {
-    this._text = value;
-  }
-  get text() {
-    return this._text ?? "";
-  }
-  set value(next) {
-    const newValue = `${next ?? ""}`;
-    this._value = newValue;
-    this.dirtyValue = true;
-    if (this.proxy instanceof HTMLOptionElement) {
-      this.proxy.value = newValue;
-    }
-    vividElement.Observable.notify(this, "value");
-  }
-  get value() {
-    vividElement.Observable.track(this, "value");
-    return this._value ?? this.text;
-  }
-  get form() {
-    return null;
-  }
-  /**
-   * @internal
-   */
-  get _matchedRangeSafe() {
-    return this._matchedRange ?? { from: 0, to: 0 };
-  }
-}
-__decorateClass([
-  vividElement.observable
-], ListboxOption.prototype, "checked");
-__decorateClass([
-  vividElement.observable
-], ListboxOption.prototype, "defaultSelected");
-// @ts-expect-error Type is incorrectly non-optional
-__decorateClass([
-  vividElement.attr({ mode: "boolean" })
-], ListboxOption.prototype, "disabled");
-// @ts-expect-error Type is incorrectly non-optional
-__decorateClass([
-  vividElement.attr({ attribute: "selected", mode: "boolean" })
-], ListboxOption.prototype, "selectedAttribute");
-__decorateClass([
-  vividElement.observable
-], ListboxOption.prototype, "selected");
-__decorateClass([
-  vividElement.attr({ attribute: "value", mode: "fromView" })
-], ListboxOption.prototype, "initialValue");
-__decorateClass([
-  vividElement.attr({
-    attribute: "label"
-  })
-], ListboxOption.prototype, "_label");
-__decorateClass([
-  vividElement.attr({
-    attribute: "text"
-  })
-], ListboxOption.prototype, "_text");
-__decorateClass([
-  vividElement.observable
-], ListboxOption.prototype, "_highlighted");
-__decorateClass([
-  vividElement.observable
-], ListboxOption.prototype, "_displayCheckmark");
-__decorateClass([
-  vividElement.observable
-], ListboxOption.prototype, "_matchedRange");
-class DelegatesARIAListboxOption {
-}
-// @ts-expect-error Type is incorrectly non-optional
-__decorateClass([
-  vividElement.observable
-], DelegatesARIAListboxOption.prototype, "ariaChecked");
-// @ts-expect-error Type is incorrectly non-optional
-__decorateClass([
-  vividElement.observable
-], DelegatesARIAListboxOption.prototype, "ariaPosInSet");
-// @ts-expect-error Type is incorrectly non-optional
-__decorateClass([
-  vividElement.observable
-], DelegatesARIAListboxOption.prototype, "ariaSelected");
-// @ts-expect-error Type is incorrectly non-optional
-__decorateClass([
-  vividElement.observable
-], DelegatesARIAListboxOption.prototype, "ariaSetSize");
-applyMixins.applyMixins(DelegatesARIAListboxOption, ariaGlobal.ARIAGlobalStatesAndProperties);
-applyMixins.applyMixins(ListboxOption, affix.AffixIconWithTrailing, DelegatesARIAListboxOption);
-
 const getClasses = (x) => classNames.classNames(
   "base",
   ["disabled", x.disabled],
@@ -253,7 +56,7 @@ const styles = ":host([disabled]){cursor:not-allowed}.base{--_connotation-color-
 
 const listboxOptionDefinition = vividElement.defineVividComponent(
   "option",
-  ListboxOption,
+  option.ListboxOption,
   ListboxOptionTemplate,
   [definition.iconDefinition],
   {
@@ -262,7 +65,5 @@ const listboxOptionDefinition = vividElement.defineVividComponent(
 );
 const registerOption = vividElement.createRegisterFunction(listboxOptionDefinition);
 
-exports.ListboxOption = ListboxOption;
-exports.isListboxOption = isListboxOption;
 exports.listboxOptionDefinition = listboxOptionDefinition;
 exports.registerOption = registerOption;