@firstprateek/vastu 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. package/LICENSE +15 -0
  2. package/README.md +52 -2
  3. package/custom-elements.json +3737 -0
  4. package/dist/dev/all.d.ts +12 -0
  5. package/dist/dev/all.d.ts.map +1 -0
  6. package/dist/dev/all.js +13 -0
  7. package/dist/dev/all.js.map +1 -0
  8. package/dist/dev/bar-chart/bar-chart.d.ts +63 -0
  9. package/dist/dev/bar-chart/bar-chart.d.ts.map +1 -0
  10. package/dist/dev/bar-chart/bar-chart.js +316 -0
  11. package/dist/dev/bar-chart/bar-chart.js.map +1 -0
  12. package/dist/dev/bar-chart/index.d.ts +3 -0
  13. package/dist/dev/bar-chart/index.d.ts.map +1 -0
  14. package/dist/dev/bar-chart/index.js +5 -0
  15. package/dist/dev/bar-chart/index.js.map +1 -0
  16. package/dist/dev/button/button.d.ts +98 -0
  17. package/dist/dev/button/button.d.ts.map +1 -0
  18. package/dist/dev/button/button.js +292 -0
  19. package/dist/dev/button/button.js.map +1 -0
  20. package/dist/dev/button/index.d.ts +4 -0
  21. package/dist/dev/button/index.d.ts.map +1 -0
  22. package/dist/dev/button/index.js +5 -0
  23. package/dist/dev/button/index.js.map +1 -0
  24. package/dist/dev/checkbox/checkbox.d.ts +71 -0
  25. package/dist/dev/checkbox/checkbox.d.ts.map +1 -0
  26. package/dist/dev/checkbox/checkbox.js +232 -0
  27. package/dist/dev/checkbox/checkbox.js.map +1 -0
  28. package/dist/dev/checkbox/index.d.ts +3 -0
  29. package/dist/dev/checkbox/index.d.ts.map +1 -0
  30. package/dist/dev/checkbox/index.js +5 -0
  31. package/dist/dev/checkbox/index.js.map +1 -0
  32. package/dist/dev/core/cssom.d.ts +15 -0
  33. package/dist/dev/core/cssom.d.ts.map +1 -0
  34. package/dist/dev/core/cssom.js +30 -0
  35. package/dist/dev/core/cssom.js.map +1 -0
  36. package/dist/dev/core/define.d.ts +3 -0
  37. package/dist/dev/core/define.d.ts.map +1 -0
  38. package/dist/dev/core/define.js +6 -0
  39. package/dist/dev/core/define.js.map +1 -0
  40. package/dist/dev/core/dev-mode.d.ts +6 -0
  41. package/dist/dev/core/dev-mode.d.ts.map +1 -0
  42. package/dist/dev/core/dev-mode.js +6 -0
  43. package/dist/dev/core/dev-mode.js.map +1 -0
  44. package/dist/dev/core/focus-ring.d.ts +3 -0
  45. package/dist/dev/core/focus-ring.d.ts.map +1 -0
  46. package/dist/dev/core/focus-ring.js +14 -0
  47. package/dist/dev/core/focus-ring.js.map +1 -0
  48. package/dist/dev/core/form-control.d.ts +47 -0
  49. package/dist/dev/core/form-control.d.ts.map +1 -0
  50. package/dist/dev/core/form-control.js +75 -0
  51. package/dist/dev/core/form-control.js.map +1 -0
  52. package/dist/dev/core/warn.d.ts +12 -0
  53. package/dist/dev/core/warn.d.ts.map +1 -0
  54. package/dist/dev/core/warn.js +35 -0
  55. package/dist/dev/core/warn.js.map +1 -0
  56. package/dist/dev/dialog/dialog.d.ts +77 -0
  57. package/dist/dev/dialog/dialog.d.ts.map +1 -0
  58. package/dist/dev/dialog/dialog.js +253 -0
  59. package/dist/dev/dialog/dialog.js.map +1 -0
  60. package/dist/dev/dialog/index.d.ts +4 -0
  61. package/dist/dev/dialog/index.d.ts.map +1 -0
  62. package/dist/dev/dialog/index.js +5 -0
  63. package/dist/dev/dialog/index.js.map +1 -0
  64. package/dist/dev/menu/index.d.ts +3 -0
  65. package/dist/dev/menu/index.d.ts.map +1 -0
  66. package/dist/dev/menu/index.js +5 -0
  67. package/dist/dev/menu/index.js.map +1 -0
  68. package/dist/dev/menu/menu.d.ts +71 -0
  69. package/dist/dev/menu/menu.d.ts.map +1 -0
  70. package/dist/dev/menu/menu.js +330 -0
  71. package/dist/dev/menu/menu.js.map +1 -0
  72. package/dist/dev/navbar/index.d.ts +3 -0
  73. package/dist/dev/navbar/index.d.ts.map +1 -0
  74. package/dist/dev/navbar/index.js +5 -0
  75. package/dist/dev/navbar/index.js.map +1 -0
  76. package/dist/dev/navbar/navbar.d.ts +69 -0
  77. package/dist/dev/navbar/navbar.d.ts.map +1 -0
  78. package/dist/dev/navbar/navbar.js +353 -0
  79. package/dist/dev/navbar/navbar.js.map +1 -0
  80. package/dist/dev/poll/index.d.ts +3 -0
  81. package/dist/dev/poll/index.d.ts.map +1 -0
  82. package/dist/dev/poll/index.js +5 -0
  83. package/dist/dev/poll/index.js.map +1 -0
  84. package/dist/dev/poll/poll.d.ts +67 -0
  85. package/dist/dev/poll/poll.d.ts.map +1 -0
  86. package/dist/dev/poll/poll.js +301 -0
  87. package/dist/dev/poll/poll.js.map +1 -0
  88. package/dist/dev/switch/index.d.ts +3 -0
  89. package/dist/dev/switch/index.d.ts.map +1 -0
  90. package/dist/dev/switch/index.js +5 -0
  91. package/dist/dev/switch/index.js.map +1 -0
  92. package/dist/dev/switch/switch.d.ts +69 -0
  93. package/dist/dev/switch/switch.d.ts.map +1 -0
  94. package/dist/dev/switch/switch.js +213 -0
  95. package/dist/dev/switch/switch.js.map +1 -0
  96. package/dist/dev/tabs/index.d.ts +3 -0
  97. package/dist/dev/tabs/index.d.ts.map +1 -0
  98. package/dist/dev/tabs/index.js +5 -0
  99. package/dist/dev/tabs/index.js.map +1 -0
  100. package/dist/dev/tabs/tabs.d.ts +64 -0
  101. package/dist/dev/tabs/tabs.d.ts.map +1 -0
  102. package/dist/dev/tabs/tabs.js +212 -0
  103. package/dist/dev/tabs/tabs.js.map +1 -0
  104. package/dist/dev/text-field/index.d.ts +3 -0
  105. package/dist/dev/text-field/index.d.ts.map +1 -0
  106. package/dist/dev/text-field/index.js +5 -0
  107. package/dist/dev/text-field/index.js.map +1 -0
  108. package/dist/dev/text-field/text-field.d.ts +91 -0
  109. package/dist/dev/text-field/text-field.d.ts.map +1 -0
  110. package/dist/dev/text-field/text-field.js +267 -0
  111. package/dist/dev/text-field/text-field.js.map +1 -0
  112. package/dist/dev/toast/index.d.ts +4 -0
  113. package/dist/dev/toast/index.d.ts.map +1 -0
  114. package/dist/dev/toast/index.js +5 -0
  115. package/dist/dev/toast/index.js.map +1 -0
  116. package/dist/dev/toast/toast.d.ts +71 -0
  117. package/dist/dev/toast/toast.d.ts.map +1 -0
  118. package/dist/dev/toast/toast.js +258 -0
  119. package/dist/dev/toast/toast.js.map +1 -0
  120. package/dist/prod/all.js +13 -0
  121. package/dist/prod/bar-chart/bar-chart.js +316 -0
  122. package/dist/prod/bar-chart/index.js +5 -0
  123. package/dist/prod/button/button.js +292 -0
  124. package/dist/prod/button/index.js +5 -0
  125. package/dist/prod/checkbox/checkbox.js +232 -0
  126. package/dist/prod/checkbox/index.js +5 -0
  127. package/dist/prod/core/cssom.js +30 -0
  128. package/dist/prod/core/define.js +6 -0
  129. package/dist/prod/core/dev-mode.js +1 -0
  130. package/dist/prod/core/focus-ring.js +14 -0
  131. package/dist/prod/core/form-control.js +75 -0
  132. package/dist/prod/core/warn.js +2 -0
  133. package/dist/prod/dialog/dialog.js +253 -0
  134. package/dist/prod/dialog/index.js +5 -0
  135. package/dist/prod/menu/index.js +5 -0
  136. package/dist/prod/menu/menu.js +330 -0
  137. package/dist/prod/navbar/index.js +5 -0
  138. package/dist/prod/navbar/navbar.js +353 -0
  139. package/dist/prod/poll/index.js +5 -0
  140. package/dist/prod/poll/poll.js +301 -0
  141. package/dist/prod/switch/index.js +5 -0
  142. package/dist/prod/switch/switch.js +213 -0
  143. package/dist/prod/tabs/index.js +5 -0
  144. package/dist/prod/tabs/tabs.js +212 -0
  145. package/dist/prod/text-field/index.js +5 -0
  146. package/dist/prod/text-field/text-field.js +267 -0
  147. package/dist/prod/toast/index.js +5 -0
  148. package/dist/prod/toast/toast.js +258 -0
  149. package/package.json +110 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"switch.js","sourceRoot":"","sources":["../../../src/switch/switch.ts"],"names":[],"mappings":"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","sourcesContent":["import { css, html, nothing, type PropertyDeclarations } from 'lit';\nimport { FormControl } from '../core/form-control.js';\nimport { focusRing } from '../core/focus-ring.js';\nimport { checkTokensLoaded, devWarn } from '../core/warn.js';\n\n/**\n * An on/off switch for a setting that takes effect immediately.\n *\n * @tag va-switch\n * @summary Turns a setting on or off, with immediate effect.\n *\n * @slot - The visible label. Clicking it flips the switch.\n * @slot help-text - Optional help text under the label. It becomes the switch's description.\n *\n * @csspart control - The switch's track (a native button with `role=\"switch\"`).\n * @csspart thumb - The round thumb.\n * @csspart label - The label text.\n * @csspart help-text - The help text.\n *\n * @cssprop {<color>} --va-switch-track-bg - Track colour when off.\n * @cssprop {<color>} --va-switch-track-bg-checked - Track colour when on.\n * @cssprop {<color>} --va-switch-thumb-bg - Thumb colour.\n *\n * @cssprop-applies --va-switch-track-bg control:unchecked background-color\n * @cssprop-applies --va-switch-track-bg-checked control:checked background-color\n * @cssprop-applies --va-switch-thumb-bg thumb background-color\n *\n * @keyboard Space | toggles | Turns the switch on or off.\n * @keyboard Enter | toggles | Turns the switch on or off.\n * @keyboard Tab | focus-next | Moves focus to the next control.\n *\n * @a11y-role switch\n * @a11y-name-from text, accessible-label\n * @replaces [role=\"switch\"]\n * @a11y-name The slotted label text. Use `accessible-label` only when there is no visible label.\n * @a11y-note The state is announced as on or off, not checked or unchecked.\n * @a11y-note Style the on state with `va-switch:state(checked)`; the `checked` attribute is the initial state only, as on a native checkbox.\n *\n * @guidance-use For a setting that applies as soon as it changes, such as \"Dark theme\" or \"Email notifications\".\n * @guidance-avoid For a choice that is only applied when a form is submitted, or for agreeing to terms.\n * @guidance-instead `va-checkbox` for choices submitted with a form.\n *\n * @fires change - When the user flips the switch. Read `event.target.checked`.\n * @fires input - When the user flips the switch, just before `change`.\n * @event-trigger change | click\n * @event-trigger input | click\n */\nexport class VaSwitch extends FormControl {\n static override shadowRootOptions: ShadowRootInit = { ...FormControl.shadowRootOptions, delegatesFocus: true };\n\n static override properties: PropertyDeclarations = {\n checked: { type: Boolean },\n value: {},\n accessibleLabel: { attribute: 'accessible-label' },\n };\n\n /** Whether the switch is on. */\n declare checked: boolean;\n /** Submitted with `name` while the switch is on. Defaults to `on`, as for a native checkbox. */\n declare value: string;\n /** Accessible name for a switch with no visible label. */\n declare accessibleLabel: string;\n\n #defaultChecked: boolean | undefined;\n\n constructor() {\n super();\n this.checked = false;\n this.value = 'on';\n this.accessibleLabel = '';\n }\n\n override connectedCallback(): void {\n super.connectedCallback();\n // The default is the initial attribute, read once: moving the element must not change it.\n this.#defaultChecked ??= this.hasAttribute('checked');\n checkTokensLoaded(this);\n }\n\n override firstUpdated(): void {\n requestAnimationFrame(() => {\n const text = this.#labelText();\n if (!text && !this.accessibleLabel) {\n devWarn('va-switch', 'This switch has no accessible name.', 'Put label text inside it (e.g. Dark theme), or add accessible-label=\"…\" when there is no room for one.');\n } else if (text && this.accessibleLabel && !this.accessibleLabel.toLowerCase().includes(text.toLowerCase())) {\n devWarn('va-switch', `accessible-label=\"${this.accessibleLabel}\" replaces the visible label \"${text}\" for screen readers (WCAG 2.5.3).`, 'Remove accessible-label: the visible text is the name.');\n }\n });\n }\n\n /** The visible label: text not in the help-text slot. */\n #labelText(): string {\n return [...this.childNodes]\n .filter((n) => !(n instanceof Element && n.slot))\n .map((n) => n.textContent ?? '')\n .join('')\n .trim();\n }\n\n override updated(): void {\n this._setState('checked', this.checked);\n this._internals.setFormValue(this.checked ? this.value : null);\n this._internals.setValidity(\n this.required && !this.checked ? { valueMissing: true } : {},\n this.required && !this.checked ? 'Turn this on to continue.' : '',\n this.shadowRoot?.querySelector('button') ?? undefined\n );\n }\n\n /** @internal */\n override formResetCallback(): void {\n this.checked = this.#defaultChecked ?? false;\n }\n\n #toggle(): void {\n if (this._isDisabled) return;\n this.checked = !this.checked;\n this._emit('input');\n this._emit('change');\n }\n\n override render() {\n return html`\n <button\n part=\"control\"\n class=\"control ${this.checked ? 'on' : ''}\"\n type=\"button\"\n role=\"switch\"\n aria-checked=${this.checked ? 'true' : 'false'}\n aria-labelledby=${this.accessibleLabel ? nothing : 'label'}\n aria-label=${this.accessibleLabel || nothing}\n aria-describedby=\"help-text\"\n ?disabled=${this._isDisabled}\n @click=${this.#toggle}\n >\n <span part=\"thumb\" class=\"thumb\"></span>\n </button>\n <span class=\"text\">\n <span part=\"label\" id=\"label\" class=\"label ${this._isDisabled ? 'disabled' : ''}\" @click=${this.#toggle}><slot></slot></span>\n <span part=\"help-text\" id=\"help-text\" class=\"help-text\"><slot name=\"help-text\"></slot></span>\n </span>\n `;\n }\n\n static override styles = [\n focusRing,\n css`\n :host {\n --_track: var(--va-switch-track-bg, var(--va-color-border-control));\n --_track-on: var(--va-switch-track-bg-checked, var(--va-color-accent-default));\n --_thumb: var(--va-switch-thumb-bg, var(--va-color-surface-default));\n display: inline-flex;\n align-items: flex-start;\n gap: var(--va-space-inline-sm);\n font-family: var(--va-font-family-ui);\n font-size: var(--va-font-size-md);\n color: var(--va-color-text-default);\n vertical-align: middle;\n }\n :host([hidden]) {\n display: none;\n }\n .control {\n flex: none;\n position: relative;\n width: 2.75rem;\n height: 1.5rem;\n margin: 0;\n padding: 0;\n border: 1px solid transparent;\n border-radius: var(--va-radius-round);\n background-color: var(--_track);\n cursor: pointer;\n transition: background-color var(--va-motion-duration-fast) ease-out;\n }\n .control.on {\n background-color: var(--_track-on);\n }\n .thumb {\n position: absolute;\n top: 2px;\n left: 2px;\n width: calc(1.5rem - 6px);\n height: calc(1.5rem - 6px);\n border-radius: 50%;\n background-color: var(--_thumb);\n box-shadow: 0 1px 2px rgb(0 0 0 / 0.25);\n transition: transform var(--va-motion-duration-fast) ease-out;\n }\n .control.on .thumb {\n transform: translateX(1.25rem);\n }\n .control:disabled,\n .label.disabled {\n opacity: 0.5;\n cursor: not-allowed;\n }\n .text {\n display: flex;\n flex-direction: column;\n padding-top: 0.1rem;\n }\n .label {\n cursor: pointer;\n user-select: none;\n }\n .help-text {\n color: var(--va-color-text-muted);\n font-size: var(--va-font-size-sm);\n }\n @media (prefers-reduced-motion: reduce) {\n .control,\n .thumb {\n transition: none;\n }\n }\n @media (forced-colors: active) {\n .control {\n border-color: ButtonText;\n }\n .control.on {\n background-color: Highlight;\n }\n .thumb {\n background-color: ButtonText;\n }\n .control.on .thumb {\n background-color: HighlightText;\n }\n }\n `,\n ];\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'va-switch': VaSwitch;\n }\n}\n"]}
@@ -0,0 +1,3 @@
1
+ import { VaTabs } from './tabs.js';
2
+ export { VaTabs };
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tabs/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,CAAC"}
@@ -0,0 +1,5 @@
1
+ import { define } from '../core/define.js';
2
+ import { VaTabs } from './tabs.js';
3
+ export { VaTabs };
4
+ define('va-tabs', VaTabs);
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tabs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC","sourcesContent":["import { define } from '../core/define.js';\nimport { VaTabs } from './tabs.js';\n\nexport { VaTabs };\n\ndefine('va-tabs', VaTabs);\n"]}
@@ -0,0 +1,64 @@
1
+ import { LitElement, type PropertyDeclarations, type PropertyValues } from 'lit';
2
+ /**
3
+ * Tabs that switch between panels of related content, following the WAI-ARIA tabs pattern.
4
+ *
5
+ * @tag va-tabs
6
+ * @summary Switches between panels of related content in the same place on the page.
7
+ *
8
+ * @slot tab - The tabs, as `<button slot="tab">` elements, in order.
9
+ * @slot panel - The panels, as elements with `slot="panel"`, in the same order as the tabs.
10
+ *
11
+ * @csspart tablist - The row of tabs.
12
+ * @csspart panels - The wrapper around the panels.
13
+ *
14
+ * @cssprop {<color>} --va-tabs-border - Colour of the line under the row of tabs.
15
+ * @cssprop {<color>} --va-tabs-indicator-border - Colour of the selected tab's underline.
16
+ * @cssprop {<color>} --va-tabs-fg - Text colour of tabs that aren't selected.
17
+ *
18
+ * @cssprop-applies --va-tabs-border tablist border-bottom-color
19
+ * @cssprop-applies --va-tabs-indicator-border light([aria-selected="true"]) border-bottom-color
20
+ * @cssprop-applies --va-tabs-fg light([aria-selected="false"]) color
21
+ *
22
+ * @keyboard-items [slot="tab"]
23
+ * @keyboard items: ArrowRight | next | Moves to the next tab, wrapping round. Selects it unless `activation="manual"`.
24
+ * @keyboard items: ArrowLeft | previous | Moves to the previous tab, wrapping round.
25
+ * @keyboard items: Home | first | Moves to the first tab.
26
+ * @keyboard items: End | last | Moves to the last tab.
27
+ * @keyboard items: Enter | activates | Selects the focused tab (needed when `activation="manual"`).
28
+ * @keyboard items: Tab | focus-next | Moves focus from the tabs into the selected panel.
29
+ *
30
+ * @a11y-role tablist
31
+ * @a11y-name-from accessible-label
32
+ * @replaces [role="tablist"]
33
+ * @a11y-name The `accessible-label` attribute, such as "Account settings" (not shown).
34
+ * @a11y-note Each tab gets `role="tab"`, `aria-selected` and `aria-controls`; each panel gets `role="tabpanel"` and `aria-labelledby`.
35
+ * @a11y-note Only the selected tab is in the Tab order (roving tabindex); arrow keys move between tabs.
36
+ *
37
+ * @guidance-use To switch between a few views of related content in one place, such as sections of a settings page.
38
+ * @guidance-avoid For navigation between pages, for steps in a sequence, or for more than about 6 tabs.
39
+ * @guidance-instead Links for navigation; a stepper for sequences; a list or menu for many options.
40
+ *
41
+ * @fires {CustomEvent<{ index: number, tab: HTMLElement }>} va-select - When the user selects a different tab. `event.detail.index` is its index; `event.detail.tab` is the tab.
42
+ * @event-trigger va-select | click-item 2
43
+ */
44
+ export declare class VaTabs extends LitElement {
45
+ #private;
46
+ static properties: PropertyDeclarations;
47
+ /** The index of the selected tab, from 0. Kept within the tabs that exist. */
48
+ selectedIndex: number;
49
+ /** `automatic` selects a tab as soon as it gets focus; `manual` waits for Enter or Space. */
50
+ activation: 'automatic' | 'manual';
51
+ /** Accessible name of the row of tabs. */
52
+ accessibleLabel: string;
53
+ constructor();
54
+ connectedCallback(): void;
55
+ updated(changed: PropertyValues): void;
56
+ render(): import("lit").TemplateResult<1>;
57
+ static styles: import("lit").CSSResult;
58
+ }
59
+ declare global {
60
+ interface HTMLElementTagNameMap {
61
+ 'va-tabs': VaTabs;
62
+ }
63
+ }
64
+ //# sourceMappingURL=tabs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../src/tabs/tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,KAAK,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAKrG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,MAAO,SAAQ,UAAU;;IACpC,OAAgB,UAAU,EAAE,oBAAoB,CAI9C;IAEF,8EAA8E;IACtE,aAAa,EAAE,MAAM,CAAC;IAC9B,6FAA6F;IACrF,UAAU,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC3C,0CAA0C;IAClC,eAAe,EAAE,MAAM,CAAC;;IAWvB,iBAAiB,IAAI,IAAI;IAazB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IA4EtC,MAAM;IAWf,OAAgB,MAAM,0BAoDpB;CACH;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB;CACF"}
@@ -0,0 +1,212 @@
1
+ import { LitElement, css, html, nothing } from 'lit';
2
+ import { checkTokensLoaded, devWarn } from '../core/warn.js';
3
+ let nextId = 0;
4
+ /**
5
+ * Tabs that switch between panels of related content, following the WAI-ARIA tabs pattern.
6
+ *
7
+ * @tag va-tabs
8
+ * @summary Switches between panels of related content in the same place on the page.
9
+ *
10
+ * @slot tab - The tabs, as `<button slot="tab">` elements, in order.
11
+ * @slot panel - The panels, as elements with `slot="panel"`, in the same order as the tabs.
12
+ *
13
+ * @csspart tablist - The row of tabs.
14
+ * @csspart panels - The wrapper around the panels.
15
+ *
16
+ * @cssprop {<color>} --va-tabs-border - Colour of the line under the row of tabs.
17
+ * @cssprop {<color>} --va-tabs-indicator-border - Colour of the selected tab's underline.
18
+ * @cssprop {<color>} --va-tabs-fg - Text colour of tabs that aren't selected.
19
+ *
20
+ * @cssprop-applies --va-tabs-border tablist border-bottom-color
21
+ * @cssprop-applies --va-tabs-indicator-border light([aria-selected="true"]) border-bottom-color
22
+ * @cssprop-applies --va-tabs-fg light([aria-selected="false"]) color
23
+ *
24
+ * @keyboard-items [slot="tab"]
25
+ * @keyboard items: ArrowRight | next | Moves to the next tab, wrapping round. Selects it unless `activation="manual"`.
26
+ * @keyboard items: ArrowLeft | previous | Moves to the previous tab, wrapping round.
27
+ * @keyboard items: Home | first | Moves to the first tab.
28
+ * @keyboard items: End | last | Moves to the last tab.
29
+ * @keyboard items: Enter | activates | Selects the focused tab (needed when `activation="manual"`).
30
+ * @keyboard items: Tab | focus-next | Moves focus from the tabs into the selected panel.
31
+ *
32
+ * @a11y-role tablist
33
+ * @a11y-name-from accessible-label
34
+ * @replaces [role="tablist"]
35
+ * @a11y-name The `accessible-label` attribute, such as "Account settings" (not shown).
36
+ * @a11y-note Each tab gets `role="tab"`, `aria-selected` and `aria-controls`; each panel gets `role="tabpanel"` and `aria-labelledby`.
37
+ * @a11y-note Only the selected tab is in the Tab order (roving tabindex); arrow keys move between tabs.
38
+ *
39
+ * @guidance-use To switch between a few views of related content in one place, such as sections of a settings page.
40
+ * @guidance-avoid For navigation between pages, for steps in a sequence, or for more than about 6 tabs.
41
+ * @guidance-instead Links for navigation; a stepper for sequences; a list or menu for many options.
42
+ *
43
+ * @fires {CustomEvent<{ index: number, tab: HTMLElement }>} va-select - When the user selects a different tab. `event.detail.index` is its index; `event.detail.tab` is the tab.
44
+ * @event-trigger va-select | click-item 2
45
+ */
46
+ export class VaTabs extends LitElement {
47
+ static { this.properties = {
48
+ selectedIndex: { type: Number, reflect: true, attribute: 'selected-index' },
49
+ activation: { reflect: true },
50
+ accessibleLabel: { attribute: 'accessible-label' },
51
+ }; }
52
+ #id = `va-tabs-${nextId++}`;
53
+ constructor() {
54
+ super();
55
+ this.selectedIndex = 0;
56
+ this.activation = 'automatic';
57
+ this.accessibleLabel = '';
58
+ }
59
+ connectedCallback() {
60
+ super.connectedCallback();
61
+ checkTokensLoaded(this);
62
+ }
63
+ get #tabs() {
64
+ return [...this.querySelectorAll(':scope > [slot="tab"]')];
65
+ }
66
+ get #panels() {
67
+ return [...this.querySelectorAll(':scope > [slot="panel"]')];
68
+ }
69
+ updated(changed) {
70
+ if (changed.has('selectedIndex') || changed.has('accessibleLabel'))
71
+ this.#sync();
72
+ }
73
+ #sync = () => {
74
+ const tabs = this.#tabs;
75
+ const panels = this.#panels;
76
+ if (tabs.length && tabs.length !== panels.length) {
77
+ devWarn('va-tabs', `It has ${tabs.length} tabs but ${panels.length} panels.`, 'Give every <button slot="tab"> a matching element with slot="panel", in the same order.');
78
+ }
79
+ if (tabs.some((t) => t.localName !== 'button')) {
80
+ devWarn('va-tabs', 'A tab is not a <button>, so it may not be keyboard accessible.', 'Use <button slot="tab">Label</button> for each tab.');
81
+ }
82
+ if (tabs.length && !this.accessibleLabel) {
83
+ devWarn('va-tabs', 'The tabs have no accessible name.', 'Add accessible-label="…" that names the group (e.g. accessible-label="Account settings").');
84
+ }
85
+ const selected = Math.min(Math.max(this.selectedIndex, 0), Math.max(tabs.length - 1, 0));
86
+ // Keep the property honest: selected-index="5" with three tabs selects, and reads, 2.
87
+ if (tabs.length && selected !== this.selectedIndex)
88
+ this.selectedIndex = selected;
89
+ tabs.forEach((tab, i) => {
90
+ tab.id ||= `${this.#id}-tab-${i}`;
91
+ tab.setAttribute('role', 'tab');
92
+ tab.setAttribute('aria-selected', String(i === selected));
93
+ tab.tabIndex = i === selected ? 0 : -1;
94
+ if (tab.localName === 'button')
95
+ tab.type = 'button';
96
+ });
97
+ panels.forEach((panel, i) => {
98
+ panel.id ||= `${this.#id}-panel-${i}`;
99
+ panel.setAttribute('role', 'tabpanel');
100
+ panel.hidden = i !== selected;
101
+ if (!panel.hasAttribute('tabindex'))
102
+ panel.tabIndex = 0;
103
+ if (tabs[i]) {
104
+ panel.setAttribute('aria-labelledby', tabs[i].id);
105
+ tabs[i].setAttribute('aria-controls', panel.id);
106
+ }
107
+ });
108
+ };
109
+ #select(index, focus) {
110
+ const tabs = this.#tabs;
111
+ if (!tabs.length)
112
+ return;
113
+ const next = (index + tabs.length) % tabs.length;
114
+ if (focus)
115
+ tabs[next].focus();
116
+ if (next !== this.selectedIndex) {
117
+ this.selectedIndex = next;
118
+ this.dispatchEvent(new CustomEvent('va-select', { detail: { index: next, tab: tabs[next] }, bubbles: true, composed: true }));
119
+ }
120
+ }
121
+ #focusTab(index) {
122
+ const tabs = this.#tabs;
123
+ const next = (index + tabs.length) % tabs.length;
124
+ if (this.activation === 'automatic') {
125
+ this.#select(next, true);
126
+ }
127
+ else {
128
+ tabs.forEach((t, i) => (t.tabIndex = i === next ? 0 : -1));
129
+ tabs[next].focus();
130
+ }
131
+ }
132
+ #onKeydown(event) {
133
+ const tabs = this.#tabs;
134
+ const current = tabs.indexOf(event.target);
135
+ if (current < 0)
136
+ return;
137
+ const moves = { ArrowRight: current + 1, ArrowLeft: current - 1, Home: 0, End: tabs.length - 1 };
138
+ if (event.key in moves) {
139
+ event.preventDefault();
140
+ this.#focusTab(moves[event.key]);
141
+ }
142
+ }
143
+ #onClick(event) {
144
+ const tab = this.#tabs.find((t) => event.composedPath().includes(t));
145
+ if (tab)
146
+ this.#select(this.#tabs.indexOf(tab), true);
147
+ }
148
+ render() {
149
+ return html `
150
+ <div part="tablist" class="tablist" role="tablist" aria-label=${this.accessibleLabel || nothing} @keydown=${this.#onKeydown} @click=${this.#onClick}>
151
+ <slot name="tab" @slotchange=${this.#sync}></slot>
152
+ </div>
153
+ <div part="panels" class="panels">
154
+ <slot name="panel" @slotchange=${this.#sync}></slot>
155
+ </div>
156
+ `;
157
+ }
158
+ static { this.styles = css `
159
+ :host {
160
+ display: block;
161
+ font-family: var(--va-font-family-ui);
162
+ color: var(--va-color-text-default);
163
+ }
164
+ :host([hidden]) {
165
+ display: none;
166
+ }
167
+ .tablist {
168
+ display: flex;
169
+ gap: var(--va-space-gap-md);
170
+ overflow-x: auto;
171
+ border-bottom: 1px solid var(--va-tabs-border, var(--va-color-border-subtle));
172
+ }
173
+ ::slotted([slot='tab']) {
174
+ flex: none;
175
+ min-height: var(--va-size-control-md);
176
+ margin: 0 0 -1px;
177
+ padding: 0 var(--va-space-inline-md);
178
+ border: none;
179
+ border-bottom: 2px solid transparent;
180
+ background: none;
181
+ color: var(--va-tabs-fg, var(--va-color-text-muted));
182
+ font: inherit;
183
+ font-size: var(--va-font-size-md);
184
+ cursor: pointer;
185
+ }
186
+ ::slotted([slot='tab']:hover) {
187
+ color: var(--va-color-text-default);
188
+ }
189
+ ::slotted([aria-selected='true']) {
190
+ border-bottom-color: var(--va-tabs-indicator-border, var(--va-color-accent-default));
191
+ color: var(--va-color-text-default);
192
+ font-weight: var(--va-font-weight-medium);
193
+ }
194
+ ::slotted([slot='tab']:focus-visible) {
195
+ outline: var(--va-size-focus-ring, 2px) solid var(--va-color-focus);
196
+ outline-offset: -2px;
197
+ }
198
+ .panels {
199
+ padding-top: var(--va-space-inline-lg);
200
+ }
201
+ ::slotted([slot='panel']:focus-visible) {
202
+ outline: var(--va-size-focus-ring, 2px) solid var(--va-color-focus);
203
+ outline-offset: 4px;
204
+ }
205
+ @media (forced-colors: active) {
206
+ ::slotted([aria-selected='true']) {
207
+ border-bottom-color: Highlight;
208
+ }
209
+ }
210
+ `; }
211
+ }
212
+ //# sourceMappingURL=tabs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../../src/tabs/tabs.ts"],"names":[],"mappings":"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","sourcesContent":["import { LitElement, css, html, nothing, type PropertyDeclarations, type PropertyValues } from 'lit';\nimport { checkTokensLoaded, devWarn } from '../core/warn.js';\n\nlet nextId = 0;\n\n/**\n * Tabs that switch between panels of related content, following the WAI-ARIA tabs pattern.\n *\n * @tag va-tabs\n * @summary Switches between panels of related content in the same place on the page.\n *\n * @slot tab - The tabs, as `<button slot=\"tab\">` elements, in order.\n * @slot panel - The panels, as elements with `slot=\"panel\"`, in the same order as the tabs.\n *\n * @csspart tablist - The row of tabs.\n * @csspart panels - The wrapper around the panels.\n *\n * @cssprop {<color>} --va-tabs-border - Colour of the line under the row of tabs.\n * @cssprop {<color>} --va-tabs-indicator-border - Colour of the selected tab's underline.\n * @cssprop {<color>} --va-tabs-fg - Text colour of tabs that aren't selected.\n *\n * @cssprop-applies --va-tabs-border tablist border-bottom-color\n * @cssprop-applies --va-tabs-indicator-border light([aria-selected=\"true\"]) border-bottom-color\n * @cssprop-applies --va-tabs-fg light([aria-selected=\"false\"]) color\n *\n * @keyboard-items [slot=\"tab\"]\n * @keyboard items: ArrowRight | next | Moves to the next tab, wrapping round. Selects it unless `activation=\"manual\"`.\n * @keyboard items: ArrowLeft | previous | Moves to the previous tab, wrapping round.\n * @keyboard items: Home | first | Moves to the first tab.\n * @keyboard items: End | last | Moves to the last tab.\n * @keyboard items: Enter | activates | Selects the focused tab (needed when `activation=\"manual\"`).\n * @keyboard items: Tab | focus-next | Moves focus from the tabs into the selected panel.\n *\n * @a11y-role tablist\n * @a11y-name-from accessible-label\n * @replaces [role=\"tablist\"]\n * @a11y-name The `accessible-label` attribute, such as \"Account settings\" (not shown).\n * @a11y-note Each tab gets `role=\"tab\"`, `aria-selected` and `aria-controls`; each panel gets `role=\"tabpanel\"` and `aria-labelledby`.\n * @a11y-note Only the selected tab is in the Tab order (roving tabindex); arrow keys move between tabs.\n *\n * @guidance-use To switch between a few views of related content in one place, such as sections of a settings page.\n * @guidance-avoid For navigation between pages, for steps in a sequence, or for more than about 6 tabs.\n * @guidance-instead Links for navigation; a stepper for sequences; a list or menu for many options.\n *\n * @fires {CustomEvent<{ index: number, tab: HTMLElement }>} va-select - When the user selects a different tab. `event.detail.index` is its index; `event.detail.tab` is the tab.\n * @event-trigger va-select | click-item 2\n */\nexport class VaTabs extends LitElement {\n static override properties: PropertyDeclarations = {\n selectedIndex: { type: Number, reflect: true, attribute: 'selected-index' },\n activation: { reflect: true },\n accessibleLabel: { attribute: 'accessible-label' },\n };\n\n /** The index of the selected tab, from 0. Kept within the tabs that exist. */\n declare selectedIndex: number;\n /** `automatic` selects a tab as soon as it gets focus; `manual` waits for Enter or Space. */\n declare activation: 'automatic' | 'manual';\n /** Accessible name of the row of tabs. */\n declare accessibleLabel: string;\n\n #id = `va-tabs-${nextId++}`;\n\n constructor() {\n super();\n this.selectedIndex = 0;\n this.activation = 'automatic';\n this.accessibleLabel = '';\n }\n\n override connectedCallback(): void {\n super.connectedCallback();\n checkTokensLoaded(this);\n }\n\n get #tabs(): HTMLElement[] {\n return [...this.querySelectorAll<HTMLElement>(':scope > [slot=\"tab\"]')];\n }\n\n get #panels(): HTMLElement[] {\n return [...this.querySelectorAll<HTMLElement>(':scope > [slot=\"panel\"]')];\n }\n\n override updated(changed: PropertyValues): void {\n if (changed.has('selectedIndex') || changed.has('accessibleLabel')) this.#sync();\n }\n\n #sync = (): void => {\n const tabs = this.#tabs;\n const panels = this.#panels;\n if (tabs.length && tabs.length !== panels.length) {\n devWarn('va-tabs', `It has ${tabs.length} tabs but ${panels.length} panels.`, 'Give every <button slot=\"tab\"> a matching element with slot=\"panel\", in the same order.');\n }\n if (tabs.some((t) => t.localName !== 'button')) {\n devWarn('va-tabs', 'A tab is not a <button>, so it may not be keyboard accessible.', 'Use <button slot=\"tab\">Label</button> for each tab.');\n }\n if (tabs.length && !this.accessibleLabel) {\n devWarn('va-tabs', 'The tabs have no accessible name.', 'Add accessible-label=\"…\" that names the group (e.g. accessible-label=\"Account settings\").');\n }\n const selected = Math.min(Math.max(this.selectedIndex, 0), Math.max(tabs.length - 1, 0));\n // Keep the property honest: selected-index=\"5\" with three tabs selects, and reads, 2.\n if (tabs.length && selected !== this.selectedIndex) this.selectedIndex = selected;\n tabs.forEach((tab, i) => {\n tab.id ||= `${this.#id}-tab-${i}`;\n tab.setAttribute('role', 'tab');\n tab.setAttribute('aria-selected', String(i === selected));\n tab.tabIndex = i === selected ? 0 : -1;\n if (tab.localName === 'button') (tab as HTMLButtonElement).type = 'button';\n });\n panels.forEach((panel, i) => {\n panel.id ||= `${this.#id}-panel-${i}`;\n panel.setAttribute('role', 'tabpanel');\n panel.hidden = i !== selected;\n if (!panel.hasAttribute('tabindex')) panel.tabIndex = 0;\n if (tabs[i]) {\n panel.setAttribute('aria-labelledby', tabs[i].id);\n tabs[i].setAttribute('aria-controls', panel.id);\n }\n });\n };\n\n #select(index: number, focus: boolean): void {\n const tabs = this.#tabs;\n if (!tabs.length) return;\n const next = (index + tabs.length) % tabs.length;\n if (focus) tabs[next].focus();\n if (next !== this.selectedIndex) {\n this.selectedIndex = next;\n this.dispatchEvent(new CustomEvent('va-select', { detail: { index: next, tab: tabs[next] }, bubbles: true, composed: true }));\n }\n }\n\n #focusTab(index: number): void {\n const tabs = this.#tabs;\n const next = (index + tabs.length) % tabs.length;\n if (this.activation === 'automatic') {\n this.#select(next, true);\n } else {\n tabs.forEach((t, i) => (t.tabIndex = i === next ? 0 : -1));\n tabs[next].focus();\n }\n }\n\n #onKeydown(event: KeyboardEvent): void {\n const tabs = this.#tabs;\n const current = tabs.indexOf(event.target as HTMLElement);\n if (current < 0) return;\n const moves: Record<string, number> = { ArrowRight: current + 1, ArrowLeft: current - 1, Home: 0, End: tabs.length - 1 };\n if (event.key in moves) {\n event.preventDefault();\n this.#focusTab(moves[event.key]);\n }\n }\n\n #onClick(event: MouseEvent): void {\n const tab = this.#tabs.find((t) => event.composedPath().includes(t));\n if (tab) this.#select(this.#tabs.indexOf(tab), true);\n }\n\n override render() {\n return html`\n <div part=\"tablist\" class=\"tablist\" role=\"tablist\" aria-label=${this.accessibleLabel || nothing} @keydown=${this.#onKeydown} @click=${this.#onClick}>\n <slot name=\"tab\" @slotchange=${this.#sync}></slot>\n </div>\n <div part=\"panels\" class=\"panels\">\n <slot name=\"panel\" @slotchange=${this.#sync}></slot>\n </div>\n `;\n }\n\n static override styles = css`\n :host {\n display: block;\n font-family: var(--va-font-family-ui);\n color: var(--va-color-text-default);\n }\n :host([hidden]) {\n display: none;\n }\n .tablist {\n display: flex;\n gap: var(--va-space-gap-md);\n overflow-x: auto;\n border-bottom: 1px solid var(--va-tabs-border, var(--va-color-border-subtle));\n }\n ::slotted([slot='tab']) {\n flex: none;\n min-height: var(--va-size-control-md);\n margin: 0 0 -1px;\n padding: 0 var(--va-space-inline-md);\n border: none;\n border-bottom: 2px solid transparent;\n background: none;\n color: var(--va-tabs-fg, var(--va-color-text-muted));\n font: inherit;\n font-size: var(--va-font-size-md);\n cursor: pointer;\n }\n ::slotted([slot='tab']:hover) {\n color: var(--va-color-text-default);\n }\n ::slotted([aria-selected='true']) {\n border-bottom-color: var(--va-tabs-indicator-border, var(--va-color-accent-default));\n color: var(--va-color-text-default);\n font-weight: var(--va-font-weight-medium);\n }\n ::slotted([slot='tab']:focus-visible) {\n outline: var(--va-size-focus-ring, 2px) solid var(--va-color-focus);\n outline-offset: -2px;\n }\n .panels {\n padding-top: var(--va-space-inline-lg);\n }\n ::slotted([slot='panel']:focus-visible) {\n outline: var(--va-size-focus-ring, 2px) solid var(--va-color-focus);\n outline-offset: 4px;\n }\n @media (forced-colors: active) {\n ::slotted([aria-selected='true']) {\n border-bottom-color: Highlight;\n }\n }\n `;\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'va-tabs': VaTabs;\n }\n}\n"]}
@@ -0,0 +1,3 @@
1
+ import { VaTextField } from './text-field.js';
2
+ export { VaTextField };
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/text-field/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,CAAC"}
@@ -0,0 +1,5 @@
1
+ import { define } from '../core/define.js';
2
+ import { VaTextField } from './text-field.js';
3
+ export { VaTextField };
4
+ define('va-text-field', VaTextField);
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/text-field/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC","sourcesContent":["import { define } from '../core/define.js';\nimport { VaTextField } from './text-field.js';\n\nexport { VaTextField };\n\ndefine('va-text-field', VaTextField);\n"]}
@@ -0,0 +1,91 @@
1
+ import { type PropertyDeclarations, type PropertyValues } from 'lit';
2
+ import { FormControl } from '../core/form-control.js';
3
+ /**
4
+ * A single-line text input with a visible label, help text and error message.
5
+ *
6
+ * @tag va-text-field
7
+ * @summary Collects a short piece of text, such as a name, an email address or a search term.
8
+ *
9
+ * @slot start - An icon or prefix inside the field, before the text.
10
+ * @slot end - An icon or suffix inside the field, after the text.
11
+ *
12
+ * @csspart label - The visible label.
13
+ * @csspart field - The box around the input and its icons.
14
+ * @csspart input - The native input.
15
+ * @csspart help-text - The help text.
16
+ * @csspart error - The error message.
17
+ *
18
+ * @cssprop {<color>} --va-text-field-bg - Background colour of the field.
19
+ * @cssprop {<color>} --va-text-field-border - Border colour of the field.
20
+ * @cssprop {<color>} --va-text-field-border-invalid - Border colour while the field shows an error.
21
+ * @cssprop {<length>} --va-text-field-radius - Corner radius of the field.
22
+ * @cssprop {<length>} --va-text-field-height - Minimum height of the field.
23
+ *
24
+ * @cssprop-applies --va-text-field-bg field background-color
25
+ * @cssprop-applies --va-text-field-border field border-top-color
26
+ * @cssprop-applies --va-text-field-border-invalid field:invalid border-top-color
27
+ * @cssprop-applies --va-text-field-radius field border-top-left-radius
28
+ * @cssprop-applies --va-text-field-height field min-height
29
+ *
30
+ * @keyboard Tab | focus-next | Moves focus to the next control.
31
+ *
32
+ * @a11y-role textbox
33
+ * @a11y-name-from label
34
+ * @replaces input:not([type]), input[type="text"], input[type="email"], input[type="password"], input[type="search"], input[type="tel"], input[type="url"]
35
+ * @a11y-name The `label` attribute, shown above the field. Every text field needs one.
36
+ * @a11y-note Help text and the error message are linked with `aria-describedby`; the error also sets `aria-invalid`.
37
+ * @a11y-note Errors appear after the user leaves the field or submits the form, not while they type.
38
+ *
39
+ * @guidance-use For short, free-form text: names, email addresses, search terms, codes.
40
+ * @guidance-avoid For long text, or for picking from a fixed set of options.
41
+ * @guidance-instead A textarea for long text; a select or radio group for fixed options.
42
+ *
43
+ * @fires input - The native input event, on every keystroke. Read `event.target.value`.
44
+ * @fires change - When the user commits a change, by leaving the field or pressing Enter.
45
+ * @event-trigger input | press a
46
+ * @event-trigger change | commit
47
+ */
48
+ export declare class VaTextField extends FormControl {
49
+ #private;
50
+ static shadowRootOptions: ShadowRootInit;
51
+ static properties: PropertyDeclarations;
52
+ /** The visible label above the field. Required: it is also the field's accessible name. */
53
+ label: string;
54
+ /** The kind of text. Sets the keyboard on phones and the built-in validation. */
55
+ type: 'text' | 'email' | 'password' | 'search' | 'tel' | 'url';
56
+ /** The current text. */
57
+ value: string;
58
+ /** Example text shown while the field is empty. Never a substitute for `label`. */
59
+ placeholder: string;
60
+ /** Help text under the field, such as the expected format. */
61
+ helpText: string;
62
+ /** A custom error message. While set, the field is invalid and shows it. */
63
+ error: string;
64
+ /** The text can be selected and submitted, but not changed. */
65
+ readOnly: boolean;
66
+ /** The minimum number of characters. */
67
+ minLength: number;
68
+ /** The maximum number of characters. */
69
+ maxLength: number;
70
+ /** A regular expression the whole value must match. */
71
+ pattern: string;
72
+ /** A hint for the browser's autofill, such as `email` or `name`. */
73
+ autocomplete: string;
74
+ private _showError;
75
+ constructor();
76
+ connectedCallback(): void;
77
+ firstUpdated(): void;
78
+ updated(changed: PropertyValues): void;
79
+ /** @internal */
80
+ formResetCallback(): void;
81
+ /** Selects all the text in the field. */
82
+ select(): void;
83
+ render(): import("lit").TemplateResult<1>;
84
+ static styles: import("lit").CSSResult;
85
+ }
86
+ declare global {
87
+ interface HTMLElementTagNameMap {
88
+ 'va-text-field': VaTextField;
89
+ }
90
+ }
91
+ //# sourceMappingURL=text-field.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text-field.d.ts","sourceRoot":"","sources":["../../../src/text-field/text-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAYtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,WAAY,SAAQ,WAAW;;IAC1C,OAAgB,iBAAiB,EAAE,cAAc,CAA8D;IAE/G,OAAgB,UAAU,EAAE,oBAAoB,CAa9C;IAEF,2FAA2F;IACnF,KAAK,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACzE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;IACvE,wBAAwB;IAChB,KAAK,EAAE,MAAM,CAAC;IACtB,mFAAmF;IAC3E,WAAW,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IACtD,QAAQ,EAAE,MAAM,CAAC;IACzB,4EAA4E;IACpE,KAAK,EAAE,MAAM,CAAC;IACtB,+DAA+D;IACvD,QAAQ,EAAE,OAAO,CAAC;IAC1B,wCAAwC;IAChC,SAAS,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IAChC,SAAS,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IAC/C,OAAO,EAAE,MAAM,CAAC;IACxB,oEAAoE;IAC5D,YAAY,EAAE,MAAM,CAAC;IAE7B,QAAgB,UAAU,CAAU;;IAmB3B,iBAAiB,IAAI,IAAI;IAMzB,YAAY,IAAI,IAAI;IAUpB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAS/C,gBAAgB;IACP,iBAAiB,IAAI,IAAI;IAKlC,yCAAyC;IACzC,MAAM,IAAI,IAAI;IAuBL,MAAM;IAmCf,OAAgB,MAAM,0BA4FpB;CACH;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,eAAe,EAAE,WAAW,CAAC;KAC9B;CACF"}