KretUI — wprowadzenie

KretUI — wprowadzenie

Status 1.0: `FROZEN_SUPPORTED_SUBSET` — zamrożony dokładnie opisany zakres; reszta poza kontraktem 1.0. Gramatyka/wersja: kretui-1.0 · kstyle-1.0 · ktheme-1.0. Status języka nie nadaje uprawnień KCS ani prawa do działania w Production.

Czym jest

KretUI opisuje strukturę i interakcje interfejsu (widoki, stan, bindingi, akcje do komend KretS). KretStyle opisuje wygląd (selektory, kaskada, stany, media), KTheme — motyw (tokeny, warianty dark/highContrast, kontrola kontrastu WCAG). Renderer SDK (Avalonia) działa we własnym procesie, logika w procesie pluginu. Interfejs nie nadaje uprawnień i nie przechowuje sekretów.

Dla początkujących

Piszesz, co ma być na ekranie: kolumny, wiersze, teksty, pola, przyciski, listy. Stan widoku (state) trzyma wartości, a przycisk może wywołać akcję — komendę w KretS — i zapisać wynik w stanie. Wygląd ustawiasz osobno w .kstyle, kolory i rozmiary w .ktheme.

Dla zaawansowanych programistów

Akcja = zadeklarowana komenda (on nazwa(...) -> T) z args, result, busy, error; kompilacja sprawdza sygnaturę i blok handlers manifestu. Warunki when/enabled to wyrażenia bez skutków ubocznych (env.*, form.valid, empty, count). Kontrolka wyłączona/niewidoczna/jednokierunkowa nie zmieni stanu (decyduje UiRuntime). pattern kompilowany silnikiem bez nawrotów. Sesja kretui-session/1 (EXPERIMENTAL) dla IDE: przeładowanie, przenoszenie stanu, logika tylko w procesie pluginu; od BRK-12 jeden proces logiki na plugin i katalog danych (STUDIO-R01). Rozszerzenia formularzy results, onBlur, shortcut (łatka 9) — PROPOSED_LOCAL (G-07).

Jakie problemy rozwiązuje

Deklaratywny, bezpieczny interfejs pluginów oddzielony od logiki i uprawnień; dostępność (opisy, kontrast) sprawdzana przy kompilacji; motywy i tryb wysokiego kontrastu.

Kiedy używać

• dashboard, panel ustawień, formularze
• listy i tabele danych z KretDB (przez KretS)
• okna dialogowe i zakładki
• motywy jasny/ciemny/wysoki kontrast

Kiedy nie używać

• tooltip, menu, contextMenu, chart (NOT_SUPPORTED, KCS-KUI-0107)
• gesty, canvas, animacje, wiele okien/monitorów, kiosk, widżety, profile dashboardów (PLANNED, KretUI 1.x)
• logika w stylu/motywie (błąd „nieznana właściwość”)
• piaskownica renderera — renderer działa z prawami użytkownika

Współpraca z innymi technologiami

KretS (komendy on …), KretL (handlers), KretDB (dane przez KretS), KretStudio (podgląd interaktywny, LSP), Core (plugin ui open, UiProcess).

Obecny status

FROZEN_SUPPORTED_SUBSET — zamrożony dokładnie opisany zakres; reszta poza kontraktem 1.0.

Dalej: ARCHITECTURE.md · SYNTAX_REFERENCE.md · ../Tutorials/BASIC/TUTORIAL_PL.md