vectis-ui 0.8.1 → 0.9.0

package/dist/components/VTimePicker/VTimePicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"VTimePicker.js","names":[],"sources":["../../../src/components/VTimePicker/VTimePicker.vue"],"sourcesContent":["<script setup lang=\"ts\">\n// @a11y @keyboard @core\n/**\n * An inline clock for choosing a time, the hour-and-minute counterpart of VDatePicker.\n * VTimeInput does no more than dress it in a field and a popover; it is usable on its own.\n *\n * Three parts: two large numerals saying what has been chosen and switching between hours\n * and minutes, the AM/PM toggle beside them on a 12-hour clock, and the face below, where a\n * time is POINTED AT rather than stepped through.\n *\n * Nothing native covers choosing a value by angle, so the JS does two things — turning a\n * point on the face into a time (the face measured once, then pure trigonometry in\n * `utils/time`) and implementing a slider's keyboard.\n *\n * Everything one SEES is CSS: the numerals are placed around the circle and the hand turned,\n * both from one unitless turn fraction set inline.\n *\n * Exactly ONE focusable element on the face, announced as a slider. The numerals are\n * `aria-hidden` markers reached by angle rather than one cell at a time, which is why that\n * single element has to carry the whole spoken value.\n */\n\nimport { computed, inject, ref, watchEffect } from 'vue'\n\nimport VButton from '../VButton/VButton.vue'\nimport VToggle from '../VToggle/VToggle.vue'\nimport type { ToggleModelValue } from '../VToggle/VToggle.vue'\nimport VToggleItem from '../VToggle/VToggleItem.vue'\nimport {\n  DIAL_INNER_THRESHOLD,\n  angleToIndex,\n  dialIndexToHour24,\n  distanceFraction,\n  formatTime,\n  hour24ToDial,\n  hourCycleFor,\n  hourWithMeridiem,\n  parseTime,\n  snapMinute,\n  to12h,\n  to24h,\n} from '../../utils/time'\nimport type { HourFormat, Meridiem } from '../../utils/time'\nimport {\n  allowedMinutesFor,\n  firstAllowed,\n  isHourAllowed,\n  isTimeAllowed,\n  limitsProblem,\n  minuteInterval,\n  nearestAllowedMinute,\n  resolveLimits,\n} from './limits'\nimport type { TimePickerAllowed } from './limits'\nimport { pad2 } from '../../utils/text'\nimport { isDev } from '../../utils/env'\nimport { hostWarnsKey } from '../../utils/hostWarns'\nimport { useAriaLabel } from '../../composables/useAriaLabel'\nimport { useMessages, useResolvedLocale } from '../../i18n/state'\n\nexport type TimePickerFormat = HourFormat\n\n/** Which of the two halves of a time is being adjusted. */\ntype TimePickerStep = 'hour' | 'minute'\n\ninterface TimePickerProps {\n  /**\n   * Whether the face shows 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   * A BCP 47 locale, which decides the clock. It TAKES PRECEDENCE over the design\n   * system's global locale and falls back to it — which is why it has no literal default:\n   * `undefined` has to stay recognizable for the global locale to have its chance.\n   */\n  locale?: string\n  /**\n   * The interval the minutes snap to, both when dragging and with the arrow keys. The face\n   * prints only the minutes it can reach, so a step of a quarter of an hour marks four.\n   */\n  minuteStep?: number\n  /**\n   * The earliest time that can be chosen, inclusive, as a canonical 24-hour `'HH:mm'`.\n   * What it rules out is LEFT OFF the face, the way `minuteStep` leaves off the minutes\n   * it cannot reach: the clock prints what can be chosen and nothing else.\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, so the\n   * same rule holds on both faces. The hours it leaves out are not printed.\n   */\n  allowedHours?: TimePickerAllowed\n  /**\n   * Which minutes can be chosen: the list of them, or a rule answering for one. The\n   * minutes it leaves out are not printed.\n   */\n  allowedMinutes?: TimePickerAllowed\n  /**\n   * Makes the whole clock unusable: the hand cannot be moved, the half-day cannot be\n   * changed, and everything greys out through the colour tokens.\n   */\n  disabled?: boolean\n  /**\n   * Shows the time without letting it be changed. The face keeps its focus and the two\n   * numerals still switch between the hour and the minutes, so the value can be read in\n   * full — which is what separates it from `disabled`.\n   */\n  readonly?: boolean\n  /**\n   * The accessible name of the whole clock, its two numerals and its face together. It\n   * falls back to the dictionary, and a consumer `aria-label` wins over it. The face\n   * keeps its own name, which says whether the hand is on the hour or the minutes.\n   */\n  label?: string\n}\n\nconst props = withDefaults(defineProps<TimePickerProps>(), {\n  format: undefined,\n  locale: undefined,\n  minuteStep: 1,\n  min: undefined,\n  max: undefined,\n  allowedHours: undefined,\n  allowedMinutes: undefined,\n  disabled: false,\n  readonly: false,\n  label: undefined,\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 *\n * With no value at all the clock shows midnight. It is deliberately NOT the current time:\n * reading the clock while rendering would make a page drawn on a server disagree with the\n * same page in the browser. A component that wants to open on the current time sets it\n * from a handler — which is exactly what VTimeInput does.\n */\nconst model = defineModel<string | null>({ default: null })\n\nconst emit = defineEmits<{\n  /**\n   * The reader has FINISHED, carrying the time as it stands: the minutes were settled from\n   * the keyboard. Releasing the pointer does not count — on a clock face, letting go of the\n   * hand is how one stops adjusting it, not how one confirms. VTimeInput listens to it to\n   * commit its draft and close its panel.\n   */\n  confirm: [value: string | null]\n}>()\n\ndefineSlots<{\n  /** A strip at the foot of the clock — the place for actions such as Cancel and OK. */\n  footer?(): unknown\n}>()\n\nconst m = useMessages()\n// @a11y — a roleless box cannot carry an accessible name (axe: aria-prohibited-attr),\n// so the root is a named group: the VCarousel viewport arrangement.\nconst ariaLabel = useAriaLabel(() => props.label ?? m.value.timePicker.label)\nconst resolvedLocale = useResolvedLocale(() => props.locale)\nconst resolvedFormat = computed<TimePickerFormat>(\n  () => props.format ?? hourCycleFor(resolvedLocale.value),\n)\n\n/** The restrictions, resolved once for the whole render. */\nconst limits = computed(() => resolveLimits(props))\n\n/**\n * The hours the restrictions still leave something in, worked out once per set of\n * restrictions. Every hour on the face, both AM/PM buttons and every key ask the question,\n * and each answer walks a whole hour of minutes: asked afresh, a drag re-walked all 24 of\n * them at pointer rate.\n */\nconst availableHours = computed(() => {\n  const hours = new Set<number>()\n  for (let candidate = 0; candidate < 24; candidate += 1)\n    if (isHourAllowed(candidate, limits.value)) hours.add(candidate)\n  return hours\n})\n\n/** Whether an hour is one the restrictions still leave something in. */\nconst isAvailableHour = (candidate: number) => availableHours.value.has(candidate)\n\n// @devwarn\n// Silent inside a host that forwards these props and reports on them itself (utils/hostWarns).\nif (isDev && !inject(hostWarnsKey, false)) {\n  watchEffect(() => {\n    if (props.minuteStep < 1 || 60 % props.minuteStep !== 0)\n      console.warn(`[VTimePicker] minuteStep ${props.minuteStep} — a divisor of 60 is expected.`)\n    const problem = limitsProblem(limits.value)\n    if (problem) console.warn(`[VTimePicker] ${problem}`)\n  })\n}\n\n/** Which of the two is being adjusted. It starts on the hour and moves on by itself. */\nconst step = ref<TimePickerStep>('hour')\n\nconst parts = computed(() => parseTime(model.value) ?? { hour: 0, minute: 0 })\nconst hour = computed(() => parts.value.hour)\nconst minute = computed(() => parts.value.minute)\n\n/*\n * The two writers are the SINGLE cut-off point for the restrictions: the pointer, the six\n * keys and the AM/PM control all write through them and through nothing else, so not one\n * handler carries a guard of its own.\n */\n\n/**\n * Writing the hour. An hour with nothing left in it has no minute to fall back on, which\n * is what refuses it; one that is only PARTLY available pulls the minutes to what it does\n * allow, since `min: '09:30'` must not be left holding 09:00.\n *\n * The minute in force is kept whenever it is allowed, which is also what leaves an\n * unrestricted clock exactly as it was: a value off the step, 09:07 on a quarter-hour\n * face, belongs to the consumer and is not ours to round.\n */\nfunction setHour(value: number | null) {\n  // The two writers below are the ONLY way the value ever changes — pointer, keys and the\n  // half-day control all come through them — so the two states are refused here and\n  // nowhere else. Changing which face is shown stays allowed under `readonly`: reading\n  // the minutes is not changing them.\n  if (props.disabled || props.readonly) return\n  if (value === null) return\n  const minutes = isTimeAllowed(value, minute.value, limits.value)\n    ? minute.value\n    : nearestAllowedMinute(value, minute.value, limits.value)\n  if (minutes === null) return\n  model.value = formatTime(value, minutes)\n}\n\n/** Writing the minutes. Null is \"there was nowhere to go\", which every key can produce. */\nfunction setMinute(value: number | null) {\n  if (props.disabled || props.readonly) return\n  if (value === null || !isTimeAllowed(hour.value, value, limits.value)) return\n  model.value = formatTime(hour.value, value)\n}\n\n// @a11y\n/*\n * Which step the clock is on is otherwise carried by the face's own name alone, and a\n * change of name is not reliably announced. A politely announced region says it a second\n * time. The wording has no prop: the dictionary is where it is changed.\n *\n * It is written HERE, by the function the reader's own gestures go through, rather than by\n * a watcher on the step: putting the clock back on the hour between two openings — what\n * `reset` does — must stay silent, and a watcher could not tell the two apart.\n */\nconst liveMessage = ref('')\n\nfunction setStep(next: TimePickerStep) {\n  step.value = next\n  liveMessage.value =\n    next === 'minute' ? m.value.timePicker.choosingMinutes : m.value.timePicker.choosingHour\n}\n\n/** One numeral on the face. */\ninterface DialCell {\n  key: string\n  /** What is printed. */\n  label: string\n  /** Where it sits, as a fraction of a full turn from twelve o'clock. */\n  turn: number\n  /** Which of the two circles it belongs to, a 24-hour face having an inner one. */\n  ring: 'outer' | 'inner'\n  /** Whether it is the value currently being pointed at. */\n  selected: boolean\n}\n\n/**\n * The hour a position on the face stands for. On a 12-hour clock that is what the half of\n * the day in force turns it into, and it is the 24-hour hour either way: the one the\n * restrictions answer about, and the one written.\n */\nfunction hourAt(index: number, ring: 'outer' | 'inner'): number {\n  return resolvedFormat.value === '24h'\n    ? dialIndexToHour24(index, ring)\n    : to24h(index === 0 ? 12 : index, currentMeridiem.value)\n}\n\n/**\n * The minutes the face prints. A numeral one can point at and not land on is a lie, which\n * the hand tells the moment it settles beside it rather than on it, so a marker is only\n * ever a minute `minuteStep` actually reaches AND the restrictions allow.\n *\n * How MANY of them is the other half of the question: sixty numerals would be unreadable,\n * so a step fine enough to offer more than twelve values keeps the five-minute grid a\n * clock is read on — minus, again, whatever it cannot reach, a step of two printing ten\n * past and not five past.\n */\nconst minuteMarks = computed(() => {\n  const interval = minuteInterval(props.minuteStep)\n  const spacing = 60 / interval <= 12 ? interval : 5\n  const marks: number[] = []\n  for (let minutes = 0; minutes < 60; minutes += spacing)\n    if (minutes % interval === 0 && isTimeAllowed(hour.value, minutes, limits.value))\n      marks.push(minutes)\n  return marks\n})\n\n/*\n * The face prints what can be chosen and nothing else — the minute step's own rule, held\n * to for all four restrictions rather than for one of them. A numeral that is only there\n * to be refused says nothing the missing numeral does not say better, and it says it in\n * grey text a screen reader has no way to reach: the markers are `aria-hidden`, so what\n * the restrictions leave is spoken by the face's own value and by nothing else.\n */\nconst cells = computed<DialCell[]>(() => {\n  if (step.value === 'minute') {\n    return minuteMarks.value.map((minutes) => ({\n      key: `m-${minutes}`,\n      label: pad2(minutes),\n      turn: minutes / 60,\n      ring: 'outer' as const,\n      selected: minute.value === minutes,\n    }))\n  }\n  // Each position's hour is worked out ONCE, since on a 12-hour face that takes the half of\n  // the day in force. The selection there still compares numerals and not hours: an empty\n  // clock holding a PM choice sits on midnight, and its hand points at the 12 all the same.\n  const twelve = resolvedFormat.value === '12h'\n  const shown12 = to12h(hour.value).hour\n  const rings: DialCell['ring'][] = twelve ? ['outer'] : ['outer', 'inner']\n  const out: DialCell[] = []\n  for (const ring of rings)\n    for (let i = 0; i < 12; i += 1) {\n      const target = hourAt(i, ring)\n      if (!isAvailableHour(target)) continue\n      const numeral = i === 0 ? 12 : i\n      out.push({\n        key: `${ring === 'outer' ? 'o' : 'i'}-${i}`,\n        label: ring === 'inner' ? pad2(target) : String(numeral),\n        turn: i / 12,\n        ring,\n        selected: twelve ? shown12 === numeral : hour.value === target,\n      })\n    }\n  return out\n})\n\nconst handTurn = computed(() => {\n  if (step.value === 'minute') return minute.value / 60\n  const index =\n    resolvedFormat.value === '24h' ? hour24ToDial(hour.value).index : to12h(hour.value).hour % 12\n  return index / 12\n})\n\nconst handRing = computed(() =>\n  step.value === 'hour' && resolvedFormat.value === '24h' ? hour24ToDial(hour.value).ring : 'outer',\n)\n\n/**\n * Whether the hand points at a minute that has no marker of its own. The tip is then\n * drawn small: at full size it would cover the two neighbouring markers and read as\n * pointing at neither.\n */\nconst handMinor = computed(\n  () => step.value === 'minute' && !minuteMarks.value.includes(minute.value),\n)\n\n/** The hour as the two large numerals show it, on whichever clock is displayed. */\nconst displayHourText = computed(() =>\n  pad2(resolvedFormat.value === '12h' ? to12h(hour.value).hour : hour.value),\n)\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. VTimeInput keeps one for its own AM/PM button, on the same terms.\n */\nconst pendingMeridiem = ref<Meridiem>('AM')\n\n/**\n * The half of the day in force: the value's own once there is one, the remembered choice\n * until then. Every hour written on a 12-hour face goes through it — without which a\n * reader who picks PM on an empty clock and then an hour would get the morning back, the\n * value having no half-day of its own to read.\n */\nconst currentMeridiem = computed<Meridiem>(() =>\n  model.value ? to12h(hour.value).meridiem : pendingMeridiem.value,\n)\n\nconst meridiemModel = computed<ToggleModelValue>({\n  get: () => currentMeridiem.value,\n  set: (value) => {\n    const meridiem: Meridiem = value === 'PM' ? 'PM' : 'AM'\n    pendingMeridiem.value = meridiem\n    // With no time set there is nothing to convert, so the choice is simply REMEMBERED\n    // and applies to the first time chosen.\n    if (!model.value) return\n    // What is being chosen here is the HALF OF THE DAY, so the hour gives way to it: kept\n    // when the new half allows it, and otherwise the first hour of that half that does.\n    // Refusing the write instead would leave the control snapping straight back, since it\n    // reads the half of the day off the value.\n    const wanted = hourWithMeridiem(hour.value, meridiem)\n    setHour(\n      isAvailableHour(wanted)\n        ? wanted\n        : firstAllowed(12, (i) => to24h(i, meridiem), isAvailableHour),\n    )\n  },\n})\n\n/**\n * Whether each half of the day still holds an hour one could choose. An empty one takes its\n * button with it: a control that can only ever be refused is worse than no control.\n */\nconst meridiemAvailable = computed<Record<Meridiem, boolean>>(() => ({\n  AM: firstAllowed(12, (i) => to24h(i, 'AM'), isAvailableHour) !== null,\n  PM: firstAllowed(12, (i) => to24h(i, 'PM'), isAvailableHour) !== null,\n}))\n\n// @a11y — the entire spoken value of the face. The numerals are hidden from screen\n// readers, so these four attributes are the ONLY thing assistive technology has: what the\n// value is, what its bounds are, and how to say it.\nconst ariaValueNow = computed(() => {\n  if (step.value === 'minute') return minute.value\n  return resolvedFormat.value === '12h' ? to12h(hour.value).hour : hour.value\n})\nconst ariaValueMin = computed(() =>\n  step.value === 'minute' ? 0 : resolvedFormat.value === '12h' ? 1 : 0,\n)\nconst ariaValueMax = computed(() =>\n  step.value === 'minute' ? 59 : resolvedFormat.value === '12h' ? 12 : 23,\n)\nconst ariaValueText = computed(() =>\n  step.value === 'minute'\n    ? m.value.timePicker.minutesValue(minute.value)\n    : m.value.timePicker.hourValue(ariaValueNow.value),\n)\n\n/**\n * A step has been settled: after the hour come the minutes, and after the minutes the\n * whole thing is confirmed — but by KEYBOARD only, for the reason given on the emit.\n */\nfunction settleStep(via: 'pointer' | 'keyboard') {\n  if (step.value === 'hour') setStep('minute')\n  else if (via === 'keyboard') emit('confirm', model.value)\n}\n\n// Pointing at the face, by click or by drag.\nconst faceEl = ref<HTMLElement | null>(null)\nconst dragging = ref(false)\n/**\n * Whether anything in the gesture under way landed on a numeral. It is the whole gesture\n * and not its last point: a drag that chose an hour and wandered off the ring before\n * being released has still chosen one, and the step follows the value rather than the\n * pixel let go of.\n */\nlet landed = false\n\n/**\n * Where a point on the face lands, and whether there was anything there at all. A\n * position the restrictions took a numeral off holds nothing to aim at, so the gesture\n * does nothing whatever: no value, and — through the answer returned here — no step moved\n * on either. The pointer catches nothing it was not aimed at.\n *\n * The question asked is the FACE's, `isAvailableHour`/`isTimeAllowed` being the pair\n * `cells` prints from, so \"there is a numeral here\" and \"this can be written\" cannot come\n * apart. The write itself still goes through `setHour`/`setMinute` and their own guards,\n * which is why `readonly` is refused THERE and not here: a frozen clock is still one\n * whose numerals are real, and a tap on one moves the step on as it always did.\n */\nfunction applyPoint(event: PointerEvent): boolean {\n  const face = faceEl.value\n  if (!face) return false\n  // Measuring the face is safe here: this runs from a handler, hence in a browser, never\n  // during a render.\n  const rect = face.getBoundingClientRect()\n  const dx = event.clientX - (rect.left + rect.width / 2)\n  const dy = event.clientY - (rect.top + rect.height / 2)\n  if (step.value === 'minute') {\n    // The step's own snapping stands: a point between two markers has always been pulled\n    // to the one it is nearest. What it is pulled to still has to BE on the face.\n    const minutes = snapMinute(angleToIndex(dx, dy, 60), props.minuteStep)\n    if (!isTimeAllowed(hour.value, minutes, limits.value)) return false\n    setMinute(minutes)\n    return true\n  }\n  const index = angleToIndex(dx, dy, 12)\n  const ring =\n    resolvedFormat.value === '24h' &&\n    distanceFraction(dx, dy, rect.width / 2) < DIAL_INNER_THRESHOLD\n      ? 'inner'\n      : 'outer'\n  const target = hourAt(index, ring)\n  if (!isAvailableHour(target)) return false\n  setHour(target)\n  return true\n}\n\nfunction onPointerdown(event: PointerEvent) {\n  // Capturing the pointer is what keeps the drag alive when it wanders off the face.\n  //\n  // @fallback — it is wrapped because a pointer event fired by a TEST refers to no real\n  // pointer, and the call then throws. Failing to capture merely means the drag stops at\n  // the edge, which no test is checking.\n  try {\n    faceEl.value?.setPointerCapture(event.pointerId)\n  } catch {\n    /* a synthetic pointer: nothing to capture */\n  }\n  dragging.value = true\n  landed = applyPoint(event)\n}\n\nfunction onPointermove(event: PointerEvent) {\n  if (dragging.value && applyPoint(event)) landed = true\n}\n\nfunction onPointerup() {\n  if (!dragging.value) return\n  dragging.value = false\n  // A gesture that never landed on a numeral has chosen nothing, so there is nothing to\n  // move on FROM: the reader is left on the face they aimed at, looking at what they missed.\n  if (landed) settleStep('pointer')\n}\n\nfunction onPointercancel() {\n  dragging.value = false\n}\n\n// @keyboard @a11y — the keyboard a slider is expected to have.\n/*\n * Every key below walks until it finds something it MAY land on, rather than stopping at\n * the first thing it may not: with scattered hours a key that stopped would die at the\n * first hole and never reach what lies past it. Against a bound there is nothing past the\n * hole, so the same walk comes back empty and the key holds still, which is what a bound\n * means. Restrict nothing and the first candidate answers: the walk is then the plain step\n * it has always been.\n */\nfunction moveHour(delta: number) {\n  if (resolvedFormat.value === '24h') {\n    setHour(firstAllowed(23, (i) => (hour.value + delta * i + 24) % 24, isAvailableHour))\n    return\n  }\n  // On a 12-hour face the hours cycle from 1 to 12 WITHIN the current half of the day:\n  // passing midday is done on the AM/PM control, not by walking the hand past twelve.\n  const hour12 = to12h(hour.value).hour\n  setHour(\n    firstAllowed(\n      11,\n      (i) => to24h(((hour12 - 1 + delta * i + 12) % 12) + 1, currentMeridiem.value),\n      isAvailableHour,\n    ),\n  )\n}\n\n/** The first or the last hour the face allows, on whichever clock it is showing. */\nfunction edgeHour(edge: 'first' | 'last'): number | null {\n  if (resolvedFormat.value === '24h')\n    return firstAllowed(24, (i) => (edge === 'first' ? i - 1 : 24 - i), isAvailableHour)\n  return firstAllowed(\n    12,\n    (i) => to24h(edge === 'first' ? i : 13 - i, currentMeridiem.value),\n    isAvailableHour,\n  )\n}\n\n/**\n * The minute a key lands on: the one it asked for when the hour allows it, and otherwise\n * the next one the same way round that it does.\n */\nfunction minuteFrom(start: number, direction: number): number | null {\n  const interval = minuteInterval(props.minuteStep)\n  const allowed = (candidate: number) => isTimeAllowed(hour.value, candidate, limits.value)\n  if (allowed(start)) return start\n  return firstAllowed(\n    Math.ceil(60 / interval),\n    (i) => snapMinute(start + direction * i * interval, interval),\n    allowed,\n  )\n}\n\nfunction onKeydown(event: KeyboardEvent) {\n  if (event.key === 'Enter' || event.key === ' ') {\n    event.preventDefault()\n    settleStep('keyboard')\n    return\n  }\n  // The arrows are NOT flipped in a right-to-left page: a clock face is never mirrored —\n  // clockwise means the same thing everywhere — so forward stays forward.\n  const delta =\n    event.key === 'ArrowUp' || event.key === 'ArrowRight'\n      ? 1\n      : event.key === 'ArrowDown' || event.key === 'ArrowLeft'\n        ? -1\n        : 0\n  if (step.value === 'hour') {\n    if (delta) moveHour(delta)\n    else if (event.key === 'Home') setHour(edgeHour('first'))\n    else if (event.key === 'End') setHour(edgeHour('last'))\n    else return\n    event.preventDefault()\n    return\n  }\n  if (delta)\n    setMinute(\n      minuteFrom(snapMinute(minute.value + delta * props.minuteStep, props.minuteStep), delta),\n    )\n  else if (event.key === 'PageUp')\n    setMinute(minuteFrom(snapMinute(minute.value + 5, props.minuteStep), 1))\n  else if (event.key === 'PageDown')\n    setMinute(minuteFrom(snapMinute(minute.value - 5, props.minuteStep), -1))\n  // The list is built in these two branches alone: the arrows walk to a neighbour and never\n  // need the whole of it.\n  else if (event.key === 'Home') setMinute(allowedMinutesFor(hour.value, limits.value)[0] ?? null)\n  else if (event.key === 'End')\n    setMinute(allowedMinutesFor(hour.value, limits.value).at(-1) ?? null)\n  else return\n  event.preventDefault()\n}\n\ndefineExpose({\n  /** Moves the focus onto the clock face, which is what the arrow keys drive. */\n  focus: (options?: FocusOptions) => faceEl.value?.focus(options),\n  /**\n   * Puts the clock back on the hour and clears the announcement, WITHOUT announcing\n   * anything itself. A component holding this one in a panel calls it as the panel opens\n   * and closes, so that every visit starts on the hour.\n   */\n  reset: () => {\n    step.value = 'hour'\n    liveMessage.value = ''\n  },\n})\n</script>\n\n<template>\n  <div\n    class=\"v-time-picker\"\n    role=\"group\"\n    :aria-label=\"ariaLabel\"\n    :data-step=\"step\"\n    :data-disabled=\"disabled ? '' : undefined\"\n    :data-readonly=\"readonly ? '' : undefined\"\n  >\n    <!-- The two large numerals switch between adjusting the hour and the minutes. The one\n         being adjusted takes the accent tone, which on a quiet button shows as the colour\n         of the numeral rather than as a filled background.\n\n         The choice of half-day sits beside them, on the same row: it is read as part of\n         the time itself rather than as a property of the face. On a 24-hour clock there\n         is no such choice, and the row then holds the numerals alone. -->\n    <div class=\"v-time-picker-header\">\n      <div class=\"v-time-picker-time\">\n        <VButton\n          class=\"v-time-picker-cell\"\n          variant=\"ghost\"\n          size=\"lg\"\n          :tone=\"step === 'hour' ? 'accent' : 'neutral'\"\n          :aria-pressed=\"step === 'hour' ? 'true' : 'false'\"\n          :aria-label=\"m.timePicker.selectHour\"\n          :disabled=\"disabled\"\n          @click=\"setStep('hour')\"\n        >\n          {{ displayHourText }}\n        </VButton>\n        <span class=\"v-time-picker-sep\" aria-hidden=\"true\">:</span>\n        <VButton\n          class=\"v-time-picker-cell\"\n          variant=\"ghost\"\n          size=\"lg\"\n          :tone=\"step === 'minute' ? 'accent' : 'neutral'\"\n          :aria-pressed=\"step === 'minute' ? 'true' : 'false'\"\n          :aria-label=\"m.timePicker.selectMinutes\"\n          :disabled=\"disabled\"\n          @click=\"setStep('minute')\"\n        >\n          {{ pad2(minute) }}\n        </VButton>\n      </div>\n\n      <VToggle\n        v-if=\"resolvedFormat === '12h'\"\n        v-model=\"meridiemModel\"\n        class=\"v-time-picker-meridiem\"\n        mandatory\n        variant=\"outline\"\n        selected-variant=\"soft\"\n        orientation=\"vertical\"\n        size=\"sm\"\n        :label=\"m.timePicker.meridiem\"\n        :disabled=\"disabled || readonly\"\n      >\n        <VToggleItem value=\"AM\" :label=\"m.timePicker.am\" :disabled=\"!meridiemAvailable.AM\" />\n        <VToggleItem value=\"PM\" :label=\"m.timePicker.pm\" :disabled=\"!meridiemAvailable.PM\" />\n      </VToggle>\n    </div>\n\n    <div\n      ref=\"faceEl\"\n      role=\"slider\"\n      :tabindex=\"disabled ? -1 : 0\"\n      class=\"v-time-picker-face\"\n      :aria-label=\"step === 'hour' ? m.timePicker.hour : m.timePicker.minutes\"\n      :aria-valuemin=\"ariaValueMin\"\n      :aria-valuemax=\"ariaValueMax\"\n      :aria-valuenow=\"ariaValueNow\"\n      :aria-valuetext=\"ariaValueText\"\n      :data-dragging=\"dragging ? '' : undefined\"\n      :aria-disabled=\"disabled ? 'true' : undefined\"\n      :aria-readonly=\"readonly ? 'true' : undefined\"\n      @pointerdown=\"onPointerdown\"\n      @pointermove=\"onPointermove\"\n      @pointerup=\"onPointerup\"\n      @pointercancel=\"onPointercancel\"\n      @keydown=\"onKeydown\"\n    >\n      <div\n        class=\"v-time-picker-hand\"\n        aria-hidden=\"true\"\n        :data-ring=\"handRing\"\n        :data-minor=\"handMinor ? '' : undefined\"\n        :style=\"{ '--dial-turn': String(handTurn) }\"\n      />\n      <span class=\"v-time-picker-center\" aria-hidden=\"true\" />\n      <span\n        v-for=\"cell in cells\"\n        :key=\"cell.key\"\n        class=\"v-time-picker-number\"\n        aria-hidden=\"true\"\n        :data-ring=\"cell.ring\"\n        :data-selected=\"cell.selected ? '' : undefined\"\n        :style=\"{ '--dial-turn': String(cell.turn) }\"\n        >{{ cell.label }}</span\n      >\n    </div>\n\n    <div class=\"v-visually-hidden\" aria-live=\"polite\">{{ liveMessage }}</div>\n\n    <div v-if=\"$slots.footer\" class=\"v-time-picker-footer\"><slot name=\"footer\" /></div>\n  </div>\n</template>\n\n<style>\n@layer vectis.components {\n  /* The same root as VDatePicker's: an inline column that sizes to its content and pads\n     itself, so the clock reads the same on a page as in VTimeInput's panel, which adds no\n     padding of its own. The gap is the clock's, its parts being larger. */\n  .v-time-picker {\n    display: inline-flex;\n    flex-direction: column;\n    gap: var(--vectis-space-4);\n    padding: var(--vectis-space-3);\n    font-family: var(--vectis-text-family);\n    color: var(--vectis-color-text);\n  }\n\n  /* The numerals and the choice of half-day on one row, the second beside the first. The\n     gap is logical, so the control follows the reading direction; the numerals inside it\n     stay in a group of their own, which is what keeps the direction they force off it.\n\n     The centring is what places the row whether or not that control is rendered — a\n     24-hour clock has none, and the numerals then come out centred on their own. */\n  .v-time-picker-header {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--vectis-space-3);\n  }\n\n  /* A time written in figures always reads hours then minutes, in every language. Forcing\n     the direction here is what stops bidirectional reordering from swapping the two in a\n     right-to-left page. */\n  .v-time-picker-time {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--vectis-space-2);\n    direction: ltr;\n  }\n\n  /* The two large numerals are ordinary quiet buttons. What is overridden here is the\n     \"large numeral\" look alone — the width and the type; the height, the states, the\n     focus ring and the transitions all come from the button itself.\n\n     The selector is qualified by an attribute that button always renders, which is what\n     makes it win whatever order the two sheets end up in. */\n  .v-time-picker-cell[data-size] {\n    width: var(--control-height);\n    font-size: var(--vectis-text-heading-1-size);\n    font-weight: var(--vectis-text-heading-2-weight);\n    /* Figures of equal width, so that going from \"11\" to \"00\" does not shift the cell. */\n    font-variant-numeric: tabular-nums;\n  }\n\n  .v-time-picker-sep {\n    font-size: var(--vectis-text-heading-2-size);\n    color: var(--vectis-color-text);\n    user-select: none;\n  }\n\n  .v-time-picker-meridiem {\n    flex: none;\n  }\n\n  .v-time-picker-face {\n    position: relative;\n    /* The row above is wider than the face as soon as the half-day control is rendered,\n       and the column is only as wide as its widest child: without this the clock would\n       hang at the start edge of that row instead of under the middle of it. The face\n       itself stays physical — a clock is never mirrored. */\n    align-self: center;\n    inline-size: var(--vectis-control-size-time-picker-dial);\n    block-size: var(--vectis-control-size-time-picker-dial);\n    border-radius: var(--vectis-radius-pill);\n    background: var(--vectis-color-surface-muted);\n    /* Dragging across the face IS how one chooses, so it must do nothing else: no\n       scrolling under a finger, and no selecting the numerals as text. */\n    touch-action: none;\n    user-select: none;\n    cursor: pointer;\n    /* How far from the centre the numerals sit — the outer circle. The numerals and the\n       hand both read it, and the inner circle redefines it for itself.\n\n       TRAP — this is coupled to the threshold that decides which of the two circles a\n       point belongs to, in `utils/time`. Changing one without the other makes the face\n       answer with the wrong ring, and no test can catch it: the unit tests measure\n       nothing. */\n    --dial-radius: calc(\n      var(--vectis-control-size-time-picker-dial) / 2 -\n        var(--vectis-control-size-time-picker-number) / 2\n    );\n  }\n\n  .v-time-picker-face:focus-visible {\n    outline: var(--vectis-focus-ring-width) solid var(--vectis-focus-ring-color);\n    outline-offset: var(--vectis-focus-ring-offset);\n  }\n\n  /*\n   * The numerals are placed around the circle by CSS trigonometry, from the fraction of a\n   * turn each one was given — no coordinates are computed in code.\n   *\n   * The properties used are PHYSICAL on purpose, where the rest of the design system\n   * prefers logical ones: a clock face is never mirrored, clockwise meaning the same thing\n   * in every language.\n   */\n  .v-time-picker-number {\n    position: absolute;\n    left: calc(50% + var(--dial-radius) * sin(var(--dial-turn) * 1turn));\n    top: calc(50% - var(--dial-radius) * cos(var(--dial-turn) * 1turn));\n    translate: -50% -50%;\n    inline-size: var(--vectis-control-size-time-picker-number);\n    block-size: var(--vectis-control-size-time-picker-number);\n    display: grid;\n    place-items: center;\n    border-radius: var(--vectis-radius-pill);\n    /* The outer circle is set at the large body size: these numerals are read at arm's\n       length on a phone, not scanned like a label. */\n    font-size: var(--vectis-text-body-lg-size);\n    color: var(--vectis-color-text);\n    /* Above the hand, so that the numeral being pointed at reads ON its dot rather than\n       being covered by it. */\n    z-index: 1;\n    pointer-events: none;\n  }\n\n  .v-time-picker-number[data-ring='inner'],\n  .v-time-picker-hand[data-ring='inner'] {\n    --dial-radius: calc(\n      var(--vectis-control-size-time-picker-dial) / 2 -\n        var(--vectis-control-size-time-picker-number) * 1.5\n    );\n  }\n\n  .v-time-picker-number[data-ring='inner'] {\n    font-size: var(--vectis-text-body-md-size);\n    color: var(--vectis-color-text-muted);\n  }\n\n  .v-time-picker-number[data-selected] {\n    color: var(--vectis-color-text-on-accent);\n  }\n\n  /*\n   * The hand: a stroke anchored at the centre and turned by the same fraction of a turn.\n   *\n   * TRAP — the rotation is deliberately NOT animated. Going from 55 minutes to 0 takes the\n   * angle from nearly a full turn back to none, and an interpolation would sweep the hand\n   * all the way round anticlockwise. That is an accepted departure from the Material\n   * design it follows otherwise.\n   */\n  .v-time-picker-hand {\n    position: absolute;\n    left: calc(50% - var(--vectis-control-size-time-picker-hand) / 2);\n    bottom: 50%;\n    inline-size: var(--vectis-control-size-time-picker-hand);\n    block-size: var(--dial-radius);\n    background: var(--vectis-color-accent);\n    transform-origin: 50% 100%;\n    rotate: calc(var(--dial-turn) * 1turn);\n  }\n\n  /* The dot at the tip of the hand. It is exactly the size of a numeral's cell, so it\n     covers the one being pointed at — whose text turns to the colour that reads on it. */\n  .v-time-picker-hand::before {\n    content: '';\n    position: absolute;\n    top: 0;\n    left: 50%;\n    translate: -50% -50%;\n    inline-size: var(--vectis-control-size-time-picker-number);\n    block-size: var(--vectis-control-size-time-picker-number);\n    border-radius: var(--vectis-radius-pill);\n    background: var(--vectis-color-accent);\n    /* The ONE thing animated on the hand: the dot changing size between its two forms. It\n       interpolates between two bounded values and can therefore never take a wrong path,\n       unlike the rotation above. */\n    transition:\n      inline-size var(--vectis-duration-fast) var(--vectis-ease-default),\n      block-size var(--vectis-duration-fast) var(--vectis-ease-default);\n  }\n\n  /*\n   * On a minute with no marker of its own, the dot covers no numeral and at full size\n   * would spill onto both neighbours, reading as pointing at neither. Shrunk, it becomes\n   * the precise marker itself — which is also why the pale centre Material draws inside it\n   * is dropped here: at this size it would turn the dot into a ring.\n   *\n   * TRAP — only the DOT's own size changes. Redefining the numeral size variable here\n   * would also move the radius derived from it, and with it the hand's length and the\n   * position of both circles.\n   */\n  .v-time-picker-hand[data-minor]::before {\n    inline-size: var(--vectis-control-size-time-picker-hand-minor);\n    block-size: var(--vectis-control-size-time-picker-hand-minor);\n  }\n\n  .v-time-picker-center {\n    position: absolute;\n    left: 50%;\n    top: 50%;\n    translate: -50% -50%;\n    inline-size: var(--vectis-control-size-time-picker-center);\n    block-size: var(--vectis-control-size-time-picker-center);\n    border-radius: var(--vectis-radius-pill);\n    background: var(--vectis-color-accent);\n  }\n\n  /* Neither state is a pointer target. A read-only clock is still read, so it keeps the\n     ordinary cursor; a disabled one refuses. */\n  .v-time-picker[data-readonly] .v-time-picker-face {\n    cursor: default;\n  }\n\n  .v-time-picker[data-disabled] .v-time-picker-face {\n    cursor: not-allowed;\n  }\n\n  /*\n   * A disabled clock greys out through the colour tokens and never through opacity: the\n   * hand and its centre dot are the two accent-painted parts, and the numeral under the\n   * dot is painted for an accent background it no longer has.\n   *\n   * The whole block sits AFTER the rules it overrides, every one of them at the same\n   * specificity: this is one sheet, so its own order is what settles them.\n   */\n  .v-time-picker[data-disabled] .v-time-picker-hand,\n  .v-time-picker[data-disabled] .v-time-picker-hand::before,\n  .v-time-picker[data-disabled] .v-time-picker-center {\n    background: var(--vectis-color-border-strong);\n  }\n\n  .v-time-picker[data-disabled] .v-time-picker-sep,\n  .v-time-picker[data-disabled] .v-time-picker-number,\n  .v-time-picker[data-disabled] .v-time-picker-number[data-selected] {\n    color: var(--vectis-color-text-subtle);\n  }\n\n  /* The foot of the clock, separated from the face the way VDatePicker's is from its grid. */\n  .v-time-picker-footer {\n    display: flex;\n    align-items: center;\n    justify-content: flex-end;\n    gap: var(--vectis-space-2);\n    padding-block-start: var(--vectis-space-2);\n    border-block-start: 1px solid var(--vectis-color-border);\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .v-time-picker-hand::before {\n      transition: none;\n    }\n  }\n}\n</style>\n"],"mappings":""}
+{"version":3,"file":"VTimePicker.js","names":[],"sources":["../../../src/components/VTimePicker/VTimePicker.vue"],"sourcesContent":["<script setup lang=\"ts\">\n// @a11y @keyboard @core\n/**\n * An inline clock for choosing a time, the hour-and-minute counterpart of VDatePicker.\n * VTimeInput does no more than dress it in a field and a popover; it is usable on its own.\n *\n * Three parts: two large numerals saying what has been chosen and switching between hours\n * and minutes, the AM/PM toggle beside them on a 12-hour clock, and the face below, where a\n * time is POINTED AT rather than stepped through.\n *\n * Nothing native covers choosing a value by angle, so the JS does two things — turning a\n * point on the face into a time (the face measured once, then pure trigonometry in\n * `utils/clock`) and implementing a slider's keyboard.\n *\n * Everything one SEES is CSS: the numerals are placed around the circle and the hand turned,\n * both from one unitless turn fraction set inline.\n *\n * Exactly ONE focusable element on the face, announced as a slider. The numerals are\n * `aria-hidden` markers reached by angle rather than one cell at a time, which is why that\n * single element has to carry the whole spoken value.\n */\n\nimport { computed, inject, ref, watchEffect } from 'vue'\n\nimport VButton from '../VButton/VButton.vue'\nimport VToggle from '../VToggle/VToggle.vue'\nimport type { ToggleModelValue } from '../VToggle/VToggle.vue'\nimport VToggleItem from '../VToggle/VToggleItem.vue'\nimport { formatTime, hourCycleFor, parseTime } from '../../utils/time'\nimport {\n  DIAL_DEAD_ZONE,\n  DIAL_INNER_THRESHOLD,\n  angleToIndex,\n  dialIndexToHour24,\n  distanceFraction,\n  hour24ToDial,\n  hourWithMeridiem,\n  snapMinute,\n  to12h,\n  to24h,\n} from '../../utils/clock'\nimport type { HourFormat, Meridiem } from '../../utils/time'\nimport {\n  allowedMinutesFor,\n  firstAllowed,\n  isHourAllowed,\n  isTimeAllowed,\n  limitsProblem,\n  minuteGrid,\n  minuteInterval,\n  nearestAllowedMinute,\n  resolveLimits,\n} from './limits'\nimport type { TimePickerAllowed } from './limits'\nimport { pad2 } from '../../utils/text'\nimport { isDev } from '../../utils/env'\nimport { hostWarnsKey } from '../../utils/hostWarns'\nimport { useAriaLabel } from '../../composables/useAriaLabel'\nimport { useMessages, useResolvedLocale } from '../../i18n/state'\n\n/** Whether the face shows a 12- or a 24-hour clock. */\nexport type TimePickerFormat = HourFormat\n\n/** Which of the two halves of a time is being adjusted. */\ntype TimePickerStep = 'hour' | 'minute'\n\ninterface TimePickerProps {\n  /**\n   * Whether the face shows 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   * A BCP 47 locale, which decides the clock. It TAKES PRECEDENCE over the design\n   * system's global locale and falls back to it, which is why it has no literal default:\n   * `undefined` has to stay recognizable for the global locale to have its chance.\n   */\n  locale?: string\n  /**\n   * The interval the minutes snap to, both when dragging and with the arrow keys. The face\n   * prints only the minutes it can reach, so a step of a quarter of an hour marks four.\n   */\n  minuteStep?: number\n  /**\n   * The earliest time that can be chosen, inclusive, as a canonical 24-hour `'HH:mm'`.\n   * What it rules out is LEFT OFF the face, the way `minuteStep` leaves off the minutes\n   * it cannot reach: the clock prints what can be chosen and nothing else.\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, so the\n   * same rule holds on both faces. The hours it leaves out are not printed.\n   */\n  allowedHours?: TimePickerAllowed\n  /**\n   * Which minutes can be chosen: the list of them, or a rule answering for one. The\n   * minutes it leaves out are not printed.\n   */\n  allowedMinutes?: TimePickerAllowed\n  /**\n   * Makes the whole clock unusable: the hand cannot be moved, the half-day cannot be\n   * changed, and everything greys out through the colour tokens.\n   */\n  disabled?: boolean\n  /**\n   * Shows the time without letting it be changed. The face keeps its focus and the two\n   * numerals still switch between the hour and the minutes, so the value can be read in\n   * full. That is what separates it from `disabled`.\n   */\n  readonly?: boolean\n  /**\n   * The accessible name of the whole clock, its two numerals and its face together. It\n   * falls back to the dictionary, and a consumer `aria-label` wins over it. The face\n   * keeps its own name, which says whether the hand is on the hour or the minutes.\n   */\n  label?: string\n}\n\nconst props = withDefaults(defineProps<TimePickerProps>(), {\n  format: undefined,\n  locale: undefined,\n  minuteStep: 1,\n  min: undefined,\n  max: undefined,\n  allowedHours: undefined,\n  allowedMinutes: undefined,\n  disabled: false,\n  readonly: false,\n  label: undefined,\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 *\n * With no value at all the clock shows midnight, or noon once PM has been chosen. It is\n * deliberately NOT the current time: reading the clock while rendering would make a page\n * drawn on a server disagree with the same page in the browser. A component that wants to\n * open on the current time sets it from a handler, which is what VTimeInput does.\n */\nconst model = defineModel<string | null>({ default: null })\n\nconst emit = defineEmits<{\n  /**\n   * The reader has FINISHED, carrying the time as it stands: the minutes were settled from\n   * the keyboard. Releasing the pointer does not count: on a clock face, letting go of the\n   * hand is how one stops adjusting it, not how one confirms. VTimeInput listens to it to\n   * commit its draft and close its panel.\n   */\n  confirm: [value: string | null]\n}>()\n\ndefineSlots<{\n  /** A strip at the foot of the clock, the place for actions such as Cancel and OK. */\n  footer?(): unknown\n}>()\n\nconst m = useMessages()\n// @a11y\n// A roleless box cannot carry an accessible name (axe: aria-prohibited-attr),\n// so the root is a named group: the VCarousel viewport arrangement.\nconst ariaLabel = useAriaLabel(() => props.label ?? m.value.timePicker.label)\nconst resolvedLocale = useResolvedLocale(() => props.locale)\nconst resolvedFormat = computed<TimePickerFormat>(\n  () => props.format ?? hourCycleFor(resolvedLocale.value),\n)\n\n/** The restrictions, resolved once for the whole render. */\nconst limits = computed(() => resolveLimits(props))\n\n/**\n * The hours the restrictions still leave something in, worked out once per set of\n * restrictions. Every hour on the face, both AM/PM buttons and every key ask the question,\n * and each answer walks a whole hour of minutes: asked afresh, a drag re-walked all 24 of\n * them at pointer rate.\n */\nconst availableHours = computed(() => {\n  const hours = new Set<number>()\n  for (let candidate = 0; candidate < 24; candidate += 1)\n    if (isHourAllowed(candidate, limits.value)) hours.add(candidate)\n  return hours\n})\n\n/** Whether an hour is one the restrictions still leave something in. */\nconst isAvailableHour = (candidate: number) => availableHours.value.has(candidate)\n\n// @devwarn\n// Silent inside a host that forwards these props and reports on them itself (utils/hostWarns).\nif (isDev && !inject(hostWarnsKey, false)) {\n  watchEffect(() => {\n    if (!Number.isInteger(props.minuteStep) || props.minuteStep < 1 || 60 % props.minuteStep !== 0)\n      console.warn(`[VTimePicker] minuteStep ${props.minuteStep} — a divisor of 60 is expected.`)\n    const problem = limitsProblem(limits.value)\n    if (problem) console.warn(`[VTimePicker] ${problem}`)\n  })\n}\n\n/** Which of the two is being adjusted. It starts on the hour and moves on by itself. */\nconst step = ref<TimePickerStep>('hour')\n\n// With no value the clock shows the first hour of the half of the day chosen so far, which\n// is midnight until PM is picked. It is also the hour a time started from the MINUTES is\n// written with, so that choice is not lost when the reader begins there.\nconst parts = computed(\n  () =>\n    parseTime(model.value) ?? {\n      hour: resolvedFormat.value === '12h' ? to24h(12, pendingMeridiem.value) : 0,\n      minute: 0,\n    },\n)\nconst hour = computed(() => parts.value.hour)\nconst minute = computed(() => parts.value.minute)\n\n/*\n * The two writers are the SINGLE cut-off point for the restrictions: the pointer, the six\n * keys and the AM/PM control all write through them and through nothing else, so not one\n * handler carries a guard of its own.\n */\n\n/**\n * Writing the hour. An hour with nothing left in it has no minute to fall back on, which\n * is what refuses it; one that is only PARTLY available pulls the minutes to what it does\n * allow, since `min: '09:30'` must not be left holding 09:00.\n *\n * The minute in force is kept whenever it is allowed, which is also what leaves an\n * unrestricted clock exactly as it was: a value off the step, 09:07 on a quarter-hour\n * face, belongs to the consumer and is not ours to round.\n */\nfunction setHour(value: number | null) {\n  // The two writers below are the ONLY way the value ever changes — pointer, keys and the\n  // half-day control all come through them — so the two states are refused here and\n  // nowhere else. Changing which face is shown stays allowed under `readonly`: reading\n  // the minutes is not changing them.\n  if (props.disabled || props.readonly) return\n  if (value === null) return\n  const minutes = isTimeAllowed(value, minute.value, limits.value)\n    ? minute.value\n    : nearestAllowedMinute(value, minute.value, limits.value)\n  if (minutes === null) return\n  model.value = formatTime(value, minutes)\n}\n\n/** Writing the minutes. Null is \"there was nowhere to go\", which every key can produce. */\nfunction setMinute(value: number | null) {\n  if (props.disabled || props.readonly) return\n  if (value === null || !isTimeAllowed(hour.value, value, limits.value)) return\n  model.value = formatTime(hour.value, value)\n}\n\n// @a11y\n/*\n * Which step the clock is on is otherwise carried by the face's own name alone, and a\n * change of name is not reliably announced. A politely announced region says it a second\n * time. The wording has no prop: the dictionary is where it is changed.\n *\n * It is written HERE, by the function the reader's own gestures go through, rather than by\n * a watcher on the step: putting the clock back on the hour between two openings — what\n * `reset` does — must stay silent, and a watcher could not tell the two apart.\n */\nconst liveMessage = ref('')\n\nfunction setStep(next: TimePickerStep) {\n  step.value = next\n  liveMessage.value =\n    next === 'minute' ? m.value.timePicker.choosingMinutes : m.value.timePicker.choosingHour\n}\n\n/** One numeral on the face. */\ninterface DialCell {\n  key: string\n  /** What is printed. */\n  label: string\n  /** Where it sits, as a fraction of a full turn from twelve o'clock. */\n  turn: number\n  /** Which of the two circles it belongs to, a 24-hour face having an inner one. */\n  ring: 'outer' | 'inner'\n  /** Whether it is the value currently being pointed at. */\n  selected: boolean\n}\n\n/**\n * The hour a position on the face stands for. On a 12-hour clock that is what the half of\n * the day in force turns it into, and it is the 24-hour hour either way: the one the\n * restrictions answer about, and the one written.\n */\nfunction hourAt(index: number, ring: 'outer' | 'inner'): number {\n  return resolvedFormat.value === '24h'\n    ? dialIndexToHour24(index, ring)\n    : to24h(index === 0 ? 12 : index, currentMeridiem.value)\n}\n\n/**\n * The minutes the face prints. A numeral one can point at and not land on is a lie, which\n * the hand tells the moment it settles beside it rather than on it, so a marker is only\n * ever a minute `minuteStep` actually reaches AND the restrictions allow.\n *\n * How MANY of them is the other half of the question: sixty numerals would be unreadable,\n * so a step fine enough to offer more than twelve values keeps the five-minute grid a\n * clock is read on — minus, again, whatever it cannot reach, a step of two printing ten\n * past and not five past.\n */\nconst minuteMarks = computed(() => {\n  const interval = minuteInterval(props.minuteStep)\n  const spacing = 60 / interval <= 12 ? interval : 5\n  const marks: number[] = []\n  for (let minutes = 0; minutes < 60; minutes += spacing)\n    if (minutes % interval === 0 && isTimeAllowed(hour.value, minutes, limits.value))\n      marks.push(minutes)\n  return marks\n})\n\n/*\n * The face prints what can be chosen and nothing else — the minute step's own rule, held\n * to for all four restrictions rather than for one of them. A numeral that is only there\n * to be refused says nothing the missing numeral does not say better, and it says it in\n * grey text a screen reader has no way to reach: the markers are `aria-hidden`, so what\n * the restrictions leave is spoken by the face's own value and by nothing else.\n */\nconst cells = computed<DialCell[]>(() => {\n  if (step.value === 'minute') {\n    return minuteMarks.value.map((minutes) => ({\n      key: `m-${minutes}`,\n      label: pad2(minutes),\n      turn: minutes / 60,\n      ring: 'outer' as const,\n      selected: minute.value === minutes,\n    }))\n  }\n  // Each position's hour is worked out ONCE, since on a 12-hour face that takes the half of\n  // the day in force. The selection there still compares numerals and not hours: an empty\n  // clock holding a PM choice sits on midnight, and its hand points at the 12 all the same.\n  const twelve = resolvedFormat.value === '12h'\n  const shown12 = to12h(hour.value).hour\n  const rings: DialCell['ring'][] = twelve ? ['outer'] : ['outer', 'inner']\n  const out: DialCell[] = []\n  for (const ring of rings)\n    for (let i = 0; i < 12; i += 1) {\n      const target = hourAt(i, ring)\n      if (!isAvailableHour(target)) continue\n      const numeral = i === 0 ? 12 : i\n      out.push({\n        key: `${ring === 'outer' ? 'o' : 'i'}-${i}`,\n        label: ring === 'inner' ? pad2(target) : String(numeral),\n        turn: i / 12,\n        ring,\n        selected: twelve ? shown12 === numeral : hour.value === target,\n      })\n    }\n  return out\n})\n\nconst handTurn = computed(() => {\n  if (step.value === 'minute') return minute.value / 60\n  const index =\n    resolvedFormat.value === '24h' ? hour24ToDial(hour.value).index : to12h(hour.value).hour % 12\n  return index / 12\n})\n\nconst handRing = computed(() =>\n  step.value === 'hour' && resolvedFormat.value === '24h' ? hour24ToDial(hour.value).ring : 'outer',\n)\n\n/**\n * Whether the hand points at a minute that has no marker of its own. The tip is then\n * drawn small: at full size it would cover the two neighbouring markers and read as\n * pointing at neither.\n */\nconst handMinor = computed(\n  () => step.value === 'minute' && !minuteMarks.value.includes(minute.value),\n)\n\n/** The hour as the two large numerals show it, on whichever clock is displayed. */\nconst displayHourText = computed(() =>\n  pad2(resolvedFormat.value === '12h' ? to12h(hour.value).hour : hour.value),\n)\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. VTimeInput keeps one for its own AM/PM button, on the same terms.\n */\nconst pendingMeridiem = ref<Meridiem>('AM')\n\n/**\n * The half of the day in force: the value's own once there is one, the remembered choice\n * until then. Every hour written on a 12-hour face goes through it — without which a\n * reader who picks PM on an empty clock and then an hour would get the morning back, the\n * value having no half-day of its own to read.\n */\nconst currentMeridiem = computed<Meridiem>(() =>\n  model.value ? to12h(hour.value).meridiem : pendingMeridiem.value,\n)\n\nconst meridiemModel = computed<ToggleModelValue>({\n  get: () => currentMeridiem.value,\n  set: (value) => {\n    const meridiem: Meridiem = value === 'PM' ? 'PM' : 'AM'\n    pendingMeridiem.value = meridiem\n    // With no time set there is nothing to convert, so the choice is simply REMEMBERED\n    // and applies to the first time chosen.\n    if (!model.value) return\n    // What is being chosen here is the HALF OF THE DAY, so the hour gives way to it: kept\n    // when the new half allows it, and otherwise the first hour of that half that does.\n    // Refusing the write instead would leave the control snapping straight back, since it\n    // reads the half of the day off the value.\n    const wanted = hourWithMeridiem(hour.value, meridiem)\n    setHour(\n      isAvailableHour(wanted)\n        ? wanted\n        : firstAllowed(12, (i) => to24h(i, meridiem), isAvailableHour),\n    )\n  },\n})\n\n/**\n * Whether each half of the day still holds an hour one could choose. An empty one takes its\n * button with it: a control that can only ever be refused is worse than no control.\n */\nconst meridiemAvailable = computed<Record<Meridiem, boolean>>(() => ({\n  AM: firstAllowed(12, (i) => to24h(i, 'AM'), isAvailableHour) !== null,\n  PM: firstAllowed(12, (i) => to24h(i, 'PM'), isAvailableHour) !== null,\n}))\n\n// @a11y\n// The entire spoken value of the face. The numerals are hidden from screen\n// readers, so these four attributes are the ONLY thing assistive technology has: what the\n// value is, what its bounds are, and how to say it.\nconst ariaValueNow = computed(() => {\n  if (step.value === 'minute') return minute.value\n  return resolvedFormat.value === '12h' ? to12h(hour.value).hour : hour.value\n})\nconst ariaValueMin = computed(() =>\n  step.value === 'minute' ? 0 : resolvedFormat.value === '12h' ? 1 : 0,\n)\nconst ariaValueMax = computed(() =>\n  step.value === 'minute' ? 59 : resolvedFormat.value === '12h' ? 12 : 23,\n)\n// On a 12-hour face the half of the day is spoken with the hour: the AM/PM control is not\n// on the slider's way, and \"9 o'clock\" alone is two different times.\nconst ariaValueText = computed(() => {\n  const m_ = m.value.timePicker\n  if (step.value === 'minute') return m_.minutesValue(minute.value)\n  const spoken = m_.hourValue(ariaValueNow.value)\n  if (resolvedFormat.value === '24h') return spoken\n  return `${spoken} ${currentMeridiem.value === 'PM' ? m_.pm : m_.am}`\n})\n\n/**\n * A step has been settled: after the hour come the minutes, and after the minutes the\n * whole thing is confirmed — but by KEYBOARD only, for the reason given on the emit.\n */\nfunction settleStep(via: 'pointer' | 'keyboard') {\n  if (step.value === 'hour') setStep('minute')\n  else if (via === 'keyboard') emit('confirm', model.value)\n}\n\n// Pointing at the face, by click or by drag.\nconst faceEl = ref<HTMLElement | null>(null)\nconst dragging = ref(false)\n/**\n * Whether anything in the gesture under way landed on a numeral. It is the whole gesture\n * and not its last point: a drag that chose an hour and wandered off the ring before\n * being released has still chosen one, and the step follows the value rather than the\n * pixel let go of.\n */\nlet landed = false\n\n/**\n * Where a point on the face lands, and whether there was anything there at all. A\n * position the restrictions took a numeral off holds nothing to aim at, so the gesture\n * does nothing whatever: no value, and — through the answer returned here — no step moved\n * on either. The pointer catches nothing it was not aimed at.\n *\n * The question asked is the FACE's, `isAvailableHour`/`isTimeAllowed` being the pair\n * `cells` prints from, so \"there is a numeral here\" and \"this can be written\" cannot come\n * apart. The write itself still goes through `setHour`/`setMinute` and their own guards,\n * which is why `readonly` is refused THERE and not here: a frozen clock is still one\n * whose numerals are real, and a tap on one moves the step on as it always did.\n */\nfunction applyPoint(event: PointerEvent): boolean {\n  const face = faceEl.value\n  // A disabled clock aims at nothing, so no step is moved on either: its header buttons\n  // are disabled for the same reason.\n  if (!face || props.disabled) return false\n  // Measuring the face is safe here: this runs from a handler, hence in a browser, never\n  // during a render.\n  const rect = face.getBoundingClientRect()\n  const dx = event.clientX - (rect.left + rect.width / 2)\n  const dy = event.clientY - (rect.top + rect.height / 2)\n  // `<=` so that the exact centre is refused even on a face measured at zero.\n  if (Math.hypot(dx, dy) <= DIAL_DEAD_ZONE * (rect.width / 2)) return false\n  if (step.value === 'minute') {\n    // The step's own snapping stands: a point between two markers has always been pulled\n    // to the one it is nearest. What it is pulled to still has to BE on the face.\n    const minutes = snapMinute(angleToIndex(dx, dy, 60), props.minuteStep)\n    if (!isTimeAllowed(hour.value, minutes, limits.value)) return false\n    setMinute(minutes)\n    return true\n  }\n  const index = angleToIndex(dx, dy, 12)\n  const ring =\n    resolvedFormat.value === '24h' &&\n    distanceFraction(dx, dy, rect.width / 2) < DIAL_INNER_THRESHOLD\n      ? 'inner'\n      : 'outer'\n  const target = hourAt(index, ring)\n  if (!isAvailableHour(target)) return false\n  setHour(target)\n  return true\n}\n\nfunction onPointerdown(event: PointerEvent) {\n  // @fallback\n  // Capturing the pointer is what keeps the drag alive when it wanders off the face. It\n  // is wrapped because a pointer event fired by a TEST refers to no real pointer, and the\n  // call then throws. Failing to capture merely means the drag stops at the edge, which\n  // no test is checking.\n  try {\n    faceEl.value?.setPointerCapture(event.pointerId)\n  } catch {\n    /* a synthetic pointer: nothing to capture */\n  }\n  dragging.value = true\n  landed = applyPoint(event)\n}\n\nfunction onPointermove(event: PointerEvent) {\n  if (dragging.value && applyPoint(event)) landed = true\n}\n\nfunction onPointerup() {\n  if (!dragging.value) return\n  dragging.value = false\n  // A gesture that never landed on a numeral has chosen nothing, so there is nothing to\n  // move on FROM: the reader is left on the face they aimed at, looking at what they missed.\n  if (landed) settleStep('pointer')\n}\n\nfunction onPointercancel() {\n  dragging.value = false\n}\n\n// @keyboard @a11y\n// The keyboard a slider is expected to have.\n/*\n * Every key below walks until it finds something it MAY land on, rather than stopping at\n * the first thing it may not: with scattered hours a key that stopped would die at the\n * first hole and never reach what lies past it. Against a bound there is nothing past the\n * hole, so the same walk comes back empty and the key holds still, which is what a bound\n * means. Restrict nothing and the first candidate answers: the walk is then the plain step\n * it has always been.\n */\nfunction moveHour(delta: number) {\n  if (resolvedFormat.value === '24h') {\n    setHour(firstAllowed(23, (i) => (hour.value + delta * i + 24) % 24, isAvailableHour))\n    return\n  }\n  // On a 12-hour face the hours cycle from 1 to 12 WITHIN the current half of the day:\n  // passing midday is done on the AM/PM control, not by walking the hand past twelve.\n  const hour12 = to12h(hour.value).hour\n  setHour(\n    firstAllowed(\n      11,\n      (i) => to24h(((hour12 - 1 + delta * i + 12) % 12) + 1, currentMeridiem.value),\n      isAvailableHour,\n    ),\n  )\n}\n\n/** The first or the last hour the face allows, on whichever clock it is showing. */\nfunction edgeHour(edge: 'first' | 'last'): number | null {\n  if (resolvedFormat.value === '24h')\n    return firstAllowed(24, (i) => (edge === 'first' ? i - 1 : 24 - i), isAvailableHour)\n  return firstAllowed(\n    12,\n    (i) => to24h(edge === 'first' ? i : 13 - i, currentMeridiem.value),\n    isAvailableHour,\n  )\n}\n\n/**\n * The minute a key lands on: the first step of the grid at least `distance` minutes away,\n * that way round, and then the next one the hour allows.\n *\n * It walks the GRID rather than adding a step and rounding: from a minute off the grid,\n * 09:07 on a quarter-hour face, rounding sent the down arrow to :45 and let PageUp round\n * straight back to where it started. Past the end of the hour it wraps, onto the grid's own\n * first step, which is also what keeps a step that does not divide sixty on its grid.\n */\nfunction minuteToward(direction: 1 | -1, distance: number): number | null {\n  const grid = minuteGrid(props.minuteStep)\n  const target = (((minute.value + direction * distance) % 60) + 60) % 60\n  const n = grid.length\n  // The first step at or past the target that way round, the grid's own end when none is.\n  let start = direction > 0 ? 0 : n - 1\n  for (let k = 0; k < n; k += 1) {\n    const i = direction > 0 ? k : n - 1 - k\n    if (direction > 0 ? grid[i]! >= target : grid[i]! <= target) {\n      start = i\n      break\n    }\n  }\n  return firstAllowed(\n    n,\n    (i) => grid[(((start + direction * (i - 1)) % n) + n) % n]!,\n    (candidate) => isTimeAllowed(hour.value, candidate, limits.value),\n  )\n}\n\nfunction onKeydown(event: KeyboardEvent) {\n  // The face of a disabled clock is out of the tab order, but `focus()` can still put the\n  // focus there: nothing it is sent may move the step on or confirm.\n  if (props.disabled) return\n  if (event.key === 'Enter' || event.key === ' ') {\n    event.preventDefault()\n    settleStep('keyboard')\n    return\n  }\n  // The arrows are NOT flipped in a right-to-left page: a clock face is never mirrored —\n  // clockwise means the same thing everywhere — so forward stays forward.\n  const delta =\n    event.key === 'ArrowUp' || event.key === 'ArrowRight'\n      ? 1\n      : event.key === 'ArrowDown' || event.key === 'ArrowLeft'\n        ? -1\n        : 0\n  if (step.value === 'hour') {\n    if (delta) moveHour(delta)\n    else if (event.key === 'Home') setHour(edgeHour('first'))\n    else if (event.key === 'End') setHour(edgeHour('last'))\n    else return\n    event.preventDefault()\n    return\n  }\n  if (delta) setMinute(minuteToward(delta, 1))\n  else if (event.key === 'PageUp') setMinute(minuteToward(1, 5))\n  else if (event.key === 'PageDown') setMinute(minuteToward(-1, 5))\n  // The list is built in these two branches alone: the arrows walk to a neighbour and never\n  // need the whole of it.\n  else if (event.key === 'Home') setMinute(allowedMinutesFor(hour.value, limits.value)[0] ?? null)\n  else if (event.key === 'End')\n    setMinute(allowedMinutesFor(hour.value, limits.value).at(-1) ?? null)\n  else return\n  event.preventDefault()\n}\n\ndefineExpose({\n  /** Moves the focus onto the clock face, which is what the arrow keys drive. */\n  focus: (options?: FocusOptions) => faceEl.value?.focus(options),\n  /**\n   * Puts the clock back on the hour and clears the announcement, WITHOUT announcing\n   * anything itself. A component holding this one in a panel calls it as the panel opens\n   * and closes, so that every visit starts on the hour.\n   */\n  reset: () => {\n    step.value = 'hour'\n    liveMessage.value = ''\n  },\n})\n</script>\n\n<template>\n  <div\n    class=\"v-time-picker\"\n    role=\"group\"\n    :aria-label=\"ariaLabel\"\n    :data-step=\"step\"\n    :data-disabled=\"disabled ? '' : undefined\"\n    :data-readonly=\"readonly ? '' : undefined\"\n  >\n    <!-- The two large numerals switch between adjusting the hour and the minutes. The one\n         being adjusted takes the accent tone, which on a quiet button shows as the colour\n         of the numeral rather than as a filled background.\n\n         The choice of half-day sits beside them, on the same row: it is read as part of\n         the time itself rather than as a property of the face. On a 24-hour clock there\n         is no such choice, and the row then holds the numerals alone. -->\n    <div class=\"v-time-picker-header\">\n      <div class=\"v-time-picker-time\">\n        <VButton\n          class=\"v-time-picker-cell\"\n          variant=\"ghost\"\n          size=\"lg\"\n          :tone=\"step === 'hour' ? 'accent' : 'neutral'\"\n          :aria-pressed=\"step === 'hour' ? 'true' : 'false'\"\n          :aria-label=\"`${displayHourText}, ${m.timePicker.selectHour}`\"\n          :disabled=\"disabled\"\n          @click=\"setStep('hour')\"\n        >\n          {{ displayHourText }}\n        </VButton>\n        <span class=\"v-time-picker-sep\" aria-hidden=\"true\">:</span>\n        <VButton\n          class=\"v-time-picker-cell\"\n          variant=\"ghost\"\n          size=\"lg\"\n          :tone=\"step === 'minute' ? 'accent' : 'neutral'\"\n          :aria-pressed=\"step === 'minute' ? 'true' : 'false'\"\n          :aria-label=\"`${pad2(minute)}, ${m.timePicker.selectMinutes}`\"\n          :disabled=\"disabled\"\n          @click=\"setStep('minute')\"\n        >\n          {{ pad2(minute) }}\n        </VButton>\n      </div>\n\n      <VToggle\n        v-if=\"resolvedFormat === '12h'\"\n        v-model=\"meridiemModel\"\n        class=\"v-time-picker-meridiem\"\n        mandatory\n        variant=\"outline\"\n        selected-variant=\"soft\"\n        orientation=\"vertical\"\n        size=\"sm\"\n        :label=\"m.timePicker.meridiem\"\n        :disabled=\"disabled || readonly\"\n      >\n        <VToggleItem value=\"AM\" :label=\"m.timePicker.am\" :disabled=\"!meridiemAvailable.AM\" />\n        <VToggleItem value=\"PM\" :label=\"m.timePicker.pm\" :disabled=\"!meridiemAvailable.PM\" />\n      </VToggle>\n    </div>\n\n    <div\n      ref=\"faceEl\"\n      role=\"slider\"\n      :tabindex=\"disabled ? -1 : 0\"\n      class=\"v-time-picker-face\"\n      :aria-label=\"step === 'hour' ? m.timePicker.hour : m.timePicker.minutes\"\n      :aria-valuemin=\"ariaValueMin\"\n      :aria-valuemax=\"ariaValueMax\"\n      :aria-valuenow=\"ariaValueNow\"\n      :aria-valuetext=\"ariaValueText\"\n      :data-dragging=\"dragging ? '' : undefined\"\n      :aria-disabled=\"disabled ? 'true' : undefined\"\n      :aria-readonly=\"readonly ? 'true' : undefined\"\n      @pointerdown=\"onPointerdown\"\n      @pointermove=\"onPointermove\"\n      @pointerup=\"onPointerup\"\n      @pointercancel=\"onPointercancel\"\n      @keydown=\"onKeydown\"\n    >\n      <div\n        class=\"v-time-picker-hand\"\n        aria-hidden=\"true\"\n        :data-ring=\"handRing\"\n        :data-minor=\"handMinor ? '' : undefined\"\n        :style=\"{ '--dial-turn': String(handTurn) }\"\n      />\n      <span class=\"v-time-picker-center\" aria-hidden=\"true\" />\n      <span\n        v-for=\"cell in cells\"\n        :key=\"cell.key\"\n        class=\"v-time-picker-number\"\n        aria-hidden=\"true\"\n        :data-ring=\"cell.ring\"\n        :data-selected=\"cell.selected ? '' : undefined\"\n        :style=\"{ '--dial-turn': String(cell.turn) }\"\n        >{{ cell.label }}</span\n      >\n    </div>\n\n    <div class=\"v-visually-hidden\" aria-live=\"polite\">{{ liveMessage }}</div>\n\n    <div v-if=\"$slots.footer\" class=\"v-time-picker-footer\"><slot name=\"footer\" /></div>\n  </div>\n</template>\n\n<style>\n@layer vectis.components {\n  /* The same root as VDatePicker's: an inline column that sizes to its content and pads\n     itself, so the clock reads the same on a page as in VTimeInput's panel, which adds no\n     padding of its own. The gap is the clock's, its parts being larger. */\n  .v-time-picker {\n    display: inline-flex;\n    flex-direction: column;\n    gap: var(--vectis-space-4);\n    padding: var(--vectis-space-3);\n    font-family: var(--vectis-text-family);\n    color: var(--vectis-color-text);\n  }\n\n  /* The numerals and the choice of half-day on one row, the second beside the first. The\n     gap is logical, so the control follows the reading direction; the numerals inside it\n     stay in a group of their own, which is what keeps the direction they force off it.\n\n     The centring is what places the row whether or not that control is rendered — a\n     24-hour clock has none, and the numerals then come out centred on their own. */\n  .v-time-picker-header {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--vectis-space-3);\n  }\n\n  /* A time written in figures always reads hours then minutes, in every language. Forcing\n     the direction here is what stops bidirectional reordering from swapping the two in a\n     right-to-left page. */\n  .v-time-picker-time {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--vectis-space-2);\n    direction: ltr;\n  }\n\n  /* The two large numerals are ordinary quiet buttons. What is overridden here is the\n     \"large numeral\" look alone — the width and the type; the height, the states, the\n     focus ring and the transitions all come from the button itself.\n\n     The type is the `heading-1` recipe taken WHOLE, and the colon the `heading-2` one:\n     read in halves, a consumer repointing `--vectis-text-heading-1-weight` would move every\n     heading but these two numerals.\n\n     The selector is qualified by an attribute that button always renders, which is what\n     makes it win whatever order the two sheets end up in. */\n  .v-time-picker-cell[data-size] {\n    width: var(--control-height);\n    font-size: var(--vectis-text-heading-1-size);\n    font-weight: var(--vectis-text-heading-1-weight);\n    line-height: var(--vectis-text-heading-1-leading);\n    letter-spacing: var(--vectis-text-heading-1-tracking);\n    /* Figures of equal width, so that going from \"11\" to \"00\" does not shift the cell. */\n    font-variant-numeric: tabular-nums;\n  }\n\n  .v-time-picker-sep {\n    font-size: var(--vectis-text-heading-2-size);\n    font-weight: var(--vectis-text-heading-2-weight);\n    line-height: var(--vectis-text-heading-2-leading);\n    color: var(--vectis-color-text);\n    user-select: none;\n  }\n\n  .v-time-picker-meridiem {\n    flex: none;\n  }\n\n  .v-time-picker-face {\n    position: relative;\n    /* The row above is wider than the face as soon as the half-day control is rendered,\n       and the column is only as wide as its widest child: without this the clock would\n       hang at the start edge of that row instead of under the middle of it. The face\n       itself stays physical — a clock is never mirrored. */\n    align-self: center;\n    inline-size: var(--vectis-control-size-time-picker-dial);\n    block-size: var(--vectis-control-size-time-picker-dial);\n    border-radius: var(--vectis-radius-pill);\n    background: var(--vectis-color-surface-muted);\n    /* Dragging across the face IS how one chooses, so it must do nothing else: no\n       scrolling under a finger, and no selecting the numerals as text. */\n    touch-action: none;\n    user-select: none;\n    cursor: pointer;\n    /* How far from the centre the numerals sit — the outer circle. The numerals and the\n       hand both read it, and the inner circle redefines it for itself.\n\n       TRAP — this is coupled to the threshold that decides which of the two circles a\n       point belongs to, in `utils/clock`. Changing one without the other makes the face\n       answer with the wrong ring, and no test can catch it: the unit tests measure\n       nothing. */\n    --dial-radius: calc(\n      var(--vectis-control-size-time-picker-dial) / 2 -\n        var(--vectis-control-size-time-picker-number) / 2\n    );\n  }\n\n  .v-time-picker-face:focus-visible {\n    outline: var(--vectis-focus-ring-width) solid var(--vectis-focus-ring-color);\n    outline-offset: var(--vectis-focus-ring-offset);\n  }\n\n  /*\n   * The numerals are placed around the circle by CSS trigonometry, from the fraction of a\n   * turn each one was given — no coordinates are computed in code.\n   *\n   * The properties used are PHYSICAL on purpose, where the rest of the design system\n   * prefers logical ones: a clock face is never mirrored, clockwise meaning the same thing\n   * in every language.\n   */\n  .v-time-picker-number {\n    position: absolute;\n    left: calc(50% + var(--dial-radius) * sin(var(--dial-turn) * 1turn));\n    top: calc(50% - var(--dial-radius) * cos(var(--dial-turn) * 1turn));\n    translate: -50% -50%;\n    inline-size: var(--vectis-control-size-time-picker-number);\n    block-size: var(--vectis-control-size-time-picker-number);\n    display: grid;\n    place-items: center;\n    border-radius: var(--vectis-radius-pill);\n    /* The outer circle is set at the large body size: these numerals are read at arm's\n       length on a phone, not scanned like a label. */\n    font-size: var(--vectis-text-body-lg-size);\n    color: var(--vectis-color-text);\n    /* Above the hand, so that the numeral being pointed at reads ON its dot rather than\n       being covered by it. */\n    z-index: 1;\n    pointer-events: none;\n  }\n\n  .v-time-picker-number[data-ring='inner'],\n  .v-time-picker-hand[data-ring='inner'] {\n    --dial-radius: calc(\n      var(--vectis-control-size-time-picker-dial) / 2 -\n        var(--vectis-control-size-time-picker-number) * 1.5\n    );\n  }\n\n  .v-time-picker-number[data-ring='inner'] {\n    font-size: var(--vectis-text-body-md-size);\n    color: var(--vectis-color-text-muted);\n  }\n\n  .v-time-picker-number[data-selected] {\n    color: var(--vectis-color-text-on-accent);\n  }\n\n  /*\n   * The hand: a stroke anchored at the centre and turned by the same fraction of a turn.\n   *\n   * TRAP — the rotation is deliberately NOT animated. Going from 55 minutes to 0 takes the\n   * angle from nearly a full turn back to none, and an interpolation would sweep the hand\n   * all the way round anticlockwise. That is an accepted departure from the Material\n   * design it follows otherwise.\n   */\n  .v-time-picker-hand {\n    position: absolute;\n    left: calc(50% - var(--vectis-control-size-time-picker-hand) / 2);\n    bottom: 50%;\n    inline-size: var(--vectis-control-size-time-picker-hand);\n    block-size: var(--dial-radius);\n    background: var(--vectis-color-accent);\n    transform-origin: 50% 100%;\n    rotate: calc(var(--dial-turn) * 1turn);\n  }\n\n  /* The dot at the tip of the hand. It is exactly the size of a numeral's cell, so it\n     covers the one being pointed at — whose text turns to the colour that reads on it. */\n  .v-time-picker-hand::before {\n    content: '';\n    position: absolute;\n    top: 0;\n    left: 50%;\n    translate: -50% -50%;\n    inline-size: var(--vectis-control-size-time-picker-number);\n    block-size: var(--vectis-control-size-time-picker-number);\n    border-radius: var(--vectis-radius-pill);\n    background: var(--vectis-color-accent);\n    /* The ONE thing animated on the hand: the dot changing size between its two forms. It\n       interpolates between two bounded values and can therefore never take a wrong path,\n       unlike the rotation above. */\n    transition:\n      inline-size var(--vectis-duration-fast) var(--vectis-ease-default),\n      block-size var(--vectis-duration-fast) var(--vectis-ease-default);\n  }\n\n  /*\n   * On a minute with no marker of its own, the dot covers no numeral and at full size\n   * would spill onto both neighbours, reading as pointing at neither. Shrunk, it becomes\n   * the precise marker itself — which is also why the pale centre Material draws inside it\n   * is dropped here: at this size it would turn the dot into a ring.\n   *\n   * TRAP — only the DOT's own size changes. Redefining the numeral size variable here\n   * would also move the radius derived from it, and with it the hand's length and the\n   * position of both circles.\n   */\n  .v-time-picker-hand[data-minor]::before {\n    inline-size: var(--vectis-control-size-time-picker-hand-minor);\n    block-size: var(--vectis-control-size-time-picker-hand-minor);\n  }\n\n  .v-time-picker-center {\n    position: absolute;\n    left: 50%;\n    top: 50%;\n    translate: -50% -50%;\n    inline-size: var(--vectis-control-size-time-picker-center);\n    block-size: var(--vectis-control-size-time-picker-center);\n    border-radius: var(--vectis-radius-pill);\n    background: var(--vectis-color-accent);\n  }\n\n  /* Neither state is a pointer target. A read-only clock is still read, so it keeps the\n     ordinary cursor; a disabled one refuses. */\n  .v-time-picker[data-readonly] .v-time-picker-face {\n    cursor: default;\n  }\n\n  .v-time-picker[data-disabled] .v-time-picker-face {\n    cursor: not-allowed;\n  }\n\n  /*\n   * A disabled clock greys out through the colour tokens and never through opacity: the\n   * hand and its centre dot are the two accent-painted parts, and the numeral under the\n   * dot is painted for an accent background it no longer has.\n   *\n   * The whole block sits AFTER the rules it overrides, every one of them at the same\n   * specificity: this is one sheet, so its own order is what settles them.\n   */\n  .v-time-picker[data-disabled] .v-time-picker-hand,\n  .v-time-picker[data-disabled] .v-time-picker-hand::before,\n  .v-time-picker[data-disabled] .v-time-picker-center {\n    background: var(--vectis-color-border-strong);\n  }\n\n  .v-time-picker[data-disabled] .v-time-picker-sep,\n  .v-time-picker[data-disabled] .v-time-picker-number,\n  .v-time-picker[data-disabled] .v-time-picker-number[data-selected] {\n    color: var(--vectis-color-text-subtle);\n  }\n\n  /* The foot of the clock, separated from the face the way VDatePicker's is from its grid. */\n  .v-time-picker-footer {\n    display: flex;\n    align-items: center;\n    justify-content: flex-end;\n    gap: var(--vectis-space-2);\n    padding-block-start: var(--vectis-space-2);\n    border-block-start: 1px solid var(--vectis-color-border);\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .v-time-picker-hand::before {\n      transition: none;\n    }\n  }\n}\n</style>\n"],"mappings":""}

package/dist/components/VTimePicker/VTimePicker.vue_vue_type_script_setup_true_lang.js

@@ -1,20 +1,22 @@
-import { useMessages as e, useResolvedLocale as t } from "../../i18n/state.js";
-import n from "../VButton/VButton.js";
-import { useAriaLabel as r } from "../../composables/useAriaLabel.js";
-import i from "../VToggle/VToggle.js";
-import a from "../VToggle/VToggleItem.js";
-import { pad2 as o } from "../../utils/text.js";
-import "../../utils/hostWarns.js";
-import { angleToIndex as s, dialIndexToHour24 as ee, distanceFraction as te, formatTime as ne, hour24ToDial as re, hourCycleFor as ie, hourWithMeridiem as ae, parseTime as oe, snapMinute as c, to12h as l, to24h as u } from "../../utils/time.js";
-import { allowedMinutesFor as se, firstAllowed as d, isHourAllowed as ce, isTimeAllowed as f, minuteInterval as p, nearestAllowedMinute as le, resolveLimits as ue } from "./limits.js";
-import { Fragment as de, computed as m, createBlock as fe, createCommentVNode as pe, createElementBlock as h, createElementVNode as g, createTextVNode as _, createVNode as v, defineComponent as y, mergeModels as b, normalizeStyle as x, openBlock as S, ref as C, renderList as me, renderSlot as he, toDisplayString as w, unref as T, useModel as ge, withCtx as E } from "vue";
+import { isDev as e } from "../../utils/env.js";
+import { useMessages as t, useResolvedLocale as n } from "../../i18n/state.js";
+import r from "../VButton/VButton.js";
+import { useAriaLabel as i } from "../../composables/useAriaLabel.js";
+import a from "../VToggle/VToggle.js";
+import o from "../VToggle/VToggleItem.js";
+import { pad2 as s } from "../../utils/text.js";
+import { hostWarnsKey as ee } from "../../utils/hostWarns.js";
+import { formatTime as c, hourCycleFor as te, parseTime as ne } from "../../utils/time.js";
+import { angleToIndex as l, dialIndexToHour24 as re, distanceFraction as ie, hour24ToDial as ae, hourWithMeridiem as oe, snapMinute as se, to12h as u, to24h as d } from "../../utils/clock.js";
+import { allowedMinutesFor as ce, firstAllowed as f, isHourAllowed as le, isTimeAllowed as p, limitsProblem as ue, minuteGrid as de, minuteInterval as fe, nearestAllowedMinute as pe, resolveLimits as me } from "./limits.js";
+import { Fragment as he, computed as m, createBlock as ge, createCommentVNode as _e, createElementBlock as h, createElementVNode as g, createTextVNode as _, createVNode as v, defineComponent as y, inject as ve, mergeModels as b, normalizeStyle as x, openBlock as S, ref as C, renderList as ye, renderSlot as be, toDisplayString as w, unref as T, useModel as xe, watchEffect as Se, withCtx as E } from "vue";
 //#region src/components/VTimePicker/VTimePicker.vue?vue&type=script&setup=true&lang.ts
-var _e = [
+var Ce = [
 	"aria-label",
 	"data-step",
 	"data-disabled",
 	"data-readonly"
-], ve = { class: "v-time-picker-header" }, ye = { class: "v-time-picker-time" }, be = [
+], we = { class: "v-time-picker-header" }, Te = { class: "v-time-picker-time" }, Ee = [
 	"tabindex",
 	"aria-label",
 	"aria-valuemin",
@@ -24,10 +26,10 @@ var _e = [
 	"data-dragging",
 	"aria-disabled",
 	"aria-readonly"
-], xe = ["data-ring", "data-minor"], Se = ["data-ring", "data-selected"], Ce = {
+], De = ["data-ring", "data-minor"], Oe = ["data-ring", "data-selected"], ke = {
 	class: "v-visually-hidden",
 	"aria-live": "polite"
-}, we = {
+}, Ae = {
 	key: 0,
 	class: "v-time-picker-footer"
 }, D = /*@__PURE__*/ y({
@@ -61,131 +63,151 @@ var _e = [
 	}),
 	emits: /*@__PURE__*/ b(["confirm"], ["update:modelValue"]),
 	setup(y, { expose: b, emit: D }) {
-		let O = y, k = ge(y, "modelValue"), Te = D, A = e(), Ee = r(() => O.label ?? A.value.timePicker.label), De = t(() => O.locale), j = m(() => O.format ?? ie(De.value)), M = m(() => ue(O)), Oe = m(() => {
+		let O = y, k = xe(y, "modelValue"), je = D, A = t(), Me = i(() => O.label ?? A.value.timePicker.label), Ne = n(() => O.locale), j = m(() => O.format ?? te(Ne.value)), M = m(() => me(O)), Pe = m(() => {
 			let e = /* @__PURE__ */ new Set();
-			for (let t = 0; t < 24; t += 1) ce(t, M.value) && e.add(t);
+			for (let t = 0; t < 24; t += 1) le(t, M.value) && e.add(t);
 			return e;
-		}), N = (e) => Oe.value.has(e), P = C("hour"), F = m(() => oe(k.value) ?? {
-			hour: 0,
+		}), N = (e) => Pe.value.has(e);
+		e && !ve(ee, !1) && Se(() => {
+			(!Number.isInteger(O.minuteStep) || O.minuteStep < 1 || 60 % O.minuteStep != 0) && console.warn(`[VTimePicker] minuteStep ${O.minuteStep} — a divisor of 60 is expected.`);
+			let e = ue(M.value);
+			e && console.warn(`[VTimePicker] ${e}`);
+		});
+		let P = C("hour"), F = m(() => ne(k.value) ?? {
+			hour: j.value === "12h" ? d(12, G.value) : 0,
 			minute: 0
 		}), I = m(() => F.value.hour), L = m(() => F.value.minute);
 		function R(e) {
 			if (O.disabled || O.readonly || e === null) return;
-			let t = f(e, L.value, M.value) ? L.value : le(e, L.value, M.value);
-			t !== null && (k.value = ne(e, t));
+			let t = p(e, L.value, M.value) ? L.value : pe(e, L.value, M.value);
+			t !== null && (k.value = c(e, t));
 		}
 		function z(e) {
-			O.disabled || O.readonly || e === null || !f(I.value, e, M.value) || (k.value = ne(I.value, e));
+			O.disabled || O.readonly || e === null || !p(I.value, e, M.value) || (k.value = c(I.value, e));
 		}
 		let B = C("");
 		function V(e) {
 			P.value = e, B.value = e === "minute" ? A.value.timePicker.choosingMinutes : A.value.timePicker.choosingHour;
 		}
 		function H(e, t) {
-			return j.value === "24h" ? ee(e, t) : u(e === 0 ? 12 : e, G.value);
+			return j.value === "24h" ? re(e, t) : d(e === 0 ? 12 : e, K.value);
 		}
 		let U = m(() => {
-			let e = p(O.minuteStep), t = 60 / e <= 12 ? e : 5, n = [];
-			for (let r = 0; r < 60; r += t) r % e === 0 && f(I.value, r, M.value) && n.push(r);
+			let e = fe(O.minuteStep), t = 60 / e <= 12 ? e : 5, n = [];
+			for (let r = 0; r < 60; r += t) r % e === 0 && p(I.value, r, M.value) && n.push(r);
 			return n;
-		}), ke = m(() => {
+		}), Fe = m(() => {
 			if (P.value === "minute") return U.value.map((e) => ({
 				key: `m-${e}`,
-				label: o(e),
+				label: s(e),
 				turn: e / 60,
 				ring: "outer",
 				selected: L.value === e
 			}));
-			let e = j.value === "12h", t = l(I.value).hour, n = e ? ["outer"] : ["outer", "inner"], r = [];
+			let e = j.value === "12h", t = u(I.value).hour, n = e ? ["outer"] : ["outer", "inner"], r = [];
 			for (let i of n) for (let n = 0; n < 12; n += 1) {
 				let a = H(n, i);
 				if (!N(a)) continue;
-				let s = n === 0 ? 12 : n;
+				let o = n === 0 ? 12 : n;
 				r.push({
 					key: `${i === "outer" ? "o" : "i"}-${n}`,
-					label: i === "inner" ? o(a) : String(s),
+					label: i === "inner" ? s(a) : String(o),
 					turn: n / 12,
 					ring: i,
-					selected: e ? t === s : I.value === a
+					selected: e ? t === o : I.value === a
 				});
 			}
 			return r;
-		}), Ae = m(() => P.value === "minute" ? L.value / 60 : (j.value === "24h" ? re(I.value).index : l(I.value).hour % 12) / 12), je = m(() => P.value === "hour" && j.value === "24h" ? re(I.value).ring : "outer"), Me = m(() => P.value === "minute" && !U.value.includes(L.value)), Ne = m(() => o(j.value === "12h" ? l(I.value).hour : I.value)), W = C("AM"), G = m(() => k.value ? l(I.value).meridiem : W.value), K = m({
-			get: () => G.value,
+		}), Ie = m(() => P.value === "minute" ? L.value / 60 : (j.value === "24h" ? ae(I.value).index : u(I.value).hour % 12) / 12), Le = m(() => P.value === "hour" && j.value === "24h" ? ae(I.value).ring : "outer"), Re = m(() => P.value === "minute" && !U.value.includes(L.value)), W = m(() => s(j.value === "12h" ? u(I.value).hour : I.value)), G = C("AM"), K = m(() => k.value ? u(I.value).meridiem : G.value), q = m({
+			get: () => K.value,
 			set: (e) => {
 				let t = e === "PM" ? "PM" : "AM";
-				if (W.value = t, !k.value) return;
-				let n = ae(I.value, t);
-				R(N(n) ? n : d(12, (e) => u(e, t), N));
+				if (G.value = t, !k.value) return;
+				let n = oe(I.value, t);
+				R(N(n) ? n : f(12, (e) => d(e, t), N));
 			}
-		}), q = m(() => ({
-			AM: d(12, (e) => u(e, "AM"), N) !== null,
-			PM: d(12, (e) => u(e, "PM"), N) !== null
-		})), J = m(() => P.value === "minute" ? L.value : j.value === "12h" ? l(I.value).hour : I.value), Pe = m(() => P.value === "minute" ? 0 : +(j.value === "12h")), Fe = m(() => P.value === "minute" ? 59 : j.value === "12h" ? 12 : 23), Ie = m(() => P.value === "minute" ? A.value.timePicker.minutesValue(L.value) : A.value.timePicker.hourValue(J.value));
-		function Y(e) {
-			P.value === "hour" ? V("minute") : e === "keyboard" && Te("confirm", k.value);
+		}), J = m(() => ({
+			AM: f(12, (e) => d(e, "AM"), N) !== null,
+			PM: f(12, (e) => d(e, "PM"), N) !== null
+		})), Y = m(() => P.value === "minute" ? L.value : j.value === "12h" ? u(I.value).hour : I.value), ze = m(() => P.value === "minute" ? 0 : +(j.value === "12h")), Be = m(() => P.value === "minute" ? 59 : j.value === "12h" ? 12 : 23), Ve = m(() => {
+			let e = A.value.timePicker;
+			if (P.value === "minute") return e.minutesValue(L.value);
+			let t = e.hourValue(Y.value);
+			return j.value === "24h" ? t : `${t} ${K.value === "PM" ? e.pm : e.am}`;
+		});
+		function He(e) {
+			P.value === "hour" ? V("minute") : e === "keyboard" && je("confirm", k.value);
 		}
 		let X = C(null), Z = C(!1), Q = !1;
-		function Le(e) {
+		function Ue(e) {
 			let t = X.value;
-			if (!t) return !1;
+			if (!t || O.disabled) return !1;
 			let n = t.getBoundingClientRect(), r = e.clientX - (n.left + n.width / 2), i = e.clientY - (n.top + n.height / 2);
+			if (Math.hypot(r, i) <= .2 * (n.width / 2)) return !1;
 			if (P.value === "minute") {
-				let e = c(s(r, i, 60), O.minuteStep);
-				return f(I.value, e, M.value) ? (z(e), !0) : !1;
+				let e = se(l(r, i, 60), O.minuteStep);
+				return p(I.value, e, M.value) ? (z(e), !0) : !1;
 			}
-			let a = H(s(r, i, 12), j.value === "24h" && te(r, i, n.width / 2) < .625 ? "inner" : "outer");
+			let a = H(l(r, i, 12), j.value === "24h" && ie(r, i, n.width / 2) < .625 ? "inner" : "outer");
 			return N(a) ? (R(a), !0) : !1;
 		}
-		function Re(e) {
+		function We(e) {
 			try {
 				X.value?.setPointerCapture(e.pointerId);
 			} catch {}
-			Z.value = !0, Q = Le(e);
+			Z.value = !0, Q = Ue(e);
 		}
-		function ze(e) {
-			Z.value && Le(e) && (Q = !0);
+		function Ge(e) {
+			Z.value && Ue(e) && (Q = !0);
 		}
-		function Be() {
-			Z.value && (Z.value = !1, Q && Y("pointer"));
+		function Ke() {
+			Z.value && (Z.value = !1, Q && He("pointer"));
 		}
-		function Ve() {
+		function qe() {
 			Z.value = !1;
 		}
-		function He(e) {
+		function Je(e) {
 			if (j.value === "24h") {
-				R(d(23, (t) => (I.value + e * t + 24) % 24, N));
+				R(f(23, (t) => (I.value + e * t + 24) % 24, N));
 				return;
 			}
-			let t = l(I.value).hour;
-			R(d(11, (n) => u((t - 1 + e * n + 12) % 12 + 1, G.value), N));
+			let t = u(I.value).hour;
+			R(f(11, (n) => d((t - 1 + e * n + 12) % 12 + 1, K.value), N));
 		}
-		function Ue(e) {
-			return j.value === "24h" ? d(24, (t) => e === "first" ? t - 1 : 24 - t, N) : d(12, (t) => u(e === "first" ? t : 13 - t, G.value), N);
+		function Ye(e) {
+			return j.value === "24h" ? f(24, (t) => e === "first" ? t - 1 : 24 - t, N) : f(12, (t) => d(e === "first" ? t : 13 - t, K.value), N);
 		}
 		function $(e, t) {
-			let n = p(O.minuteStep), r = (e) => f(I.value, e, M.value);
-			return r(e) ? e : d(Math.ceil(60 / n), (r) => c(e + t * r * n, n), r);
+			let n = de(O.minuteStep), r = ((L.value + e * t) % 60 + 60) % 60, i = n.length, a = e > 0 ? 0 : i - 1;
+			for (let t = 0; t < i; t += 1) {
+				let o = e > 0 ? t : i - 1 - t;
+				if (e > 0 ? n[o] >= r : n[o] <= r) {
+					a = o;
+					break;
+				}
+			}
+			return f(i, (t) => n[((a + e * (t - 1)) % i + i) % i], (e) => p(I.value, e, M.value));
 		}
-		function We(e) {
+		function Xe(e) {
+			if (O.disabled) return;
 			if (e.key === "Enter" || e.key === " ") {
-				e.preventDefault(), Y("keyboard");
+				e.preventDefault(), He("keyboard");
 				return;
 			}
 			let t = e.key === "ArrowUp" || e.key === "ArrowRight" ? 1 : e.key === "ArrowDown" || e.key === "ArrowLeft" ? -1 : 0;
 			if (P.value === "hour") {
-				if (t) He(t);
-				else if (e.key === "Home") R(Ue("first"));
-				else if (e.key === "End") R(Ue("last"));
+				if (t) Je(t);
+				else if (e.key === "Home") R(Ye("first"));
+				else if (e.key === "End") R(Ye("last"));
 				else return;
 				e.preventDefault();
 				return;
 			}
-			if (t) z($(c(L.value + t * O.minuteStep, O.minuteStep), t));
-			else if (e.key === "PageUp") z($(c(L.value + 5, O.minuteStep), 1));
-			else if (e.key === "PageDown") z($(c(L.value - 5, O.minuteStep), -1));
-			else if (e.key === "Home") z(se(I.value, M.value)[0] ?? null);
-			else if (e.key === "End") z(se(I.value, M.value).at(-1) ?? null);
+			if (t) z($(t, 1));
+			else if (e.key === "PageUp") z($(1, 5));
+			else if (e.key === "PageDown") z($(-1, 5));
+			else if (e.key === "Home") z(ce(I.value, M.value)[0] ?? null);
+			else if (e.key === "End") z(ce(I.value, M.value).at(-1) ?? null);
 			else return;
 			e.preventDefault();
 		}
@@ -197,23 +219,23 @@ var _e = [
 		}), (e, t) => (S(), h("div", {
 			class: "v-time-picker",
 			role: "group",
-			"aria-label": T(Ee),
+			"aria-label": T(Me),
 			"data-step": P.value,
 			"data-disabled": y.disabled ? "" : void 0,
 			"data-readonly": y.readonly ? "" : void 0
 		}, [
-			g("div", ve, [g("div", ye, [
-				v(n, {
+			g("div", we, [g("div", Te, [
+				v(r, {
 					class: "v-time-picker-cell",
 					variant: "ghost",
 					size: "lg",
 					tone: P.value === "hour" ? "accent" : "neutral",
 					"aria-pressed": P.value === "hour" ? "true" : "false",
-					"aria-label": T(A).timePicker.selectHour,
+					"aria-label": `${W.value}, ${T(A).timePicker.selectHour}`,
 					disabled: y.disabled,
 					onClick: t[0] ||= (e) => V("hour")
 				}, {
-					default: E(() => [_(w(Ne.value), 1)]),
+					default: E(() => [_(w(W.value), 1)]),
 					_: 1
 				}, 8, [
 					"tone",
@@ -225,17 +247,17 @@ var _e = [
 					class: "v-time-picker-sep",
 					"aria-hidden": "true"
 				}, ":", -1),
-				v(n, {
+				v(r, {
 					class: "v-time-picker-cell",
 					variant: "ghost",
 					size: "lg",
 					tone: P.value === "minute" ? "accent" : "neutral",
 					"aria-pressed": P.value === "minute" ? "true" : "false",
-					"aria-label": T(A).timePicker.selectMinutes,
+					"aria-label": `${T(s)(L.value)}, ${T(A).timePicker.selectMinutes}`,
 					disabled: y.disabled,
 					onClick: t[1] ||= (e) => V("minute")
 				}, {
-					default: E(() => [_(w(T(o)(L.value)), 1)]),
+					default: E(() => [_(w(T(s)(L.value)), 1)]),
 					_: 1
 				}, 8, [
 					"tone",
@@ -243,10 +265,10 @@ var _e = [
 					"aria-label",
 					"disabled"
 				])
-			]), j.value === "12h" ? (S(), fe(i, {
+			]), j.value === "12h" ? (S(), ge(a, {
 				key: 0,
-				modelValue: K.value,
-				"onUpdate:modelValue": t[2] ||= (e) => K.value = e,
+				modelValue: q.value,
+				"onUpdate:modelValue": t[2] ||= (e) => q.value = e,
 				class: "v-time-picker-meridiem",
 				mandatory: "",
 				variant: "outline",
@@ -256,21 +278,21 @@ var _e = [
 				label: T(A).timePicker.meridiem,
 				disabled: y.disabled || y.readonly
 			}, {
-				default: E(() => [v(a, {
+				default: E(() => [v(o, {
 					value: "AM",
 					label: T(A).timePicker.am,
-					disabled: !q.value.AM
-				}, null, 8, ["label", "disabled"]), v(a, {
+					disabled: !J.value.AM
+				}, null, 8, ["label", "disabled"]), v(o, {
 					value: "PM",
 					label: T(A).timePicker.pm,
-					disabled: !q.value.PM
+					disabled: !J.value.PM
 				}, null, 8, ["label", "disabled"])]),
 				_: 1
 			}, 8, [
 				"modelValue",
 				"label",
 				"disabled"
-			])) : pe("", !0)]),
+			])) : _e("", !0)]),
 			g("div", {
 				ref_key: "faceEl",
 				ref: X,
@@ -278,42 +300,42 @@ var _e = [
 				tabindex: y.disabled ? -1 : 0,
 				class: "v-time-picker-face",
 				"aria-label": P.value === "hour" ? T(A).timePicker.hour : T(A).timePicker.minutes,
-				"aria-valuemin": Pe.value,
-				"aria-valuemax": Fe.value,
-				"aria-valuenow": J.value,
-				"aria-valuetext": Ie.value,
+				"aria-valuemin": ze.value,
+				"aria-valuemax": Be.value,
+				"aria-valuenow": Y.value,
+				"aria-valuetext": Ve.value,
 				"data-dragging": Z.value ? "" : void 0,
 				"aria-disabled": y.disabled ? "true" : void 0,
 				"aria-readonly": y.readonly ? "true" : void 0,
-				onPointerdown: Re,
-				onPointermove: ze,
-				onPointerup: Be,
-				onPointercancel: Ve,
-				onKeydown: We
+				onPointerdown: We,
+				onPointermove: Ge,
+				onPointerup: Ke,
+				onPointercancel: qe,
+				onKeydown: Xe
 			}, [
 				g("div", {
 					class: "v-time-picker-hand",
 					"aria-hidden": "true",
-					"data-ring": je.value,
-					"data-minor": Me.value ? "" : void 0,
-					style: x({ "--dial-turn": String(Ae.value) })
-				}, null, 12, xe),
+					"data-ring": Le.value,
+					"data-minor": Re.value ? "" : void 0,
+					style: x({ "--dial-turn": String(Ie.value) })
+				}, null, 12, De),
 				t[4] ||= g("span", {
 					class: "v-time-picker-center",
 					"aria-hidden": "true"
 				}, null, -1),
-				(S(!0), h(de, null, me(ke.value, (e) => (S(), h("span", {
+				(S(!0), h(he, null, ye(Fe.value, (e) => (S(), h("span", {
 					key: e.key,
 					class: "v-time-picker-number",
 					"aria-hidden": "true",
 					"data-ring": e.ring,
 					"data-selected": e.selected ? "" : void 0,
 					style: x({ "--dial-turn": String(e.turn) })
-				}, w(e.label), 13, Se))), 128))
-			], 40, be),
-			g("div", Ce, w(B.value), 1),
-			e.$slots.footer ? (S(), h("div", we, [he(e.$slots, "footer")])) : pe("", !0)
-		], 8, _e));
+				}, w(e.label), 13, Oe))), 128))
+			], 40, Ee),
+			g("div", ke, w(B.value), 1),
+			e.$slots.footer ? (S(), h("div", Ae, [be(e.$slots, "footer")])) : _e("", !0)
+		], 8, Ce));
 	}
 });
 //#endregion