명세 · API

Rust API

안정적 facade

Crate root는 Engine, Matcher, ResourceBundle, 컴파일 옵션, 오류와 일치 provenance type을 노출합니다. 이 공개 표면을 1.x 호환 계약으로 유지합니다.

Matcher는 UTF-8 byte slice를 검색하며 파일 순회·인코딩·출력은 처리하지 않습니다.

Matcher::find_all_with_diagnostics(input, &diagnostics)는 일치 결과와 함께 SearchDiagnostics::structural_verification_incomplete()로 판정 불가 여부를 확인하게 합니다. 진단은 검색 단위로 생성합니다. 같은 진단을 재사용하면 판정 불가 상태를 누적하며, 다른 worker와 공유하지 않습니다.

resource 초기화

Engine::with_resources는 선택적 full POS, enriched predicate와 구성 요소를 하나의 profile로 검증합니다. Engine::new는 embedded profile을 만듭니다.

load_component_resource는 전체 검증 뒤 구성 요소 리소스를 교체합니다. 검증에 실패하면 기존 리소스를 유지합니다.

expert API

kfind::expert는 호출자가 구성한 Lexicons, QueryPlan과 matcher plan에 접근할 수 있게 합니다.

Expert type은 root facade의 인자나 반환값에 나타나지 않으며 1.x 안정 계약에 포함되지 않습니다.