nooher/snil

SNIL — Swahili Native Intent Language. A sovereign Kiswahili programming language by Laetoli. # SNIL — Swahili Native Intent Language **Lugha huru ya kompyuta ya Kiswahili — yenye utambulisho wake.** Bendera ya Laetoli Ltd. *(A sovereign Kiswahili programming language — a Laetoli flagship.)* SNIL ni lugha ya programu iliyoundwa kwa wazungumzaji wa Kiswahili kuanzia msingi: ina sarufi yake, maneno-msingi ya Kiswahili, makosa ya Kiswahili, na maktaba yake. Si tafsiri ya Python wala lugha nyingine — ni lugha huru inayowezesha mtu yeyote anayezungumza Kiswahili kujifunza, kufundisha na kujenga programu kupitia lugha yake mwenyewe. *(SNIL is a programming language built from the ground up for Kiswahili speakers: its own grammar, Kiswahili keywords, Kiswahili errors, and its own standard library. It is not a translation of Python — it is a language of its own.)* ```snil weka jina kuwa "Asha" onyesha "Habari, " + jina + "!" kwa kila n kutoka 1 hadi 3 onyesha n mwisho ``` ## Maumbile mawili — Dual nature SNIL inakimbia kwa njia mbili: - **Interpreter (kivinjari)** — andika SNIL, uone matokeo papo hapo, bila kusakinisha chochote. Hii ni *playground* ya elimu. - **Python codegen** — SNIL i-compile kwenda Python (target ya kwanza) ili kujenga software halisi. Tabia na maonyesho ni **sawasawa** kati ya njia zote mbili (ona `examples/EXPECTED.md`). ## Vipengele muhimu — Key features - **CLI** (`endesha` / `tengeneza` / `nadhifu`) ya kuendesha, kutafsiri kwenda Python, na kunadhifisha programu nje ya kivinjari. - **Kiendelezi cha VS Code** (`vscode-snil/`) — *syntax highlighting* kwa faili `.snil`. - **DARASA** (DARASA.md) — masomo ya hatua kwa hatua ya kujifunza programu kwa Kiswahili (pia hujengwa ndani ya app, ona `src/darasa/`). - **Makosa ya Kiswahili** — kila kosa la mkalimani huelezwa kwa Kiswahili na nambari ya mstari. - **Maktaba ya kawaida** — moduli `hisabati`, `maandishi`, `orodha`, `muda`, `faili`. ## Amri — Commands ```bash npm install # sakinisha (install) npm run dev # playground ya kivinjari (port 5200) npm test # majar …