33 lines
1.4 KiB
TypeScript
33 lines
1.4 KiB
TypeScript
|
"use client";
|
||
|
|
|
||
|
|
/**
|
||
|
|
* FOCUS HYGIENE — transient transcript controls don't keep focus
|
||
|
|
* (owner, keyboard round 2026-10-10). A pointer click on a thinking
|
||
|
|
* toggle, a copy button, a plan chip used to LEAVE focus on that
|
||
|
|
* button; the learner's next Enter then re-activated the toggle
|
||
|
|
* instead of submitting (see enter-submits.ts for the other half of
|
||
|
|
* the fix). Here we restore, after pointer activation, exactly the
|
||
|
|
* state clicking empty transcript space produces: focus falls back to
|
||
|
|
* the body — Enter submits, arrows cycle the question rows, nothing
|
||
|
|
* re-toggles. Deliberately NOT a focus-into-a-text-field: a focused
|
||
|
|
* field would own the arrows as caret moves, against the arrows-always
|
||
|
|
* law (owner, 2026-10-10).
|
||
|
|
*
|
||
|
|
* Keyboard-activated clicks are untouched: e.detail === 0 marks the
|
||
|
|
* synthesized click of Enter/Space on a keyboard-focused button — the
|
||
|
|
* keyboard user keeps their focus.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/** Attach as (or compose into) a transient control's onClick: blurs the
|
||
|
|
* control after POINTER clicks (keyboard clicks keep focus). Node-safe
|
||
|
|
* duck-typing — no HTMLElement global needed (the test harness runs
|
||
|
|
* bare node with linkedom). */
|
||
|
|
export function blurAfterPointerClick(e: {
|
||
|
|
detail: number;
|
||
|
|
currentTarget: EventTarget | null;
|
||
|
|
}): void {
|
||
|
|
if (e.detail === 0) return;
|
||
|
|
const el = e.currentTarget as { blur?: unknown } | null;
|
||
|
|
if (el && typeof el.blur === "function") (el.blur as () => void).call(el);
|
||
|
|
}
|