@heartlandone/vega 2.77.1 → 2.78.0

package/dist/cjs/vega-input-numeric.cjs.entry.js

@@ -7,42 +7,42 @@ const component = require('./component-1e352960.js');
 const globalSlimmerRegistry = require('./global-slimmer-registry-b3bce7e0.js');
 const componentUsageRuntimeMetrics = require('./component-usage-runtime-metrics-4572c5b7.js');
 const domNodeSubjectObserverFactory = require('./dom-node-subject-observer-factory-c62823de.js');
-const vegaEventId = require('./vega-event-id-ee01d8dd.js');
+const vegaEventId = require('./vega-event-id-c08ce3d3.js');
 const number = require('./number-4816603d.js');
-const childNodesEventPreventSlimmer = require('./child-nodes-event-prevent-slimmer-cc6d2919.js');
-const eventEmitSlimmer = require('./event-emit-slimmer-062cdcb8.js');
+const childNodesEventPreventSlimmer = require('./child-nodes-event-prevent-slimmer-dd0bb8b6.js');
+const eventEmitSlimmer = require('./event-emit-slimmer-c84121c8.js');
 const staticSubjectTitle = require('./static-subject-title-5829a298.js');
 const changeManager = require('./change-manager-a297e4d2.js');
-const keyboardManagerSlimmer = require('./keyboard-manager-slimmer-5b8fa209.js');
-const formFieldControllerSlimmer = require('./form-field-controller-slimmer-1b3a1388.js');
+const keyboardManagerSlimmer = require('./keyboard-manager-slimmer-b44f0dc9.js');
+const formFieldControllerSlimmer = require('./form-field-controller-slimmer-73f5849e.js');
 const requiredFieldRule = require('./required-field-rule-d73c1d8c.js');
-const subStateNotifySlimmer = require('./sub-state-notify-slimmer-58121111.js');
+const subStateNotifySlimmer = require('./sub-state-notify-slimmer-ac1dae32.js');
 const minNumberRule = require('./min-number-rule-dc555309.js');
 require('./observer-f49483e8.js');
 require('./ui-234ea151.js');
-require('./internal-vega-event-manager-f7ecf3d4.js');
+require('./internal-vega-event-manager-cc0f511c.js');
 require('./vega-env-manager-23b8b23c.js');
 require('./feature-flag-controller-9129ef52.js');
 require('./index-f054eb5d.js');
 require('./dynamic-slimmer-f31fdfd7.js');
 require('./try-get-document-c0ebd39a.js');
-require('./keyboard-manager-16494c34.js');
-require('./type-guard-cd0376d4.js');
+require('./keyboard-manager-7de7ecfd.js');
+require('./type-guard-a0d9ff1f.js');
 require('./breakpoints-ebde4837.js');
-require('./ui-32e69595.js');
+require('./ui-024696c0.js');
 require('./typography-4560e7f1.js');
-require('./internal-translation-controller-1f84ab0a.js');
+require('./internal-translation-controller-24df468f.js');
 require('./string-39438062.js');
 require('./misc-3d30df91.js');
-require('./vega-internal-event-id-f2465f1b.js');
+require('./vega-internal-event-id-e0aeac45.js');
 require('./index-592b4052.js');
-require('./page-resize-observer-slimmer-7f065ee1.js');
-require('./breakpoints-751d433a.js');
+require('./page-resize-observer-slimmer-e050cd26.js');
+require('./breakpoints-a8ff22f0.js');
 require('./internal-form-field-validation-rule.abstract-07cdff46.js');
 require('./mutation-observer-slimmer-749d5020.js');
 require('./mutation-observer-filters-38cebc6d.js');
 require('./array-249289f2.js');
-require('./sub-state-observer-slimmer-1dfbc4c3.js');
+require('./sub-state-observer-slimmer-e692d849.js');
 
 var __decorate$3 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -311,106 +311,166 @@ const VegaInputNumeric = class {
     this.vegaComponentUsageRuntimeMetricsSlimmer = new componentUsageRuntimeMetrics.VegaComponentUsageRuntimeMetricsSlimmer();
     this.isCompactInputWidth = true;
     /**
-     * Defines the prefix for the input numeric field.
-     * It provides additional context or information displayed
-     *    before the numeric value, helping to
-     *    clarify its purpose or usage.
+     * Text displayed before (to the left of) the numeric value inside the input
+     * field. Use this to provide contextual information such as a currency
+     * symbol (e.g., `'$'`) or unit prefix.
      *
+     * @default ''
      * @vegaVersion 2.29.0
      */
     this.prefixText = '';
     /**
-     * Represents a pre-set or default value for the input numeric field.
+     * The current value of the numeric input field, represented as a string.
      *
+     * This property is mutable and will be updated when the user types or uses
+     * keyboard increment/decrement actions. It can also be set externally to
+     * pre-populate or reset the field. When `thousandComma` is enabled, the
+     * display is formatted with separators but the underlying value remains
+     * unformatted. Changes to this property trigger the `vegaChange` event.
+     *
+     * @default ''
      * @vegaVersion 2.29.0
      */
     /* eslint-disable-next-line @stencil/strict-mutable */
     this.value = '';
     /**
-     * Defines the size of the input numeric field.
+     * Controls the visual size of the numeric input field.
+     *
+     * - `'medium'` — Standard height, suitable for most form layouts.
+     * - `'small'` — Compact height, useful for dense UIs or inline editing.
      *
+     * @default 'medium'
      * @vegaVersion 2.29.0
      */
     this.size = 'medium';
     /**
-     * Determines whether the numeric input field should format numbers
-     *    with thousand separators (commas) during user input.
+     * When `true`, the numeric input automatically formats the displayed value
+     * with thousand separators (commas) as the user types (e.g., `1,000,000`).
+     * The underlying `value` property remains an unformatted numeric string.
      *
+     * @default false
      * @vegaVersion 2.29.0
      */
     this.thousandComma = false;
     /**
-     * Determines whether the numeric input field should restrict
-     *    input to integers only.
+     * When `true`, restricts user input to whole numbers only — decimal points
+     * and fractional digits are rejected. Useful for fields like quantity,
+     * count, or age.
      *
+     * @default false
      * @vegaVersion 2.29.0
      */
     this.integerOnly = false;
     /**
-     * Determines whether the input numeric field is disabled.
+     * Specifies whether the numeric input field is disabled. When `true`, the
+     * field is non-interactive — the user cannot type, focus, or use keyboard
+     * controls to change the value.
      *
+     * @default false
      * @vegaVersion 2.29.0
      */
     this.disabled = false;
     /**
-     * Specifies the step value for increasing or decreasing the input
-     *    when pressing the ArrowUp or ArrowDown key.
-     *    It controls the finer adjustments in the numeric input.
+     * The step value used when the user presses the `ArrowUp` or `ArrowDown`
+     * key to increment or decrement the value. This controls fine-grained
+     * adjustments to the numeric input.
+     *
+     * For larger jumps, see `majorIncrement` (activated with `Shift` + arrow
+     * keys).
      *
+     * @default 1
      * @vegaVersion 2.29.0
      */
     this.minorIncrement = 1;
     /**
-     * Specifies the step value for increasing or decreasing the input
-     *    when pressing the ArrowUp or ArrowDown key
-     *    while holding the Shift key.
-     *    It controls larger adjustments in the numeric input.
+     * The step value used when the user presses `Shift` + `ArrowUp` or
+     * `Shift` + `ArrowDown` to increment or decrement the value by a larger
+     * amount. This enables quick coarse-grained adjustments.
      *
+     * For smaller steps, see `minorIncrement`.
+     *
+     * @default 10
      * @vegaVersion 2.29.0
      */
     this.majorIncrement = 10;
     /**
-     * Provides a descriptive text or string that serves
-     *    as the label or title for the input numeric.
+     * Specifies the visible label text rendered above the numeric input.
+     * The label identifies the purpose of the field and serves as the
+     * accessible name for screen readers.
      *
+     * @default ''
      * @vegaVersion 2.29.0
      */
     this.label = '';
     /**
-     * Defines custom validation rules for the input numeric field.
+     * An array of custom validation rules applied to the numeric input in
+     * addition to the built-in rules (`RequiredFieldRule`, `MinNumberRule`,
+     * `MaxNumberRule`). Each rule must implement the `FormFieldValidationRule`
+     * interface.
+     *
+     * Rules are evaluated in order when `autoValidation` is enabled or when
+     * validation is triggered programmatically.
      *
+     * @default []
      * @vegaVersion 2.29.0
      */
     this.validationRules = [];
     /**
-     * Specifies the validation status of the input numeric field.
+     * Reflects the current validation status of the numeric input.
      *
+     * - `true` — the field value passes all validation rules.
+     * - `false` — one or more validation rules have failed.
+     * - `null` — the field has not been validated yet (initial state).
+     *
+     * This property is mutable: it is updated automatically when
+     * `autoValidation` is enabled, but can also be set manually to override
+     * the validation state.
+     *
+     * @default null
      * @vegaVersion 2.29.0
      */
     /* eslint-disable-next-line @stencil/strict-mutable */
     this.isValid = null;
     /**
-     * Determines whether the input field should undergo automatic validation
-     *    during the user's input.
+     * Determines whether the numeric input should be validated automatically as
+     * the user interacts with it. When `true`, validation rules (including
+     * `required`, `min`, `max`, and custom `validationRules`) are evaluated
+     * and the `isValid` property is updated accordingly.
+     *
+     * Set to `false` to handle validation manually.
      *
+     * @default true
      * @vegaVersion 2.29.0
      */
     this.autoValidation = true;
     /**
-     * Determines whether the clear icon should be displayed or hidden.
+     * Controls whether a clear (×) icon button is shown inside the input field
+     * when a value is present. Clicking the button resets the value to an empty
+     * string and triggers the `vegaChange` event.
      *
+     * @default true
      * @vegaVersion 2.53.0
      */
     this.showClearIcon = true;
     /**
-     * Sets the minimum allowable value for the numeric input.
+     * Sets the minimum allowable value for the numeric input. When set, the
+     * built-in `MinNumberRule` is applied during validation. Values below this
+     * threshold will cause validation to fail.
      *
+     * Set to `null` to remove the lower bound.
+     *
+     * @default null
      * @vegaVersion 2.63.0
      */
     this.min = null;
     /**
-     * Sets the maximum allowable value for the numeric input.
+     * Sets the maximum allowable value for the numeric input. When set, the
+     * built-in `MaxNumberRule` is applied during validation. Values above this
+     * threshold will cause validation to fail.
+     *
+     * Set to `null` to remove the upper bound.
      *
+     * @default null
      * @vegaVersion 2.63.0
      */
     this.max = null;

package/dist/cjs/vega-input-passcode.cjs.entry.js

@@ -6,41 +6,41 @@ const index = require('./index-58ea899e.js');
 const globalSlimmerRegistry = require('./global-slimmer-registry-b3bce7e0.js');
 const componentUsageRuntimeMetrics = require('./component-usage-runtime-metrics-4572c5b7.js');
 const component = require('./component-1e352960.js');
-const vegaEventId = require('./vega-event-id-ee01d8dd.js');
+const vegaEventId = require('./vega-event-id-c08ce3d3.js');
 const domNodeSubjectObserverFactory = require('./dom-node-subject-observer-factory-c62823de.js');
 const staticSubjectTitle = require('./static-subject-title-5829a298.js');
 const changeManager = require('./change-manager-a297e4d2.js');
-const eventEmitSlimmer = require('./event-emit-slimmer-062cdcb8.js');
-const keyboardManagerSlimmer = require('./keyboard-manager-slimmer-5b8fa209.js');
-const childNodesEventPreventSlimmer = require('./child-nodes-event-prevent-slimmer-cc6d2919.js');
-const formFieldControllerSlimmer = require('./form-field-controller-slimmer-1b3a1388.js');
+const eventEmitSlimmer = require('./event-emit-slimmer-c84121c8.js');
+const keyboardManagerSlimmer = require('./keyboard-manager-slimmer-b44f0dc9.js');
+const childNodesEventPreventSlimmer = require('./child-nodes-event-prevent-slimmer-dd0bb8b6.js');
+const formFieldControllerSlimmer = require('./form-field-controller-slimmer-73f5849e.js');
 const requiredFieldRule = require('./required-field-rule-d73c1d8c.js');
 require('./observer-f49483e8.js');
 require('./ui-234ea151.js');
 require('./dynamic-slimmer-f31fdfd7.js');
-require('./internal-vega-event-manager-f7ecf3d4.js');
+require('./internal-vega-event-manager-cc0f511c.js');
 require('./try-get-document-c0ebd39a.js');
-require('./keyboard-manager-16494c34.js');
-require('./type-guard-cd0376d4.js');
+require('./keyboard-manager-7de7ecfd.js');
+require('./type-guard-a0d9ff1f.js');
 require('./breakpoints-ebde4837.js');
-require('./ui-32e69595.js');
+require('./ui-024696c0.js');
 require('./typography-4560e7f1.js');
-require('./internal-translation-controller-1f84ab0a.js');
+require('./internal-translation-controller-24df468f.js');
 require('./vega-env-manager-23b8b23c.js');
 require('./feature-flag-controller-9129ef52.js');
 require('./index-f054eb5d.js');
 require('./string-39438062.js');
 require('./misc-3d30df91.js');
-require('./vega-internal-event-id-f2465f1b.js');
+require('./vega-internal-event-id-e0aeac45.js');
 require('./index-592b4052.js');
-require('./page-resize-observer-slimmer-7f065ee1.js');
-require('./breakpoints-751d433a.js');
+require('./page-resize-observer-slimmer-e050cd26.js');
+require('./breakpoints-a8ff22f0.js');
 require('./internal-form-field-validation-rule.abstract-07cdff46.js');
 require('./mutation-observer-slimmer-749d5020.js');
 require('./mutation-observer-filters-38cebc6d.js');
 require('./array-249289f2.js');
 require('./number-4816603d.js');
-require('./sub-state-observer-slimmer-1dfbc4c3.js');
+require('./sub-state-observer-slimmer-e692d849.js');
 
 var __decorate$3 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -629,79 +629,122 @@ const VegaInputPasscode = class {
       this.vegaInputValues = newArr;
     });
     /**
-     * Specifies the label or title for the input passcode.
-     *
-     * It provides descriptive text that helps identify the
-     *    purpose or content expected in the input passcode.
+     * Specifies the visible label text rendered above the passcode input.
+     * The label identifies the purpose of the field (e.g., "Enter verification
+     * code") and serves as the accessible name for screen readers.
      *
+     * @default ''
      * @vegaVersion 2.66.0
      */
     this.label = '';
     /**
-     * Determines whether the input passcode is disabled.
+     * Specifies whether the passcode input is disabled. When `true`, all
+     * individual input boxes become non-interactive — the user cannot type,
+     * paste, or focus any box.
      *
+     * @default false
      * @vegaVersion 2.66.0
      */
     this.disabled = false;
     /**
-     * Defines the size of the input passcode,
-     *    specifying its width or length.
+     * Controls the visual size of the passcode input boxes.
+     *
+     * - `'medium'` — Standard height, suitable for most form layouts.
+     * - `'small'` — Compact height, useful for dense UIs.
      *
+     * @default 'medium'
      * @vegaVersion 2.66.0
      */
     this.size = 'medium';
     /**
-     * Provides a supplementary prompt message that assists users in
-     *    understanding the expected value for the input passcode.
+     * Supplementary helper message displayed below the passcode input that
+     * assists users in understanding the expected input. For example,
+     * `'Enter the 4-digit code sent to your email'`.
      *
+     * @default ''
      * @vegaVersion 2.66.0
      */
     this.hint = '';
     /**
-     * Specifies the number of input boxes to display.
+     * Specifies the number of individual input boxes rendered for the passcode.
+     * Each box accepts a single character. Common values are `4` for a PIN and
+     * `6` for a two-factor authentication code.
      *
+     * @default 4
      * @vegaVersion 2.66.0
      */
     this.length = 4;
     /**
-     * Specifies the input type of the input passcode
-     *    Numeric type: only 0-9 are accepted
-     *    Text type: any non-space character is accepted
-     *    Spaces are rejected for all types
+     * Specifies the type of characters accepted by each passcode box.
+     *
+     * - `'numeric'` — Only digits `0`–`9` are accepted.
+     * - `'text'` — Any non-space character is accepted.
      *
+     * Spaces are always rejected regardless of the selected type.
+     *
+     * @default 'numeric'
      * @vegaVersion 2.66.0
      */
     this.inputType = 'numeric';
     /**
-     * Specifies the value of the input passcode.
+     * The current value of the passcode input, represented as a concatenated
+     * string of all box values (e.g., `'1234'` for a 4-digit passcode).
+     *
+     * This property is mutable and reflected to the host element attribute.
+     * It updates as the user types into the boxes and can be set externally
+     * to pre-populate or reset the field.
      *
+     * @default ''
      * @vegaVersion 2.66.0
      */
     /* eslint-disable-next-line @stencil/strict-mutable */
     this.value = '';
     /**
-     * Determines whether the input passcode field is required.
+     * Determines whether the passcode field must have a value before the form
+     * can be submitted. When `true`, the built-in `RequiredFieldRule` is
+     * applied during validation and a required indicator is shown on the label.
      *
+     * @default false
      * @vegaVersion 2.66.0
      */
     /* eslint-disable-next-line @stencil/strict-mutable */
     this.required = false;
     /**
-     * Defines custom validation rules for the input passcode.
+     * An array of custom validation rules applied to the passcode input in
+     * addition to the built-in `RequiredFieldRule`. Each rule must implement
+     * the `FormFieldValidationRule` interface.
      *
+     * Rules are evaluated in order when `autoValidation` is enabled or when
+     * validation is triggered programmatically.
+     *
+     * @default []
      * @vegaVersion 2.66.0
      */
     this.validationRules = [];
     /**
-     * Determines whether the input passcode should undergo automatic validation
-     *    during the user's input.
+     * Determines whether the passcode input should be validated automatically
+     * as the user types. When `true`, validation rules (including `required`
+     * and custom `validationRules`) are evaluated and the `isValid` property
+     * is updated accordingly.
+     *
+     * Set to `false` to handle validation manually.
      *
+     * @default true
      * @vegaVersion 2.66.0
      */
     this.autoValidation = true;
     /**
-     * Specifies the validation status of the input passcode.
+     * Reflects the current validation status of the passcode input.
+     *
+     * - `true` — the field value passes all validation rules.
+     * - `false` — one or more validation rules have failed.
+     * - `null` — the field has not been validated yet (initial state).
+     *
+     * This property is mutable: it is updated automatically when
+     * `autoValidation` is enabled, but can also be set manually to override
+     * the validation state.
      *
+     * @default null
      * @vegaVersion 2.66.0
      */
     /* eslint-disable-next-line @stencil/strict-mutable */