# SLeeLa 3.0 — Suomi (FI)


Natiivi järjestelmäkieli, kääntäjä, suoritusympäristö ja virtuaalikoneiden ekosysteemi.

> **Kansainvälinen maaeditio.** Tämä editio on suomeksi. Tekniset tunnisteet, komennot, koodiesimerkit, tiedostonimet, polut ja linkit ovat muuttumattomia kanoniseen englanninkieliseen tiedostoon [README.md](../../README.md) verrattuna.
**The Now. The Ingredient.** Kieli on enemmän kuin syntaksi: se on kääntäjä, suoritusympäristö, kirjastot, työkalut ja alustasopimukset, jotka tekevät ohjelmistosta käyttökelpoisen.
**Mihin SLeeLa on osallisena.** SLeeLa on osallisena sanoissa **Math**,
**Object**, **Science** ja **Reach** — työn neljä kasvoa: laskettava
(Math), katalogissa olevan asian joukossa seisova vakiintunut asia (Object),
totuuden kurinalainen tutkimus (Science) sekä järjestelmän käden ulottaminen
muihin järjestelmiin ja ihmisiin (Reach). **Kansalliset edut säilyvät** —
yksikään neljästä ei syrjäytä niitä; kun aihe koskee kansakunnan etua, tuo
asema säilytetään (kirjataan tarkasti, esim. kunkin luokan Metadata-kentissä
`metaOrigin` / `metaNationalSchedule`), eikä sitä koskaan hajoteta.
## I. Aloitus tästä
- [Natiivin toteutuksen rakentaminen](../../impl/README.md)
- [Virtuaalikoneet ja Modium — käytännön käyttöopas](../../virtual-machine/USER-GUIDE.md) (`sleela vm`, `sleela modium`)
- [CPU-pino SLeeLa-lähdekoodina](../../lib/cpu/CPU.md) — täydellinen portit→ALU→ytimet→käyttöjärjestelmä→ohjelmat-kone, yli 130 CPU-profiilin luettelo sekä säädettävät [jännitteet, muuttuvat kellotaajuudet ja asiantuntija-ajoitukset](../../lib/cpu/TIMING.md), joita voit [ajaa määrittelyn mukaisesti ja ylikellottaa](../../lib/cpu/components/README.md)
- [Dokumentaatiohakemisto](../../docs/README.md)
- [CSPML-tietolähde ja Salt & Salary -tutkimusviite](../reference/CSPML.DATA.SOURCE.AND.SALT-AND-SALARY.REFERENCE.md) — ulkoisen yhdysvaltalaisen paikka-, sosioekonomisen, työvoima-, koulutus- ja peruskoulutietojen alkuperä sekä integrointiohjeet.
- [Generoitu API-dokumentaatio](../../docs/api/README.md) — nykyinen HTML-viite, versioitu API-editio ja uudelleengenerointiohjeet
- [API-luettelo](../../api/README.md)
- [Laskennalliset vertailustandardit](../../comparison/README.md) — SLeeLa VM:n, Java/JVM:n ja natiivin C/C++:n tyyppi-, muisti-, ABI- ja yhteensopivuusstandardit.
- [Recursion stanchion — C- ja C++-prototyypit](../../recursion/stanchion/README.md) — alkeistyypeille (Boolean, Byte, Character, Integer, Long, Float ja Double) erikoistetut esimerkit sekä yleiset, sovelletut, tieteelliset ja opetukselliset rekursiomallit.
- [Alustatuki ja varmennusmatriisi](../../docs/PLATFORM-SUPPORT.md)
- [Brändiopas](../../docs/BRAND-GUIDE.md)
- [Oheistuotekonseptit ja -aineistot](../../merchandise/README.md)
- [NitroWebExpress-logo](../../images/nitro-web-express/nitrowebexpress-logo-004.jpeg)
- [Testauskäytäntö ja julkaisuportit](../../markdown/TESTING.md)
## II. Uutiset
Viimeaikaiset lisäykset kieleen, ajureihin ja vakiokirjastoon:
- **`advantage`-vakiokirjastopaketti — osingon hyödyntäminen (advantaging),
matematiikalla, fysiikalla, integraatiolla, arvostelulla ja reititettävällä tulosteella.**
[`lib/advantage/`](../../lib/advantage/README.md) kapseloi ajatuksen
*ainutlaatuisen osingon hyödyntämisestä suhteessa malliin* kerrokselliseksi
**Sequitur-sipuliksi** (osinko → katselmointi → huolet → matematiikka → lisäykset → vähennys
→ uudelleenryhmittely → iterointi), jossa voi liikkua sisäänpäin ja ulospäin täydellä dynaamisella päivityksellä
ja palautuksella (restitute), ja joka tarjotaan yksinkertaisen **käyttäjän mallin** ja täyden hallinnan
**kehittäjän mallin** kautta. Siinä on viisi aihealuetta: **`math/`**
kahdenvälisen kaupan taloustiede (yhteisen voiton maksimointi, Nash-neuvottelu, kahdenvälisen
newsvendor-mallin kriittinen suhde), **`physics/`** rakennetaloudellinen
”luottamuskenttien fysiikka” (luottamus metrisenä tensorina, transaktionaalinen geodeesi, ilmoituksen
kontaktirakenne, CIR+hyppy-luottamuksenhäviö-SDE — mallinnusanalogia, ja se on
merkitty sellaiseksi), **`integration/`** rekursiivisesti koostettava
vertikaalisen integraation malli kapitalismille/vähittäiskaupalle (lokerot,
suunnittelulahdet, koelokerot, newton-mediaanitarjottimet ja
järjestelmän hienostuneisuuspisteet), **`grading/`** hienostuneisuuspiirin arvostelija, joka luokittelee jokaisen moduulin
sekä minkä tahansa voittavien/häviävien/arvostelija-/absoluuttisten moduulien joukon A–D, sekä **`output/`**
reititettävä emit-sauma, joka lähettää moduulin tulosteen päätteelle,
**CommonRails**-muotoiltuun pintaan tai pistokkeeseen/liittimeen (kehystettynä natiiville
`slnet_write`-kutsulle). Jokainen luokka kantaa Metadata-Class-tietueen; viisi ajettavaa
demoa validoi aihealueet, ja oheiset
[`DEFINITIONS.md`](../../lib/advantage/DEFINITIONS.md),
[`MATH.md`](../../lib/advantage/MATH.md) ja
[`PHYSICS.md`](../../lib/advantage/PHYSICS.md) dokumentoivat ne. Natiivi C/C++-
kuluttaja hakemistossa [`advantage/`](../../advantage/README.md) (C-ydin
`advantage_value`/`advantage_mean`, XML-tietovarasto, turvallinen
HTTPS/SFTP/SSH-hankinta + avainsäilö + DH/ECDH-siirtokirjasto) linkittää
mallin toimiviin
[kauppaesimerkkeihin](../../advantage/examples/README.md) — oletetuista internetlähteistä peräisin olevat positiiviset kaupat,
yleisörelevanssin sarja (Traders,
Consumers, Helpers, Healers) ja kahdeksan mallia luokiteltuna A–D (D = eniten Cementiä,
A = eniten Brandia).
- **Silmukan ajoitusmerkinnät — `@loopDelay` / `@loopBudget` (+ sisäänrakennettu
`sleep(ms)`).** SLeeLan ensimmäiset **lausetason, käyttäytymiseen vaikuttavat** merkinnät:
kun ne kirjoitetaan omalle rivilleen ennen `for`- / `while`- / `do`-silmukkaa, ne lisäävät silmukan suoritukseen
todellisen tauon. `@loopDelay(ms = 250)` /
`@loopDelay(seconds = 2)` nukkuu kiinteän ajan kutakin kierrosta kohti (pelkkä
`@loopDelay(250)` tulkitaan oletuksena millisekunneiksi); `@loopBudget(seconds = 10,
iterations = 1000)` jakaa tunnetun kierrosmäärän tasaisesti koko
seinäkelloajan budjetille. Molemmat muunnetaan uudeksi vain lisäävästi laajenevaksi käskyksi **`OP_SLEEP`**
(ISA 157), joka tukee myös yleistä **`sleep()`**-sisäänrakennettua funktiota, jota voi kutsua
mistä tahansa; tauko toteutetaan siirrettävästi (`nanosleep` / `Sleep`). Määritelty
tiedostossa [`SLEELA.syntax` §32](../../SLEELA.syntax); API-viite tiedostossa
[`api/sleela/3.0/LOOP_TIMING_API.md`](../../api/sleela/3.0/LOOP_TIMING_API.md);
ajettava
[`examples/loop-timing-annotation-demo.sleela`](../../examples/loop-timing-annotation-demo.sleela).
Istuntolisäysten hakemisto (sisältäen tämän, natiivin `OP_BIGMUL`-
suurten kokonaislukujen kertolaskun sekä itsenäiset **[local-generator](../../local-generator/README.md)**-
ja **[pi-generator](../../pi-generator/README.md)**-työkalut) on tiedostossa
[`api/sleela/3.0/SESSION-ADDITIONS-API.md`](../../api/sleela/3.0/SESSION-ADDITIONS-API.md).
Kolme generoitua API-pintaa
([`sleeladoc-api/`](../../sleeladoc-api/README.md),
[`docs/api/`](../../docs/api/README.md) ja muuttumaton
[`api/sleela/3.0/version-014/`](../../api/sleela/3.0/version-014/index.html)
-tilannekuva) rakennettiin uudelleen komennolla `make api-docs`, ja niiden `vm`-pakettisivuilla on nyt uudet `SLISASleep`
/ `SLISABigMul` -käskymerkinnät.
- **SleelaDoc komentoriviltä — `sleela docs`.** SleelaDociin pääsee nyt
suoraan päätteestä. `sleela docs` luettelee kaikki dokumentoitavat aiheet;
`sleela docs crypto` näyttää paketin; `sleela docs stringbuilder` ratkaisee
luokan (kirjainkoosta riippumatta sekä `SL`-vakiokirjastoetuliitteellä →
`SLStringBuilder`) ja tulostaa rikkaan sivun — **määritelmä, suunnittelutarkoitus,
suhteet, rakenne, käyttäjän clayt ja viisiportainen mestaruuden tikapuut** —
ja lähes osuneista haulla näytetään järjestetyt ”tarkoititko” -tulokset. Kirjoittajat rikastavat mitä tahansa sivua
lisäämällä siihen SleelaDocin `@`-tageja (`@intent`, `@thesis`, `@axiom`, `@param`,
`@see`, `@mastery`). `sleela docs --generate [dir]` kirjoittaa pelkän tekstin korpuksen
(yksi sivu per luokka + `TOPICS.index`), jota CLI sitten lukee offline-tilassa;
**`make sleeladoc`** niputtaa tuon korpuksen **ja vastaavat `.sleela`-lähteet**
tiedostoon `sleeladoc/build/sleeladoc.jar`. Pelkkää julkisivua (facade) käyttäville aiheille (esim.
`psychiatry`, `politico`) `sleela docs --facade ` etsii
tiedostojärjestelmästä ajon aikana ja luettelee todelliset **kansiot (sitten tiedostot, luonnollisena
liikkeenä)**, rajattuna käyttäjän ohitettavilla rajoilla **6 MB / 6000 tiedostoa / 6
minuuttia**. Yksiköitä `lib/sleeladoc` ylläpidetään nykyisellä editiolla,
**`#sleela 3.0`**. Katso [`man/man1/sleela.1`](../../man/man1/sleela.1) ja
[`lib/sleeladoc/README.md`](../../lib/sleeladoc/README.md).
- **SleelaDoc — Javadoc-tyylinen dokumentaatioratkaisu ja generoitu HTML-sivusto.**
**SleelaDoc** on SLeeLan lähdekoodin sisäinen dokumentaatiokommenttikäytäntö
(kulmasulkukommentit, joiden merkkinä on `@doc` / `@page`; katso
[`manifesto/SLEELADOC.md`](../../manifesto/SLEELADOC.md)), ja
[`lib/sleeladoc`](../../lib/sleeladoc/README.md) on **poimija**, joka renderöi
`.sleela`-yksikön Markdown- tai HTML-API-sivuksi — samaan tapaan kuin `javadoc` renderöi Javaa —
dokumentoiden *tarkoitusta*. Täydellinen, selattava **HTML-dokumentaatiosivusto
koko `/lib`-hakemistolle** generoidaan hakemistoon [`/sleeladoc-api`](../../sleeladoc-api/README.md)
työkalulla `tools/generate-sleeladoc-api.py` (avaa `sleeladoc-api/index.html`; selkeä
sinisen / vaaleansinisen / vaaleanharmaan / valkoisen tyyli, jossa on paketti → luokka → jäsen
-hierarkia ja *Student 2* -lukijalle kirjoitettu sanasto). Kääntäjä
tuottaa myös kirjoittajan merkitsemät dokumentaatiotulosteet käännöksen sivutuotteena (`--wiki`
MediaWiki-sivu + alkuperäistetty lähdekaksonen), dokumentoituna tiedostossa
[`manifesto/SLEELADOC.WIKI.md`](../../manifesto/SLEELADOC.WIKI.md). Ajettava:
[`lib/sleeladoc/sleeladoc-demo.sleela`](../../lib/sleeladoc/sleeladoc-demo.sleela).
- **XML Document Object Model (`lib/xml`).** SLeeLa-puolen XML DOM — dokumentti,
joka omistaa element-/text-/comment-/CDATA-/PI-solmujen puun järjestettyine lapsineen ja
nimettyine attribuutteineen, serialisoija (kompakti/kaunisteltu, XML 1.0 §2.4 -pakotus), merkkisolu-
jäsennin sekä `SLXmlAspect`-laaturekisteri. Solmujen yhtäsuuruus on
kolmiportainen luottamuksen ketju (identiteetti → sama subjekti → rakenne), refleksiivinen,
symmetrinen ja deterministinen. Katso [`lib/xml/README.md`](../../lib/xml/README.md) ja
ajettava [`lib/xml/xml-dom.sleela`](../../lib/xml/xml-dom.sleela).
- **Leveät etumerkilliset kokonaislukualkeistyypit (`long`, `int64`, `int128`).** `int`, `long`
ja `int64` ovat kaikki 64-bittisiä etumerkillisiä kokonaislukuja, jotka tyyppitarkistuvat ja toimivat samalla tavalla;
`int128` hyväksytään kokonaislukutyypiksi (toistaiseksi 64-bittisenä, ja todellinen
128-bittisyys on dokumentoitu jatkotoimi). Kantaluvun 2 etumerkillinen sarja `int32`..`int16777216`
(syntaksi 2.7) ja vastaava etumerkitön sarja `uint32`..`uint16777216`
(syntaksi 2.8) laajentavat tätä. Katso [`SLEELA.syntax`](../../SLEELA.syntax) §21, §24, §25.
- **`@mix`-seurannaiskentät (syntaksi 2.9).** Luokka voi määritellä useita
ilmentymäkenttiä **samalla nimellä**, kun jokaisella toistolla on `@mix`; kieli
ymmärtää ryhmän seurannaisena (indeksillä avainnettu taulukko / lista),
oletuksena ylhäältä alas `1,2,3,…` tai manuaalisesti `@mix(1,2,3,...)`, jonka indeksien
määrän on vastattava kenttien määrää. Katso [`SLEELA.syntax`](../../SLEELA.syntax) §28.
- **Dokumenttimerkit — Luonnollinen prosessi, nimeltään Preonemit
(`author`/`authorial`, `material`, `memory`, `determine`, `object`, `field`).**
Näitä paljaita dokumenttimerkkisanoja kutsutaan yhdessä **Preonemeiksi**
(yksi merkki on *Preonem*; joukko *Preonemit* — katso
[`SLEELA.syntax`](../../SLEELA.syntax) §26.1). Ensiluokkaisia, vain deklaratiivisia
dokumenttimerkkejä, jotka nimeävät, mitä dokumentti *on* tekemisen järjestyksessä:
`author`/`authorial` (syntaksi 2.4; käsittelee ammattilaisneuvosto — ainoa
jäsen, jolla on käyttäytymisvaikutus), `material;` (vakiintunut Lähde) ja `memory;`
(syntaksi 2.5), `determine;` (syntaksi 2.6; dokumentti, jota lääkäri, fysiikko
tai aave voi vielä käsitellä kohti laillisen käden suorittamaa viimeistelyä),
sekä kaksi uusinta, **`object;`** (katalogissa olevan asian joukossa seisova vakiintunut asia
— **reifioitu, konkreettisen aseman saanut, syntaksissa 2.8**) ja
**`field;`** (suhteen perusta, jossa oliot seisovat ja liikkuvat) —
molemmat rajattu syntaksista 2.6 alkaen. Kukin on paljas, kontekstuaalinen ja
versiorajattu front endissä, eikä sillä ole vaikutusta jäsennykseen, tyypitykseen tai koodin generointiin; merkkipaikan
ulkopuolella jokainen pysyy tavallisena tunnisteena (joten `field` ei koskaan häiritse
luokan jäsentä tai `.field`-käyttöä). Katso [`SLEELA.syntax`](../../SLEELA.syntax)
§18–§20, §23 ja §26.
- **Nordshrift syntaksissa 3.0 täydellä kirjastotavoitettavuudella.** Nordshrift ratkaisee
samalla rekursiivisella `/lib`-indeksillä kuin kääntäjä, tavoittaen jokaisen
paketin ja `.sleela`-yksikön; `nordshrift check` raportoi koko puun lukumäärät.
- **Recursion stanchion.** Hakemisto [`recursion/stanchion/`](../../recursion/stanchion/README.md) sisältää nyt omat C- ja C++-viiteprototyypit seitsemälle dokumentoidulle alkeissopimukselle sekä yleisiä, sovellettuja, tieteellisiä ja opetuksellisia esimerkkejä. Nämä ovat viitelähteitä; käännä ja testaa ne ennen kuin pidät niitä varmennettuina.
- **Kulmasulkukommentit (`<` / `<<`).** Uusi eteenpäin suunnattu kommenttityyli —
`< rivi >` ja `<< lohko >>` — jonka SLeeLan front end lekseeraa ja joka on dokumentoitu
tiedostossa [`SLEELA.syntax`](../../SLEELA.syntax) §1.1.
- **Kantalukukirjaimelliset kokonaisluvut.** `int`-literaalit hyväksyvät nyt heksadesimaali- (`0x`),
binääri- (`0b`) ja oktaalimuodot (`0o`) `_`-numeroerottimilla sekä
SLeeLa-lähdekielessä ([`SLEELA.syntax`](../../SLEELA.syntax) §1.4) että
[`.xlt`-CPU-malliformaatissa](../../lib/xlt/README.md).
- **Metadata Class -standardi koko kirjastossa.** Kuvaileva metatietomalli
(alkuperä, lainmukaisuus, lainkäyttöalueellinen kattavuus) on nyt mukana
jokaisessa luokkia sisältävässä `.sleela`-tiedostossa hakemiston `/lib` alla; katso
[`SLEELA.syntax`](../../SLEELA.syntax) §15 ja
[opetusosuus](../../tutorial/13-metadata-class.md).
- **Rikkaampi text / String -perhe.** `lib/text` saa todellisia kielensisäisiä apufunktioita,
merkkisolunäkymän, joka antaa aidot `charAt`/`substring`/`indexOf`/`reverse`/
sarakekohdistuksen, sekä todellisen paikkaan perustuvan mallinnuksen — katso
[text & String -opetusosuus](../../tutorial/14-text-and-strings.md) ja ajettava
[`lib/text/text-string-demo.sleela`](../../lib/text/text-string-demo.sleela).
- **Ensiluokkainen `String` Nordshrift-sheeteissä.** `.sst`-sheet voi määritellä
tyypitetyn `strings:`-lohkon, joka osallistuu koonnin komponenttimanifestiin;
katso [Nordshrift Sheet Reference](../../wiki/Nordshrift-Sheet-Reference.md).
- **CPU-mallit ajavat sekä käskykoodeilla että funktiokutsuekvivalenssilla.** Jokainen
`SLCPU` perii perustan, jossa natiivia käskyvirtaa ajetaan
nouto-dekoodaus-suoritus-silmukassa *ja* oletetun toisen prosessin koodia ajetaan
vastaavilla kutsuilla jaetun VM-alustan päällä — katso
[`lib/cpu/EXECUTION.md`](../../lib/cpu/EXECUTION.md) §5.
## III. Rakentaminen ja testaus
**Esivaatimukset:** C/C++-työkaluketju (GCC tai Clang) ja GNU Make; Python 3
manifesti- ja työnkulkutyökaluille; Linuxissa X11/Xrandr-kehityspaketit
näyttötuotteita varten (moduulin `make deps` raportoi/asentaa tarvittavan). Hakemiston
`impl/` koonti on fail-closed luotetun SHA-256-manifestin suhteen, johon juuren
`Makefile` osoittaa automaattisesti.
Puhtaasta checkoutista nopein tapa aloittaa:
```sh
make # build everything from the repo root
```
Tai rakenna ja testaa vain natiivi ydin:
```sh
make -C impl all # build the core compiler/runtime only
bash ./test-suites/run-all.sh --all # run the full test suite
```
Repositorion juuren `make` rakentaa kaikki tuotteet (ydin, VM, koodekit, churn,
virustorjunta, …) ja päättyy **rekisterin** rakentamiseen sekä sen
perustaulukon materialisointiin — joten rakennettu puu sisältää tarkistettavan rekisterin heti valmiina.
Olennaiset kohteet:
```sh
make # build everything (alias of `make all`; registry runs last)
make all # the same full build, named explicitly
sudo make install # install commands + runtime support (see §IV)
make clean # remove build outputs from every dispatched build system
make help # list every target the root Makefile provides
```
Muita hyödyllisiä kohteita:
```sh
make registry # just the registry: build + materialize the table
./build-registry.sh # same thing, invoked directly
make tests # build and run the test suite
make ballum # build the Ballum display library for this OS (see ballum/)
bin/install-modules # paced install/build of each module over ~10-20 min (see bin/)
```
Kohde `registry` ajaa tiedoston [`build-registry.sh`](../../build-registry.sh): se rakentaa
rekisterin ytimen, kylvää perustaulukon siirrettävään tekstivarastoon
`registry/build/sleela.sleelareg` ja vie MySQL-taulukkoskriptin
`registry/build/registry.sql` (komennolla `sleela registry export`). Tarkista se komennolla
`sleela registry` tai `registry/build/sleela-registry review`. Katso
[rekisterin opas](../../registry/README.md) ja [Registry 3.0 -arkkitehtuuri](../../registry/REGISTRY-3.0-ARCHITECTURE.md).
Tarkista esivaatimukset ja alustakohtaiset vaiheet rakennus- ja testausoppaista. Yhden komponentin onnistunut koonti ei todista, että jokainen kirjasto tai alusta olisi julkaisukunnossa.
## IV. Asennus
Kun natiivit tuotteet on rakennettu, asenna komennot ja suoritusympäristön tukitiedostot:
```sh
sudo make install
make install PREFIX="$HOME/.local" # user-local install, no sudo
make install DESTDIR="$PWD/package-root" # staged package install
make install-check
```
Perinteinen asennin käyttää oletuksena hakemistoja `/usr/local/bin`, `/usr/local/lib/sleela`
ja `/usr/local/share/sleela`. Se säilyttää olemassa olevan käynnistysmäärityksen ja kieltäytyy
korvaamasta seurantaan kuulumattomia olemassa olevia komentoja. Poisto
poistaa vain asentimen kirjaamat tiedostot ja säilyttää määrityksen sekä
seurantaan kuulumattoman suoritusaikaisen datan.
Pelkän pääpaketin kohdennettuun, ohjattuun käyttöönottoon — binäärit `sleela`,
`sleelvac` ja `nordshrift`, vakiokirjasto, protokollat ja
tukimoduulit — käytä puhdasta asenninta:
```sh
make clean-install # guided install of the main package only
```
Se tekee yhden pääpäätöksen (asennetaanko pääpaketti), sitten laajuusvalinnan
ja onnistumisen jälkeen valinnaisen valitsimen kuratoiduille lisämoduuleille. Vuorovaikutteisen
käyttöönoton työnkulku ja kaikki asennusvaihtoehdot on kuvattu osoitteessa
[Quick and Safe Install](../../install/README.md).
## V. Kieli ja suoritusympäristö
Normatiivinen kielioppi on [`SLEELA.syntax`](../../SLEELA.syntax). Repositorio dokumentoi tällä hetkellä syntaksin **3.0**; kääntäjän/työkalun versio ja lähdekielen syntaksiversio ovat eri asioita. Versio 3.0 lisää **`pure`- ja `gasoline`-dokumenttimerkit** (§30) — parin paljaita, kontekstuaalisia, vain deklaratiivisia Preonemeja, jotka tarkoittavat lähes samaa ja joista kumpikin merkitsee dokumentin aseman omalla rehellisyydellään. Syntaksi 3.0 yhdistää kielen pinnan 1.0–2.9 nykyiseksi normatiiviseksi editioksi säilyttäen kaikki ominaisuuskohtaiset vähimmäisportit. Edellinen pinta 2.9 lisää **`@mix`-seurannaiskentät** (§28) — luokka voi määritellä useita samannimisiä ilmentymäkenttiä, kun jokaisella on `@mix`, ja ne ymmärretään yhtenä indeksoituna ryhmänä (ylhäältä alas `1,2,3,…` tai manuaalisesti `@mix(1,2,3,...)`, jonka indeksien määrän on vastattava ryhmää). Se kantaa mukanaan kantaluvun 2 etumerkilliset/etumerkittömät leveät kokonaislukuperheet `int32`..`int16777216` (§24) ja `uint32`..`uint16777216` (§25) aiempien `long`/`int64`/`int128`-tyyppien (§21) päällä; **avainsanatukidokumentit** (§22); sekä **Preonemit** — vain deklaratiiviset dokumenttimerkit `author`/`authorial` (§18), `material`/`memory` (§19–§20), `determine` (§23), `object`/`field` (§26), `pure`/`gasoline` (§30) ja `artifact` (§35, lainsäädäntötason asema, joka on arvioitu ajan ja paikan suhteen), yhdessä nimeltään Preonemit (§26.1). Konstruktorin ylikuormituksen ratkaisu sekä `this(...)`-/kantakonstruktoridelegointi ovat nimenomaisesti varmennetun syntaksin 1.8 sopimuksen ulkopuolella. Tutustu kielioppiin ja toteutusmuistiinpanoihin ennen kuin turvaudut ominaisuuteen. SleelaDocin yhdeksän lähdeyksikköä ilmoittavat nyt `#sleela 3.0`; jaettu kääntäjäportti hyväksyy lähdesyntaksin 1.0–3.0. Uusi API-koonti tuotetaan komennolla `make api-docs`.
Repositorio sisältää natiivin C/C++-toteutuksen, SLVM-generointiviitteet, vakiokirjastomoduulit, testit, esimerkit ja alustaintegraatiot. Toteutuksen ja validoinnin tila vaihtelee moduuleittain; tarkista moduulin määrittely ja ajantasaiset CI-tulokset sen sijaan, että olettaisit yhtenäisen täydellisyyden.
## VI. Suunnitteluperiaatteet
- **Näyttö väitteiden sijaan:** erota toteutettu, testattu, kokeellinen ja suunniteltu käyttäytyminen toisistaan.
- **Yksi sopimus rajaa kohti:** dokumentoi syntaksi, API:t, tiedostomuodot, alustaoletukset ja virhekäyttäytyminen.
- **Siirrettävyys suunnittelun lähtökohtana:** eristä alustakohtaiset taustajärjestelmät ja testaa natiiveilla ajureilla.
- **Turvallinen epäonnistuminen:** testaa virheellinen syöte, resurssirajat, prosessivirheet ja siivouspolut.
- **Toistettavat julkaisut:** rakenna puhtaasti uudelleen ja julkaise artefaktien tiivisteet sekä julkaisutiedot.
## VII. Virustorjunnan koonti ja eheys
Sleelavirin-virustorjuntapaketti sisältää natiivin SHA-256-skannerin, valinnaisen
ClamAV-sovittimen, lähde- ja indeksieheysmanifestit sekä alustapakettien tarkistussummat.
Rakenna ja testaa paketti repositorion juuresta:
```sh
make antivirus
make antivirus-test
make antivirus-integrity
make antivirus-integrity-check MANIFEST=build/INTEGRITY-MANIFEST.json
```
Eheysmanifesti generoidaan hakemiston `antivirus/build/` alle; se kattaa seurannassa olevat
lähde- ja dokumentaatiosyötteet sekä suojatut allekirjoitusindeksitiedostot, mutta
jättää pois generoidun tulosteen ja muuttuvan ClamAV-välimuistin. ClamAV-tietokantojen
tilannekuvilla on omat manifestinsa. Julkaisu-ZIP-paketit sisältävät `INTEGRITY-MANIFEST.json`,
`SHA256SUMS` ja `.sha256`-sivutiedoston. Varmista ladattujen arkistojen tiivisteet
erikseen hankittua luotettua arvoa vastaan: arkiston vieressä säilytetty tarkistussumma ei
ole julkaisijan allekirjoitus. Katso [Sleelavirin-opas](../../antivirus/README.md),
[tietoturvatarkistuslista](../../antivirus/SECURITY.md) ja
[virustorjunnan koontityönkulku](../../.github/workflows/antivirus-binaries.yml).
Julkaisua ei pidetä varmennettuna, ennen kuin asiaankuuluvat CI-työt ovat läpäisseet
täsmälleen kyseisen julkaisucommitin ja syntyneet artefaktit on tarkastettu.
## VIII. SLeeLa-editoriteemat — Vim ja Emacs
SLeeLa sisältää koordinoidun joukon ammattimaisia tummia värimaailmoja **Vimille** ja **Emacsille** sekä natiivin C/C++-palettityökalun. Alkuperäinen **American Professional** -teema on edelleen oletus. Kymmenen kumppanipalettia on tarjolla erilaisten kulttuuristen ja institutionaalisten suunnitteluinspiraatioiden pohjalta; ne ovat tulkinnallisia suunnittelupaletteja, eivät minkään kansakunnan, kulttuurin, tuomioistuimen tai instituution virallisia esityksiä.
### Yksitoista teemaa ja niiden värit
| Teema | Tausta | Edustaväri | Avainsanat | Tyypit | Merkkijonot | Kommentit |
|---|---|---|---|---|---|---|
| **American Professional** | `#101820` | `#F4F7FA` | `#7FB3FF` | `#73DACA` | `#F2C078` | `#8A96A3` |
| **Pan-Eurasian** | `#111827` | `#F0F2F5` | `#7AA7E8` | `#69C9B3` | `#D7B56D` | `#8995A5` |
| **Russian and Slavic — Medium** | `#202733` | `#E8EAF0` | `#A9C0DD` | `#8FC4B2` | `#D6BD8B` | `#9AA3AF` |
| **Central Asian / Silk Road** | `#1C2529` | `#F5F0E5` | `#7FADE0` | `#45C6C2` | `#D9B56D` | `#92A3A0` |
| **East Asian** | `#171A1C` | `#F2EFE7` | `#D97878` | `#72C7A5` | `#D8B76A` | `#969F9B` |
| **ICC — International Criminal Court** | `#0E1A2B` | `#EAF0F7` | `#5B8FD6` | `#7FB7C9` | `#D9B25A` | `#7E8CA0` |
| **SCOTUS — U.S. Supreme Court** | `#1A1416` | `#F3EEE6` | `#9E2B35` | `#8FA9B8` | `#C9A24B` | `#8C8178` |
| **Greek (Hellenic)** | `#0A1A30` | `#FFFFFF` | `#2E7BD6` | `#5E9FE0` | `#9FC3EC` | `#6E86A6` |
| **Turkish (Al Bayrak)** | `#2A0609` | `#FFFFFF` | `#F23D48` | `#F0A9AE` | `#F0C9A9` | `#A8767A` |
| **Kiro** | `#0B0B12` | `#F5F5FA` | `#A98EDA` | `#6E8BE0` | `#E8C547` | `#6A6482` |
| **SLeeLa** | `#08080E` | `#FFFFFF` | `#B07CFF` | `#5A7CFF` | `#FFD21E` | `#6E5F9E` |
#### Kansallisten lippujen värit (lähdepaletti)
Kreikan ja Turkin teemat on johdettu maiden **virallisista kansallislippujen väreistä**, jotka on esitetty tässä tarkkoine julkaistuine heksa-arvoineen. Yllä olevat teemojen taustat ja korostusvärit ovat näiden lähdevärien tummennettuja, editoriystävällisiä tulkintoja — alla oleva taulukko on ”kansallisesti esitetyt värit” -viite.
| Valtio | Väri | Heksa | Perusta ja merkitys |
|---|---|---|---|
| **Kreikka** | Sininen | `#0D5EAF` | Kansallislipun sininen (laki 851/1978). Taivas ja meret; heraldisesti kuvattuna *azure*. |
| **Kreikka** | Valkoinen | `#FFFFFF` | Kansallislipun valkoinen. Itsenäisyystaistelun puhtaus; risti tarkoittaa itäortodoksista kristinuskoa. |
| **Türkiye** | Punainen (*al bayrak*) | `#E30A17` | Kansallislipun punainen (Turkin lippulaki). Kenttä; perinteisesti marttyyrien veri ja ottomaanien suvereniteetti. |
| **Türkiye** | Valkoinen | `#FFFFFF` | Kansallislipun valkoinen. Puolikuu ja tähti — rauha, puhtaus sekä turkkilaisen/islamilaisen perinnön symboli. |
Teemat ankkuroivat kunkin editorin edustavärin kansalliseen **valkoiseen** ja avainsanat, kohdistimen, valinnan sekä tilarivin täsmälliseen kansalliseen **siniseen** (`#0D5EAF`) tai **punaiseen** (`#E30A17`), joten olennaiset värit ovat kirjaimellisesti kansallisia värejä. Nämä ovat tulkinnallisia suunnittelupaletteja; lippuvärien viite on annettu alkuperän osoittamiseksi, eikä se ole kummankaan valtion virallinen esitys. Värien merkitykset noudattavat Helleenien tasavallan ulkoministeriön valtion symbolien kuvausta ja Turkin lippulain perinnettä.
### Värimallitaulukko
Alla olevien palettisolujen **SVG-näytteet** saavat GitHubin renderöimään todelliset värit tyhjien HTML-värisolujen sijaan. Jokainen kaista näyttää kuusi väriä tässä järjestyksessä: tausta, edustaväri, avainsanat, tyypit, merkkijonot ja kommentit. Tarkat heksakoodit on lueteltu kunkin näytteen vieressä samassa teemajärjestyksessä kuin yllä olevassa viitetaulukossa.
| Teema | Renderöidyt palettivärit | Heksakoodit (tausta · edustaväri · avainsanat · tyypit · merkkijonot · kommentit) |
|---|---|---|
| **American Professional** |  | `#101820` · `#F4F7FA` · `#7FB3FF` · `#73DACA` · `#F2C078` · `#8A96A3` |
| **Pan-Eurasian** |  | `#111827` · `#F0F2F5` · `#7AA7E8` · `#69C9B3` · `#D7B56D` · `#8995A5` |
| **Russian and Slavic — Medium** |  | `#202733` · `#E8EAF0` · `#A9C0DD` · `#8FC4B2` · `#D6BD8B` · `#9AA3AF` |
| **Central Asian / Silk Road** |  | `#1C2529` · `#F5F0E5` · `#7FADE0` · `#45C6C2` · `#D9B56D` · `#92A3A0` |
| **East Asian** |  | `#171A1C` · `#F2EFE7` · `#D97878` · `#72C7A5` · `#D8B76A` · `#969F9B` |
| **ICC — International Criminal Court** |  | `#0E1A2B` · `#EAF0F7` · `#5B8FD6` · `#7FB7C9` · `#D9B25A` · `#7E8CA0` |
| **SCOTUS — U.S. Supreme Court** |  | `#1A1416` · `#F3EEE6` · `#9E2B35` · `#8FA9B8` · `#C9A24B` · `#8C8178` |
| **Greek (Hellenic)** |  | `#0A1A30` · `#FFFFFF` · `#2E7BD6` · `#5E9FE0` · `#9FC3EC` · `#6E86A6` |
| **Turkish (Al Bayrak)** |  | `#2A0609` · `#FFFFFF` · `#F23D48` · `#F0A9AE` · `#F0C9A9` · `#A8767A` |
| **Kiro** |  | `#0B0B12` · `#F5F5FA` · `#A98EDA` · `#6E8BE0` · `#E8C547` · `#6A6482` |
| **SLeeLa** |  | `#08080E` · `#FFFFFF` · `#B07CFF` · `#5A7CFF` · `#FFD21E` · `#6E5F9E` |
Funktioille, vakioille, valinnoille, diagnostiikalle ja esikääntäjän direktiiveille käytetään lisäkorostusvärejä. Venäläinen ja slaavilainen paletti käyttää tarkoituksella keskivoimakkaita liuskekiven, sinisen, salvian, rubiinin ja antiikkikullan sävyjä rauhallisemman ammattimaisen ilmeen aikaansaamiseksi.
### Vim-teemojen asennus
Repositorion juuresta:
```sh
mkdir -p ~/.vim/{syntax,ftdetect,colors}
cp lib/linux-editors/vim/syntax/sleela.vim ~/.vim/syntax/
cp lib/linux-editors/vim/ftdetect/sleela.vim ~/.vim/ftdetect/
cp lib/linux-editors/vim/colors/sleela-*.vim ~/.vim/colors/
```
Lisää seuraava tiedostoon `~/.vimrc` ottaaksesi SLeeLa-syntaksikorostuksen käyttöön ja valitaksesi teeman:
```vim
syntax enable
set background=dark
colorscheme sleela-american
```
Valitse täsmälleen yksi seuraavista colorscheme-nimistä:
- `sleela-american`
- `sleela-eurasia`
- `sleela-russian-slavic`
- `sleela-silk-road`
- `sleela-east-asian`
- `sleela-greek`
- `sleela-turkish`
- `sleela-kiro`
- `sleela-sleela`
Käytä esimerkiksi `colorscheme sleela-russian-slavic` keskivoimakkaalle venäläiselle ja slaavilaiselle paletille tai `colorscheme sleela-greek` / `colorscheme sleela-turkish` helleeniselle ja Al Bayrak -paletille. Käynnistä Vim uudelleen tai lataa määritys komennolla `:source $MYVIMRC`.
### Emacs-teemojen asennus
Luo paikallinen teemahakemisto ja kopioi tila- ja teematiedostot repositorion juuresta:
```sh
mkdir -p ~/.emacs.d/sleela
cp lib/linux-editors/emacs/sleela-mode.el ~/.emacs.d/sleela/
cp lib/linux-editors/emacs/sleela-*-theme.el ~/.emacs.d/sleela/
```
Lisää tämä tiedostoon `~/.emacs` tai `~/.emacs.d/init.el`:
```elisp
(add-to-list 'load-path (expand-file-name "~/.emacs.d/sleela"))
(add-to-list 'custom-theme-load-path (expand-file-name "~/.emacs.d/sleela"))
(require 'sleela-mode)
(load-theme 'sleela-american t)
```
Korvaa `sleela-american` arvolla `sleela-eurasia`, `sleela-russian-slavic`, `sleela-silk-road`, `sleela-east-asian`, `sleela-greek`, `sleela-turkish`, `sleela-kiro` tai `sleela-sleela` valitaksesi toisen teeman. Jos Emacs kysyy, luotetaanko teemaan, tarkista paikallinen teematiedosto ennen hyväksymistä.
### Natiivien C/C++-palettien esikatselu
Pieni natiivi palettityökalu osaa luetella teemat, tulostaa niiden päätteen värit ja hakea yksittäisen värin:
```sh
make -C linux-editors
./linux-editors/build/sleela-editor-theme --themes
./linux-editors/build/sleela-editor-theme --theme eurasia --palette
./linux-editors/build/sleela-editor-theme --theme russian-slavic --hex keyword
make -C linux-editors test
```
Taaksepäinyhteensopivuuden vuoksi `--palette` ja `--hex COLOR` ilman `--theme`-valitsinta valitsevat American Professionalin. Koonti- ja testitulokset on tarkistettava kohdejärjestelmässä ja CI:ssä; komennon dokumentointi ei sellaisenaan todista, että se olisi läpäissyt testin.
Katso täydelliset palettikuvaukset ja työkalun tiedot [editoriintegraatio-oppaasta](../../linux-editors/README.md).
## IX. Osallistuminen
1. Lue dokumentaatiohakemisto ja testauskäytäntö.
2. Tee rajattuja muutoksia positiivisten ja negatiivisten testien kera.
3. Aja kohdennetut testit ja sen jälkeen laaja testikokonaisuus.
4. Ilmoita käyttöjärjestelmän ja työkaluketjun tiedot; älä kuvaa ohitettuja tarkistuksia läpäistyiksi.
SLeeLaa kehittää **MEARVK LLC**. Historiallinen aloitussivuaineisto on säilytetty tiedostossa [`docs/README-LEGACY.md`](../../docs/README-LEGACY.md).
## X. AE6E66 — Round Public -sähköpostin veroodotus
AE6E66-aloitteessa projektin ilmoitettu odotus on **$300,000,000.00 USD jokaista Round Public -sähköpostia kohti** ehdotettuna veromaksun määränä, joka liittyy kuhunkin kelpuutettuun Round Public -sähköpostiin.
Tämä lausuma kirjaa vain projektin odotuksen. Se **ei** ole oikeudellinen veropäätös, viranomaismääräys, tuomioistuimen tuomio eikä itsenäisesti vahvistettu verovelvollisuus. Todellinen vero edellyttäisi toimivaltaista oikeudellista viranomaista, lainkäyttöaluetta, määritelmiä, menettelyä ja pätevää valtiollista päätöstä.
## XI. Aakkoset ja merkistön suoritusympäristö
SLeeLan aakkosdokumentaatiota ja natiivia merkkien suoritusympäristöä ylläpidetään hakemistoissa alphabet/sleela/ ja lib/alphabet/native/. Natiivit C++17-testit kattavat tiukan UTF-8-skalaarien dekoodauksen/enkoodauksen, C-kapasiteettiallekirjoitukset ja rajatun merkistöjäsenyyden:
make -C lib/alphabet/native test
Kokeellinen UTF-4088-luettelo ja sen SLeeLa-hakusovitin on dokumentoitu tiedostossa utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. UTF-4088-tunnisteet ovat erillinen nimiavaruus, eivät Unicode-skalaariarvoja. Kääntäjän ja SLVM:n sidostyö on nimenomaisesti erillään seurannassa näistä natiiveista perustoista.
## XII. AutoCAD Creator™
[AutoCAD Creator™](../../autocad/creator/README.md) on vuorovaikutteinen 2D-CAD-
sovellus, joka on kirjoitettu kokonaan SLeeLalla. Siinä missä sisarsovellus AutoCAD Renderer muuntaa
suunnitelman piirrokseksi yhdellä kertaa, Creatorilla voi **luoda ja muuttaa** 2D-
AutoCAD-dokumenttia livenä — lisätä seiniä, huoneita, mittoja ja huomautuksia ja sitten siirtää,
nimetä uudelleen, vaihtaa tasoa, poistaa ja kumota lisäämänsä — sekä **tallentaa** tuloksen
todelliseksi AutoCAD DXF -piirrokseksi (R12-teksti, aukeaa AutoCADissa / LibreCADissa).
Sen graafinen käyttöliittymä on rakennettu **SleelaUI™**-kirjaston päälle, joka on SLeeLan oma alustariippumaton käyttöliittymätyökalupakki
(hakemistossa [`lib/user-interface`](../../lib/user-interface)) — ei JavaFX —
ja se nostaa esiin todellisen natiivin ikkunan X11:llä / Cocoalla / Win32:lla. Suunnittelu noudattaa yhtä sääntöä,
**”SleelaUI presents; SLeeLa decides”**: GUI ei koskaan laske geometriaa eikä kirjoita
DXF:ää. Jokainen työkalu antaa luonti- / muutos- / poisto- / kumoa- / tallenna-aikeen
auktoriteettiselle [`SLCadCreator`](../../lib/autocad/SLCadCreator.sleela)-luokalle, joka omistaa
muokattavan dokumentin ja käännettävän komentohistorian, kun taas piirtoalue vain esikatselee
Creatorin hallussa olevaa geometriaa.
Uudelleenkäytettävä muokkausmoottori sijaitsee hakemistossa [`lib/autocad`](../../lib/autocad) —
[`SLCadEntity`](../../lib/autocad/SLCadEntity.sleela),
[`SLCadDocument`](../../lib/autocad/SLCadDocument.sleela),
[`SLCadCommand`](../../lib/autocad/SLCadCommand.sleela) ja
[`SLCadCreator`](../../lib/autocad/SLCadCreator.sleela) — ja toimii päästä päähän ilman näyttöä.
GUI-kuori ja demo sijaitsevat hakemistossa [`autocad/creator`](../../autocad/creator):
```sh
make creator # from autocad/: run the Creator demo -> out/altered.dxf
```
Näytöllisellä koneella tämä avaa live-muokkausikkunan; näyttämättömällä isännällä se rakentaa
piirroksen muistissa, tulostaa raportin ja DXF:n sekä päättyy siististi.
## XIII. UTF-4088-syöttökartan järjestys
Erikoistunut UTF-4088-luettelo määrittelee tilallisen syöttökarttansa läpikäynnin ja abstraktit painekierrokset tiedostossa [`utf-4088/INPUT-MAP-AND-PRESSURE.md`](../utf-4088/INPUT-MAP-AND-PRESSURE.md). National Lien -aiheindeksikäytäntö on tiedostossa [`utf-4088/NATIONAL-LIEN-REGISTER.md`](../utf-4088/NATIONAL-LIEN-REGISTER.md). Karttakoordinaatit, painetasot (1–50), pysyvät luettelotunnisteet ja aakkosjärjestysluokat ovat toisistaan riippumattomia kenttiä; mitään niistä ei saa huomaamatta korvata toisella. Paine on algoritminen iteraatiotaso, ei fysikaalinen suure.
## XIV. Viimeaikainen ja laajennettu pakettihakemisto
Tämä liitetty hakemisto nostaa esiin äskettäin laajennettuja paketteja, aluekirjastoja ja
lähdekokoelmia. Merkinnät on ryhmitelty aakkosjärjestykseen paketin nimen tai aiheen mukaan.
Kuvaukset osoittavat repositoriosijainnin; toteutuksen ja validoinnin
tila on tarkistettava kunkin paketin omasta dokumentaatiosta ja testeistä.
### A–C
- **Advantage** — `lib/advantage/` ja `advantage/`: ainutlaatuisen osingon
hyödyntäminen suhteessa malliin kerroksellisena Sequitur-sipulina, viidellä
aiheen alikansiolla — `math/` (yhteisen voiton maksimointi, Nash-neuvottelu,
kahdenvälinen newsvendor), `physics/` (luottamuskentän metriikka/geodeesi/kontakti/SDE,
merkitty mallinnusanalogia), `integration/` (vertikaalisen integraation
lokerot ja hienostuneisuuspisteet), `grading/` (A–D-hienostuneisuuspiirin
arvostelija moduuleille ja joukoille) sekä `output/` (pääte- / CommonRails- /
pistoke-emit). Natiivi C/C++-kuluttaja (`advantage/`) linkittää mallin
toimiviin kauppaesimerkkeihin. Katso [`lib/advantage/README.md`](../../lib/advantage/README.md)
ja [`DEFINITIONS.md`](../../lib/advantage/DEFINITIONS.md).
- **Alphabet ja UTF-4088** — `alphabet/sleela/`, `lib/alphabet/native/` ja
`utf-4088/`: aakkosluettelot, natiivi merkistötuki, syöttökartan
järjestys ja UTF-4088-integraatiodokumentaatio.
- **AutoCAD Creator** — `autocad/creator/` ja `lib/autocad/`: vuorovaikutteiset
2D-piirtotyönkulut ja uudelleenkäytettävät CAD-dokumentti-/muokkauskomponentit.
- **Ballum** — pikselitason näytönhallinta: pikselikohtainen set/get, alueen blit,
koko näytön kirkkaus/lämpö/gamma, osoitin- ja näppäimistösyöte sekä
**kokoruudun kehyspuskuripinta** täydelle, omistetulle ja nopealle pikselikohtaiselle hallinnalle
(override-redirect-ikkuna + yksi `XPutImage`/MIT-SHM-esitys Linux/X11:llä).
Natiivi ydin hakemistossa `ballum/`, SLeeLa-julkisivu hakemistossa `lib/ballum/` ja VM-
silta hakemiston `impl/` alla; katso [`ballum/README.md`](../../ballum/README.md) ja
ajettava [`ballum/example/`](../../ballum/example/).
- **CDMA** — `cdma/` ja `lib/cdma/`: CDMA:han liittyvä tekninen aineisto ja
SLeeLa-lähdekirjastotyö.
- **Character** — `lib/character/`: hahmoprofiilit ja uudelleenkäytettävät hahmotilastot,
mukaan lukien elämäkertaprofiiliesimerkit.
- **Coorenagraph** — `lib/coorenagraph/`: eettinen päättely, moraalisanasto,
harkinta ja niihin liittyvät käsitteet; katso paketin README ja lähdetiedostot.
### D–G
- **Governance-lähdemallit** — [lib/governance](../../lib/governance/README.md) määrittelee deklaratiiviset SLeeLa-lähdemuodot ehdotuksille, anonyymeille manuaalisille äänestyslipuille ja koosteäänille. Ehdotettu @vote-merkintä ja manuaalinen prosessi on dokumentoitu tiedostossa [registry/DEMOCRATIC-VOTING-SYNTAX.md](../../registry/DEMOCRATIC-VOTING-SYNTAX.md); nykyiset kääntäjät käsittelevät sitä toimimattomana kommenttimetatietona.
### H–I
- **HTTP 1.0–8.0** — `lib/http-1.0/` aina saatavilla oleviin versioituihin HTTP-
pakettihakemistoihin asti: versiokohtaiset protokollamäärittelyt ja
toteutukset. Tarkista kunkin version dokumentaatiosta sen tarkka laajuus
ja varmennuksen tila.
- **International Criminal Court** — `lib/international-criminal-court/` ja
`INTERNATIONAL.CRIMINAL.COURTS.md`: aiheeseen liittyvä aluekohtainen lähdekoodi ja
dokumentaatio.
### O–S
- **OFDMA** — `ofdma/`: ortogonaalisen taajuusjakomonikäytön (OFDMA)
tekninen aineisto ja C/C++-kehitysresurssit.
- **Philosophy ja Conversation Mask -moduuli** — [`philosophy/`](../../philosophy/README.md)
sisältää natiivit C/C++-perustat, ja [`philosophy/module/`](../../philosophy/module/README.md)
jäsentää niiden seuraavan moduulikerroksen kolmeen eksplisiittiseen alueeseen:
[`data/`](../../philosophy/module/data/README.md) tyypitetyille, päivätyille havainnoille,
tapahtumien päätöksille, puoliintumisaika-asetuksille, alkuperälle ja suostumukselle; [`helper/`](../../philosophy/module/helper/README.md)
deterministiselle validoinnille, relevanssin vaimenemiselle, yhteensopiville vertailuille ja
suostumussuodatetulle esittämiselle; sekä [`psychiatry-friend/`](../../philosophy/module/psychiatry-friend/README.md)
tukevalle, ei-kliiniselle keskustelurajapinnalle. SLeeLa-puolen
kahvat ja koostettu Tree sijaitsevat hakemistossa [`lib/philosophy/`](../../lib/philosophy/README.md),
laajemman filosofiapaketin rinnalla. Moduuli perustuu eksplisiittiseen syötteeseen ja
suostumukseen ensin: se ei passiivisesti seuraa ihmisiä tai mediaa, ei tee diagnooseja, ei päättele
yksityisiä aikeita, ei pisteytä ihmisen arvoa eikä suosita lääkityksen muutoksia. Sen
tapahtumalinkit säilyttävät alkuperän ja navigoinnin, eivät riippumatonta vahvistusta.
- **Synchro** — natiivi suoritusympäristö-/kääntäjäintegraatio sekä pakettien välitykseen
ja mittaukseen liittyvä toiminnallisuus; katso asiaankuuluva `impl/`-lähde ja
kääntäjätoteutus.
- **SleelaUI / terminal UI** — `lib/user-interface/` ja
`sleela-terminal`-projekti: SLeeLa-käyttöliittymäintegraatio ja päätepohjaiset
vuorovaikutuskomponentit.
### U–W
- **United Nations** — `united-nations/`: aluekohtaiset repositorioaineistot.
- **Wi-Fi 4, Wi-Fi 5 ja Wi-Fi 6** — `wi-fi-4/`, `wi-fi-5/`,
`wi-fi-6/` ja niihin liittyvät `lib/wifi/`-lähdehakemistot: sukupolvikohtainen
langattoman verkon aineisto ja määritysresurssit.
### Pakettihakemiston ylläpito
Kun paketti lisätään tai sitä laajennetaan olennaisesti, lisää sen merkintä tänne
asianmukaiseen aakkosryhmään, linkitä sen kanoniseen hakemistoon ja README-tiedostoon
ja kuvaa vain ominaisuudet, joita sisäänkirjatut lähteet tukevat. Pidä tämä
hakemisto additiivisena: älä poista tai kirjoita uudelleen olemassa olevia README-osioita
pakettihakemistopäivitysten yhteydessä.
---
##
XV. Bitcoin Conjegeum

bc1qs6v4q9zsw70t0umk3m0quhvf9dr6cdeskl28dh :: ⠝⠇⠼⠁⠟⠎⠼⠋⠧⠼⠙⠟⠼⠊⠵⠎⠺⠼⠛⠼⠚⠞⠼⠚⠥⠍⠦⠼⠉⠍⠼⠚⠟⠥⠓⠧⠦⠼⠊⠙⠫⠼⠋⠉⠙⠑⠎⠅⠇⠼⠼⠃⠼⠗⠙⠓
bc1qx33vma553gddsjkq372l3xlm8e8huv2vzad3cc :: ⠃⠉⠼⠁⠟⠭⠼⠉⠼⠉⠪⠍⠁⠼⠑⠑⠛⠙⠙⠎⠚⠅⠟⠼⠉⠼⠛⠼⠝⠇⠼⠉⠼⠭⠇⠍⠼⠨e⠼⠨a⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉
US Democratic and US Policy.
---
## XVI. Kansallinen tiedebrändikuvasto


## XVII. UTF-4088:n miljoonan merkinnän kokeellinen luettelo
[UTF-4088-luettelogeneraattori](../../utf-4088/tools/generate_catalogue.py) rakentaa deterministisesti 1 048 576 merkinnän kokeellisen symboliluettelon. Dokumentoitu kompakti muoto on kuvattu tiedostossa [utf-4088/FORMAT.md](../../utf-4088/FORMAT.md); generoinnin ja validoinnin sopimus on tiedostossa [utf-4088/GENERATION-RESULTS.md](../../utf-4088/GENERATION-RESULTS.md).
Aja generaattori Python 3:lla:
```sh
python3 utf-4088/tools/generate_catalogue.py \
--output utf4088-million.bin \
--summary utf4088-million.summary.json
```
Generoitu binääri on 16 777 244 tavua, ja se on suunniteltu pysymään alle 20 000 000 tavun. Yksikkötestit ja GitHub Actions -työnkulku varmentavat merkintöjen määrän, glyfien yksilöllisyyden, koon ja SHA-256:n; onnistuneet ajot julkaisevat binäärin ja yhteenvedon työnkulun artefaktina `utf4088-million-catalogue`. Generoitu binääri pidetään tarkoituksella poissa Git-historiasta. UTF-4088 on edelleen kokeellinen eikä ole Unicode-yhteensopiva.
---
# SLeeLa


---
## XVIII. Viimeaikaiset lisäykset — Pi-vakio, Modium/Registry-käynnistys, sleelactl Math ja `@native`
Tämä osio kirjaa ominaisuudet, jotka lisättiin työssä 2026-11, uusimmat ryhmät ensin. Linkitetyt lähdetiedostot ja niiden varmennustila ovat ratkaisevia; tarkistettavana olevia muutoksia ei kuvata yhdistetyiksi, ennen kuin ne ovat tulleet haaraan `master`.
### 100 000 000 numeron Pi-luettelovakio
Repositorio sisältää varmennetun **sadan miljoonan numeron** π-arvon tiedostossa [`pi-generator/pi.100000000.digits`](../../pi-generator/pi.100000000.digits) (hyvin muodostettu desimaaliluku, `3.14159…`) sekä 57 344 numeron arvon [`pi-generator/pi.57344.digits`](../../pi-generator/pi.57344.digits). Molemmat on itsenäisesti varmennettu aidoksi π:ksi — katso [`pi-generator/VERIFIED.md`](../../pi-generator/VERIFIED.md), joka dokumentoi tarkistukset (oppikirjan etuliite, Feynmanin piste murto-osan paikassa 762, kuuluisa miljoonas numero, yhtäpitävyys tiedoston `lib/math/SLPiReference.sleela` kanssa sekä koko tiedoston numerofrekvenssianalyysi) ja yhden ajon toistoskriptin.
### Modium™ / Registry™ lataavat Pi-vakion alijärjestelmän käynnistyksessä
Omistetuissa alijärjestelmän sisääntulopisteissä — `sleela registry` ja `sleela modium` (sekä asentimen ensimmäinen ajo), **ei** jokaisella `sleela run` -ajolla — Modium- ja Registry-alijärjestelmät lataavat suuren π-luettelovakion. Interaktiivisessa päätteessä ne tulostavat ohimenevän punaisen `Loading Modium™` / `Loading Registry™` -rivin, joka pyyhitään paikallaan pois ennen normaalin tulosteen alkua; vaikutus on tiukasti sidottu TTY:hyn, joten putkitettu ja testitulos pysyvät tavu tavulta muuttumattomina. Paikannin (ei tavut) kylvetään rekisterin `Math`-avaimen oletuksiksi `piReferenceLargePath` ja `piReferenceLargeDigits`, sekä SLeeLa-mallissa ([`lib/registry/SLRegistry.sleela`](../../lib/registry/SLRegistry.sleela)) että natiivissa kylväjässä ([`registry/sleela_registry.c`](../../registry/sleela_registry.c)); `lib/math/SLPiReference.sleela` tarjoaa `largePath()` / `largeDigits()`. π-vakio asennetaan käyttöjärjestelmän SLeeLa-sijaintiin (`/pi/`) **sekä** tavallisella `make`-asentimella että ohjatulla ”kauniilla” asentimella. Lisätiedot: [`pi-generator/MODIUM-REGISTRY-PI-STARTUP.md`](../../pi-generator/MODIUM-REGISTRY-PI-STARTUP.md).
### `sleelactl` — kaunis asennin ja natiivitukeinen `math`-subjekti
- Ohjattu (”kaunis”) asennin asentaa nyt `sleelactl`-työkalun (SLeeLan ohjaustaso) ja sen moduulirekisterin, kuten `make`-asennin. Katso [`bin/SLEELACTL.md`](../../bin/SLEELACTL.md).
- `sleelactl` sai uuden **`subject`**-luonteen suoritusympäristöön käännetyille natiiveille C/C++-subjektikirjastoille ja rekisteröi ensimmäisen niistä: **`math`**. `sleelactl run math` käyttää natiivia `__NativeMath`-taustaa (`impl/subjects/math/math_native.cpp`) päästä päähän subjektin viitedemon kautta; `sleelactl info math` selittää, miten siihen päästään (`import math;`). Subjektiluonne tarjoaa vain `run info` — `check`-verbiä ei tarkoituksella ole, koska `sleela check` ei lataa SHEET-rekisteröityjä natiiveja subjekteja.
### `@native`, Native Drive ja monikielinen suoritus
Uusi **`@native`**-metodimerkintä pyytää kuuman metodin ennakkoon tehtävää natiivikäännöstä. Uusi `sleela aot` -komento etsii `@native`-metodit, varmistaa, että kukin kuuluu tuettuun *ulkoistettavaan osajoukkoon*, ja tuottaa C/C++:aa — **epäonnistuen suljetusti** (kieltäytyen täsmällisellä syyllä) kaikista rakenteista, joita se ei vielä osaa kääntää, jolloin puoliksi käännettyä metodia ei koskaan synny.
```sh
sleela aot --list # per-method verdict: ok / REFUSED (reason)
sleela aot --emit # emit C/C++ (stdout) for an in-subset program
```
`@native` on edelleen pyyntö AOT-käsittelystä, ja tukemattomat rakenteet hylätään ennen tuottamista. [Native Drive](../../impl/native-drive/README.md) tukee usean yksikön C/C++-suoritettavien ja jaettujen kirjastojen koontia isäntäkääntäjillä (MSVC mukaan lukien), tuettua SLeeLa AOT -tulostetta, symbolien tarkastusta natiivilataajan ABI:a vasten, kuoretonta prosessin suoritusta, stdin/stdout/stderr-käsittelyä, monivaiheista putkitusta sekä XClass-delegointia tuotantolataajalle. `sleelactl` tarjoaa sen koonti-/ajokomennot ja reitittää XClass-tarkastuksen sekä nimenomaisen systemd-yksikön renderöinnin ja asennuksen komennon `inspect native-drive` kautta. VM omistaa rajatun natiivimoduulikahvataulukon, jossa on pakollinen isäntävaltuutus ja sukupolvitarkistetut kahvat. Syntaksi 3.0 lisää nyt `nativeOpen`, `nativeCall` ja `nativeClose`: vain lisäävä tavukoodivälitys ylittää erikseen versioidun null/bool/int64/double/UTF-8 -ABI:n, kun taas VM:n omistamat taulukot, structit ja muut yhdistetyt arvot pysyvät tulkin sisällä ja voivat käyttää samannimistä tavukoodivaraa. Lisäosat voivat valinnaisesti saada versioidun isäntäkutsutaulun, jolla ne kutsuvat täsmällisiä SLeeLa-funktioita sisäkkäisen VM-suorituksen kautta; keskeytettyjen pinojen GC-juuritus, nimenomainen isäntäkutsunimien sallittujen lista ja rekursiiviset natiivit API-kutsut hylätään. Natiivi koodi pysyy luotettuna prosessinsisäisenä koodina, ei hiekkalaatikkona. Lähteen prosessipolitiikkamerkinnöillä on versioitu skeema, mutta niitä ei vielä jäsennetä/pakoteta. Lisätiedot, turvallisuusrajat ja seitsemän työvirran kirjanpito: [Native Drive](../../impl/native-drive/README.md) ja [`pi-generator/AT-NATIVE.md`](../../pi-generator/AT-NATIVE.md).
## XIX. Kansainväliset README-editiot
SLeeLa tarjoaa maakohtaiset README-aloituspisteet kansainvälisen editionsa 50 markkinalle. Jokaisella maalla on yksi tiedosto nimeltä `README..md`; missä useat kielet ovat relevantteja, ne on ryhmitelty kyseisen maan tiedoston sisään.
- [README.AE](README.AE.md)
- [README.AT](README.AT.md)
- [README.AU](README.AU.md)
- [README.BE](README.BE.md)
- [README.BR](README.BR.md)
- [README.CA](README.CA.md)
- [README.CH](README.CH.md)
- [README.CL](README.CL.md)
- [README.CN](README.CN.md)
- [README.CO](README.CO.md)
- [README.CZ](README.CZ.md)
- [README.DE](README.DE.md)
- [README.DK](README.DK.md)
- [README.EE](README.EE.md)
- [README.ES](README.ES.md)
- [README.FI](README.FI.md)
- [README.FR](README.FR.md)
- [README.GB](README.GB.md)
- [README.GR](README.GR.md)
- [README.HK](README.HK.md)
- [README.HU](README.HU.md)
- [README.ID](README.ID.md)
- [README.IE](README.IE.md)
- [README.IL](README.IL.md)
- [README.IN](README.IN.md)
- [README.IS](README.IS.md)
- [README.IT](README.IT.md)
- [README.JP](README.JP.md)
- [README.KR](README.KR.md)
- [README.LU](README.LU.md)
- [README.MX](README.MX.md)
- [README.MY](README.MY.md)
- [README.NL](README.NL.md)
- [README.NO](README.NO.md)
- [README.NZ](README.NZ.md)
- [README.PH](README.PH.md)
- [README.PL](README.PL.md)
- [README.PT](README.PT.md)
- [README.QA](README.QA.md)
- [README.RU](README.RU.md)
- [README.SA](README.SA.md)
- [README.SE](README.SE.md)
- [README.SG](README.SG.md)
- [README.SI](README.SI.md)
- [README.SK](README.SK.md)
- [README.TH](README.TH.md)
- [README.TR](README.TR.md)
- [README.TW](README.TW.md)
- [README.US](README.US.md)
- [README.ZA](README.ZA.md)
**Käännöskäytäntö:** Nämä tiedostot ovat alustavia lokalisoituja maakohtaisia aloituspisteitä. Niiden johdannot ja kieliotsikot on lokalisoitu, kun taas täydellinen tekninen viite säilyy kanonisessa englanninkielisessä tiedostossa [README.md](../../README.md). Maatiedostoa ei saa kuvata täydelliseksi käännökseksi, ennen kuin jokainen osio on käännetty, tekniset tunnisteet ja linkit on tarkistettu ja edition kieli on tarkastettu. Kielikattavuus tässä ensimmäisessä vaiheessa on edustava, eikä se ole väite siitä, että jokainen perustuslaillisesti tunnustettu, alueellinen, alkuperäiskansojen tai viittomakieli olisi käännetty täysin.
## Liite — säilytetty alueellinen ohjeistus
Tämä liite säilyttää aiemman lyhyen suomenkielisen oppaan käytännön ohjeet, joita ei ole omina osioinaan kanonisessa README-tiedostossa. Kanoninen englanninkielinen [README.md](../../README.md) on ensisijainen kaikissa ristiriitatilanteissa.
### Kääntäjän rakenne ja suoritusmalli
SLeeLa erottaa lähdekielen, kääntäjän frontendin, välimuodon, koodin generoinnin ja suoritusympäristön suorituksen. Kääntäjän julkaisuversio, syntaksiversio ja VM/ISA-versio ovat eri asioita. Ominaisuuden maininta määrittelyssä ei todista, että se olisi toteutettu kaikilla kohteilla.
Tavallinen putki lukee UTF-8-`.sleela`-lähdetiedostoja, tekee leksikaalisen ja syntaktisen analyysin, tarkistaa symbolit ja tyypit, muuntaa rakenteisen välimuodon, tuottaa tulosteen tuetuille VM- tai välikohteille ja suorittaa tuloksen suoritusympäristössä. Normatiivinen kielioppi on [SLEELA.syntax](../../SLEELA.syntax); katso myös [lähdedokumentaatio](../../markdown/SOURCE.md) ja [kääntäjädokumentaatio](../../markdown/COMPILER.md).
### Tyypit, oliot ja kirjastot
Dokumentoituun lähdetyyppien joukkoon kuuluvat `int`, `double`, `boolean`, `String`, `void`, ilmoitetut `struct`-tyypit ja tuetut viitetyyppien allekirjoitukset. `int`, `long` ja `int64` ovat etumerkillisiä 64-bittisiä kokonaislukuja. `int128` hyväksytään kokonaislukutyypiksi, mutta nykyinen dokumentoitu toteutus perustuu edelleen 64 bittiin.
`struct` on nimetty koosterakenne. VM:n hallitsema struct-kahva ei ole raaka osoitin; sijoitus ja parametrien välitys jakavat saman ilmentymän, ja yhtäsuuruus perustuu identiteettiin. Käytä dokumentoituja `structPack(instance)`- ja `structUnpack(TypeName, json)`-toimintoja siirrettävään serialisointiin. Luokat sisältävät kenttiä ja metodeja; perintä, sisäkkäiset luokat ja geneeriset tyypit ovat syntaksiversion rajaamia.
Keskeisiä moduuleja ovat `lib/advantage` (mallipohjainen arviointi, matematiikka, integraatio, luokittelu ja reititettävä tuloste), `lib/xml` (XML DOM), `lib/text` (teksti- ja merkkijono-operaatiot), `lib/sleeladoc` (lähdedokumentaatio ja CLI), `lib/cpu`, `lib/xlt` (CPU-profiilit ja ajoitusviitteet) sekä `recursion/stanchion` (C/C++-rekursioprototyypit). Moduulin olemassaolo ei todista tuotantovalmiutta; tarkista testit ja alustarajoitukset.
### Kohteet, profiilit ja natiivin suoritusraja
SLeeLa erottaa lähdekoodin suoritus- ja käännöskohteista. Dokumentoituun kohdeperheeseen kuuluvat `SLVM`, `SLJVM` ja `SLIR`; `NATIVE` on rajattu ja ehdollinen kohde, eikä sitä pidä olettaa yleisesti saatavaksi kaikilla alustoilla. Profiilit `BASIC_COMPLETE` ja `ADVANCED_TOTAL` kuvaavat eri laajuuksia. Varmista aina kyseisen koonnin todellinen kohde, profiili ja alustatuki.
Viite tunnistaa tiedoston, moduulin tai resurssin, mutta ei itsessään anna lupaa suorittaa sitä. Tämä on tärkeää, kun ohjelma käyttää tiedostoja, ulkoisia kirjastoja, native-sidoksia tai järjestelmäresursseja. Tarkista syötteet ja määritä selvästi, millä komponentilla on oikeus suorittaa toiminto. Dokumentaatioväite ei yksin todista suoritusaikaista tietoturvatakuuta ilman vastaavaa toteutus- tai testinäyttöä.
### Resurssien elinkaari ja vianmääritys
Dokumentoi funktioiden tai säikeiden välillä jaettujen resurssien omistajuus, elinkaari ja synkronointivastuu. Erota paikalliset muuttujat, jaettu oliotila, VM-kahvat ja serialisoitava data toisistaan. VM-paikallinen kahva ei ole vakaa tiedostomuoto tai verkkoviesti. Käytä moduulin määrittelemää serialisointirajapintaa ja testaa virheelliset, puuttuvat ja raja-arvoiset syötteet.
Vianmäärityksessä kirjaa commit, käyttöjärjestelmä, arkkitehtuuri ja työkaluketju. Aloita pienimmästä asiaankuuluvasta koonnista, tallenna koko virhetuloste ja erota kääntäjän virheet suoritusaikaisista virheistä. Pyri tuottamaan pieni toistettava esimerkki. Onnistunut koonti ei yksin todista ohjelman oikeaa toimintaa.
Hyvä varmennusraportti sisältää tarkan commitin, käyttöjärjestelmän ja arkkitehtuurin, kääntäjän versiot, täsmälliset koonti- ja testikomennot, läpäisseiden/epäonnistuneiden/ohitettujen testien määrät sekä tunnetut rajoitukset. Ohitettuja tai suorittamattomia testejä ei saa laskea läpäistyiksi.
### Moduulirajapinnat, yhteensopivuus ja testaus
Uuden API:n yhteydessä on kuvattava syötteet, tulosteet, virhetilanteet, tietojen omistajuus sekä mahdolliset sivuvaikutukset. Dokumentaatioesimerkkien tulee näyttää sekä tavallinen käyttö että virheellisten tai puuttuvien arvojen käsittely. Älä esitä takuuna toimintaa, jota toteutus ja testit eivät vahvista.
Jaa testaus kääntäjän vaiheiden mukaan: lekseeraus/jäsennys, semanttinen analyysi, IR-madallus, koodin generointi, VM-suoritus ja natiivi integraatio. Säilytä jokaisesta regressiotapauksesta pienin toistettava syöte, odotettu tulos ja todellinen tulos. API-muutoksissa on kuvattava taaksepäinyhteensopivuus, migraatiovaiheet ja vaikutukset olemassa oleviin esimerkkeihin.
### Huomautuksia viitteistä ja osoitteista
README:n viitteet aiheisiin kuten CSPML, Character, Governance, Synchro, SleelaUI ja United Nations kuvaavat repositorion sisältöä eivätkä ole viranomaisten tai instituutioiden virallisia hyväksyntöjä.
Osoitteiden tai kuvien esiintyminen osiossa **Bitcoin Conjegeum** (XV) ei ole sijoitussuositus, omistuksen vahvistus eikä ohje siirtää varoja. Tarkista tiedot itsenäisesti ennen käyttöä.
**Käännöksen tila:** Osiot I–XIX on käännetty suomeksi. Tekniset tunnisteet, komennot, koodiesimerkit, tiedostonimet, linkit ja osoitteet on säilytetty. Äidinkielisten puhujien suorittama lopullinen kielentarkistus on suositeltavaa.