KRET LANGUAGE ACADEMY · DOKUMENTACJA ZE ŹRÓDEŁ

KretUI — referencja składni

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.

Opisane są wyłącznie konstrukcje potwierdzone implementacją SDK (i, gdzie zaznaczono, testami tej rundy).

`view / state`

Widok i jego stan.

Plik

1view Counter {
2    title "Licznik: {count}"
3    width 480
4    state {
5        count Int64 0
6    }
7    column { … }
8}

Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

view Counter {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
title "Licznik: {count}"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
width 480Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
state {Początek nazwanego bloku; jego pola odczytaj w powiązanej referencji.
count Int64 0Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
column { … }Początek nazwanego bloku; jego pola odczytaj w powiązanej referencji.
}Zamknięcie struktury otwartej we wcześniejszych liniach.

Cecha	Wartość
Parametry / typy	`title`, `width`, `height`; zmienne stanu z typem i wartością
Wynik	—
Wymagania	—
Ograniczenia	stan prezentacji ograniczony (łatka 8: 32 pola)
Możliwe błędy	KCS-KUI-01xx
Wprowadzono	1.0

`action / open`

Akcja = komenda KretS; open uruchamia akcję przy otwarciu widoku.

Plik

1action add "notes.add" {
2    args draft
3    result items
4    busy busy
5    error error
6}
7open load

Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

action add "notes.add" {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
args draftOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
result itemsOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
busy busyOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
error errorOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
open loadOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.

Cecha	Wartość
Parametry / typy	`args` (stan albo literały), `result`, `busy` (`Bool`), `error` (`String`)
Wynik	wynik komendy → zmienna stanu
Wymagania	komenda w `handlers` manifestu, zgodna sygnatura
Ograniczenia	nazwy funkcji ochronnych odrzucane
Możliwe błędy	KCS-KUI-*
Wprowadzono	1.0

`text / input / button`

Tekst, pole (walidacja required minLength maxLength pattern type), przycisk (action, set).

Plik

1input name {
2    label "Imię"
3    required true
4    maxLength 40
5}
6button "Zapisz" {
7    action save
8    enabled "form.valid and not busy"
9}

Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

input name {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
label "Imię"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
required trueOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
maxLength 40Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
button "Zapisz" {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
action saveOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
enabled "form.valid and not busy"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.

Cecha	Wartość
Parametry / typy	`type` `text\|number\|email\|password`
Wynik	—
Wymagania	—
Ograniczenia	brak `label`/`description` → ostrzeżenie dostępności `KCS-KUI-0108`
Możliwe błędy	KCS-KUI-0108
Wprowadzono	1.0

`list / table / checkbox / slider / dialog / tabs`

Komponenty VERIFIED: list (StringList), table (Rows), checkbox, slider, dialog, tabs+tab, row, column. IMPLEMENTED: switch, progress, image, icon, separator, badge, status, grid, stack, scroll, card, panel.

Plik

1list items {
2    label "Notatki"
3    selected selected
4}
5dialog confirm {
6    title "Usunąć?"
7}

Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

list items {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
label "Notatki"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
selected selectedOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
dialog confirm {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
title "Usunąć?"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.

Cecha	Wartość
Parametry / typy	wg komponentu
Wynik	—
Wymagania	—
Ograniczenia	tabela ≤ 1000 wierszy, bez przewijania własnego
Możliwe błędy	KCS-KUI-0107
Wprowadzono	1.0

`bind / when / enabled / set`

Bindingi oneWay/twoWay/oneTime, warunki widoczności/aktywności, lokalna zmiana stanu.

Plik

1text "Brak" {
2    when "empty(items)"
3}
4button "Otwórz" {
5    set open true
6}

Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

text "Brak" {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
when "empty(items)"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
button "Otwórz" {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
set open trueOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.

Cecha	Wartość
Parametry / typy	wyrażenia bez skutków ubocznych
Wynik	—
Wymagania	—
Ograniczenia	`set` przy akcji wykonuje się po jej powodzeniu
Możliwe błędy	KCS-KUI-*
Wprowadzono	1.0

`KretStyle: style / state / media`

Selektory typ .klasa #id typ.klasa *, kaskada wg szczegółowości, stany hover pressed focused disabled loading error success selected, media size|touch|highContrast|reduceMotion.

Plik

1kstyle "1.0"
2style "button.primary, #submit" {
3    background accent
4    state hover {
5        background accentHover
6    }
7}
8media size compact {
9    style "column" {
10        gap 4px
11    }
12}

Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

kstyle "1.0"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
style "button.primary, #submit" {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
background accentOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
state hover {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
background accentHoverOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
media size compact {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
style "column" {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
gap 4pxOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
}Zamknięcie struktury otwartej we wcześniejszych liniach.

Cecha	Wartość
Parametry / typy	właściwości: kolory, długości, `padding/margin`, `opacity`, `fontWeight`, `textAlign`, `align`, `justify`, `fontFamily`
Wynik	—
Wymagania	—
Ograniczenia	animacje, przejścia, cienie, gradienty — NOT_SUPPORTED
Możliwe błędy	KCS-KUI-02xx
Wprowadzono	1.0

`KTheme: theme / tokens / variant / contrast`

Tokeny (kolor, długość, liczba, tekst, alias), warianty nadpisujące tokeny, wymagany kontrast WCAG sprawdzany przy kompilacji.

Plik

1ktheme "1.0"
2theme Notes {
3    tokens {
4        surface "#FBFBFD"
5        text "#1A1C22"
6    }
7    variant dark {
8        surface "#17181C"
9        text "#ECEDF1"
10    }
11    contrast text surface 7
12}

Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

ktheme "1.0"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
theme Notes {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
tokens {Początek nazwanego bloku; jego pola odczytaj w powiązanej referencji.
surface "#FBFBFD"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
text "#1A1C22"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
variant dark {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
surface "#17181C"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
text "#ECEDF1"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.
contrast text surface 7Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
}Zamknięcie struktury otwartej we wcześniejszych liniach.

Cecha	Wartość
Parametry / typy	—
Wynik	—
Wymagania	warianty mają ten sam zestaw nazw
Ograniczenia	za mały kontrast = błąd `KCS-KUI-0305` (sprawdzone w tej rundzie); `extends` między plikami — NOT_SUPPORTED
Możliwe błędy	KCS-KUI-0305, KCS-KUI-03xx
Wprowadzono	1.0

Źródło i wersja

Zweryfikowany import PUBLIC_CANDIDATE. Identyfikatory źródeł odnoszą się do eksportu i nie dają dostępu do plików serwera.

01_LANGUAGES/KretUI/Documentation/SYNTAX_REFERENCE.md
SHA-256 BF0B3A0CAF13B0175008271BB239939A9E00A0455F09B498ED4EAD9B2929D8F7

Zaloguj się na konto użytkownika, aby zapisywać postęp i zakładki. Konta obsługi mogą czytać bez zapisu postępu. Logowanie →