Add full compiler toolchain, libc, examples and reference docs

First substantive commit: the entire Sprinter C compiler tree on top of
the bare README+gitignore initial commit.

What's in here:
  bin/sprinter-cc        — driver script invoking SDCC + linker + mkexe
  libc/                  — Sprinter-specific libc layer over ESTEX/BIOS
                           (conio, gfx, io, mem, stdio + headers)
  runtime/               — crt0 variants (default/small/banked/minimal)
                           + heap + bank trampolines
  toolchain/             — mkexe (SprintEXE packer, C + tests)
  examples/              — 30 demo programs (gfx, file I/O, env, time, …)
  lib/Makefile           — builds the libc archive (sprinter.lib)
  docs/                  — converted Sprinter manuals + asm reference samples
  third_party/           — solid-c reference compiler dump + sdcc setup script
  release_docs/          — packaging / release notes

gitignore overhaul:
  • Drop dangerous blanket patterns: *.asm (would hide docs/samples/*.asm)
    and *.exe (case-insensitive match was hiding third_party/solid-c/*.EXE
    on macOS APFS).  Replaced with examples/*/*.{asm,exe,…} and lib/*.lib.
  • Restore tracking of toolchain/mkexe/tests/{one,big}.bin — those are
    INPUT fixtures, not build outputs.
  • Collapse the duplicated SDCC/C/Sdcc sections into one section per
    concern (build outputs / vendored / OS-junk).
  • Add .sprinter-cc-*/, build/ (catches lib/build/ too), .claude/.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

examples/conio/Makefile

@@ -0,0 +1,5 @@
+# Build conio_test.exe — uses lib/sprinter.lib in TINY memory mode.
+
+PROJ_ROOT := $(abspath $(CURDIR)/../..)
+EXAMPLE   := conio
+include $(PROJ_ROOT)/examples/example.mk

examples/conio/conio.c

@@ -0,0 +1,128 @@
+#include <stdio.h>
+#include <conio.h>
+#include <unistd.h>     /* sleep */
+
+/*
+ * Exercises every conio function:
+ *   clrscr  — clear the screen
+ *   gotoxy  — move cursor to (x, y), 0-based
+ *   putch   — single character
+ *   cputs   — string without auto-newline
+ *   kbhit   — non-blocking key probe
+ *   getch   — blocking, no echo
+ *   getche  — blocking, with echo
+ *
+ * Sprinter native text mode is 80×32, so we anchor corners at
+ * (0,0), (79,0), (0,31), (79,31).
+ */
+
+int main(void)
+{
+    /* 1. clrscr + diagnostic probes + a centered banner.
+     *
+     * Row-0 probe: figure out why [NW]/[NE] don't paint.
+     *   '0','1','2','3' — single putch at row 0, cols 0/5/40/79
+     *   "R0"            — cputs at row 0, col 10
+     *   'a','b','c','R1'— same pattern on row 1 (control)
+     */
+    clrscr();
+
+    gotoxy(0, 0);  putch('0');
+    gotoxy(5, 0);  putch('1');
+    gotoxy(40, 0); putch('2');
+    gotoxy(79, 0); putch('3');
+    gotoxy(10, 0); cputs("R0");
+
+    gotoxy(0, 1);  putch('a');
+    gotoxy(5, 1);  putch('b');
+    gotoxy(79, 1); putch('c');
+    gotoxy(10, 1); cputs("R1");
+
+    /* Bottom corners moved to row 30 to avoid the auto-wrap-scroll issue —
+     * cputs("[SE]") at (76, 31) ends with cursor at col 80 on the last row,
+     * which scrolls the screen up by one and eats everything we wrote at
+     * row 0.  By staying on row 30, no wraparound is triggered. */
+    gotoxy(0, 30);  cputs("[SW]");
+    gotoxy(76, 30); cputs("[SE]");
+
+    /* Row 31 single-char probes (col 0 + col 78, no col-80 reach). */
+    gotoxy(0, 31);  putch('L');
+    gotoxy(78, 31); putch('R');
+
+    gotoxy(30, 4);
+    cputs("== conio test ==");
+
+    /* wherex/wherey probe — place cursor at a known spot, read it back. */
+    gotoxy(15, 5);
+    int cx = wherex();
+    int cy = wherey();
+    gotoxy(0, 6);
+    printf("wherex/wherey after gotoxy(15,5) -> x=%d y=%d", cx, cy);
+
+    /* 2. putch — single chars in a diagonal. */
+    for (int i = 0; i < 16; i++) {
+        gotoxy(10 + i, 8 + i);
+        putch('*');
+    }
+
+    /* 3. kbhit polling loop with a spinning indicator. */
+    gotoxy(0, 14);
+    cputs("kbhit polling - press any key to interrupt");
+
+    static const char spin[] = "|/-\\";
+    int frame = 0;
+    while (!kbhit()) {
+        gotoxy(50, 14);
+        putch(spin[frame & 3]);
+        frame++;
+        /* small delay so the spin is visible (sleep is in 1-sec units;
+         * we want ~10 fps — implemented with a busy "halts" later, but
+         * here we just rely on kbhit being slow enough to be visible). */
+    }
+    int probed = kbhit();   /* re-read to clear / display */
+    gotoxy(0, 16);
+    printf("kbhit captured 0x%02X ('%c')", probed,
+           (probed >= 0x20 && probed < 0x7F) ? probed : '?');
+
+    /* 4. getch — drain the key + ask for one with no echo. */
+    gotoxy(0, 18);
+    cputs("getch (no echo) — press a key: ");
+    int k1 = getch();
+    gotoxy(0, 19);
+    printf("you pressed 0x%02X ('%c')", k1,
+           (k1 >= 0x20 && k1 < 0x7F) ? k1 : '?');
+
+    /* 5. getche — same but the keypress should appear on screen. */
+    gotoxy(0, 21);
+    cputs("getche (with echo) — press a key:   ");
+    gotoxy(36, 21);
+    int k2 = getche();
+    gotoxy(0, 22);
+    printf("you pressed 0x%02X (echoed above)", k2);
+
+    /* 6. Finish at the bottom; do NOT scroll. */
+    gotoxy(0, 28);
+    cputs("All conio functions exercised. Press any key to exit.");
+    
+
+    set_videotextmode(TEXT_MODE_40x32);
+    
+    for (int i = 0; i < 16; i++) {
+        wrchar(4 + i * 2, 3, i < 10 ? '0' + i : 'A' - 10 + i, 0x1F);
+        wrchar(4 + i * 2 + 1, 3, ' ', 0x1F);
+    }
+    for (int j = 0; j < 16; j++) {
+        wrchar(2, 4 + j, j < 10 ? '0' + j : 'A' - 10 + j, 0x1F);
+        wrchar(2 + 1, 4 + j, ' ', 0x1F);
+        for (int i = 0; i < 16; i++) {
+            wrchar(4 + i * 2, 4 + j, j * 16 + i, 0x2F);
+            wrchar(4 + i * 2 + 1, 4 + j, ' ', 0x2F);
+        }
+    }
+
+    (void)getch();
+
+    set_videotextmode(TEXT_MODE_80x32);
+
+    return 0;
+}

examples/conio/prob

@@ -0,0 +1,31 @@
+Задача -
+меняем алгоритм работы putch (и соответственно остальных ф-ий работающих через putch - cputs/cprintf и т.д.) -
+
+вводится еще одна глобальная переменная (с сеттером и геттером) - char - 
+как обрабатываются управляющие символы ф-иями вывода в conio - выводятся через wrchar или отрабатываются как управляющие
+если она 0 - то отрабатваются как управляющие -
+это символы 
+0x08 - BS - уменьшаем pc_col на 1 если она еще не равна 0 (если 0 - не меняется)
+0x09 - TAB - увеличиваем pc_col до ближайшего кратного 8-ми
+0x0A - LF - увеличиваем pc_row на 1 кроме случая когда pc_row = 32 - тогда уже не увеличиваем
+0x0D - CR - сбрасываем pc_col до 0
+в остальных случаях после вывода символа увеличиваем pc_col на 1 (но не более чем до 80)
+
+если же глобальная переменная 1 - то выводим ВСЕ символы as is через wrchar так же увеличивая pc_col на 1 (но не более чем до 80)
+
+Замечание - если pc_col == 80 или pc_row == 32 - можем просто не выводить символ
+(символы выводятся только если координаты X / Y = [0..79]/[0..31])
+
+такой режим только если attr <= 0x00FF, в противном случае - вывод через быстрый вывод без управления координат и цветом
+
+для ускорения предлагается создать raw putch который будет принимать в параметрах только символ и аттрибут.
+этой функции уже не надо будет проверять старший байт аттрибутов (а в аттрибуты будет принимать младший байт)
+этот raw putch всегда будет выводить через WRCHAR (но будет отрабатывать новый параметр - как отрабатывать управляющие сигналы)
+
+обычный putch вначале будет проверять attr что бы понять выводить через PUTCHAR (5B) или WRCHAR (58 - raw putch).
+аналогично cputs - вначале будет проверять attr что бы понять - выводить через PCHARS (5C - _cputs_pchars) или через WRCHAR (58 - raw putch)
+так же перед выводом и cputs и putcg будут получать текущие координаты для вывода и сохрнять их (если вывод идет через WRCHAR)
+
+то есть еще один пункт для оптимизации - мы должны только один раз получить кооринаты для вывода и один раз их сохранить 
+(если вывод через WRCHAR, если же через PUTCHAR/PCHARS - то за координаты отвечает уже сам ESTEX).
+