01
구현된 기능
02
시작하기
- 저장소를 가져오고 README에서 공개 버전의 개발 상황과 구성을 확인합니다.
- just check로 프로젝트 검사를 실행하고 LanguageEditor와 TextContent 계약을 확인해 구현에 통합합니다.
Rust와 필요한 개발 도구를 준비하고, 도입 전에 링크된 README에서 환경 요구 사항을 확인하세요. 실행 예시는 기능의 시작점이며 모든 환경에서의 동작을 보장하지 않습니다.
근거use katana_language_editor::{LanguageEditor, TextContent};
pub fn set_markdown(editor: &mut impl LanguageEditor, markdown: &str) {
editor.set_content(TextContent {
text: markdown.to_owned(),
language: Some("markdown".to_owned()),
});
}01 / KLE
사용 장면
에디터 구현을 UI framework에서 분리하기
공개 neutral crate는 TextContent, CursorPosition, Selection, EditorEvent, LanguageEditor를 제공해 KatanA 측이 egui 타입을 직접 보유하지 않는 경계를 만듭니다. 입력 UI를 교체해도 호스트가 의존하는 trait 면을 유지할 수 있습니다.
egui MVP를 연결점으로 시험하기
katana-language-editor-egui는 EditorConfig를 받아 egui TextEdit을 렌더링하고 내용 변경을 ContentChanged 이벤트에 쌓습니다. 공개판은 scaffolding이며 Floem crate는 구현이 아니라 의존성과 trait 구현의 뼈대입니다.
02 / KLE
입력부터 출력까지
본문과 설정 전달하기
호스트는 TextContent에 본문과 language를 설정하고 EditorConfig에서 font size, line numbers, word wrap, tab size를 지정합니다. EguiLanguageEditor::set_content가 현재 본문을 교체합니다.
UI 입력을 이벤트로 변환하기
egui TextEdit의 response.changed()를 감지하면 구현은 현재 TextContent를 EditorEvent::ContentChanged로 만들어 pending queue에 쌓습니다. neutral crate는 egui의 Response 타입을 공개 계약으로 노출하지 않습니다.
호스트가 이벤트 회수하기
호스트는 LanguageEditor::poll_events()로 이벤트를 꺼내고 content()로 본문을 읽습니다. 공개 egui MVP의 cursor()는 default CursorPosition을 반환하므로 실제 cursor 동기화나 selection 연동을 완성 기능으로 취급할 수 없습니다.
03 / KLE
주요 API·CLI
TextContent — 편집 본문- text는 본문이고 language는 임의의 언어 식별자입니다. Markdown 등의 입력을 framework-neutral 데이터로 보유합니다.
CursorPosition과 Selection- CursorPosition은 line과 column, Selection은 start와 end 범위를 가집니다. 공개 타입은 존재하지만 egui MVP가 실제 cursor를 반환하는 것까지 구현된 것은 아닙니다.
EditorConfig — 표시 설정- font_size, line_numbers, word_wrap, tab_size를 지정합니다. egui 구현에서는 visible rows 계산에 사용되지만 완성된 편집 기능 전체를 나타내는 설정은 아닙니다.
LanguageEditor와 EditorEvent- content, set_content, cursor, poll_events가 host와의 trait 계약입니다. ContentChanged, CursorMoved, SelectionChanged가 이벤트 타입으로 정의되어 있습니다.
04 / KLE
구체적인 예
egui MVP에 Markdown 본문 설정하기
이 코드 예가 실행하는 것은 EditorConfig로 표시 설정을 만들고 EguiLanguageEditor에 TextContent를 설정한 뒤 본문을 읽는 것까지입니다. 실제 화면에 통합하는 host는 매 프레임 show(ui)를 호출하고 입력 후 poll_events()로 ContentChanged를 회수하는 처리를 추가해야 합니다.
use katana_language_editor::{EditorConfig, LanguageEditor, TextContent};
use katana_language_editor_egui::EguiLanguageEditor;
fn main() {
let mut editor = EguiLanguageEditor::new(EditorConfig {
font_size: Some(14.0),
line_numbers: true,
word_wrap: true,
tab_size: 4,
});
editor.set_content(TextContent {
text: "# KatanA\n".to_owned(),
language: Some("markdown".to_owned()),
});
println!("{}", editor.content().text);
}05 / KLE
통합 조건과 책임 경계
neutral crate를 먼저 의존하기
KatanA나 다른 host는 katana-language-editor의 trait와 DTO를 참조하고 UI 고유 crate는 adapter로 분리합니다. README가 설명하는 설계대로 egui에서 custom input surface로 이동할 때도 host 측의 중립 의존성을 유지합니다.
scaffolding 범위에서 수용하기
공개 README는 Scaffolding이라고 명시하며 Floem은 v0.1.0에서 컴파일 가능한 skeleton에 머문다고 설명합니다. 도입 시 본문 설정과 ContentChanged 연결을 대상으로 하고 cursor/selection과 완전한 편집 조작은 미구현 위험으로 다룹니다.
근거
조사 시점의 공개 저장소를 바탕으로 소개합니다. 링크된 고정 커밋에서 구현과 사용 방법을 확인할 수 있습니다.