npm - future-lang - Versions diffs - 0.3.0 - Mend

future-lang 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (47) hide show

package/ARCHITECTURE.md +424 -0
package/MIGRATION.md +365 -0
package/README.md +370 -0
package/ROADMAP.md +263 -0
package/examples/adult.future +8 -0
package/examples/api.future +11 -0
package/examples/assistant.future +8 -0
package/examples/browser-demo.html +164 -0
package/examples/greet.future +7 -0
package/examples/hello.future +1 -0
package/examples/math.future +8 -0
package/examples/mini-app.html +301 -0
package/examples/smarthome.future +10 -0
package/future-browser.js +102 -0
package/future-playground.html +650 -0
package/package.json +27 -0
package/runtime/ai.js +92 -0
package/runtime/browser.js +458 -0
package/runtime/device.js +36 -0
package/runtime/home.js +19 -0
package/runtime/http.js +32 -0
package/runtime/index.js +403 -0
package/runtime/lsp-metadata.js +104 -0
package/runtime/math.js +16 -0
package/runtime/memory.js +61 -0
package/runtime/mqtt.js +49 -0
package/runtime/providers/anthropic.js +59 -0
package/runtime/providers/index.js +93 -0
package/runtime/providers/openai-compat.js +85 -0
package/runtime/providers/util.js +70 -0
package/runtime/rag/chunker.js +65 -0
package/runtime/rag/pipeline.js +86 -0
package/runtime/rag/vector-store.js +119 -0
package/runtime/rag.js +94 -0
package/runtime/schedule.js +77 -0
package/runtime/system.js +101 -0
package/runtime/tts.js +38 -0
package/runtime/vision.js +85 -0
package/server.js +42 -0
package/src/ast.js +202 -0
package/src/cli.js +391 -0
package/src/errors.js +21 -0
package/src/formatter.js +48 -0
package/src/generator.js +457 -0
package/src/index.js +48 -0
package/src/lexer.js +248 -0
package/src/parser.js +469 -0

package/examples/browser-demo.html ADDED Viewed

@@ -0,0 +1,164 @@
+<!DOCTYPE html>
+<html lang="pt">
+<head>
+  <meta charset="UTF-8">
+  <title>Future — Browser Demo</title>
+  <style>
+    body { font-family: monospace; max-width: 700px; margin: 2rem auto; padding: 0 1rem; background: #0d1117; color: #e6edf3; }
+    h1   { color: #58a6ff; }
+    h2   { color: #8b949e; font-size: 0.9rem; font-weight: normal; margin-top: 2rem; }
+    pre  { background: #161b22; padding: 1rem; border-radius: 6px; border: 1px solid #30363d; overflow-x: auto; }
+    #output { background: #0d1117; border: 1px solid #30363d; border-radius: 6px;
+              padding: 1rem; min-height: 60px; white-space: pre-wrap; color: #3fb950; }
+    .badge { display: inline-block; padding: 2px 8px; border-radius: 4px; font-size: 0.75rem; font-weight: bold; }
+    .demo  { background: #2d1b00; color: #f0a500; }
+    .proxy { background: #0d2b00; color: #3fb950; }
+    code   { font-family: monospace; }
+  </style>
+</head>
+<body>
+<h1>Future Language — Browser Runtime</h1>
+<!-- Step 1: load the Future runtime -->
+<script type="module" src="../future-browser.js"></script>
+<!-- Step 2: configure (runs after future-browser.js, same module tick) -->
+<script type="module">
+  import Future from '../future-browser.js';
+  // ── Option A: Proxy mode (production — API key stays on your server) ────────
+  // Future.configure({ proxy: '/api/ai' })
+  // ── Option B: Demo mode (dev only — key visible in source) ──────────────────
+  // Future.configure({ provider: 'openai',     apiKey: 'sk-...' })
+  // Future.configure({ provider: 'anthropic',  apiKey: 'sk-ant-...' })
+  // Future.configure({ provider: 'ollama' })   // local, no key needed
+  // ── Redirect print output to the page ───────────────────────────────────────
+  const out = document.getElementById('output');
+  Future.runtime.print = (...args) => {
+    const line = args.join(' ');
+    console.log(line);
+    if (out) out.textContent += line + '\n';
+  };
+</script>
+<!-- ─── Example 1: Basic — no AI needed ──────────────────────────────────── -->
+<h2>Example 1 — Basic (no AI required)</h2>
+<pre><code>names = ["Alice", "Bob", "Carlos"]
+for name in names
+  print "Olá, {name}!"
+end
+user = { name: "João"  age: 30 }
+if user.age >= 18
+  print "{user.name} é adulto"
+end</code></pre>
+<script type="future">
+names = ["Alice", "Bob", "Carlos"]
+for name in names
+  print "Olá, {name}!"
+end
+user = { name: "João"  age: 30 }
+if user.age >= 18
+  print "{user.name} é adulto"
+end
+</script>
+<!-- ─── Example 2: Memory ─────────────────────────────────────────────────── -->
+<h2>Example 2 — Memory (no AI required)</h2>
+<pre><code>memory.set("visits", 1)
+count = memory.get("visits")
+print "Visitas: {count}"</code></pre>
+<script type="future">
+memory.set("visits", 1)
+count = memory.get("visits")
+print "Visitas: {count}"
+</script>
+<!-- ─── Example 3: AI ─────────────────────────────────────────────────────── -->
+<h2>Example 3 — AI <span class="badge demo">requires API key or proxy</span></h2>
+<pre><code>try
+  answer = ai.ask("What is 2 + 2? Reply with just the number.")
+  print "AI diz: {answer}"
+catch err
+  print "AI não configurada — adiciona uma key ou proxy"
+end</code></pre>
+<script type="future">
+try
+  answer = ai.ask("What is 2 + 2? Reply with just the number.")
+  print "AI diz: {answer}"
+catch err
+  print "AI não configurada — adiciona uma key ou proxy"
+end
+</script>
+<!-- ─── Example 4: Agent ──────────────────────────────────────────────────── -->
+<h2>Example 4 — Agent <span class="badge demo">requires API key or proxy</span></h2>
+<pre><code>agent tradutor
+  use ai
+  resultado = ai.ask("Traduz para português: {goal}")
+  return resultado
+end
+try
+  pt = tradutor("Good morning, how are you?")
+  print pt
+catch err
+  print "Agent precisa de AI — adiciona uma key ou proxy"
+end</code></pre>
+<script type="future">
+agent tradutor
+  use ai
+  resultado = ai.ask("Traduz para português: {goal}")
+  return resultado
+end
+try
+  pt = tradutor("Good morning, how are you?")
+  print pt
+catch err
+  print "Agent precisa de AI — adiciona uma key ou proxy"
+end
+</script>
+<!-- ─── Output ────────────────────────────────────────────────────────────── -->
+<h2>Output</h2>
+<div id="output"></div>
+<!-- ─── Proxy server example ──────────────────────────────────────────────── -->
+<h2>Proxy server example <span class="badge proxy">production</span></h2>
+<pre><code>// server.js — guarda a tua key no servidor, nunca no browser
+import express from 'express'
+import { runtime } from 'future-lang/runtime'
+const app = express()
+app.use(express.json())
+runtime.ai.configure('openai', process.env.OPENAI_KEY)
+app.post('/api/ai/ask',   async (req, res) => res.json({ text: await runtime.ai.ask(req.body.prompt) }))
+app.post('/api/ai/chat',  async (req, res) => res.json({ text: await runtime.ai.chat(req.body.messages) }))
+app.post('/api/ai/embed', async (req, res) => res.json({ embedding: await runtime.ai.embed(req.body.text) }))
+app.listen(3000)</code></pre>
+<pre><code>&lt;!-- HTML — a key nunca aparece aqui --&gt;
+&lt;script type="module" src="future-browser.js"&gt;&lt;/script&gt;
+&lt;script type="module"&gt;
+  import Future from './future-browser.js'
+  Future.configure({ proxy: '/api/ai' })
+&lt;/script&gt;
+&lt;script type="future"&gt;
+  answer = ai.ask("Olá!")
+  print answer
+&lt;/script&gt;</code></pre>
+</body>
+</html>

package/examples/greet.future ADDED Viewed

@@ -0,0 +1,7 @@
+# Functions, string concatenation and calls
+function greet(name)
+  print "Hello, " + name
+end
+greet("John")
+greet("Ada")

package/examples/hello.future ADDED Viewed

	@@ -0,0 +1 @@
1	+ print "Hello World"

package/examples/math.future ADDED Viewed

@@ -0,0 +1,8 @@
+# Functions with return values and arithmetic
+function square(n)
+  return n * n
+end
+x = 5
+print "x squared is:"
+print square(x)

package/examples/mini-app.html ADDED Viewed

@@ -0,0 +1,301 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <title>Future — mini app test</title>
+</head>
+<body>
+<h1>Future runtime test</h1>
+<pre id="out" style="background:#111;color:#0f0;padding:1rem;min-height:200px;white-space:pre-wrap"></pre>
+<!-- ── 1. Load the runtime ──────────────────────────────────────────────────── -->
+<script type="module" src="../future-browser.js"></script>
+<!-- ── 2. Configure: redirect print + set AI key ────────────────────────────── -->
+<script type="module">
+  import Future from '../future-browser.js';
+  const out = document.getElementById('out');
+  Future.runtime.print = (...args) => {
+    out.textContent += args.join(' ') + '\n';
+  };
+  // Uncomment to test AI (programs 10 and 11):
+  // Future.configure({ proxy: '/api/ai' });
+  // Future.configure({ provider: 'venice', apiKey: 'your-key-here' });
+  //
+  // Or set window.__env before this script and use system.env() from Future code:
+  window.__env = { VENICE_API_KEY: 'VENICE-INFERENCE-KEY-n9mnNP2DsEdj-M8osOKWgwpxou51VXtWlAlpasmdnl' }
+</script>
+<!-- ── Future programs ────────────────────────────────────────────────────────
+     Tip: string interpolation supports {variable} and {object.prop} only.
+     Function calls must be assigned to a variable first:
+       n = len(items)
+       print "Count: {n}"       ✓
+       print "Count: {len(items)}"  ✗ (stays as literal text)
+──────────────────────────────────────────────────────────────────────────── -->
+<!-- Program 1: variables, strings, lists, for -->
+<script type="future">
+print "=== 1. Basic ==="
+name = "Future"
+version = 0.3
+print "Language: {name} v{version}"
+items = ["alpha", "beta", "gamma", "delta"]
+n = len(items)
+print "List has {n} items:"
+for item in items
+  print "  - {item}"
+end
+</script>
+<!-- Program 2: math module -->
+<script type="future">
+print "=== 2. Math ==="
+a = math.round(3.7)
+b = math.floor(3.9)
+c = math.ceil(3.1)
+d = math.abs(-42)
+e = math.sqrt(144)
+f = math.pow(2, 10)
+g = math.max(3, 9, 1, 7)
+h = math.min(3, 9, 1, 7)
+r = math.random()
+print "round(3.7)       = {a}"
+print "floor(3.9)       = {b}"
+print "ceil(3.1)        = {c}"
+print "abs(-42)         = {d}"
+print "sqrt(144)        = {e}"
+print "pow(2,10)        = {f}"
+print "max(3,9,1,7)     = {g}"
+print "min(3,9,1,7)     = {h}"
+print "random()         = {r}"
+print "pi               = {math.pi}"
+print "e                = {math.e}"
+</script>
+<!-- Program 3: while loop + len — use for to sum (no bracket index in Future) -->
+<script type="future">
+print "=== 3. While + for accumulator ==="
+scores = [72, 85, 91, 60, 88, 95, 78]
+n = len(scores)
+# sum with for (Future has no array[i] index access yet)
+total = 0
+for s in scores
+  total = total + s
+end
+avg = math.round(total / n)
+best = math.max(72, 85, 91, 60, 88, 95, 78)
+worst = math.min(72, 85, 91, 60, 88, 95, 78)
+print "Count: {n}  Total: {total}  Avg: {avg}"
+print "Best:  {best}  Worst: {worst}"
+# while loop counting down
+i = 5
+print "Countdown:"
+while i > 0
+  print "  {i}"
+  i = i - 1
+end
+print "  go!"
+</script>
+<!-- Program 4: objects, null, conditionals -->
+<script type="future">
+print "=== 4. Objects + null ==="
+user = { name: "Alice"  age: 28  role: "admin" }
+print "Name: {user.name}  Age: {user.age}  Role: {user.role}"
+session = null
+if session == null
+  print "No active session"
+else
+  print "Session active"
+end
+if user.age >= 18
+  print "{user.name} is an adult"
+end
+# nested object access
+product = { name: "Widget"  price: 9.99 }
+total = product.price * 3
+rounded = math.round(total * 100) / 100
+print "3x {product.name} = {rounded}"
+</script>
+<!-- Program 5: functions -->
+<script type="future">
+print "=== 5. Functions ==="
+function greet(name)
+  return "Hello, {name}!"
+end
+function factorial(n)
+  if n <= 1
+    return 1
+  end
+  return n * factorial(n - 1)
+end
+function clamp(value, lo, hi)
+  if value < lo
+    return lo
+  end
+  if value > hi
+    return hi
+  end
+  return value
+end
+msg = greet("World")
+print msg
+f5 = factorial(5)
+f10 = factorial(10)
+print "5! = {f5}"
+print "10! = {f10}"
+c1 = clamp(150, 0, 100)
+c2 = clamp(-10, 0, 100)
+c3 = clamp(42,  0, 100)
+print "clamp(150, 0, 100) = {c1}"
+print "clamp(-10, 0, 100) = {c2}"
+print "clamp(42,  0, 100) = {c3}"
+</script>
+<!-- Program 6: memory module -->
+<script type="future">
+print "=== 6. Memory ==="
+memory.set("app", "FutureTest")
+memory.set("version", "0.3.2")
+memory.set("user", "Alice")
+memory.set("score", 99)
+app = memory.get("app")
+ver = memory.get("version")
+print "Running {app} v{ver}"
+results = memory.search("ver")
+n = len(results)
+print "Keys matching 'ver': {n}"
+memory.forget("user")
+gone = memory.get("user")
+if gone == null
+  print "user key deleted"
+end
+score = memory.get("score")
+print "score = {score}"
+</script>
+<!-- Program 7: try / catch + custom error-safe function -->
+<script type="future">
+print "=== 7. Error handling ==="
+function safeDivide(a, b)
+  if b == 0
+    return null
+  end
+  return a / b
+end
+r1 = safeDivide(10, 2)
+r2 = safeDivide(10, 0)
+print "10 / 2 = {r1}"
+print "10 / 0 = {r2}"
+try
+  bad = http.get("https://this-does-not-exist-xyz123.com/api")
+  print bad
+catch err
+  print "Caught expected error: request failed"
+end
+print "Execution continues after catch"
+</script>
+<!-- Program 8: HTTP (live fetch) -->
+<script type="future">
+print "=== 8. HTTP ==="
+todo = http.get("https://jsonplaceholder.typicode.com/todos/3")
+print "Title:     {todo.title}"
+print "Completed: {todo.completed}"
+user = http.get("https://jsonplaceholder.typicode.com/users/1")
+print "User:      {user.name}"
+print "Email:     {user.email}"
+print "City:      {user.address.city}"
+</script>
+<!-- Program 9: system.env -->
+<script type="future">
+print "=== 9. system.env ==="
+# In the browser, reads from window.__env
+# In Node.js CLI, reads from process.env
+key = system.env("VENICE_API_KEY")
+if key == null
+  print "VENICE_API_KEY not set"
+  print "Set window.__env = { VENICE_API_KEY: '...' } before loading the page"
+else
+  n = len(key)
+  print "VENICE_API_KEY is set ({n} chars)"
+end
+</script>
+<!-- Program 10: agent (no AI call — works without any key) -->
+<script type="future">
+print "=== 10. Agent (no AI) ==="
+agent greet
+  msg = "Hello from agent! Goal: {goal}"
+  return msg
+end
+agent measure
+  n = len(goal)
+  return "Input has {n} characters"
+end
+agent double
+  result = goal + " | " + goal
+  return result
+end
+r1 = greet("test the runtime")
+r2 = measure("Hello Future language!")
+r3 = double("ping")
+print r1
+print r2
+print r3
+</script>
+<!-- Program 11: AI (requires key or proxy — skips cleanly if not set) -->
+<script type="future">
+print "=== 11. AI ==="
+# To enable: configure in the <script type="module"> block above
+key = system.env("VENICE_API_KEY")
+if key == null
+  print "AI skipped — no key configured"
+  print "Set window.__env.VENICE_API_KEY or Future.configure({ proxy: '/api/ai' })"
+else
+  ai.configure("venice", key)
+  try
+    answer = ai.ask("Reply with exactly three words: Future is awesome")
+    print "AI says: {answer}"
+  catch err
+    print "AI error: {err}"
+  end
+end
+</script>
+</body>
+</html>

package/examples/smarthome.future ADDED Viewed

@@ -0,0 +1,10 @@
+# Automação residencial sobre MQTT (loopback local, roda sem broker)
+function aoReceber(mensagem)
+  print "Sensor disse: " + mensagem
+end
+mqtt.subscribe("casa/sala/temperatura", aoReceber)
+mqtt.publish("casa/sala/temperatura", "23.5")
+home.turnOn("luz_sala")
+print "Luz da sala ligada."

package/future-browser.js ADDED Viewed

@@ -0,0 +1,102 @@
+// future-browser.js — Browser runtime for the Future programming language.
+//
+// Usage:
+//   <script type="module" src="future-browser.js"></script>
+//
+//   <!-- Option A: Proxy mode (production — key stays on your server) -->
+//   <script>Future.configure({ proxy: '/api/ai' })</script>
+//
+//   <!-- Option B: Demo mode (key visible in HTML — dev/demos only) -->
+//   <script>Future.configure({ provider: 'openai', apiKey: 'sk-...' })</script>
+//
+//   <!-- Then write Future code anywhere on the page -->
+//   <script type="future">
+//     answer = ai.ask("Olá mundo")
+//     print answer
+//   </script>
+//
+// Proxy contract (for Option A):
+//   POST {proxy}/ask    { prompt }           → { text }
+//   POST {proxy}/chat   { messages }         → { text }
+//   POST {proxy}/stream { prompt }           → SSE (OpenAI format)
+//   POST {proxy}/embed  { text }             → { embedding: number[] }
+import { tokenize } from './src/lexer.js';
+import { parse }    from './src/parser.js';
+import { generate } from './src/generator.js';
+import { browserRuntime, setProxy, ai } from './runtime/browser.js';
+// ─── Public API ───────────────────────────────────────────────────────────────
+const Future = {
+  /**
+   * Configure the browser runtime.
+   *
+   * Proxy mode (production):
+   *   Future.configure({ proxy: '/api/ai' })
+   *
+   * Demo mode (development):
+   *   Future.configure({ provider: 'openai', apiKey: 'sk-...' })
+   *   Future.configure({ provider: 'anthropic', apiKey: 'sk-ant-...' })
+   *   Future.configure({ provider: 'ollama' })   // local, no key needed
+   */
+  configure(options = {}) {
+    if (options.proxy) {
+      setProxy(options.proxy);
+    }
+    if (options.provider || options.apiKey) {
+      ai.configure(options.provider ?? 'openai', options.apiKey ?? null, options.model ?? null);
+    }
+  },
+  /**
+   * Compile and run a Future source string.
+   * Returns a Promise that resolves when the program finishes.
+   */
+  async run(source) {
+    let js;
+    try {
+      js = generate(parse(tokenize(String(source))), { browserMode: true });
+    } catch (e) {
+      console.error('[Future] Compile error:', e.message);
+      throw e;
+    }
+    // Wrap in async IIFE; __rt is passed as parameter (not a global).
+    // __rt is always passed — even in SIMPLE mode — so __rt.print is available.
+    const fn = new Function('__rt', `return (async () => {\n${js}\n})()`);
+    return fn(browserRuntime);
+  },
+  /** Compile Future source to JavaScript without running it. */
+  compile(source) {
+    return generate(parse(tokenize(String(source))), { browserMode: true });
+  },
+  /** The underlying runtime object — useful for REPL or direct capability calls. */
+  runtime: browserRuntime,
+};
+// ─── <script type="future"> interceptor ──────────────────────────────────────
+async function runScripts() {
+  const scripts = document.querySelectorAll('script[type="future"]');
+  for (const script of scripts) {
+    const source = script.textContent ?? '';
+    if (!source.trim()) continue;
+    try {
+      await Future.run(source);
+    } catch (e) {
+      console.error(`[Future] Runtime error in <script type="future">:`, e);
+    }
+  }
+}
+// Defer runScripts with setTimeout so all <script type="module"> blocks on the
+// page (including configuration scripts that set proxy or override print) finish
+// initialising before any <script type="future"> block runs.
+setTimeout(runScripts, 0);
+// ─── Expose globally ──────────────────────────────────────────────────────────
+window.Future = Future;
+export default Future;