@reliability-design/web 1.4.5 → 1.4.6

package/dist/components/rel-time-picker/rel-time-picker.ts

@@ -1,7 +1,10 @@
 import { LitElement, html, css, nothing } from "lit";
 import { customElement, property, state, query } from "lit/decorators.js";
+import { live } from "lit/directives/live.js";
 import "@reliability-design/icons/rel-icon";
 import "../rel-button/rel-button";
+import { parseTimeInput } from "./time-parse";
+import { announce } from "../../utils/announce";
 
 type TimeColumn = "hour" | "minute" | "second" | "period";
 
@@ -62,10 +65,21 @@ export class RelTimePicker extends LitElement {
   @state() private draftHour: number | null = null;
   @state() private draftMinute: number | null = null;
   @state() private draftSecond: number | null = null;
-  /** Panel opens above the field when there is no viewport space below. */
-  @state() private openUp = false;
+  /** Uncommitted typed text; null → the input shows the committed value. */
+  @state() private inputText: string | null = null;
+  /** Parse/range error message for the typed text (cleared on next input). */
+  @state() private inputError: string | null = null;
 
-  @query(".trigger-button") private triggerButton?: HTMLButtonElement;
+  /**
+   * Whether the next popover open should move focus into the columns.
+   * Icon-click / ArrowDown / external `open` do (previous behavior); opening
+   * by clicking into the text input must NOT, or typing would be impossible.
+   */
+  private focusPanelOnOpen = true;
+
+  @query(".trigger-input") private triggerInput?: HTMLInputElement;
+  @query(".trigger-button") private triggerButton?: HTMLElement;
+  @query(".popover") private popoverElement?: HTMLElement;
   @query(".columns") private columnsElement?: HTMLElement;
 
   static styles = css`
@@ -129,6 +143,11 @@ export class RelTimePicker extends LitElement {
       color: var(--rel-text-danger);
     }
 
+    /* Persistent live region — out of flow while empty so it adds no gap. */
+    .time-picker-support.empty {
+      position: absolute;
+    }
+
     .trigger-button {
       width: 100%;
       min-width: 160px;
@@ -151,28 +170,48 @@ export class RelTimePicker extends LitElement {
       letter-spacing: var(--rel-body-md-regular-letter-spacing);
     }
 
-    .trigger-button:hover:not(:disabled) {
+    :host(:not([disabled])) .trigger-button:hover {
       border-color: var(--rel-border-strong);
     }
 
-    .trigger-button:focus-visible {
+    .trigger-button:focus-within {
       outline: 2px solid var(--rel-border-focus);
       outline-offset: 2px;
       border-color: var(--rel-border-focus);
     }
 
-    .trigger-button:disabled {
+    :host([disabled]) .trigger-button {
       cursor: not-allowed;
       background: var(--rel-bg-surface-elevated);
     }
 
+    /* The editable field itself — the wrapper carries the box styles. */
+    .trigger-input {
+      flex: 1;
+      min-width: 0;
+      border: none;
+      background: transparent;
+      padding: 0;
+      margin: 0;
+      outline: none;
+      color: var(--rel-text-default);
+      font: inherit;
+      letter-spacing: inherit;
+      cursor: inherit;
+    }
+
+    .trigger-input::placeholder {
+      color: var(--rel-text-placeholder);
+      opacity: 1;
+    }
+
     /* Error state */
     .trigger-button.error,
-    .trigger-button.error:hover:not(:disabled) {
+    :host(:not([disabled])) .trigger-button.error:hover {
       border-color: var(--rel-border-danger);
     }
 
-    .trigger-button.error:focus-visible {
+    .trigger-button.error:focus-within {
       outline-color: var(--rel-border-danger);
       border-color: var(--rel-border-danger);
     }
@@ -196,15 +235,6 @@ export class RelTimePicker extends LitElement {
       letter-spacing: var(--rel-body-lg-regular-letter-spacing);
     }
 
-    .trigger-content {
-      flex: 1;
-      color: var(--rel-text-default);
-    }
-
-    .trigger-content.placeholder {
-      color: var(--rel-text-placeholder);
-    }
-
     .trigger-icons {
       display: flex;
       align-items: center;
@@ -237,17 +267,34 @@ export class RelTimePicker extends LitElement {
 
     /* Panel (Figma "Time Picker"): fixed width per size, full-bleed content. */
     .popover {
+      /* Reset native [popover] UA styles first (the panel is promoted to
+         the top layer so a drawer/sheet/modal ancestor — transformed,
+         overflow:hidden, or an equal-z-index sibling panel — can't clip it
+         or paint over it). While in the top layer, JS overrides the
+         anchored position below with inline fixed coordinates; the CSS
+         anchoring is the no-Popover-API fallback. */
+      margin: 0;
+      padding: 0;
+      height: auto;
+      inset: auto;
+      color: inherit;
       position: absolute;
       top: calc(100% + 4px);
       left: 0;
-      z-index: 1000;
+      z-index: 2147483647;
       background: var(--rel-bg-surface);
       border: 1px solid var(--rel-border-subtle);
       border-radius: var(--rel-border-radius-sm);
       box-shadow: var(--rel-shadows-shadow-300);
-      overflow: hidden;
-      min-width: 220px;
+      /* Never wider or taller than the viewport (small screens). border-box
+         so the Figma widths and viewport caps include the 1px borders. */
+      box-sizing: border-box;
+      overflow-x: hidden;
+      overflow-y: auto;
+      min-width: min(220px, calc(100vw - 16px));
       width: 250px;
+      max-width: calc(100vw - 16px);
+      max-height: calc(100vh - 16px);
       display: none;
     }
 
@@ -255,10 +302,53 @@ export class RelTimePicker extends LitElement {
       display: block;
     }
 
-    /* Flip above the field when the viewport has no room below. */
-    .popover.open-up {
-      top: auto;
-      bottom: calc(100% + 4px);
+    /* Typed-shortcut hints ("N → Now"); each chip applies its value. */
+    .shortcut-row {
+      display: flex;
+      flex-wrap: wrap;
+      gap: var(--rel-spacing-2xs);
+      padding: var(--rel-spacing-2xs) var(--rel-spacing-xs);
+      border-bottom: 1px solid var(--rel-border-subtle);
+    }
+
+    .shortcut-chip {
+      display: inline-flex;
+      align-items: center;
+      gap: var(--rel-spacing-2xs);
+      border: none;
+      background: transparent;
+      border-radius: var(--rel-border-radius-xs);
+      padding: var(--rel-spacing-3xs) var(--rel-spacing-2xs);
+      cursor: pointer;
+      color: var(--rel-text-default);
+      transition: background 0.15s ease;
+      font-family: var(--rel-body-xs-regular-font-family);
+      font-weight: var(--rel-body-xs-regular-font-weight);
+      font-size: var(--rel-body-xs-regular-font-size);
+      line-height: var(--rel-body-xs-regular-line-height);
+      letter-spacing: var(--rel-body-xs-regular-letter-spacing);
+    }
+
+    .shortcut-chip:hover {
+      background: var(--rel-bg-neutral-elevated-1);
+    }
+
+    .shortcut-chip:focus-visible {
+      outline: 2px solid var(--rel-border-focus);
+      outline-offset: -2px;
+    }
+
+    .shortcut-chip kbd {
+      border: 1px solid var(--rel-border-default);
+      border-bottom-width: 2px;
+      border-radius: var(--rel-border-radius-xs);
+      background: var(--rel-bg-surface-elevated);
+      padding: 0 var(--rel-spacing-3xs);
+      min-width: 18px;
+      text-align: center;
+      font-family: inherit;
+      font-size: inherit;
+      color: var(--rel-text-label);
     }
 
     /* Full-bleed column row with 1px dividers (Figma "Columns"). */
@@ -439,13 +529,17 @@ export class RelTimePicker extends LitElement {
     super.disconnectedCallback();
     document.removeEventListener("click", this.handleClickOutside);
     document.removeEventListener("keydown", this.handleEscapeKey);
+    window.removeEventListener("resize", this.onReposition);
+    window.removeEventListener("scroll", this.onReposition, true);
+    this.hideTopLayer();
   }
 
   private handleClickOutside = (e: MouseEvent) => {
     if (!this.open) return;
     const path = e.composedPath();
     if (!path.includes(this)) {
-      this.cancelPopover();
+      // Don't refocus the field — the user clicked somewhere else on purpose.
+      this.cancelPopover(false);
     }
   };
 
@@ -455,39 +549,131 @@ export class RelTimePicker extends LitElement {
     }
   };
 
+  // `open` is a public reflected property (consumers may set it directly,
+  // not only via the trigger), so top-layer promotion syncs here rather
+  // than inside toggle/cancel.
   updated(changedProperties: Map<string, any>) {
     if (changedProperties.has("open")) {
       if (!this.open) {
-        this.openUp = false;
+        window.removeEventListener("resize", this.onReposition);
+        window.removeEventListener("scroll", this.onReposition, true);
+        this.hideTopLayer();
+        this.focusPanelOnOpen = true;
         return;
       }
       this.resetDraftFromValue();
-      // Once the popover has rendered: flip it above the field if the
-      // viewport lacks room below, center each column's selection, and focus
-      // the selected (or first enabled) hour without scrolling the page.
+      this.showTopLayer();
+      window.addEventListener("resize", this.onReposition);
+      window.addEventListener("scroll", this.onReposition, true);
+      // Once the popover has rendered: center each column's selection, and —
+      // unless the open came from clicking into the text input (typing must
+      // keep working) — focus the selected hour without scrolling the page.
+      const focusPanel = this.focusPanelOnOpen;
+      this.focusPanelOnOpen = true;
       setTimeout(() => {
-        this.updatePanelPlacement();
         this.scrollColumnsToSelection();
-        const target =
-          this.columnsElement?.querySelector<HTMLButtonElement>(
-            ".option-button.selected:not(:disabled)"
-          ) ??
-          this.columnsElement?.querySelector<HTMLButtonElement>(
-            ".option-button:not(:disabled)"
-          );
-        target?.focus({ preventScroll: true });
+        if (focusPanel) this.focusPanelSelection();
       }, 0);
     }
   }
 
-  /** Open upward when the panel doesn't fit below but does fit above. */
-  private updatePanelPlacement() {
-    const panel = this.renderRoot.querySelector<HTMLElement>(".popover");
-    if (!panel) return;
-    const rect = this.getBoundingClientRect();
-    const panelHeight = panel.offsetHeight;
-    const spaceBelow = window.innerHeight - rect.bottom;
-    this.openUp = spaceBelow < panelHeight + 8 && rect.top > panelHeight + 8;
+  /* A drawer/sheet/modal ancestor breaks the anchored panel two ways: a
+   * transform makes it the containing block for position:fixed descendants
+   * (and overflow:hidden clips absolute ones), and an equal-z-index panel
+   * later in the DOM paints over the columns. Promoting the panel to the
+   * browser top layer sidesteps both — same fix as rel-popover /
+   * rel-autocomplete / rel-select / rel-range-picker / rel-date-picker.
+   * `manual` keeps outside-click and Escape handling under this component's
+   * own control. While in the top layer the CSS anchoring is meaningless, so
+   * the panel gets inline fixed coordinates from updatePopoverPosition()
+   * (which also replaces the old .open-up CSS flip). */
+
+  private showTopLayer() {
+    const el = this.popoverElement;
+    if (el && typeof el.showPopover === "function") {
+      try {
+        if (!el.matches(":popover-open")) el.showPopover();
+      } catch {
+        /* older engines / detached element — CSS fallback applies */
+      }
+    }
+    requestAnimationFrame(() => this.updatePopoverPosition());
+  }
+
+  private hideTopLayer() {
+    const el = this.popoverElement;
+    if (!el) return;
+    if (typeof el.hidePopover === "function") {
+      try {
+        if (el.matches(":popover-open")) el.hidePopover();
+      } catch {
+        /* already hidden or unsupported — nothing to do */
+      }
+    }
+    el.style.position = "";
+    el.style.top = "";
+    el.style.left = "";
+    el.style.maxHeight = "";
+  }
+
+  private onReposition = () => {
+    if (this.open) this.updatePopoverPosition();
+  };
+
+  private updatePopoverPosition = () => {
+    const panel = this.popoverElement;
+    const anchor = this.triggerButton;
+    if (!panel || !anchor || !this.open) return;
+
+    const t = anchor.getBoundingClientRect();
+    // Measure the natural height, clearing any cap from a previous pass.
+    panel.style.maxHeight = "";
+    const c = panel.getBoundingClientRect();
+
+    // Below the trigger; flip above when there's no room below. Either side
+    // keeps the same 4px gap to the field (above, the panel may cover the
+    // label) and the panel shrinks to the available space — columns scroll —
+    // rather than sliding over the trigger. 8px viewport margin on every edge.
+    const spaceBelow = Math.max(0, window.innerHeight - 8 - (t.bottom + 4));
+    const spaceAbove = Math.max(0, t.top - 4 - 8);
+    let top: number;
+    if (c.height <= spaceBelow || spaceBelow >= spaceAbove) {
+      panel.style.maxHeight = `${Math.min(c.height, spaceBelow)}px`;
+      top = t.bottom + 4;
+    } else {
+      const height = Math.min(c.height, spaceAbove);
+      panel.style.maxHeight = `${height}px`;
+      top = t.top - 4 - height;
+    }
+    let left = t.left;
+    if (left + c.width > window.innerWidth - 8) {
+      left = window.innerWidth - c.width - 8;
+    }
+    left = Math.max(8, left);
+
+    // Without top-layer support a transformed ancestor may be the containing
+    // block for position:fixed, shifting the panel away from the viewport
+    // coordinates computed above. Apply, re-measure, and cancel the offset.
+    panel.style.position = "fixed";
+    panel.style.top = `${top}px`;
+    panel.style.left = `${left}px`;
+    const applied = panel.getBoundingClientRect();
+    top -= applied.top - top;
+    left -= applied.left - left;
+    panel.style.top = `${top}px`;
+    panel.style.left = `${left}px`;
+  };
+
+  /** Focus the selected (or first enabled) option in the columns. */
+  private focusPanelSelection() {
+    const target =
+      this.columnsElement?.querySelector<HTMLButtonElement>(
+        ".option-button.selected:not(:disabled)"
+      ) ??
+      this.columnsElement?.querySelector<HTMLButtonElement>(
+        ".option-button:not(:disabled)"
+      );
+    target?.focus({ preventScroll: true });
   }
 
   // ── Parsing / formatting ──
@@ -637,9 +823,9 @@ export class RelTimePicker extends LitElement {
   }
 
   /** Close discarding the draft (Cancel / Escape / outside click). */
-  private cancelPopover() {
+  private cancelPopover(refocus = true) {
     this.open = false;
-    this.triggerButton?.focus();
+    if (refocus) this.triggerInput?.focus();
     this.dispatchEvent(
       new CustomEvent("rel-open-change", {
         detail: { open: false },
@@ -651,12 +837,20 @@ export class RelTimePicker extends LitElement {
 
   private applySelection() {
     if (this.draftHour === null) return;
-    const newValue = this.formatValue(
-      this.draftHour,
-      this.draftMinute ?? 0,
-      this.draftSecond ?? 0
-    );
+    const hour = this.draftHour;
+    const minute = this.draftMinute ?? 0;
+    const second = this.draftSecond ?? 0;
+    this.commitTime(hour, minute, second);
+    announce(`${this.formatDisplay(hour, minute, second)} selected`);
+    this.cancelPopover();
+  }
+
+  /** Commit a time: set value, reset typed text/error, fire rel-change. */
+  private commitTime(hour: number, minute: number, second: number) {
+    const newValue = this.formatValue(hour, minute, second);
     this.value = newValue;
+    this.inputText = null;
+    this.inputError = null;
     this.dispatchEvent(
       new CustomEvent("rel-change", {
         detail: { value: newValue },
@@ -664,7 +858,6 @@ export class RelTimePicker extends LitElement {
         composed: true,
       })
     );
-    this.cancelPopover();
   }
 
   /** Set the draft to the current time, snapped to the minute step and range. */
@@ -698,6 +891,8 @@ export class RelTimePicker extends LitElement {
     this.draftHour = null;
     this.draftMinute = null;
     this.draftSecond = null;
+    this.inputText = null;
+    this.inputError = null;
     this.dispatchEvent(
       new CustomEvent("rel-change", {
         detail: { value: null },
@@ -707,6 +902,73 @@ export class RelTimePicker extends LitElement {
     );
   }
 
+  // ── Typed keyboard entry ──
+
+  /**
+   * Parse and commit the typed text (Enter / blur). Invalid or out-of-range
+   * text keeps the field in an error state with the text preserved for
+   * correction; the committed value is untouched (Escape reverts the text).
+   */
+  private commitTypedValue() {
+    if (this.inputText === null) return; // nothing typed since last commit
+    const text = this.inputText.trim();
+
+    if (!text) {
+      // Field cleared by keyboard — behaves like the clear button.
+      this.inputText = null;
+      this.inputError = null;
+      if (this.value !== null) {
+        this.value = null;
+        this.dispatchEvent(
+          new CustomEvent("rel-change", {
+            detail: { value: null },
+            bubbles: true,
+            composed: true,
+          })
+        );
+      }
+      if (this.open) this.cancelPopover();
+      return;
+    }
+
+    const parsed = parseTimeInput(text);
+    if (!parsed) {
+      this.inputError = "Invalid time";
+      return;
+    }
+
+    if (parsed.kind === "now") {
+      this.applyNowShortcut();
+      return;
+    }
+
+    if (!this.isTimeInRange(parsed.hour, parsed.minute)) {
+      this.inputError = "Time out of range";
+      return;
+    }
+
+    // Typed entry accepts exact minutes/seconds (not limited to minuteStep).
+    this.commitTime(parsed.hour, parsed.minute, this.seconds ? parsed.second : 0);
+    if (this.open) this.cancelPopover();
+  }
+
+  /** "Now", committed directly (N shortcut / popover chip), clamped to range. */
+  private applyNowShortcut() {
+    const now = new Date();
+    let hour = now.getHours();
+    let minute = now.getMinutes();
+    const total = this.toMinutes(hour, minute);
+    if (total < this.minBoundMinutes) {
+      hour = Math.floor(this.minBoundMinutes / 60);
+      minute = this.minBoundMinutes % 60;
+    } else if (total > this.maxBoundMinutes) {
+      hour = Math.floor(this.maxBoundMinutes / 60);
+      minute = this.maxBoundMinutes % 60;
+    }
+    this.commitTime(hour, minute, this.seconds ? now.getSeconds() : 0);
+    if (this.open) this.cancelPopover();
+  }
+
   // ── Column selection ──
 
   private selectHour(hour24: number) {
@@ -796,15 +1058,82 @@ export class RelTimePicker extends LitElement {
 
   // ── Keyboard ──
 
-  private handleTriggerKeydown(e: KeyboardEvent) {
-    if (e.key === "Enter" || e.key === " " || e.key === "ArrowDown") {
+  private handleInputInput(e: Event) {
+    this.inputText = (e.target as HTMLInputElement).value;
+    if (this.inputError) this.inputError = null;
+  }
+
+  private handleInputKeydown(e: KeyboardEvent) {
+    if (e.key === "Enter") {
+      e.preventDefault();
+      if (this.inputText === null) {
+        // Nothing typed — Enter toggles the popover (previous trigger behavior).
+        if (!this.open) {
+          this.toggleTimePopover();
+        } else {
+          this.applySelection();
+        }
+      } else {
+        this.commitTypedValue();
+      }
+      return;
+    }
+    if (e.key === "ArrowDown") {
       e.preventDefault();
       if (!this.open) {
         this.toggleTimePopover();
+      } else {
+        this.focusPanelSelection();
       }
+      return;
+    }
+    if (e.key === "Escape" && this.inputText !== null) {
+      // Revert the typed text; the document listener closes the popover.
+      this.inputText = null;
+      this.inputError = null;
     }
   }
 
+  /** Clicking anywhere on the field opens the popover, keeping focus typed-in. */
+  private handleFieldClick() {
+    if (this.open || this.disabled || this.readonly) return;
+    this.focusPanelOnOpen = false;
+    this.toggleTimePopover();
+  }
+
+  /** The clock icon toggles the popover with the previous focus behavior. */
+  private handleIconClick(e: Event) {
+    e.stopPropagation();
+    if (this.open) {
+      this.cancelPopover();
+    } else {
+      this.toggleTimePopover();
+    }
+  }
+
+  /** Commit typed text when focus leaves the component entirely. */
+  private handleInputBlur = (e: FocusEvent) => {
+    this.dispatchEvent(new CustomEvent("rel-blur", { bubbles: true, composed: true }));
+    const related = e.relatedTarget as Node | null;
+    if (related && (this.renderRoot.contains(related) || this.contains(related))) {
+      return; // focus moved into the panel/icons — their own handlers commit
+    }
+    this.commitTypedValue();
+  };
+
+  /** N inside the panel (columns/footer focus) applies Now directly. */
+  private handlePanelKeydown = (e: KeyboardEvent) => {
+    if (
+      (e.key === "n" || e.key === "N") &&
+      !e.ctrlKey &&
+      !e.metaKey &&
+      !e.altKey
+    ) {
+      e.preventDefault();
+      this.applyNowShortcut();
+    }
+  };
+
   /**
    * Column navigation: Up/Down move within the column (and select), Left/Right
    * jump between columns, Home/End go to the first/last option, Enter applies.
@@ -877,8 +1206,10 @@ export class RelTimePicker extends LitElement {
   // ── Render ──
 
   render() {
-    const isError = this.error || this.invalid;
-    const belowText = isError && this.errorMessage ? this.errorMessage : this.helperText;
+    const isError = this.error || this.invalid || this.inputError !== null;
+    const belowText = isError
+      ? this.errorMessage ?? this.inputError ?? this.helperText
+      : this.helperText;
     const describedById = belowText ? "time-picker-desc" : undefined;
     const parsedValue = this.parseTime(this.value);
     const displayText = parsedValue
@@ -911,33 +1242,39 @@ export class RelTimePicker extends LitElement {
           ? html`<input type="hidden" name=${this.name} .value=${this.value ?? ""} />`
           : nothing}
 
-        <button
+        <div
           part="trigger"
           class="trigger-button ${isError ? "error" : ""}"
-          type="button"
-          ?disabled=${this.disabled}
-          @click=${this.toggleTimePopover}
-          @keydown=${this.handleTriggerKeydown}
-          @focus=${() =>
-            this.dispatchEvent(
-              new CustomEvent("rel-focus", { bubbles: true, composed: true })
-            )}
-          @blur=${() =>
-            this.dispatchEvent(
-              new CustomEvent("rel-blur", { bubbles: true, composed: true })
-            )}
-          aria-label=${this.label || "Select time"}
-          aria-haspopup="dialog"
-          aria-expanded=${this.open}
-          aria-required=${this.required}
-          aria-invalid=${isError}
-          aria-readonly=${this.readonly}
-          aria-describedby=${describedById ?? nothing}
-          aria-labelledby=${this.label ? "time-picker-label" : nothing}
+          @click=${this.handleFieldClick}
         >
-          <span part="value" class="trigger-content ${displayText ? "" : "placeholder"}">
-            ${displayText || this.placeholder}
-          </span>
+          <input
+            part="value"
+            class="trigger-input"
+            type="text"
+            .value=${live(this.inputText ?? displayText)}
+            placeholder=${this.placeholder}
+            ?disabled=${this.disabled}
+            ?readonly=${this.readonly}
+            autocomplete="off"
+            spellcheck="false"
+            enterkeyhint="done"
+            @input=${this.handleInputInput}
+            @keydown=${this.handleInputKeydown}
+            @focus=${() =>
+              this.dispatchEvent(
+                new CustomEvent("rel-focus", { bubbles: true, composed: true })
+              )}
+            @blur=${this.handleInputBlur}
+            role="combobox"
+            aria-label=${this.label || "Select time"}
+            aria-haspopup="dialog"
+            aria-expanded=${this.open}
+            aria-controls="time-picker-panel"
+            aria-required=${this.required}
+            aria-invalid=${isError}
+            aria-describedby=${describedById ?? nothing}
+            aria-labelledby=${this.label ? "time-picker-label" : nothing}
+          />
           <span class="trigger-icons">
             ${this.clearable && this.value
               ? html`
@@ -958,16 +1295,38 @@ export class RelTimePicker extends LitElement {
                   </button>
                 `
               : nothing}
-            <rel-icon part="icon" name="time-filled" size="sm"></rel-icon>
+            <button
+              class="icon-button"
+              type="button"
+              aria-label="Open time panel"
+              aria-expanded=${this.open}
+              ?disabled=${this.disabled}
+              @click=${this.handleIconClick}
+            >
+              <rel-icon part="icon" name="time-filled" size="sm"></rel-icon>
+            </button>
           </span>
-        </button>
+        </div>
 
         <div
           part="panel"
-          class="popover ${this.open ? "open" : ""} ${this.openUp ? "open-up" : ""}"
+          id="time-picker-panel"
+          class="popover ${this.open ? "open" : ""}"
+          popover="manual"
           role="dialog"
           aria-label="Choose time"
+          @keydown=${this.handlePanelKeydown}
         >
+          <div part="shortcuts" class="shortcut-row">
+            <button
+              class="shortcut-chip"
+              type="button"
+              title="Type N in the field for the current time"
+              @click=${() => this.applyNowShortcut()}
+            >
+              <kbd aria-hidden="true">N</kbd><span>Now</span>
+            </button>
+          </div>
           <div class="columns">
             <div class="column-list" role="listbox" aria-label="Hours">
               ${hourOptions.map(
@@ -1105,15 +1464,12 @@ export class RelTimePicker extends LitElement {
           </div>
         </div>
 
-        ${belowText
-          ? html`<div
-              part="helper"
-              class="time-picker-support ${isError ? "error" : ""}"
-              id=${describedById}
-            >
-              ${belowText}
-            </div>`
-          : nothing}
+        <div
+          part="helper"
+          class="time-picker-support ${isError ? "error" : ""} ${belowText ? "" : "empty"}"
+          id="time-picker-desc"
+          aria-live="polite"
+        >${belowText ?? nothing}</div>
       </div>
     `;
   }