ds-harness-remote-fast/apps/android/src/screens/chat/composer-gate.ts

128 lines
4.5 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/**
* Composer availability rules for the chat input.
*
* Editing is a local operation: a dropped carrier must never lock the
* `TextInput`, otherwise the draft cannot be continued while the Host is
* unreachable. Sending still requires the authenticated channel, so an offline
* tap must leave the draft untouched instead of entering the submit path that
* clears it before `sendMessage` runs.
*/
/** Reason a send attempt must not start. */
export type SubmitIntent = 'submit' | 'offline' | 'ignore'
export type SubmitGateInput = {
/** Authenticated Host channel (Harness/ACP/CodeX ready). */
connected: boolean
/** Connection plus per-backend readiness and no blocking session action. */
sendReady: boolean
permissionSelecting: boolean
/** A prompt upload is already in flight. */
uploading: boolean
/** Live draft/quotes/images/files produced by the caller, not the render closure. */
hasContent: boolean
}
export type ComposerEditGateInput = {
permissionSelecting: boolean
uploading: boolean
}
/**
* Editing stays available while the Host is unreachable; only composer-local
* blocking states (permission switch, in-flight upload) lock the input.
*/
export function composerEditable(input: ComposerEditGateInput): boolean {
return !input.permissionSelecting && !input.uploading
}
/**
* `offline` means the tap was deliberate but cannot be delivered: the caller
* must return before clearing the draft or creating an optimistic row.
*/
export function submitIntent(input: SubmitGateInput): SubmitIntent {
if (input.uploading || !input.hasContent) return 'ignore'
if (!input.connected) return 'offline'
if (!input.sendReady || input.permissionSelecting) return 'ignore'
return 'submit'
}
/**
* Blank sessions retain the data-policy note when vertical space allows,
* while active chats keep the bottom bar compact without extra footer lines.
*/
export function policyHintVisible(input: { showPolicyHint: boolean; compactComposer: boolean }): boolean {
return input.showPolicyHint && !input.compactComposer
}
export type QuickPromptActionMode = 'fill' | 'send'
export function isQuickPromptActionMode(value: unknown): value is QuickPromptActionMode {
return value === 'fill' || value === 'send'
}
/**
* Track whether the composer should promote from inline single-row mode
* (`[+] [Input] [⚡] [↑]`) to the two-row stacked layout (`[Input]` above
* `[+] ... [⚡] [↑]`). Uses overflow-length hysteresis so expanding to full
* pill width does not immediately shrink line height back to 1 line and flip-flop.
*/
export function nextStackedOverflowLength(input: {
draft: string
contentHeight: number
currentOverflowLength: number | null
}): number | null {
if (input.draft.length === 0) return null
if (input.contentHeight > 44) {
if (input.currentOverflowLength === null) {
return input.draft.length
}
return Math.min(input.currentOverflowLength, input.draft.length)
}
if (input.currentOverflowLength !== null) {
const exitThreshold = Math.max(1, input.currentOverflowLength - 2)
if (input.draft.length < exitThreshold) {
return null
}
}
return input.currentOverflowLength
}
export function shouldUseStackedComposer(input: {
draft: string
hasQuotes: boolean
overflowLength: number | null
}): boolean {
if (input.hasQuotes) return true
if (input.draft.length === 0) return false
if (input.draft.includes('\n')) return true
return input.overflowLength !== null && input.draft.length >= input.overflowLength
}
/**
* Show the top-right corner expand trigger only once a draft reaches 5+ lines
* inside the stacked composer so short 1–4 line pills remain uncluttered and
* the trigger stays cleanly separated above the bottom action bar.
*/
export function shouldShowExpandCorner(input: { draft: string; contentHeight: number }): boolean {
return input.draft.split('\n').length >= 5 || input.contentHeight > 110
}
/**
* Insert a quick prompt into an existing or empty draft and place the caret at the end.
*/
export function applyQuickPromptDraft(
currentDraft: string,
promptText: string,
): { draft: string; cursor: number } {
if (promptText.length === 0) {
return { draft: currentDraft, cursor: currentDraft.length }
}
const separator =
currentDraft.length === 0 || currentDraft.endsWith('\n') || currentDraft.endsWith(' ')
? ''
: (currentDraft.includes('\n') || promptText.includes('\n') ? '\n' : ' ')
const draft = `${currentDraft}${separator}${promptText}`
return { draft, cursor: draft.length }
}