feat: grow memory limits, add icon/actor libraries, overhaul LSP diagnostics

Compiler and VM
- make every memory map limit dynamic and adjustable at both build time and
  runtime, including compiler tables, stacks, and every execution region
- reserve and grow tables, operand and return stacks, frame segments, and
  image-building output without relocating live code or globals
- rename i/o and string helpers consistently (puts -> put_s, putn -> put_n,
  scat -> cat_s) across compiler, runtime, examples, tests, and docs
- recast and consume values assigned to globals from inside functions
- allow fixed and const together, add typed closure returns (fn:t(...)),
  multi-include syntax (include rt, run, core;), and recurse type inference
- never infer string literals as word, anywhere, as argument, variable, or
  return type
- draft docs/BORROW.md: a borrow checker less intrusive than Rust's but more
  intelligent

LSP and editor integration
- require explicit includes and give every toolchain area its own namespace
  (rt, lsp, run, core)
- hover for built-in types, inferred types, values known at hover time, array
  and pointer lifetime/size, library names in include statements, and inferred
  lifetimes with explanations
- honor /* */ comments as documentation for variables and arguments, and stop
  misattributing section headers or trailing comments as variable hints
- stream diagnostics and cancel stale requests on change
- jump to definition and references, including cross-file
- quick fixes with automatic library import, and namespace completion

Hints and diagnostics
- render hints as blue squigglies by default, with hints on/small/off per file
- suppress magic-number hints via a preceding /* */ comment, and say so
- warn on unused arguments; allow multiple _ discards in parameters, pattern
  matching, and tagged enums, warning if a _ is actually used
- rewrite hint and comment prose in professional compiler-doc register

Libraries
- add icon.zc: run-time self-modification, find/replace syntax, type and block
  edits, and step-through inspection of locals and globals
- add actor.zc: async actors with Actor<I,O>, implicit this, spawn/recv/send,
  injected into the compiler machinery at include time rather than built in

Tooling and docs
- reorganize sources, tests, and designs into subdirectories
- unify windows entry points in tinyvm.bat and add a matching tinyvm.sh
- add --help across the toolchain
- polish the learning guide, stdlib docs, and design notes

Tests
- add accept, reject, and regression coverage across the compiler, LSP,
- runtime, icon, actors, threads, formatting, and the toolchain contracts,
  plus fuzzers and property tests

1 files changed, 31 insertions, 0 deletions

diff --git a/tests/drivers/sourceprovider_test.js b/tests/drivers/sourceprovider_test.js
new file mode 100644
index 0000000..f9551da
--- /dev/null
+++ b/tests/drivers/sourceprovider_test.js
@@ -0,0 +1,31 @@
+// verify the extension's virtual source provider and its language-server request.
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const { createSourceProvider } = require('../../editors/vscode/client/sourceprovider.js');
+
+async function main() {
+    const calls = [];
+    const runtime = fs.readFileSync(path.resolve(__dirname, '..', '..', 'src', 'runtime', 'rt.zc'), 'utf8');
+    const provider = createSourceProvider(async (method, params) => {
+        calls.push({ method, params });
+        return runtime;
+    }, () => true);
+    assert.strictEqual(await provider.provideTextDocumentContent({ path: '/rt.zc' }), runtime);
+    assert.deepStrictEqual(calls, [{ method: 'zc/source', params: { path: '/rt.zc' } }]);
+
+    const missing = createSourceProvider(async () => null, () => true);
+    assert.strictEqual(await missing.provideTextDocumentContent({ path: '/missing.zc' }), '// no such built-in source\n');
+    const failed = createSourceProvider(async () => { throw new Error('closed'); }, () => true);
+    assert.strictEqual(await failed.provideTextDocumentContent({ path: '/rt.zc' }), '// the language server could not give this source\n');
+
+    let readyChecks = 0, delays = 0;
+    const starting = createSourceProvider(async () => runtime, () => ++readyChecks > 2, async () => { delays++; });
+    assert.strictEqual(await starting.provideTextDocumentContent({ path: '/rt.zc' }), runtime);
+    assert.strictEqual(delays, 2);
+    const stopped = createSourceProvider(async () => runtime, () => false, async () => {});
+    assert.strictEqual(await stopped.provideTextDocumentContent({ path: '/rt.zc' }), '// the language server is not running\n');
+    console.log('ok   virtual source provider waits for the server and returns embedded source text');
+}
+
+main().catch(error => { console.error(error); process.exitCode = 1; });