Skip to content

Add inline completion (ghost text) coordination layer#375

Open
anxkhn wants to merge 1 commit into
CodeEditApp:mainfrom
anxkhn:feat/inline-completion
Open

Add inline completion (ghost text) coordination layer#375
anxkhn wants to merge 1 commit into
CodeEditApp:mainfrom
anxkhn:feat/inline-completion

Conversation

@anxkhn

@anxkhn anxkhn commented Jun 30, 2026

Copy link
Copy Markdown

Description

Adds an inline completion (ghost text) coordination layer to CodeEditSourceEditor, built on the inline suggestion rendering primitive in CodeEditTextView. It gives the editor a provider-agnostic way to request, show, accept, cycle, and dismiss inline AI suggestions (the GitHub Copilot UI pattern), without any host having to re-implement the lifecycle.

What's added:

  • InlineCompletionDelegate: a @MainActor protocol a host conforms to. inlineCompletionsRequested(textView:cursorPosition:) async -> [InlineCompletionItem] returns suggestions; optional inlineCompletionDidShow/Accept/Dismiss hooks report lifecycle.
  • InlineCompletionItem: the suggestion model (insert text and the range it applies to).
  • InlineCompletionTriggerModel plus TextViewController methods: requestInlineSuggestion() (debounced), setInlineSuggestions(_:selectedIndex:), acceptInlineSuggestion(), dismissInlineSuggestion(), selectNext/PreviousInlineSuggestion().

Behavior:

  • Requests are debounced and skipped while the completion popup is visible, so ghost text and the popup never appear at the same time.
  • Tab accepts when a suggestion is active; the accepted text is inserted via the text view.
  • Moving the cursor or editing dismisses the active ghost text.
  • Ghost text is rendered by the CodeEditTextView overlay primitive and never mutates text storage until the suggestion is explicitly accepted.

Related Issues

Checklist

  • I read and understood the contributing guide as well as the code of conduct
  • The issues this PR addresses are related to each other
  • My changes generate no new warnings
  • My code builds and runs on my machine
  • My changes are all related to the related issue above
  • I documented my code

Screenshots

This is the coordination layer; the user-visible ghost text is shown by the app-level integration in CodeEdit. Behavior here is covered by unit tests.

Testing

  • xcodebuild -scheme CodeEditSourceEditor -destination "platform=macOS,name=My Mac" clean test: the full suite passes, including the new InlineCompletionTests suite (request/show, accept, dismiss, cycling, Tab-accept gating, and ghost-text clearing on cursor move and edit), built against the CodeEditTextView change in [chore]: Update CodeEditLanguages to 0.1.9 #125.
  • SwiftLint: 0 violations (strict) on all changed files.

Add the inline completion plumbing that drives the CodeEditTextView ghost
text primitive. A delegate provides completion items, the controller
renders the selected item as ghost text anchored at the caret, and
keyboard shortcuts accept, dismiss, and cycle through items.

- InlineCompletionItem: Identifiable item holding insertText and the range
  it replaces on acceptance (an empty range is a pure insertion).
- InlineCompletionDelegate: @mainactor protocol to request items and observe
  the show, accept, and dismiss lifecycle, with default empty impls.
- InlineCompletionTriggerModel: requests after typing and clears stale ghost
  text, mirroring SuggestionTriggerCharacterModel.
- TextViewController+InlineCompletion: debounced single in-flight request,
  render, accept, dismiss, and next/previous cycling.
- Wire triggers and clears into didReplaceContentsIn and updateCursorPosition,
  and add Tab-accept, Escape-dismiss, and Option+]/[ cycling key handling.
- SourceEditor and TextViewController gain a weak inlineCompletionDelegate,
  forwarded exactly like completionDelegate.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Inline completion (ghost text) coordination layer

1 participant