vectis-ui 0.1.0 → 0.8.0

package/dist/components/VTimeInput/VTimeInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"VTimeInput.js","names":[],"sources":["../../../src/components/VTimeInput/VTimeInput.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { computed, ref, useId, watchEffect } from 'vue'\n\nimport VButton from '../VButton/VButton.vue'\nimport { expand_more as expandMoreIcon } from '../VIcon/icons/expand_more'\nimport { schedule as scheduleIcon } from '../VIcon/icons/schedule'\nimport type { IconSource } from '../VIcon/types'\nimport VInput from '../VInput/VInput.vue'\nimport VPopover from '../VPopover/VPopover.vue'\nimport VToggle from '../VToggle/VToggle.vue'\nimport type { ToggleModelValue } from '../VToggle/VToggle.vue'\nimport VToggleItem from '../VToggle/VToggleItem.vue'\nimport VTimePicker from '../VTimePicker/VTimePicker.vue'\nimport type { TimePickerFormat } from '../VTimePicker/VTimePicker.vue'\nimport {\n  formatDisplay,\n  formatTime,\n  formatTimeMask,\n  hourCycleFor,\n  isValidTime,\n  minutesOf,\n  parseTime,\n  parseTimeMask,\n  snapMinute,\n  timeCaret,\n  timeList,\n  timeToMask,\n  to12h,\n  to24h,\n} from '../../utils/time'\nimport type { Meridiem, TimeOption } from '../../utils/time'\nimport { arrowNavigate } from '../../utils/arrowNav'\nimport { clamp } from '../../utils/number'\nimport { isDev } from '../../utils/env'\nimport { digitsOf } from '../../utils/text'\n\nimport { useRootAttrs } from '../../composables/useRootAttrs'\n\nimport { useFieldPanel } from '../../composables/useFieldPanel'\nimport { useMaskedField } from '../../composables/useMaskedField'\nimport { useLocale, useMessages } from '../../i18n/state'\n\n// @a11y @core\n/**\n * A field for choosing a time, with an optional panel below it. The shell is the same one\n * VDateInput uses: the panel is opened from code, which is what lets the focus be moved\n * into it, and closed when the focus leaves the component or Escape is pressed.\n *\n * The field comes in three forms. It can be TYPED into, hours and minutes behind a mask,\n * optionally with a picker beside it. It can be read-only, the picker then being the only way\n * in. Or it can offer a LIST of times at a fixed interval, which suits booking a slot far\n * better than pointing at a clock face.\n *\n * The two panels commit differently, and deliberately so. The PICKER works on a draft that\n * only OK writes to the value — Cancel, Escape and the focus leaving all discard it —\n * because dragging a hand across a clock passes over dozens of times nobody meant. The\n * LIST writes immediately: choosing a row there is one deliberate gesture.\n *\n * Whatever is displayed, the value itself is always a 24-hour time.\n */\nexport type TimeInputMode = 'readonly' | 'input' | 'list'\n\nconst MODES: TimeInputMode[] = ['readonly', 'input', 'list']\n\ntype Placement = 'bottom' | 'bottom-start' | 'bottom-end' | 'top' | 'top-start' | 'top-end'\n\ninterface TimeInputProps {\n  /**\n   * Whether times are shown on a 12- or a 24-hour clock. Left out, the reader's language\n   * decides, which is almost always what one wants.\n   */\n  format?: TimePickerFormat\n  /**\n   * Which form the field takes: one that can be TYPED into, a read-only one where the\n   * picker is the only way in — so the picker is forced on there — or a LIST of times at a\n   * fixed interval, where a picker would make no sense.\n   */\n  mode?: TimeInputMode\n  /**\n   * Offers the picker beside a field one can type into: an icon at the end of the field,\n   * and a panel it opens.\n   *\n   * It is left undefined by default rather than set to off, which is what distinguishes\n   * \"not given\" from an explicit refusal — and therefore what allows warning only the\n   * consumer who really asked to remove the picker from a read-only field, where it is the\n   * only way in.\n   */\n  showPicker?: boolean\n  /**\n   * The interval between two times that can be chosen. It applies to the picker, to the\n   * arrow keys and to the rows of the list.\n   */\n  minuteStep?: number\n  /**\n   * A BCP 47 locale, which decides the clock and how a time is written out. It TAKES\n   * PRECEDENCE over the design system's global locale and falls back to it — which is why\n   * it has no literal default: `undefined` has to stay recognizable for the global locale\n   * to have its chance.\n   */\n  locale?: string\n  // From here on: the field.\n  /** The label above the field. */\n  label?: string\n  /** A line of help under the field. */\n  hint?: string\n  /** What the field says while empty. */\n  placeholder?: string\n  /** The height of the field: 32, 40 or 48 pixels. */\n  size?: 'sm' | 'md' | 'lg'\n  /** Takes 4px off the height. */\n  compact?: boolean\n  /** Makes the field unusable, greyed out through the colour tokens. */\n  disabled?: boolean\n  /** Marks the field as invalid — for a rule of your own. */\n  invalid?: boolean\n  /** Offers a cross that empties the value, shown before the end icon. */\n  clearable?: boolean\n  /**\n   * The icon that opens the PICKER, at the end of the field. It has no effect on the list\n   * form, whose chevron follows the combobox convention. The clear cross appears to its\n   * left rather than in its place.\n   */\n  pickerIcon?: IconSource\n  /** Where the panel opens relative to the field. */\n  placement?: Placement\n}\n\nconst props = withDefaults(defineProps<TimeInputProps>(), {\n  format: undefined,\n  // Deliberately left undefined rather than defaulted to the typed mode: that is what\n  // distinguishes \"the prop was not given\" from \"the prop was given this value\", and\n  // therefore what allows warning ONLY the consumer who explicitly asked for something\n  // that cannot work.\n  mode: undefined,\n  showPicker: undefined,\n  minuteStep: 1,\n  locale: undefined,\n  label: undefined,\n  hint: undefined,\n  placeholder: undefined,\n  size: 'md',\n  compact: false,\n  disabled: false,\n  invalid: false,\n  clearable: true,\n  pickerIcon: () => scheduleIcon,\n  placement: 'bottom-start',\n})\n\n/**\n * The time, always as a 24-hour \"HH:mm\" string whatever clock is displayed. A consumer\n * therefore never has to know which clock the reader's language uses.\n */\nconst model = defineModel<string | null>({ default: null })\n\n// `class` and `style` stay on the wrapper; everything else goes down to the text field,\n// which is what a consumer's label points at and what assistive technology deals with.\ndefineOptions({ inheritAttrs: false })\nconst { rootClass, rootStyle, forwardedAttrs } = useRootAttrs()\n\nconst rootEl = ref<HTMLElement | null>(null)\nconst panelRef = ref<InstanceType<typeof VPopover> | null>(null)\nconst inputRef = ref<InstanceType<typeof VInput> | null>(null)\nconst pickerRef = ref<InstanceType<typeof VTimePicker> | null>(null)\nconst panelId = useId()\n\n/** The real input inside the field, which the mask and the caret work on. */\nconst fieldEl = computed<HTMLInputElement | null>(() => inputRef.value?.el ?? null)\n\nconst resolvedMode = computed<TimeInputMode>(() => {\n  // TRAP — the default is applied BEFORE the value is checked. A prop that was never\n  // given is not an unknown value, and treating it as one would warn on a bare\n  // `<VTimeInput />`.\n  const mode = props.mode ?? 'input'\n  return MODES.includes(mode) ? mode : 'input'\n})\nconst typing = computed(() => resolvedMode.value === 'input')\nconst isList = computed(() => resolvedMode.value === 'list')\n/**\n * Whether there is a picker. It is forced on a read-only field, where nothing else could\n * fill it; offered beside a field one types into; and meaningless in the list form, which\n * has a panel of its own.\n */\nconst hasPicker = computed(\n  () => resolvedMode.value === 'readonly' || (typing.value && props.showPicker === true),\n)\nconst hasPanel = computed(() => hasPicker.value || isList.value)\n\nconst vectisLocale = useLocale()\n/* The prop wins, and the design system's global locale is what it falls back to. */\nconst resolvedLocale = computed(() => props.locale ?? vectisLocale.value)\n\nconst resolvedFormat = computed<TimePickerFormat>(\n  () => props.format ?? hourCycleFor(resolvedLocale.value),\n)\n\n// @devwarn\nif (isDev) {\n  watchEffect(() => {\n    if (props.minuteStep < 1 || 60 % props.minuteStep !== 0)\n      console.warn(`[VTimeInput] minuteStep ${props.minuteStep} — a divisor of 60 is expected.`)\n    if (props.mode !== undefined && !MODES.includes(props.mode))\n      console.warn(\n        `[VTimeInput] unknown mode \"${props.mode}\": use \"input\" (the default), \"readonly\" or \"list\".`,\n      )\n    if (resolvedMode.value === 'readonly' && props.showPicker === false)\n      console.warn(\n        '[VTimeInput] showPicker is forced to true in \"readonly\" mode: with no picker, a read-only field would be impossible to fill.',\n      )\n    if (isList.value && props.showPicker === true)\n      console.warn(\n        '[VTimeInput] showPicker is ignored in \"list\" mode: the list of times is the only panel.',\n      )\n    if (isList.value && props.minuteStep < 5)\n      console.warn(\n        `[VTimeInput] minuteStep ${props.minuteStep} in \"list\" mode would render ${Math.ceil(1440 / props.minuteStep)} rows: a step of 15 or 30 minutes is expected.`,\n      )\n  })\n}\n\n/**\n * The time being built on the clock, in the same canonical form as the value itself.\n * Nothing here reaches the value until OK is pressed — which is the whole reason the\n * picker is bound to THIS rather than to the model.\n */\nconst draft = ref<string | null>(null)\n\nconst modelParts = computed(() => parseTime(model.value))\n\n/**\n * Which half of the day is chosen while NO time is set at all. The AM/PM control always\n * needs a value — it refuses to have none — and \"nothing\" is not one.\n *\n * It starts at AM rather than at whatever the current time happens to be, which keeps the\n * component's first render identical on a server and in a browser, and its tests free of\n * a clock.\n */\nconst pendingMeridiem = ref<Meridiem>('AM')\n\n/**\n * The AM/PM control beside the FIELD. It is what the mask needs — the half of the day has\n * to be known while the panel is shut, and in the list form there is no picker at all — so\n * it is rendered in every form but the read-only one, where the picker carries its own.\n */\nconst meridiemModel = computed<ToggleModelValue>({\n  get: () => {\n    // With the picker open it is the DRAFT that is on screen, and this control has to read\n    // the same thing: two controls showing opposite halves of the day until OK is pressed\n    // is the one state that must not happen.\n    const parts = open.value && hasPicker.value ? parseTime(draft.value) : modelParts.value\n    return parts ? to12h(parts.hour).meridiem : pendingMeridiem.value\n  },\n  set: (value) => {\n    const meridiem: Meridiem = value === 'PM' ? 'PM' : 'AM'\n    pendingMeridiem.value = meridiem\n    const parts = modelParts.value\n    // With no time set there is nothing to convert, so the choice is simply REMEMBERED\n    // and applies to the first time typed or chosen.\n    if (parts) model.value = formatTime(to24h(to12h(parts.hour).hour, meridiem), parts.minute)\n    // With the picker open the draft has to follow as well, or OK would write back the\n    // half of the day the reader has just changed.\n    const pending = open.value && hasPicker.value ? parseTime(draft.value) : null\n    if (pending) draft.value = formatTime(to24h(to12h(pending.hour).hour, meridiem), pending.minute)\n  },\n})\n\nconst hasValue = computed(() => !!modelParts.value)\nconst displayText = computed(() =>\n  model.value ? formatDisplay(model.value, resolvedLocale.value, resolvedFormat.value) : '',\n)\n\n// @a11y\n// Where the focus goes when the panel opens.\nfunction focusInPanel() {\n  if (!isList.value) {\n    // The picker publishes where its own focus goes, so nothing here has to know that the\n    // target is a slider — the same arrangement VDateInput has with VDatePicker.\n    pickerRef.value?.focus()\n    return\n  }\n  const panel = panelRef.value?.el\n  if (panel) focusListSelection(panel)\n}\n\n// The whole \"field plus panel\" shell, shared with VDateInput. What is specific to this\n// component is only what happens around it: preparing the draft as the panel opens, and\n// clearing the announcement as it closes.\nconst { open, openPanel, closePanel, onControlClick, onFocusout, onKeydown, onPanelMousedown } =\n  useFieldPanel({\n    rootEl,\n    panelRef,\n    fieldEl: inputRef,\n    // With no panel there is nothing to open. This is the composable's SINGLE cut-off\n    // point, and every way in passes through it — clicking the field, focusing it, the\n    // down arrow, Enter, the icon.\n    disabled: () => props.disabled || !hasPanel.value,\n    focusInPanel,\n    // Beside a field one types into, the panel opens WITHOUT taking the focus, so typing\n    // carries on.\n    focusOnOpen: () => !typing.value,\n    onOpen: () => {\n      // Only the picker works on a draft; the list writes its choice straight away.\n      if (!hasPicker.value) return\n      const parts = modelParts.value\n      if (parts) draft.value = formatTime(parts.hour, parts.minute)\n      else {\n        // Opening on the current time when none is set. Reading the clock is safe here:\n        // this runs from a handler, hence in a browser, never during a render — and it is\n        // why the picker itself never reads it, so that it stays identical on both sides\n        // of hydration. The instant is taken ONCE: two reads could straddle a minute.\n        const now = new Date()\n        draft.value = formatTime(now.getHours(), snapMinute(now.getMinutes(), props.minuteStep))\n      }\n      pickerRef.value?.reset()\n    },\n    onClose: () => {\n      pickerRef.value?.reset()\n    },\n  })\n\n// @a11y\n/**\n * TRAP — closing the panel hands the focus back to the field, and beside a field one\n * types into the panel opens ON FOCUS: the two would chase each other and the panel would\n * never close.\n *\n * This lock covers the focus call, which is synchronous. EVERY close that returns the\n * focus must go through here; closing directly brings the loop straight back.\n */\nlet refocusing = false\nfunction closeAndFocus() {\n  refocusing = true\n  closePanel(true)\n  refocusing = false\n}\n\n/** OK: the ONE route by which the picker's draft becomes the value. */\nfunction confirm() {\n  if (draft.value) model.value = draft.value\n  closeAndFocus()\n}\n\nfunction cancel() {\n  closeAndFocus()\n}\n\n// @a11y\n/*\n * Emptying the value, called by the field as it emits its clear event.\n *\n * TRAP — the focus is taken here, under the lock, on purpose: the field focuses itself\n * immediately afterwards, and focusing an element that ALREADY has the focus emits no\n * event at all. That is what stops the panel reopening. Taking the lock away from this\n * function brings the reopening straight back.\n */\nfunction clearValue() {\n  model.value = null\n  // The typed text is emptied EXPLICITLY: when the value was already empty, nothing\n  // changes, and the guard that keeps the field and the value from chasing each other\n  // would leave the text where it was.\n  if (typing.value) writeField('')\n  refocusing = true\n  inputRef.value?.focus()\n  refocusing = false\n}\n\n// Escape and the focus leaving both close WITHOUT committing, which is the picker's Cancel\n// behaviour: closing never writes the value, and only OK does.\n\nconst m = useMessages()\n\n/* From here on: everything the typed field needs. */\n\nconst currentMeridiem = (): Meridiem => (meridiemModel.value === 'PM' ? 'PM' : 'AM')\n\n/*\n * The mask machinery — the text being typed, the bridge to the value, the reformatting\n * that preserves the caret, the commit and the silent revert — is shared with VDateInput\n * and lives in `useMaskedField`.\n *\n * The time vocabulary is the simpler of the two: four digits, and a separator that is the\n * SAME in every language. That is why the caret can be computed outright here, where a\n * date has to look for a separator it cannot predict; and why nothing distinguishes a\n * final commit from a live one, there being no equivalent of expanding a two-digit year.\n */\nconst {\n  draft: maskDraft,\n  fieldModel,\n  writeField,\n  commitLive,\n  commitOrRevert,\n  onFieldInput,\n} = useMaskedField({\n  fieldEl,\n  typing: () => typing.value,\n  displayText: () => displayText.value,\n  readValue: () => model.value,\n  writeValue: (time) => {\n    model.value = time\n  },\n  maxDigits: () => 4,\n  format: formatTimeMask,\n  caret: (_text, digitsBefore, inserting) => timeCaret(digitsBefore, inserting),\n  parse: (text) => parseTimeMask(text, resolvedFormat.value, currentMeridiem()),\n  toMask: (time) => timeToMask(time, resolvedFormat.value),\n})\n\n// @keyboard @core — the keys the mask itself needs, plus the down arrow, which is the one\n// explicit way from the field into the picker.\nfunction onFieldKeydown(event: KeyboardEvent) {\n  if (!typing.value) return\n  const el = fieldEl.value\n  if (!el) return\n\n  if (event.key === 'Enter') {\n    // Cancelling the default does two things at once: it stops the surrounding form from\n    // being submitted, and it stops the panel this keystroke has just closed from being\n    // reopened as the event travels up to the root.\n    event.preventDefault()\n    commitOrRevert()\n    if (open.value) closeAndFocus()\n    return\n  }\n  if (event.key === 'ArrowDown' && open.value && hasPicker.value) {\n    // The one explicit route from the field into the picker.\n    event.preventDefault()\n    focusInPanel()\n    return\n  }\n  if (event.key === 'Backspace') {\n    const start = el.selectionStart\n    if (\n      start !== null &&\n      start === el.selectionEnd &&\n      start > 0 &&\n      !/\\d/.test(el.value[start - 1] ?? '')\n    ) {\n      // TRAP — the separator is PLACED by the mask and never typed, so erasing one has to\n      // erase the DIGIT before it. Left alone, the mask would write it straight back and\n      // the key would look dead.\n      event.preventDefault()\n      const n = digitsOf(el.value.slice(0, start)).length\n      const digits = digitsOf(el.value)\n      writeField(formatTimeMask(digits.slice(0, n - 1) + digits.slice(n)), timeCaret(n - 1))\n      commitLive()\n    }\n    return\n  }\n  // Typing anything that is not a digit — the separator included, so that \"9:30\" can be\n  // typed exactly as it reads — completes the hour with a leading zero and moves on to\n  // the minutes.\n  if (\n    event.key.length === 1 &&\n    !event.ctrlKey &&\n    !event.metaKey &&\n    !event.altKey &&\n    !/\\d/.test(event.key)\n  ) {\n    event.preventDefault()\n    const digits = digitsOf(el.value)\n    if (digits.length === 1) writeField(formatTimeMask(`0${digits}`), 3)\n  }\n}\n\n/**\n * Pasting. A time recognizable as a whole is adopted as it stands; anything else\n * contributes its digits alone.\n */\nfunction onFieldPaste(event: ClipboardEvent) {\n  if (!typing.value) return\n  const el = fieldEl.value\n  if (!el) return\n  event.preventDefault()\n  const pasted = (event.clipboardData?.getData('text') ?? '').trim()\n  // A pasted 24-hour time is read as one whatever clock is on display: \"19:05\" means\n  // seven in the evening even in a field showing a 12-hour clock.\n  if (isValidTime(pasted)) {\n    const text = timeToMask(pasted, resolvedFormat.value)\n    writeField(text, text.length)\n    if (pasted !== model.value) model.value = pasted\n    return\n  }\n  const digits = digitsOf(el.value)\n  const start = el.selectionStart ?? el.value.length\n  const end = el.selectionEnd ?? start\n  const from = digitsOf(el.value.slice(0, start)).length\n  const to = digitsOf(el.value.slice(0, end)).length\n  const inserted = digitsOf(pasted)\n  const next = (digits.slice(0, from) + inserted + digits.slice(to)).slice(0, 4)\n  writeField(formatTimeMask(next), timeCaret(Math.min(from + inserted.length, next.length), true))\n  commitLive()\n}\n\nfunction onFieldFocus() {\n  if (!typing.value || refocusing) return\n  openPanel(false)\n}\n\nfunction onRootKeydown(event: KeyboardEvent) {\n  if (typing.value && event.key === 'Escape' && open.value) {\n    event.preventDefault()\n    closeAndFocus()\n    return\n  }\n  onKeydown(event)\n}\n\n/* From here on: everything the list form needs. */\n\nconst options = computed<TimeOption[]>(() =>\n  isList.value ? timeList(props.minuteStep, resolvedLocale.value, resolvedFormat.value) : [],\n)\n\n// @keyboard\n/**\n * The rows the arrows may move to, gathered by hand rather than through the shared\n * helper.\n *\n * That helper asks the browser for the computed style of EVERY element it considers, to\n * skip the hidden ones. Across dozens of rows — a list at a five-minute step holds nearly\n * three hundred — that is a real cost, and none of these rows is ever hidden.\n */\nconst optionEls = (panel: HTMLElement) => [\n  ...panel.querySelectorAll<HTMLElement>('[role=\"option\"]'),\n]\n\n// @a11y\n/**\n * On opening, the list is both scrolled and focused onto the current time — or onto the\n * NEAREST row, since a value need not be one of them: \"09:07\" against a list stepping\n * every fifteen minutes matches nothing at all.\n */\nfunction focusListSelection(panel: HTMLElement) {\n  const items = optionEls(panel)\n  if (!items.length) return\n  const minutes = minutesOf(model.value)\n  const index =\n    minutes === null ? 0 : clamp(Math.round(minutes / props.minuteStep), 0, items.length - 1)\n  const el = items[index]\n  // Called optionally, the unit-test environment implementing no scrolling. No scrolling\n  // behaviour is requested either: leaving it out lets the stylesheet decide, which is\n  // what makes the movement respect a reader who has asked for less motion.\n  el?.scrollIntoView?.({ block: 'center' })\n  el?.focus({ preventScroll: true })\n}\n\n/**\n * Choosing a row writes the value straight away and closes — no draft and no footer, the\n * same way choosing a single date closes the calendar.\n */\nfunction selectTime(value: string) {\n  model.value = value\n  closeAndFocus()\n}\n\n// @keyboard @a11y\nfunction onPanelKeydown(event: KeyboardEvent) {\n  if (!isList.value) return\n  const panel = panelRef.value?.el\n  if (!panel) return\n  if (event.key === 'Enter' || event.key === ' ') {\n    // TRAP — cancelling the default here is MANDATORY, and the commit consequently has to\n    // be explicit. Left alone, Enter would fire the row's own click — which closes the\n    // panel — and then travel up to the root WITHOUT being marked as handled, so the\n    // guard that stops a consumed key reopening the panel would not apply, and it would\n    // reopen immediately.\n    const value = (document.activeElement as HTMLElement | null)?.closest<HTMLElement>(\n      '[role=\"option\"]',\n    )?.dataset.value\n    if (!value) return\n    event.preventDefault()\n    selectTime(value)\n    return\n  }\n  arrowNavigate(event, panel, optionEls(panel), { vertical: true })\n}\n\n/*\n * The clear cross and the icon at the end of the field.\n *\n * The cross is the field's own, which renders it BEFORE the end icon rather than in its\n * place — the convention every field in the design system follows. In the list form that\n * gives exactly the cross-and-chevron pairing of a combobox, which is the right thing:\n * the two behave the same way.\n *\n * Whether the cross is shown has to be answered explicitly here: outside the typed mode\n * the field is read-only and would hide it, while the value comes from the panel.\n */\nconst canClear = computed(\n  () =>\n    props.clearable && !props.disabled && (hasValue.value || (typing.value && !!maskDraft.value)),\n)\nconst endIcon = computed<IconSource | undefined>(() =>\n  isList.value ? expandMoreIcon : hasPicker.value ? props.pickerIcon : undefined,\n)\n// @a11y @devwarn\n/*\n * TRAP — the LABEL is defined at all times, even when no icon is rendered at all.\n *\n * The helper detecting a click handler on an icon warns AT SETUP if one is attached\n * without a label, and it has no way of knowing whether an icon exists. Since the\n * listener here is attached permanently and that detection is static, making the label\n * conditional would produce a false warning every time a typed field without a picker is\n * mounted.\n */\nconst endIconLabel = computed(() =>\n  isList.value ? m.value.timeInput.openList : m.value.timeInput.openPicker,\n)\n\nfunction onEndIcon() {\n  if (open.value) closeAndFocus()\n  else openPanel(true)\n}\n</script>\n\n<template>\n  <div\n    ref=\"rootEl\"\n    class=\"v-time-input\"\n    :class=\"rootClass\"\n    :style=\"rootStyle\"\n    :data-open=\"open ? '' : undefined\"\n    :data-mode=\"resolvedMode\"\n    @focusout=\"onFocusout\"\n    @keydown=\"onRootKeydown\"\n  >\n    <div class=\"v-time-input-row\">\n      <div class=\"v-time-input-control\" @click=\"onControlClick\">\n        <!-- The field is declared a combobox rather than left as the plain text box it\n             implicitly is, because a text box may not carry the attribute saying whether\n             something is expanded — the same reasoning as in VDateInput. Here it also\n             agrees with the list form, where what the field opens really is a list. -->\n        <VInput\n          ref=\"inputRef\"\n          v-model=\"fieldModel\"\n          :inputmode=\"typing ? 'numeric' : undefined\"\n          :autocomplete=\"typing ? 'off' : undefined\"\n          v-bind=\"forwardedAttrs\"\n          :readonly=\"!typing\"\n          :label=\"label\"\n          :hint=\"hint\"\n          :placeholder=\"placeholder ?? (typing ? m.timeInput.maskPlaceholder : undefined)\"\n          :size=\"size\"\n          :compact=\"compact\"\n          :disabled=\"disabled\"\n          :invalid=\"invalid\"\n          :clearable=\"clearable\"\n          :clear-visible=\"canClear\"\n          :clear-label=\"m.timeInput.clear\"\n          :icon-end=\"endIcon\"\n          :icon-end-label=\"endIconLabel\"\n          :role=\"hasPanel ? 'combobox' : undefined\"\n          :aria-haspopup=\"hasPanel ? (isList ? 'listbox' : 'dialog') : undefined\"\n          :aria-expanded=\"hasPanel ? open : undefined\"\n          :aria-controls=\"hasPanel ? panelId : undefined\"\n          @click:icon-end=\"onEndIcon\"\n          @clear=\"clearValue\"\n          @focus=\"onFieldFocus\"\n          @input=\"onFieldInput\"\n          @change=\"commitOrRevert\"\n          @blur=\"commitOrRevert\"\n          @keydown=\"onFieldKeydown\"\n          @paste=\"onFieldPaste\"\n        />\n      </div>\n\n      <!-- The AM/PM control beside the field, which the two typed forms cannot do without:\n           the mask needs the half of the day while the panel is shut, and the list form\n           has no picker at all. It is dropped in the READ-ONLY form alone, where the\n           picker is the only way in and carries its own.\n\n           It stays INSIDE the component's root: clicking it must not count as the focus\n           leaving, which would close the panel under the reader's hand. -->\n      <VToggle\n        v-if=\"resolvedFormat === '12h' && resolvedMode !== 'readonly'\"\n        v-model=\"meridiemModel\"\n        class=\"v-time-input-meridiem\"\n        mandatory\n        variant=\"outline\"\n        :size=\"size\"\n        :compact=\"compact\"\n        :label=\"m.timePicker.meridiem\"\n      >\n        <VToggleItem value=\"AM\" :label=\"m.timePicker.am\" />\n        <VToggleItem value=\"PM\" :label=\"m.timePicker.pm\" />\n      </VToggle>\n    </div>\n\n    <!-- With no panel rendered there is nothing to hold a reference to, and the open state\n         — which is fed by the panel's own events — can no longer become true. The absence\n         of a panel is therefore self-enforcing. -->\n    <VPopover\n      v-if=\"hasPanel\"\n      :id=\"panelId\"\n      ref=\"panelRef\"\n      v-model:open=\"open\"\n      mode=\"manual\"\n      anchor=\"--time-input-anchor\"\n      :placement=\"placement\"\n      surface\n      :role=\"isList ? 'listbox' : 'dialog'\"\n      :class=\"isList ? 'v-time-input-list v-control' : 'v-time-input-panel'\"\n      :data-size=\"isList ? size : undefined\"\n      :data-compact=\"isList && compact ? '' : undefined\"\n      :aria-label=\"label ?? (isList ? m.timeInput.listLabel : m.timeInput.pickerLabel)\"\n      @mousedown=\"onPanelMousedown\"\n      @keydown=\"onPanelKeydown\"\n    >\n      <!-- The list: rows the focus really moves between, as in a menu or a calendar —\n           unlike VCombobox, where the focus stays in the field — and a choice written\n           straight away on a click or on Enter. -->\n      <template v-if=\"isList\">\n        <button\n          v-for=\"option in options\"\n          :key=\"option.value\"\n          type=\"button\"\n          role=\"option\"\n          tabindex=\"-1\"\n          class=\"v-time-input-option\"\n          :data-value=\"option.value\"\n          :aria-selected=\"option.value === model ? 'true' : 'false'\"\n          @click=\"selectTime(option.value)\"\n        >\n          {{ option.label }}\n        </button>\n      </template>\n\n      <!-- The picker works on the DRAFT and not on the value, which is what makes OK the\n           only way in: Cancel, Escape and the focus leaving simply drop it. The two\n           actions are handed to its own footer slot, since they belong to this panel\n           rather than to a clock shown on its own. -->\n      <VTimePicker\n        v-else\n        ref=\"pickerRef\"\n        v-model=\"draft\"\n        :format=\"resolvedFormat\"\n        :locale=\"resolvedLocale\"\n        :minute-step=\"minuteStep\"\n        @confirm=\"confirm\"\n      >\n        <template #footer>\n          <VButton variant=\"ghost\" tone=\"neutral\" @click=\"cancel\">{{ m.common.cancel }}</VButton>\n          <VButton @click=\"confirm\">{{ m.common.confirm }}</VButton>\n        </template>\n      </VTimePicker>\n    </VPopover>\n  </div>\n</template>\n\n<style>\n@layer vectis.components {\n  .v-time-input {\n    /* Confines the anchor name to this instance. It is declared on the root because that\n       is the common ancestor of the field and the panel. */\n    anchor-scope: --time-input-anchor;\n    display: block;\n    width: 100%;\n    font-family: var(--vectis-text-family);\n  }\n\n  /* The row holding the field: the field takes whatever room is left, and the AM/PM\n     control keeps its natural width. */\n  .v-time-input-row {\n    display: flex;\n    align-items: stretch;\n    gap: var(--vectis-space-2);\n  }\n\n  .v-time-input-control {\n    anchor-name: --time-input-anchor;\n    flex: 1;\n    /* Without this the field would refuse to shrink below its own content and would\n       overflow the row. */\n    min-inline-size: 0;\n    cursor: pointer;\n  }\n\n  /* A field one types into shows the text cursor rather than the pointer a clickable\n     control shows. Its figures are also given equal widths: with proportional ones the\n     text shifts as digits are typed, and the caret appears to jitter. */\n  .v-time-input[data-mode='input'] .v-time-input-control {\n    cursor: text;\n  }\n\n  .v-time-input[data-mode='input'] .v-input-control {\n    font-variant-numeric: tabular-nums;\n  }\n\n  /* The AM/PM control lines up with the FIELD and not with the whole block, which also\n     stacks a label above and a hint below it. Those two are compensated with margins\n     derived from their own type, so the control sits exactly beside the field whatever\n     the field is given. */\n  .v-time-input-meridiem {\n    flex: none;\n    align-self: center;\n  }\n\n  .v-time-input-row:has(.v-input-label) .v-time-input-meridiem {\n    margin-block-start: calc(\n      var(--vectis-text-label-size) * var(--vectis-text-label-leading) + var(--vectis-space-1)\n    );\n  }\n\n  .v-time-input-row:has(.v-input-hint) .v-time-input-meridiem {\n    margin-block-end: calc(\n      var(--vectis-text-caption-size) * var(--vectis-text-caption-leading) + var(--vectis-space-1)\n    );\n  }\n\n  /* The anchoring and the panel's surface both come from VPopover; what is left here is\n     the padding around the picker. The picker brings its own layout — including the gap\n     between its parts and the centring of the face — so nothing of that is declared here.\n\n     TRAP — declaring a display here overrides the browser's own rule hiding a closed\n     popover. What closes it back is the shared guard on the overlay class, which is more\n     specific than anything a component can write.\n\n     The selector compounds two classes VPopover puts on the same element, because the\n     padding is also declared by the shared panel class: at equal specificity the winner\n     would be whichever sheet the consumer's bundler put last. The size attribute cannot\n     serve that purpose here — the picker's panel carries none. */\n  .v-popover-panel.v-time-input-panel {\n    display: flex;\n    flex-direction: column;\n    width: max-content;\n    padding: var(--vectis-space-3);\n    color: var(--vectis-color-text);\n  }\n\n  /* The list's surface comes from the shared panel class, and its rows read their\n     dimensions from the size class set on the PANEL. What stays here are the panel's own\n     dimensions, which the shared class deliberately declares none of. */\n  .v-time-input-list {\n    min-inline-size: anchor-size(width);\n    max-block-size: var(--vectis-control-size-time-input-list-max-block);\n    overflow: auto;\n  }\n\n  .v-time-input-option {\n    display: flex;\n    align-items: center;\n    width: 100%;\n    min-height: var(--control-height);\n    padding: var(--vectis-space-1) var(--control-padding-inline);\n    border: none;\n    border-radius: var(--vectis-radius-sm);\n    background: transparent;\n    color: var(--vectis-color-text);\n    font-family: inherit;\n    font-size: var(--control-font-size);\n    line-height: var(--vectis-text-body-md-leading);\n    font-variant-numeric: tabular-nums;\n    text-align: start;\n    cursor: pointer;\n  }\n\n  .v-time-input-option:hover {\n    background: var(--vectis-color-surface-muted);\n  }\n\n  /* The focus ring is drawn INSIDE the row: the panel scrolls, and a ring sitting outside\n     it would be cropped on the first and last rows. */\n  .v-time-input-option:focus-visible {\n    outline: var(--vectis-focus-ring-width) solid var(--vectis-focus-ring-color);\n    outline-offset: calc(-1 * var(--vectis-focus-ring-width));\n  }\n\n  .v-time-input-option[aria-selected='true'] {\n    background: var(--vectis-color-accent-surface);\n    color: var(--vectis-color-accent-text);\n  }\n\n  .v-time-input-footer {\n    display: flex;\n    align-items: center;\n    justify-content: flex-end;\n    gap: var(--vectis-space-2);\n  }\n}\n</style>\n"],"mappings":""}
+{"version":3,"file":"VTimeInput.js","names":[],"sources":["../../../src/components/VTimeInput/VTimeInput.vue"],"sourcesContent":["<script setup lang=\"ts\">\n// @a11y @core\n/**\n * A field for choosing a time. Three forms, and only two of them are built here.\n *\n * `input` types hours and minutes behind a mask, optionally with a clock beside it, and\n * `picker` makes that clock the only way in. What the field is FOR is a different question\n * from the `readonly` prop, which freezes whatever it holds by every route at once. Both use the VDateInput shell\n * (`useFieldPanel`): the panel is opened imperatively, so the focus can be moved into it,\n * and closes on `focusout` or Escape. The CLOCK works on a draft only OK writes — Cancel,\n * Escape and focusout all discard it — because dragging a hand passes over dozens of times\n * nobody meant.\n *\n * `list` offers the times at a fixed interval, which suits booking a slot far better than\n * pointing at a dial. It is a VCombobox outright, so a time is FOUND by typing as much as\n * scrolled to, and the whole listbox pattern comes from there rather than being written\n * again. Choosing a row commits at once: picking from a list is a single gesture.\n *\n * Whatever is displayed, the value is always a canonical 24-hour `'HH:mm'`.\n */\n\nimport { computed, inject, provide, ref, watchEffect } from 'vue'\n\nimport VButton from '../VButton/VButton.vue'\nimport VCombobox from '../VCombobox/VCombobox.vue'\nimport type { ComboboxOption } from '../VCombobox/VCombobox.vue'\nimport { inputGroupKey } from '../VInput/context'\nimport { schedule as scheduleIcon } from '../VIcon/icons/schedule'\nimport type { IconSource } from '../VIcon/types'\nimport VInput from '../VInput/VInput.vue'\nimport VPopover from '../VPopover/VPopover.vue'\nimport VSeparator from '../VSeparator/VSeparator.vue'\nimport VTimePicker from '../VTimePicker/VTimePicker.vue'\nimport type { TimePickerFormat } from '../VTimePicker/VTimePicker.vue'\nimport {\n  isTimeAllowed,\n  limitsProblem,\n  nearestAllowedTime,\n  resolveLimits,\n} from '../VTimePicker/limits'\nimport type { TimePickerAllowed } from '../VTimePicker/limits'\nimport {\n  formatTime,\n  formatTimeDisplay,\n  formatTimeMask,\n  hourCycleFor,\n  isValidTime,\n  parseTime,\n  parseTimeMask,\n  snapMinute,\n  timeCaret,\n  timeList,\n  timeToMask,\n  to12h,\n  withMeridiem,\n} from '../../utils/time'\nimport type { Meridiem, TimeOption } from '../../utils/time'\nimport { timeMatches } from './search'\nimport { isDev } from '../../utils/env'\nimport { hostWarnsKey } from '../../utils/hostWarns'\nimport { digitsOf } from '../../utils/text'\n\nimport { useControlShape } from '../../composables/useControlShape'\nimport { useRootAttrs } from '../../composables/useRootAttrs'\n\nimport { useFieldPanel } from '../../composables/useFieldPanel'\nimport { canClear } from '../../composables/useClearable'\nimport { iconStartListener } from '../../composables/useIconClickHandlers'\nimport { useMaskedField } from '../../composables/useMaskedField'\nimport { useMessages, useResolvedLocale } from '../../i18n/state'\n\nexport type TimeInputMode = 'picker' | 'input' | 'list'\n\nconst MODES: TimeInputMode[] = ['picker', 'input', 'list']\n\n/** Where the panel opens relative to the field, whether it holds the clock or the list. */\nexport type TimeInputPlacement =\n  'bottom' | 'bottom-start' | 'bottom-end' | 'top' | 'top-start' | 'top-end'\n\n/** The height of the field: 32, 40 or 48 pixels. */\nexport type TimeInputSize = 'sm' | 'md' | 'lg'\n\ninterface TimeInputProps {\n  /**\n   * Whether times are shown on a 12- or a 24-hour clock. Left out, the reader's language\n   * decides, which is almost always what one wants.\n   */\n  format?: TimePickerFormat\n  /**\n   * Which form the field takes: one that can be TYPED into, a `picker` one where the\n   * clock is the only way in — so the picker is forced on there — or a searchable LIST of\n   * times at a fixed interval, where a picker would make no sense.\n   */\n  mode?: TimeInputMode\n  /**\n   * Offers the picker beside a field one can type into: an icon at the end of the field,\n   * and a panel it opens.\n   *\n   * It means nothing in `picker` mode, where the clock is already the only way to choose,\n   * nor in `list` mode, which has a panel of its own — VDateInput reads it the same way.\n   */\n  showPicker?: boolean\n  /**\n   * The interval between two times that can be chosen. It applies to the picker, to the\n   * arrow keys and to the rows of the list.\n   */\n  minuteStep?: number\n  /**\n   * The earliest time that can be chosen, inclusive, as a canonical 24-hour `'HH:mm'`.\n   * The picker and the list both LEAVE OUT what it rules out, and a time typed past it\n   * makes the field invalid.\n   */\n  min?: string\n  /** The latest time that can be chosen, inclusive, written like `min`. */\n  max?: string\n  /**\n   * Which hours can be chosen: the list of them, or a rule answering for one. The hour\n   * handed to a rule is always the 24-hour one, whichever clock is on display.\n   */\n  allowedHours?: TimePickerAllowed\n  /** Which minutes can be chosen: the list of them, or a rule answering for one. */\n  allowedMinutes?: TimePickerAllowed\n  /**\n   * A BCP 47 locale, which decides the clock and how a time is written out. It TAKES\n   * PRECEDENCE over the design system's global locale and falls back to it — which is why\n   * it has no literal default: `undefined` has to stay recognizable for the global locale\n   * to have its chance.\n   */\n  locale?: string\n  // From here on: the field.\n  /** The label above the field. */\n  label?: string\n  /** A line of help under the field. */\n  hint?: string\n  /** What the field says while empty. */\n  placeholder?: string\n  /** The height of the field: 32, 40 or 48 pixels. */\n  size?: TimeInputSize\n  /** Takes 4px off the height. */\n  compact?: boolean\n  /** Makes the field unusable, greyed out through the colour tokens. */\n  disabled?: boolean\n  /**\n   * Shows the time without letting it be changed: nothing can be typed, there is no\n   * clock and no clear cross. The field stays focusable and can be copied from, which\n   * is what separates it from `disabled`, and it is a different question from `mode`,\n   * which says how a field that CAN be changed is filled in.\n   */\n  readonly?: boolean\n  /** Marks the field as invalid — for a rule of your own. */\n  invalid?: boolean\n  /**\n   * An icon inside the field, at the start. It is decorative by default and becomes a\n   * real button as soon as a `@click:icon-start` listener is attached, in which case it\n   * needs `iconStartLabel`.\n   */\n  iconStart?: IconSource\n  /** What the start icon does, in words, once it is clickable. */\n  iconStartLabel?: string\n  /**\n   * What the clock button does, in words. It names the button `pickerIcon` renders,\n   * and falls back to the design system dictionary.\n   */\n  pickerIconLabel?: string\n  /**\n   * Shows a spinner at the end of the field, in place of the clock icon. It says that\n   * something is being loaded and changes nothing else: the field can still be typed\n   * into and the panel still opens.\n   */\n  loading?: boolean\n  /**\n   * What screen readers announce while the spinner turns. It falls back to the design\n   * system dictionary.\n   */\n  loadingLabel?: string\n  /** Offers a cross that empties the value, shown before the end icon. */\n  clearable?: boolean\n  /** What that cross does, in words. It falls back to the design system dictionary. */\n  clearLabel?: string\n  /**\n   * The icon that opens the PICKER, at the end of the field. It has no effect on the list\n   * form, whose chevron follows the combobox convention. The clear cross appears to its\n   * left rather than in its place.\n   */\n  pickerIcon?: IconSource\n  /** Where the panel opens relative to the field, whether it holds the clock or the list. */\n  placement?: TimeInputPlacement\n}\n\nconst props = withDefaults(defineProps<TimeInputProps>(), {\n  format: undefined,\n  // Deliberately left undefined rather than defaulted to the typed mode: that is what\n  // distinguishes \"the prop was not given\" from \"the prop was given this value\", and\n  // therefore what allows warning ONLY the consumer who explicitly asked for something\n  // that cannot work.\n  mode: undefined,\n  showPicker: false,\n  minuteStep: 1,\n  min: undefined,\n  max: undefined,\n  allowedHours: undefined,\n  allowedMinutes: undefined,\n  locale: undefined,\n  label: undefined,\n  hint: undefined,\n  placeholder: undefined,\n  size: 'md',\n  compact: false,\n  disabled: false,\n  readonly: false,\n  invalid: false,\n  iconStart: undefined,\n  iconStartLabel: undefined,\n  pickerIconLabel: undefined,\n  loading: false,\n  loadingLabel: undefined,\n  clearable: false,\n  clearLabel: undefined,\n  pickerIcon: () => scheduleIcon,\n  placement: 'bottom-start',\n})\n\n/**\n * The time, always as a 24-hour \"HH:mm\" string whatever clock is displayed. A consumer\n * therefore never has to know which clock the reader's language uses.\n */\nconst model = defineModel<string | null>({ default: null })\n\nconst emit = defineEmits<{\n  /** The clear cross emptied the field. The value has already been reset. */\n  clear: []\n  /** The start icon was clicked. Attaching this listener is what makes it a button. */\n  'click:icon-start': [event: MouseEvent]\n}>()\n\ndefineSlots<{\n  /**\n   * Content at the start of the field, rendered after `iconStart` rather than in its place,\n   * as in VInput.\n   */\n  start?(): unknown\n  /**\n   * Controls of your own inside the field, after the AM/PM button when there is one and\n   * before the ones the field owns — the clear cross and the icon that opens the panel.\n   * Those two are this component's own affordance, which is why there is no `#end` here.\n   */\n  'value-end'?(): unknown\n  /**\n   * The strip at the foot of the clock, which REPLACES the Cancel and OK buttons rather\n   * than joining them.\n   *\n   * It receives both actions, and they are what make the slot usable: the clock writes a\n   * DRAFT that only `confirm` commits, so a footer of your own without it would leave the\n   * value unchangeable through the panel. `cancel` drops the draft and closes, and `close`\n   * is the same function under the name VDateInput's footer hands out.\n   *\n   * It is not rendered in `list` mode, which has no panel of this component's own.\n   */\n  footer?(props: { confirm: () => void; cancel: () => void; close: () => void }): unknown\n}>()\n\n// `class` and `style` stay on the wrapper; everything else goes down to the text field,\n// which is what a consumer's label points at and what assistive technology deals with.\ndefineOptions({ inheritAttrs: false })\nconst { rootClass, rootStyle, forwardedAttrs } = useRootAttrs()\n\n// Declared as this component's own event, `click:icon-start` is out of `$attrs`, so the\n// listener is relayed to the field by hand — and only when the consumer wrote one.\nconst iconStartClick = iconStartListener((event) => emit('click:icon-start', event))\n\n/** What reaches the field on screen — the masked VInput or the list's VCombobox. */\nconst fieldAttrs = computed(() => ({ ...forwardedAttrs.value, ...iconStartClick }))\n\nconst rootEl = ref<HTMLElement | null>(null)\nconst panelRef = ref<InstanceType<typeof VPopover> | null>(null)\nconst inputRef = ref<InstanceType<typeof VInput> | null>(null)\nconst listRef = ref<InstanceType<typeof VCombobox> | null>(null)\nconst pickerRef = ref<InstanceType<typeof VTimePicker> | null>(null)\n\n/** The real input inside the field, which the mask and the caret work on. */\nconst fieldEl = computed<HTMLInputElement | null>(() => inputRef.value?.el ?? null)\n\nconst resolvedMode = computed<TimeInputMode>(() => {\n  // TRAP — the default is applied BEFORE the value is checked. A prop that was never\n  // given is not an unknown value, and treating it as one would warn on a bare\n  // `<VTimeInput />`.\n  const mode = props.mode ?? 'input'\n  return MODES.includes(mode) ? mode : 'input'\n})\nconst typing = computed(() => resolvedMode.value === 'input')\nconst isList = computed(() => resolvedMode.value === 'list')\n/**\n * Whether this component builds a panel of its own, which is the clock's: the list form\n * hands that job to VCombobox. It is forced on a `picker` field, where nothing else could\n * fill it, and offered beside a field one types into. A frozen field has none: there is\n * nothing left for a panel to do.\n */\nconst hasPanel = computed(\n  () => !props.readonly && (resolvedMode.value === 'picker' || (typing.value && props.showPicker)),\n)\n\nconst resolvedLocale = useResolvedLocale(() => props.locale)\n\nconst resolvedFormat = computed<TimePickerFormat>(\n  () => props.format ?? hourCycleFor(resolvedLocale.value),\n)\n\n/**\n * The restrictions, resolved once. VTimePicker resolves the same props again for itself:\n * they are ITS contract, and this component only consults them for the two things the\n * picker knows nothing about — which rows the list offers, and whether a typed time is\n * one the field should be showing as invalid.\n */\nconst limits = computed(() => resolveLimits(props))\n\n/** Whether the value is one the restrictions allow. Nothing at all is not a breach. */\nconst valueAllowed = computed(() => {\n  const parts = modelParts.value\n  return !parts || isTimeAllowed(parts.hour, parts.minute, limits.value)\n})\n\n// @devwarn\nif (isDev) {\n  // The clock receives `minuteStep` and the restrictions as they stand, so what it would say\n  // about them is said here, under the name the consumer wrote (utils/hostWarns).\n  provide(hostWarnsKey, true)\n  watchEffect(() => {\n    if (props.minuteStep < 1 || 60 % props.minuteStep !== 0)\n      console.warn(`[VTimeInput] minuteStep ${props.minuteStep} — a divisor of 60 is expected.`)\n    if (props.mode !== undefined && !MODES.includes(props.mode))\n      console.warn(\n        `[VTimeInput] unknown mode \"${props.mode}\": use \"input\" (the default), \"picker\" or \"list\".`,\n      )\n    if (isList.value && props.showPicker)\n      console.warn(\n        '[VTimeInput] showPicker is ignored in \"list\" mode: the list of times is the only panel.',\n      )\n    // The list form is a VCombobox, which draws the end of the field itself: its own\n    // chevron, and a spinner that names nothing because the panel is what announces the\n    // loading. The three props that describe THIS component's end icon therefore reach\n    // nothing at all, and their absence is invisible on screen.\n    const inert = ([] as string[]).concat(\n      props.pickerIcon !== scheduleIcon ? 'pickerIcon' : [],\n      props.pickerIconLabel ? 'pickerIconLabel' : [],\n      props.loadingLabel ? 'loadingLabel' : [],\n    )\n    if (isList.value && inert.length > 0)\n      console.warn(\n        `[VTimeInput] ${inert.join(', ')} ${inert.length > 1 ? 'are' : 'is'} ignored in \"list\" mode: the list draws its own chevron and spinner.`,\n      )\n    // A field one types into without the picker has no end icon either, as in VDateInput.\n    // A read-only field is left out: it is a state that comes and goes, not a configuration\n    // to correct.\n    const iconless = ([] as string[]).concat(\n      props.pickerIcon !== scheduleIcon ? 'pickerIcon' : [],\n      props.pickerIconLabel ? 'pickerIconLabel' : [],\n    )\n    if (typing.value && !props.showPicker && iconless.length > 0)\n      console.warn(\n        `[VTimeInput] ${iconless.join(', ')} ${iconless.length > 1 ? 'are' : 'is'} ignored without showPicker: a field one types into has no clock icon unless it offers the clock.`,\n      )\n    const problem = limitsProblem(limits.value)\n    if (problem) console.warn(`[VTimeInput] ${problem}`)\n    if (isList.value && props.minuteStep < 5)\n      console.warn(\n        `[VTimeInput] minuteStep ${props.minuteStep} in \"list\" mode would render ${Math.ceil(1440 / props.minuteStep)} rows: a step of 15 or 30 minutes is expected.`,\n      )\n  })\n}\n\n/**\n * The time being built on the clock, in the same canonical form as the value itself.\n * Nothing here reaches the value until OK is pressed — which is the whole reason the\n * picker is bound to THIS rather than to the model.\n */\nconst pickerDraft = ref<string | null>(null)\n\nconst modelParts = computed(() => parseTime(model.value))\n\n/** The half of the day chosen while no time is set: VTimePicker's own `pendingMeridiem`. */\nconst pendingMeridiem = ref<Meridiem>('AM')\n\n/**\n * The half of the day the FIELD is showing. It is what the mask needs: typing \"9:30\" says\n * nothing about the morning or the afternoon, so the answer has to be readable while the\n * panel is shut.\n */\nconst currentMeridiem = computed<Meridiem>(() => {\n  // With the picker open it is the DRAFT that is on screen, and this control has to read\n  // the same thing: two controls showing opposite halves of the day until OK is pressed\n  // is the one state that must not happen.\n  const parts = open.value && hasPanel.value ? parseTime(pickerDraft.value) : modelParts.value\n  return parts ? to12h(parts.hour).meridiem : pendingMeridiem.value\n})\n\n/**\n * The button beside the value flips the half of the day. There is no third state to reach,\n * so it names the half it is showing and swaps to the other one on a click.\n */\nfunction toggleMeridiem() {\n  const next: Meridiem = currentMeridiem.value === 'PM' ? 'AM' : 'PM'\n  pendingMeridiem.value = next\n  // With no time set there is nothing to convert, so the choice is simply REMEMBERED\n  // and applies to the first time typed or chosen.\n  const moved = withMeridiem(model.value, next)\n  if (moved) model.value = moved\n  // With the picker open the draft has to follow as well, or OK would write back the\n  // half of the day the reader has just changed.\n  const pending = open.value && hasPanel.value ? withMeridiem(pickerDraft.value, next) : null\n  if (pending) pickerDraft.value = pending\n}\n\n/**\n * Whether the button is rendered at all. Only the typed form needs it: the `picker` form\n * reaches the clock, which carries its own AM/PM, and the list already spells the half of\n * the day out on every row. It writes the value, so a frozen field renders none.\n */\nconst hasMeridiem = computed(\n  () => typing.value && !props.readonly && resolvedFormat.value === '12h',\n)\n\nconst hasValue = computed(() => !!modelParts.value)\nconst displayText = computed(() =>\n  model.value ? formatTimeDisplay(model.value, resolvedLocale.value, resolvedFormat.value) : '',\n)\n\n// @a11y\n// Where the focus goes when the panel opens. The picker publishes where its own focus\n// belongs, so nothing here has to know that the target is a slider — the same arrangement\n// VDateInput has with VDatePicker.\nfunction focusInPanel() {\n  pickerRef.value?.focus()\n}\n\n// A VInputGroup joins several controls into one object, so the shape of this field is the\n// row's decision rather than its own (VInput/context.ts). Nothing else is needed here: the\n// AM/PM button lives INSIDE the field, so a 12 hour field is one box like any other and\n// the row has nothing of its own to join.\nconst group = inject(inputGroupKey, null)\nconst {\n  size: resolvedSize,\n  compact: resolvedCompact,\n  disabled: resolvedDisabled,\n} = useControlShape(props, group)\n\n// The whole \"field plus panel\" shell, shared with VDateInput. What is specific to this\n// component is only what happens around it: preparing the draft as the panel opens, and\n// clearing the announcement as it closes.\nconst {\n  open,\n  panelId,\n  closeAndFocus,\n  focusField,\n  onFieldFocus,\n  toggleFromIcon,\n  onControlClick,\n  onFocusout,\n  onKeydown,\n  onPanelMousedown,\n} = useFieldPanel({\n  rootEl,\n  panelRef,\n  field: inputRef,\n  // With no panel there is nothing to open. This is the composable's SINGLE cut-off\n  // point, and every way in passes through it — clicking the field, focusing it, the\n  // down arrow, Enter, the icon.\n  disabled: () => resolvedDisabled.value || !hasPanel.value,\n  focusInPanel,\n  // Beside a field one types into, the panel opens on focus WITHOUT taking it, so typing\n  // carries on.\n  openOnFocus: () => typing.value,\n  onOpen: () => {\n    // Only the picker works on a draft; the list writes its choice straight away.\n    if (!hasPanel.value) return\n    const parts = modelParts.value\n    if (parts) pickerDraft.value = formatTime(parts.hour, parts.minute)\n    else {\n      // Opening on the current time when none is set. Reading the clock is safe here:\n      // this runs from a handler, hence in a browser, never during a render — and it is\n      // why the picker itself never reads it, so that it stays identical on both sides\n      // of hydration. The instant is taken ONCE: two reads could straddle a minute.\n      const now = new Date()\n      const wanted = snapMinute(now.getMinutes(), props.minuteStep)\n      // Pulled to the nearest time the restrictions allow, so that the panel never opens\n      // on one the reader would be refused. Null is a set of restrictions that allows\n      // nothing at all, which the warning above has already reported.\n      pickerDraft.value =\n        nearestAllowedTime(now.getHours(), wanted, limits.value) ??\n        formatTime(now.getHours(), wanted)\n    }\n    pickerRef.value?.reset()\n  },\n  onClose: () => {\n    pickerRef.value?.reset()\n  },\n})\n\n/** OK: the ONE route by which the picker's draft becomes the value. */\nfunction confirm() {\n  if (pickerDraft.value) model.value = pickerDraft.value\n  closeAndFocus()\n}\n\n/** Cancel: the draft is simply dropped with the panel. */\nconst cancel = closeAndFocus\n\n/*\n * Emptying the value, called by the field as it emits its clear event. The focus is taken\n * through `focusField`, whose note says why that stops the panel reopening.\n */\nfunction clearValue() {\n  model.value = null\n  // The typed text is emptied EXPLICITLY: when the value was already empty, nothing\n  // changes, and the guard that keeps the field and the value from chasing each other\n  // would leave the text where it was.\n  if (typing.value) writeField('')\n  focusField()\n  emit('clear')\n}\n\n// Escape and the focus leaving both close WITHOUT committing, which is the picker's Cancel\n// behaviour: closing never writes the value, and only OK does.\n\nconst m = useMessages()\n\n// @core\n/**\n * Saying no to a time that is not one the restrictions allow.\n *\n * The value is committed all the same — the field shows what was typed, and a consumer\n * bound to it reads the same thing — and the refusal is carried by the control's OWN\n * validity, which is what turns the field red through `:user-invalid` and what stops a\n * form being submitted with it. That is the design system's route for a rule of its own\n * making (`useTextLimit`), never an event of its own invention.\n *\n * It is written unconditionally rather than only while typing: the browser BARS a\n * read-only control from constraint validation, so the read-only form settles it without\n * a branch here. The list form never reaches this at all, having no control of this\n * component's own to write on.\n */\nwatchEffect(\n  () => {\n    const el = fieldEl.value\n    if (!el) return\n    el.setCustomValidity(valueAllowed.value ? '' : m.value.timeInput.unavailable)\n  },\n  { flush: 'post' },\n)\n\n/* From here on: everything the typed field needs. */\n\n/*\n * The mask machinery — the text being typed, the bridge to the value, the reformatting\n * that preserves the caret, the commit and the silent revert — is shared with VDateInput\n * and lives in `useMaskedField`.\n *\n * The time vocabulary is the simpler of the two: four digits, and a separator that is the\n * SAME in every language. That is why the caret can be computed outright here, where a\n * date has to look for a separator it cannot predict; and why nothing distinguishes a\n * final commit from a live one, there being no equivalent of expanding a two-digit year.\n */\nconst {\n  draft,\n  fieldModel,\n  writeField,\n  commitOrRevert,\n  onFieldInput,\n  onKeydown: onMaskKeydown,\n  onPaste,\n} = useMaskedField({\n  fieldEl,\n  typing: () => typing.value,\n  displayText: () => displayText.value,\n  readValue: () => model.value,\n  writeValue: (time) => {\n    model.value = time\n  },\n  maxDigits: () => 4,\n  format: formatTimeMask,\n  caret: (_text, digitsBefore, inserting) => timeCaret(digitsBefore, inserting),\n  parse: (text) => parseTimeMask(text, resolvedFormat.value, currentMeridiem.value),\n  toMask: (time) => timeToMask(time, resolvedFormat.value),\n})\n\n// @keyboard — what the mask's keys mean for a time: typing anything that is not a digit,\n// the separator included so that \"9:30\" can be typed exactly as it reads, completes the\n// hour with a leading zero and moves on to the minutes; the down arrow is the one explicit\n// way from the field into the picker.\nfunction onFieldKeydown(event: KeyboardEvent) {\n  onMaskKeydown(event, {\n    onSeparator: (el) => {\n      const digits = digitsOf(el.value)\n      if (digits.length === 1) writeField(formatTimeMask(`0${digits}`), 3)\n    },\n    onArrowDown: () => {\n      if (!open.value) return false\n      focusInPanel()\n      return true\n    },\n    onEnter: closeAndFocus,\n  })\n}\n\n/**\n * Pasting. A time recognizable as a whole is adopted as it stands — and a pasted 24-hour\n * time is read as one whatever clock is on display: \"19:05\" means seven in the evening\n * even in a field showing a 12-hour clock. Anything else contributes its digits alone.\n */\nfunction onFieldPaste(event: ClipboardEvent) {\n  onPaste(event, (pasted) => (isValidTime(pasted) ? pasted : null))\n}\n\n/*\n * TRAP — the list form must not reach these two at all, and being panel-less is not\n * enough to keep it out. `useFieldPanel.onKeydown` cancels the default on Enter BEFORE\n * asking whether a panel can open, so an Enter travelling up from the VCombobox would\n * stop a surrounding form from being submitted with nothing to show for it.\n */\nfunction onRootKeydown(event: KeyboardEvent) {\n  if (!isList.value) onKeydown(event)\n}\n\nfunction onRootFocusout(event: FocusEvent) {\n  if (!isList.value) onFocusout(event)\n}\n\n/*\n * From here on: everything the list form needs.\n *\n * The list is a VCombobox, so the whole ARIA listbox pattern — the panel, the highlight,\n * the scroll onto the chosen row, the commit and the dismissal — comes from there and\n * NONE of it is written here. What is left is the three things a combobox cannot know\n * about times: which rows to offer, how a search matches one, and the fact that this\n * component's value is a nullable string where a combobox's is a plain one.\n */\n\n/**\n * The rows the step and the restrictions offer, which the value does not enter into: a\n * change of value must not format up to 1440 times again.\n */\nconst baseOptions = computed<TimeOption[]>(() => {\n  if (!isList.value) return []\n  return timeList(props.minuteStep, resolvedLocale.value, resolvedFormat.value).filter((row) => {\n    // A list is READ before it is chosen from, so a time it may not take has no reason to be\n    // in it, which is the picker's own rule for its numerals.\n    const parts = parseTime(row.value)\n    return !parts || isTimeAllowed(parts.hour, parts.minute, limits.value)\n  })\n})\n\n/**\n * The rows on offer.\n *\n * A value that is not ON the step is added to them, in order: it is a real value, so the\n * field has to be able to write it out and the panel to open on it. Without it the field\n * would fall back to showing the raw canonical string — \"09:07\" in a field that spells\n * every other row \"9:07 AM\" — since a combobox labels a value through the option carrying\n * it.\n */\nconst options = computed<TimeOption[]>(() => {\n  const rows = baseOptions.value\n  const current = model.value\n  if (!isValidTime(current) || rows.some((row) => row.value === current)) return rows\n  const at = rows.findIndex((row) => row.value > current)\n  const extra: TimeOption = {\n    value: current,\n    label: formatTimeDisplay(current, resolvedLocale.value, resolvedFormat.value),\n  }\n  return at < 0 ? [...rows, extra] : [...rows.slice(0, at), extra, ...rows.slice(at)]\n})\n\n/**\n * The search, which accepts the digit run as well as the words — \"930\" finds 9:30, the way\n * the typed form's mask reads what it is given. The rule itself is pure and lives in\n * `./search`, which says why it is not in `utils/time.ts`.\n */\nconst matchTime = (option: ComboboxOption, query: string) =>\n  timeMatches(option.label, String(option.value), query)\n\n/**\n * The bridge to VCombobox, whose value is a plain string where this component's is\n * nullable: an emptied combobox says so with an empty string, which is not a time.\n */\nconst listModel = computed<string | string[]>({\n  get: () => model.value ?? '',\n  set: (value) => {\n    model.value = typeof value === 'string' && value ? value : null\n  },\n})\n\n/*\n * The clear cross and the icon at the end of the field, for the two forms this component\n * builds itself; the list form gets both from VCombobox.\n *\n * The cross is the field's own, which renders it BEFORE the end icon rather than in its\n * place — the convention every field in the design system follows.\n *\n * Whether the cross is shown has to be answered explicitly here: outside the typed mode\n * the field is read-only and would hide it, while the value comes from the panel. The\n * `readonly` PROP is the one case where that default answer was right: frozen, the field\n * offers no route to a new value, so it offers no route to none either.\n */\nconst clearVisible = computed(() =>\n  canClear(props, resolvedDisabled.value, hasValue.value || (typing.value && !!draft.value)),\n)\nconst endIcon = computed<IconSource | undefined>(() =>\n  hasPanel.value ? props.pickerIcon : undefined,\n)\n// @a11y @devwarn\n/*\n * TRAP — the LABEL is passed at all times, even when no icon is rendered at all.\n *\n * The helper detecting a click handler on an icon warns AT SETUP if one is attached\n * without a label, and it has no way of knowing whether an icon exists. Since the\n * listener here is attached permanently and that detection is static, making the label\n * conditional would produce a false warning every time a typed field without a picker is\n * mounted.\n */\nconst endIconLabel = computed(() => props.pickerIconLabel ?? m.value.timeInput.openPicker)\nconst resolvedClearLabel = computed(() => props.clearLabel ?? m.value.timeInput.clear)\n\n/*\n * The three of them go through whichever field is on screen: in the list form there is no\n * VInput of this component's own, the VCombobox owning the one the reader sees. Exposing\n * the same trio as the other fields is what keeps a consumer's `ref` working whatever the\n * mode, which is a runtime prop they may well be binding.\n */\nconst field = computed(() => (isList.value ? listRef.value : inputRef.value))\n\ndefineExpose({\n  /** Moves the focus to the text field. */\n  focus: (options?: FocusOptions) => field.value?.focus(options),\n  /** Selects what the field is showing. */\n  select: () => field.value?.select(),\n  /** The real `<input>` behind the field, for what neither of the two above covers. */\n  el: computed(() => field.value?.el ?? null),\n})\n</script>\n\n<template>\n  <div\n    ref=\"rootEl\"\n    class=\"v-time-input\"\n    :class=\"rootClass\"\n    :style=\"rootStyle\"\n    :data-open=\"open ? '' : undefined\"\n    :data-mode=\"resolvedMode\"\n    @focusout=\"onRootFocusout\"\n    @keydown=\"onRootKeydown\"\n  >\n    <!-- The list form is a VCombobox and nothing else: a list one picks a value from and\n         narrows by typing IS the combobox pattern, down to the chevron, the clear cross\n         and the dismissal. All this component adds is the three things a combobox cannot\n         know about times — the rows, the search, and a value that may be nothing. -->\n    <VCombobox\n      v-if=\"isList\"\n      ref=\"listRef\"\n      v-model=\"listModel\"\n      v-bind=\"fieldAttrs\"\n      :options=\"options\"\n      :filter=\"matchTime\"\n      :label=\"label\"\n      :hint=\"hint\"\n      :placeholder=\"placeholder\"\n      :size=\"resolvedSize\"\n      :compact=\"resolvedCompact\"\n      :disabled=\"resolvedDisabled\"\n      :readonly=\"readonly\"\n      :invalid=\"invalid\"\n      :icon-start=\"iconStart\"\n      :icon-start-label=\"iconStartLabel\"\n      :clearable=\"clearable\"\n      :clear-label=\"clearLabel\"\n      :loading=\"loading\"\n      :placement=\"placement\"\n      @clear=\"emit('clear')\"\n    />\n\n    <div v-else class=\"v-time-input-control\" @click=\"onControlClick\">\n      <!-- The field is declared a combobox rather than left as the plain text box it\n           implicitly is, because a text box may not carry the attribute saying whether\n           something is expanded — the same reasoning as in VDateInput. -->\n      <VInput\n        ref=\"inputRef\"\n        v-model=\"fieldModel\"\n        :inputmode=\"typing ? 'numeric' : undefined\"\n        :autocomplete=\"typing ? 'off' : undefined\"\n        v-bind=\"fieldAttrs\"\n        :readonly=\"!typing || readonly\"\n        :label=\"label\"\n        :hint=\"hint\"\n        :placeholder=\"placeholder ?? (typing ? m.timeInput.maskPlaceholder : undefined)\"\n        :size=\"resolvedSize\"\n        :compact=\"resolvedCompact\"\n        :disabled=\"resolvedDisabled\"\n        :invalid=\"invalid\"\n        :clearable=\"clearable\"\n        :clear-visible=\"clearVisible\"\n        :clear-label=\"resolvedClearLabel\"\n        :icon-start=\"iconStart\"\n        :icon-start-label=\"iconStartLabel\"\n        :loading=\"loading\"\n        :loading-label=\"loadingLabel\"\n        :icon-end=\"endIcon\"\n        :icon-end-label=\"endIconLabel\"\n        :role=\"hasPanel ? 'combobox' : undefined\"\n        :aria-haspopup=\"hasPanel ? 'dialog' : undefined\"\n        :aria-expanded=\"hasPanel ? open : undefined\"\n        :aria-controls=\"hasPanel ? panelId : undefined\"\n        @click:icon-end=\"toggleFromIcon\"\n        @clear=\"clearValue\"\n        @focus=\"onFieldFocus\"\n        @input=\"onFieldInput\"\n        @change=\"commitOrRevert\"\n        @blur=\"commitOrRevert\"\n        @keydown=\"onFieldKeydown\"\n        @paste=\"onFieldPaste\"\n      >\n        <!-- The AM/PM button sits beside the value it qualifies, before the controls that\n             clear the field and open the panel. It carries `.v-input-action`, which is\n             what the field's own buttons wear AND what tells the shell that a click here\n             is that button's business rather than a reason to open the panel.\n\n             The rule after it separates what acts on the VALUE from what acts on the\n             FIELD. It is dropped when nothing follows it, or it would trail off the end\n             of an otherwise bare field. -->\n        <template v-if=\"$slots.start\" #start><slot name=\"start\" /></template>\n        <template v-if=\"hasMeridiem || $slots['value-end']\" #value-end>\n          <button\n            v-if=\"hasMeridiem\"\n            type=\"button\"\n            class=\"v-input-action v-field-action v-time-input-meridiem\"\n            :disabled=\"resolvedDisabled\"\n            :aria-label=\"\n              m.timeInput.meridiemValue(\n                currentMeridiem === 'PM' ? m.timePicker.pm : m.timePicker.am,\n              )\n            \"\n            @click=\"toggleMeridiem\"\n          >\n            {{ currentMeridiem === 'PM' ? m.timePicker.pm : m.timePicker.am }}\n          </button>\n          <VSeparator\n            v-if=\"hasMeridiem && (clearVisible || endIcon)\"\n            orientation=\"vertical\"\n            class=\"v-time-input-divider\"\n          />\n          <slot name=\"value-end\" />\n        </template>\n      </VInput>\n    </div>\n\n    <!-- With no panel rendered there is nothing to hold a reference to, and the open state\n         — which is fed by the panel's own events — can no longer become true. The absence\n         of a panel is therefore self-enforcing. -->\n    <VPopover\n      v-if=\"hasPanel\"\n      :id=\"panelId\"\n      ref=\"panelRef\"\n      v-model:open=\"open\"\n      mode=\"manual\"\n      anchor=\"--time-input-anchor\"\n      :placement=\"placement\"\n      role=\"dialog\"\n      class=\"v-time-input-panel\"\n      :aria-label=\"label ?? m.timeInput.pickerLabel\"\n      @mousedown=\"onPanelMousedown\"\n    >\n      <!-- The picker works on the DRAFT and not on the value, which is what makes OK the\n           only way in: Cancel, Escape and the focus leaving simply drop it. The two\n           actions are handed to its own footer slot, since they belong to this panel\n           rather than to a clock shown on its own. -->\n      <VTimePicker\n        ref=\"pickerRef\"\n        v-model=\"pickerDraft\"\n        :format=\"resolvedFormat\"\n        :locale=\"resolvedLocale\"\n        :minute-step=\"minuteStep\"\n        :min=\"min\"\n        :max=\"max\"\n        :allowed-hours=\"allowedHours\"\n        :allowed-minutes=\"allowedMinutes\"\n        @confirm=\"confirm\"\n      >\n        <!-- The slot REPLACES the two buttons rather than sitting beside them, so it is\n             handed both actions: the clock writes a draft, and without `confirm` a footer\n             of one's own could never commit it — the value would become unchangeable\n             through the panel. The `remove` of VCombobox's `#chip` slot exists for the\n             same reason. -->\n        <template #footer>\n          <slot name=\"footer\" :confirm=\"confirm\" :cancel=\"cancel\" :close=\"cancel\">\n            <VButton variant=\"ghost\" tone=\"neutral\" @click=\"cancel\">{{ m.common.cancel }}</VButton>\n            <VButton @click=\"confirm\">{{ m.common.confirm }}</VButton>\n          </slot>\n        </template>\n      </VTimePicker>\n    </VPopover>\n  </div>\n</template>\n\n<style>\n@layer vectis.components {\n  .v-time-input {\n    /* Confines the anchor name to this instance. It is declared on the root because that\n       is the common ancestor of the field and the panel. */\n    anchor-scope: --time-input-anchor;\n    display: block;\n    width: 100%;\n    font-family: var(--vectis-text-family);\n  }\n\n  .v-time-input-control {\n    cursor: pointer;\n  }\n\n  /* The anchor is the FIELD's box and not this wrapper's, which also holds the label and\n     the hint: anchored to the wrapper, the panel opens a hint's height below the field, and\n     a label's height above it once there is no room below and `flip-block` turns it over.\n     Against the field it covers whichever of the two it lands on, which is what a panel\n     belonging to a control is supposed to do.\n\n     TRAP — the selector has to start at the wrapper and never at the root. In `list` mode\n     that wrapper is not rendered at all and the field on screen belongs to a VCombobox,\n     which names it `--combobox-anchor` from its own sheet at the same (0,2,0): written\n     `.v-time-input .v-input-field`, this rule would put a SECOND `anchor-name` on that very\n     element, and which of the two survived would be decided by the order the consumer's\n     bundler gave the two sheets. The list's panel would then lose its anchor and paint\n     itself at the viewport origin, with nothing in the console to say why. */\n  .v-time-input-control .v-input-field {\n    anchor-name: --time-input-anchor;\n  }\n\n  /* A field one types into shows the text cursor rather than the pointer a clickable\n     control shows. Its figures are also given equal widths: with proportional ones the\n     text shifts as digits are typed, and the caret appears to jitter. */\n  .v-time-input[data-mode='input'] .v-time-input-control {\n    cursor: text;\n  }\n\n  .v-time-input[data-mode='input'] .v-input-control {\n    font-variant-numeric: tabular-nums;\n  }\n\n  /* The AM/PM button wears the field's own action recipe — the box, the muted colour that\n     lights up on hover, the focus ring and the disabled state all come from\n     `.v-field-action` — and changes only what a WORD needs that a glyph does not: room to\n     be read, and the field's type rather than the browser's default button font.\n\n     The floor keeps the hit target at the size of its neighbours, so the two spellings do\n     not resize the field between them.\n\n     The padding is DERIVED and not picked from the spacing scale: `.v-field-action` carries\n     a negative inline margin that cancels the slack around a glyph inside its box, so that\n     the row's gap is measured from the INK. A word fills its own box, so it has to put that\n     slack back or it would sit a couple of pixels off the rhythm its neighbours keep —\n     which reads as an asymmetry around the rule, whose two sides are otherwise identical.\n\n     The selector compounds the two classes because they are the same specificity in two\n     different sheets, and which one the consumer's bundler puts last is not ours to\n     decide. */\n  .v-field-action.v-time-input-meridiem {\n    inline-size: auto;\n    min-inline-size: var(--control-action-size);\n    padding-inline: calc((var(--control-action-size) - var(--vectis-icon-size)) / 2);\n    font: inherit;\n  }\n\n  /* The rule between the AM/PM button and the field's own controls, which is what keeps a\n     word from reading as a third icon in the row.\n\n     A vertical VSeparator stretches to its flex line by contract, which here is the full\n     height of the field: it would meet the border at both ends and read as a division of\n     the box rather than a break in the row. It is brought back to the height of the\n     buttons on either side of it.\n\n     `align-self` and the height are declared against the ORIENTATION branch, which is the\n     one that stretches, and beating it takes the extra class: the compound alone would tie\n     with it. */\n  .v-separator[data-orientation='vertical'].v-time-input-divider {\n    align-self: center;\n    block-size: var(--control-action-size);\n  }\n\n  /* The anchoring and the panel's surface both come from VPopover. The panel's OWN padding\n     is cancelled: VTimePicker pads itself, as VDatePicker does, so both pickers keep the\n     same room on a page and in a panel. The picker brings its own layout too — the gap\n     between its parts and the centring of the face — so nothing of that is declared here.\n\n     TRAP — NO `display` here, and that is not an omission. The column layout comes from\n     `.v-panel`, which is (0,1,0) and therefore loses to `.v-overlay:not(:popover-open)`, the\n     guard that hides a closed popover. This selector is (0,2,0): declaring a display on it\n     would TIE with that guard, and a tie between two sheets is settled by whichever the\n     consumer's bundler put last. The symptom when the component wins is silent and nasty —\n     the closed panel keeps its box, invisible at `opacity: 0` and fixed over the page, and\n     swallows every click that lands on it.\n\n     The selector compounds two classes VPopover puts on the same element, because the\n     padding is also declared by the shared panel class: at equal specificity the winner\n     would be whichever sheet the consumer's bundler put last. The size attribute cannot\n     serve that purpose here — the picker's panel carries none. */\n  .v-popover-panel.v-time-input-panel {\n    width: max-content;\n    padding: 0;\n    color: var(--vectis-color-text);\n  }\n\n  /* The list form is a VCombobox and takes everything from it — this is the one\n     declaration that does not belong to a combobox in general.\n\n     A column of times read down the panel is a column of FIGURES, and proportional ones\n     slide the colon from row to row. The selector is (0,2,0) against the panel's own\n     (0,1,0), so it wins on specificity and not on the order the consumer's bundler\n     happens to give the two sheets. */\n  .v-time-input[data-mode='list'] .v-combobox-panel {\n    font-variant-numeric: tabular-nums;\n  }\n}\n</style>\n"],"mappings":""}