Input

Report whether the host window currently has focus. Use it to decide whether a foreground-only UI action should run. This reports window focus, not whether a script or network request has finished.

Press and release the key identified by its numeric key code. Use it for one complete key tap without leaving the key held. Kawaii accepts numeric virtual-key codes; this does not enter an arbitrary text string.

Press and hold the key identified by its numeric key code. Use it to represent the beginning of a held key in a local input interaction. Pair it with keyrelease for the same code; keyclick is the shorter form for a complete tap.

Release the key identified by its numeric key code. Use it to end a hold started by keypress. Releasing a key is a separate action from pressing it and should be part of cleanup for an input interaction.

Show a message dialog and return the result code for the selected button. Use it for a short notice or a dialog whose selected button controls the next step. Read the numeric result rather than testing it as a boolean.

Press and release the primary mouse button. Use it for a single primary click at the current pointer position. Move the pointer separately when a specific location is required.

Press and hold the primary mouse button. Use it to begin a held primary mouse-button interaction. Pair it with mouse1release so the button is not left held.

Release the primary mouse button. Use it to finish a primary mouse-button hold begun by mouse1press. This is the release portion of an interaction rather than a complete click.

Press and release the secondary mouse button. Use it for a single secondary click at the current pointer position. Move the pointer separately when a specific location is required.

Press and hold the secondary mouse button. Use it to begin a held secondary mouse-button interaction. Pair it with mouse2release so the button is not left held.

Release the secondary mouse button. Use it to finish a secondary mouse-button hold begun by mouse2press. This is the release portion of an interaction rather than a complete click.

Move the pointer to the supplied absolute coordinates. Use it when a local input interaction needs a known pointer destination. This changes the position without pressing a mouse button.

Move the pointer by an offset from its current position. Use it to adjust the pointer relative to where it already is. Positive or negative offsets choose the direction; no button is pressed by this call.

Submit a mouse-wheel scroll amount to the input bridge. Use it to submit a wheel movement to a focused local interface. The receiving control decides how that movement changes its scroll position.

Replace the system clipboard text with the supplied string. Use it for a Copy action that exports a short result, generated text, or settings JSON. The copied value replaces the previous clipboard text.