Function finalizeBoundKeyboard

finalizeBoundKeyboard(
    bindingsArray: BaseBoundKeyEntry[],
    actionKeysMap: Map<string, string[]>,
    layer: KeyboardLayerWithBindings,
    entry: BaseBoundKeyEntry,
    handler: string | KeyHandler,
    keys: string[],
    options?: BoundKeyboardOptions,
    onRelease?: () => void,
): () => void
Finalize a bound keyboard entry: register action-key mappings (when the handler is a string action ID), create an unbind closure that cleans up the binding and global-key overrides, and optionally wrap the handler with times/once lifecycle.

Extracted from KeyboardEngine.boundKeyboard to eliminate the duplicate block that previously appeared identically in both the focus‑target and layer‑level branches.
Parameters
- bindingsArray: BaseBoundKeyEntry[]
  The array the entry was pushed into (ScreenKeyboardLayer.bindings or focus‑target bindings).
- actionKeysMap: Map<string, string[]>
  The corresponding action‑keys map.
- layer: KeyboardLayerWithBindings
  The enclosing screen keyboard layer.
- entry: BaseBoundKeyEntry
  The binding entry just created.
- handler: string | KeyHandler
  Original handler (function or action‑ID string).
- keys: string[]
  Normalized key names.
- Optionaloptions: BoundKeyboardOptions
  Original BoundKeyboardOptions.
- OptionalonRelease: () => void
  Runs after the entry is removed, on every unbind path — including the once/times self-unbind that bypasses the returned closure. Must be idempotent, since both paths can fire for one binding.
Returns () => void
An unbind function that reverses the registration.
- Defined in src/keyboard-engine/src/providers/helpers.ts:314

Function finalizeBoundKeyboard

Parameters

Returns () => void

Settings