패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.1.1

val_highlight

순수 Dart로 구현된 55개 언어의 문법 강조. 증분 업데이트, 테마, VS Code 테마 가져오기 및 HTML 출력 지원. 모든 플랫폼에서 실행 가능.

AndroidiOSLinuxmacOSWebWindows
30일 다운로드
6.6만
좋아요
6
Pub 점수
160

패키지 설치

flutter pub add val_highlight

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

val_highlight는 55개 언어의 구문 강조를 제공하는 순수 Dart 패키지로, 증분 업데이트, 사용자 정의 테마, VS Code 테마 가져오기 기능을 지원합니다. HTML 출력을 생성하며 Android, iOS, Linux, macOS, Web, Windows 등 주요 플랫폼에서 원활하게 작동합니다. 외부 종속성 없이 실시간 언어별 강조가 필요한 코드 에디터 또는 문서 도구를 개발하는 개발자에게 이상적입니다.

사용 사례

  • 코드 편집기 구현
  • 문서 생성
  • 실시간 구문 미리보기
  • 교육용 코딩 앱
  • 강조된 코드를 사용한 정적 사이트 생성
  • 크로스 플랫폼 코드 표시

주요 기능

  • 55개의 프로그래밍 언어를 지원합니다
  • 증분 강조 업데이트
  • VS Code 테마 가져오기 기능
  • HTML 출력 생성
  • 순수 Dart 구현
  • 다중 플랫폼 호환성

적합한 대상

  • 코드 편집기 개발 중인 개발자
  • 동적 구문 강조가 필요한 앱
  • 코드 스니펫이 포함된 웹 및 모바일 앱
  • 문서 및 튜토리얼 플랫폼
  • 경량 구문 강조가 필요한 프로젝트

고려 사항

  • 매우 큰 코드 파일에 대한 최적화가 필요할 수 있습니다
  • 테마 사용자 정의는 CSS/JSON 형식에 대한 이해가 필요합니다
  • 사전 정의된 언어 문법에 제한됨
  • 내장된 줄 번호 없음
  • 성능은 업데이트의 세부 수준에 따라 달라집니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

val_highlight

Syntax highlighting for Dart and Flutter.

A pure-Dart engine with 55 languages, incremental updates and themes,
plus Flutter widgets to show and edit code.

val_highlight on pub.dev val_highlight_flutter on pub.dev BSD-3-Clause license


📦 Packages

Package Use it for
val_highlight The engine, in pure Dart: 55 languages plus a generic fallback, flat tokens, incremental updates, language detection, 8 themes, VS Code theme import and HTML output. Runs on the VM, in Flutter and on the web.
val_highlight_flutter Flutter widgets: CodeView to show code, CodeField to edit it, HighlightTextController, and CodeTheme for app-wide defaults.

A val_highlight_jaspr package is planned, built on the same engine.

// Flutter
CodeView(source, language: dartLanguage)

// Pure Dart
final html = const Highlighter().toHtml(source, language: dartLanguage);
Dart in CodeView with line numbers and highlighted lines
CodeView
Line numbers, highlighted lines, selection.
TSX in the midnight theme
Themes
Eight built in, or import a VS Code theme.
Markdown with bash, Python and JSON code fences
Languages inside languages
Markdown fences, HTML with CSS and JavaScript.
Python being edited in CodeField
CodeField
An editor that highlights as you type.

⚡ Performance

just bench compiles to native code, highlights a Dart file and renders it to HTML (best of 5 runs, on a MacBook):

Lines Highlight + HTML
600 1.5 ms
2,400 4.3 ms
9,600 13.9 ms

just bench-languages measures about 256 KB of realistic source per language on native code. It averages about 43 MB/s, from 30 MB/s (HTML) to 64 MB/s (Markdown). just bench-js runs the same test compiled to JavaScript, where it averages about 62 MB/s.

With incremental highlighting, one keystroke in the 9,600-line file takes about 0.4 ms. Frame timings for scrolling and typing in Flutter are in the val_highlight_flutter README (just bench-frames).

How it works
  • One pass, no copying. The scanner walks the source by offset, never copies it, and time grows in step with input size.
  • First-character dispatch. Each rule's pattern is analysed once to find the characters it can start with. The scanner skips positions where no rule can start, and tries only the rules that can. Rules anchored with ^ are tried only at line starts. States with a rule that can start almost anywhere fall back to one combined regular expression. Both paths give identical results, and fuzz tests check this.
  • Plain-Dart matchers. On native platforms, most patterns run as small Dart matchers instead of the regular expression engine, with identical results (checked by fuzz tests). Browsers compile regular expressions to machine code, so the web keeps using them.
  • Flat output. Tokens are two integer lists, not a tree of objects.

🛠️ Development

This repository is a pub workspace. The Flutter version is pinned in .fvmrc (3.44.2), and the justfile runs everything through FVM:

just setup            # install the pinned SDK and fetch dependencies
just check            # format check, analyze, all tests (VM and JS)
just devices          # list available devices
just example-flutter  # run the Flutter example; asks which device to use
just example-web      # run the Flutter example in Chrome
just example-dart     # run the pure-Dart example
just bench            # benchmark

Run just with no arguments to list every command.

Note: with Xcode 27, Flutter 3.44.2 (the pinned version) fails to build for iOS, and to build macOS apps in profile or release mode, such as the frame benchmark. Its architecture check rejects Xcode 27's lipo output. Flutter 3.47 builds both. Web, Android and macOS debug builds work with the pin.

Built by Val

val_highlight is part of Val, the live visual layer for AI agents.

💬 Community

Issues and pull requests are welcome. See CONTRIBUTING.md for setup, tests and what we look for in a pull request.

📄 License

BSD 3-Clause — see LICENSE.

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.

순위