Skip to content
bit-ioPublic

Latest commit

 

History

391 Commits

Folders and files

Repository files navigation

Silver 0.5

Framework okienkowy w stylu Tauri bez WebView: frontend w HTML/CSS/JS (albo TypeScript, React, Vue, Solid, Preact, Svelte), backend w H#. Własny silnik układu i rysowania na SDL2, JavaScript przez QuickJS. Pakiety zarządzane przez bit.

frontend (HTML + CSS + JS/TS)  ──silver.invoke / on-click──▶  backend H# (app::command)
        ▲                                                           │
        └────────── zdarzenia (app::emit, silver.listen) ◀──────────┘

Szybki start

bit add silver                          # w istniejącym projekcie H#
use "bit -> silver" from "silver"      # w kodzie → app::, ui::, data::, dialog::, …

silver new moja-apka               # nowy projekt (szablon vanilla)
silver new notatki --ts            # TypeScript + Preact + esbuild
silver new notatki --svelte        # Svelte 5 + esbuild
silver list                        # wszystkie szablony
cd moja-apka && bit                # instaluje zależności, buduje, uruchamia

Minimalna aplikacja:

use "bit -> silver" from "silver"

fn greet(args: string) -> string is
    return "{{\"message\": \"Cześć z H#!\"}}"     ;; UWAGA: w literałach H# klamry podwajamy
end

fn main() is
    let mut a = app::new("Hello", 800, 600)
    a = app::load_html(a, "frontend/index.html")
    a = app::load_css(a, "frontend/style.css")
    a = app::command(a, "greet", greet)
    a = app::load_js(a, ["frontend/app.js"])      ;; opcjonalnie
    a = app::enable_hot_reload(a)                 ;; HTML + CSS + JS
    app::run(a)
end
// frontend/app.js
document.querySelector('#btn').addEventListener('click', async () => {
  const r = await silver.invoke('greet');       // await działa
  document.querySelector('#out').textContent = r.message;
});

Co potrafi (0.5)

Obszar Zakres
HTML parser stosowy: encje, komentarze, <!DOCTYPE>, atrybuty w "…"/'…'/bez cudzysłowów, tagi void, <script>/<style>/<link>, formularze (input, textarea, select, checkbox, radio, button, label, form), data-*
CSS kolory, jednostki, calc()/clamp(), var(), inherit/initial/unset dla każdej właściwości, właściwości logiczne, @media (zakresy, or, not), @supports, @layer, @import, @font-face, @keyframes/animation, transition geometrii, transform, filter, clip-path, float, z-index, position: sticky, aspect-ratio, letter-spacing, text-shadow, ramki dashed/dotted, ::before/::after z attr()/counter(), :has(), :nth-child(… of S), … → docs/css.md
Układ blok z float i zwijaniem marginesów, inline, inline-block, flexbox (align-content), grid (obszary, linie, auto-placement), prawdziwe tabele (colspan, rowspan), position, listy, przewijanie kontenerów
Interakcja edycja pól (kursor, zaznaczenie, schowek, UTF-8, IME), Tab, kursory CSS, drag & drop plików, on-click/input/change/submit/keydown/hover
JS QuickJS ES2020+: moduły ES, await, timery, fetch z nagłówkami, lustro DOM z układem (getBoundingClientRect, getComputedStyle), obserwatory, synchroniczne preventDefault, Intl, trwały localStorage, Worker, WebSocket, Shadow DOM, Custom Elements, source mapy → docs/javascript.md
TypeScript / frameworki esbuild + npm; typy z npm (@hackeros/silver-types); sprawdzone: TypeScript, Preact, Svelte 4/5, React 18, Vue 3, Solid → docs/typescript.md
Backend H# komendy z uprawnieniami (capabilities), dyrektywy UI (ui.h#), szablony {{klucz}}/if/each, zadania w tle, wiele okien, cykliczny on_tick
System schowek, powiadomienia, dialogi plików, ikona, pełny ekran, motyw jasny/ciemny
Dystrybucja silver bundle: AppImage, .deb, .app/.dmg, Windows .zip/instalator → docs/packaging.md

CLI

silver new <nazwa> [--template <szablon>] [--ts] [--svelte]
silver embed [--dir frontend]   # wbuduj frontend w binarkę (src/assets_gen.h#)
silver run --x11 | --backend <wayland|wayland-only|x11|auto>
silver list | doctor | version
silver dev                 # frontend --watch + aplikacja z hot reload
silver build | run         # npm (jeśli jest frontend/package.json) + bit build | bit run
silver bundle <appimage|deb|macos|dmg|windows>

Szablony

Szablon Co pokazuje
vanilla najprostszy start: HTML/CSS + trochę JS
counter stan w H# + cykliczny on_tick + JS (async/await, skróty klawiszowe)
kitchen_sink przegląd silnika: formularze, flex, grid, przewijanie, motyw ciemny, dyrektywy UI
todo_js aplikacja prawie w całości w JS: DOM, delegacja zdarzeń, dialogi, schowek, zapis przez H#
dashboard pulpit: grid, wykres z div-ów w JS, requestAnimationFrame, fetch, zadania w tle
ts_preact TypeScript + TSX + Preact, typowany kontrakt komend, hooki
svelte Svelte 5 (runes)

Dokumentacja

Co jest zweryfikowane, a co nie (0.5)

Sprawdzone realnie (kompilator H# i bit 0.3.0 były dostępne):

  • pełny bit build biblioteki i aplikacji (szablon counter, zależność przez ścieżkę) → jedna statyczna binarka z wbudowanym frontendem;
  • start z pustego katalogu (bez frontend/) na Waylandzie (weston headless) i na X11 (Xvfb), wybór backendu SILVER_BACKEND;
  • silver embed → src/assets_gen.h# → binarka serwuje HTML/CSS/JS/obrazy z pamięci (bez plików obok);
  • 599 testów silnika (sh tools/run_engine_tests.sh; kolejnych 12 wymaga fixtur/HarfBuzz — SILVER_TEST_FULL=1);
  • test natywny (sh native/tests/run.sh), type-check @hackeros/silver-types (tsc), .deb z jedną binarką.

Niesprawdzone / ograniczenia — patrz ROADMAP.md: statyczny SDL nie ma libdecor (na GNOME/Wayland użyj frameless + app-region albo budowy dynamicznej), wss:// nie było testowane na prawdziwym serwerze, macOS/Windows nie były uruchamiane, ścieżka pobierania źródeł wayland/xkbcommon z gitlaba nie była sprawdzona (przetestowano tarballe Ubuntu).

Releases

Packages

Contributors

Languages