/** * sx.js — S-expression parser, evaluator, and DOM renderer. [v2-debug] * * Client-side counterpart to shared/sx/ Python modules. * Parses s-expression text, evaluates it, and renders to DOM nodes. * * Usage: * Sx.loadComponents('(defcomp ~card (&key title) (div :class "c" title))'); * const node = Sx.render('(~card :title "Hello")'); * document.body.appendChild(node); */ ;(function (global) { "use strict"; // --- Types --- /** Singleton nil — falsy placeholder. */ var NIL = Object.freeze({ _nil: true, toString: function () { return "nil"; } }); function isNil(x) { return x === NIL || x === null || x === undefined; } function isSxTruthy(x) { return x !== false && !isNil(x); } function Symbol(name) { this.name = name; } Symbol.prototype.toString = function () { return this.name; }; Symbol.prototype._sym = true; function Keyword(name) { this.name = name; } Keyword.prototype.toString = function () { return ":" + this.name; }; Keyword.prototype._kw = true; function Lambda(params, body, closure, name) { this.params = params; this.body = body; this.closure = closure || {}; this.name = name || null; } Lambda.prototype._lambda = true; function Component(name, params, hasChildren, body, closure) { this.name = name; this.params = params; this.hasChildren = hasChildren; this.body = body; this.closure = closure || {}; } Component.prototype._component = true; function Macro(params, restParam, body, closure, name) { this.params = params; this.restParam = restParam; this.body = body; this.closure = closure || {}; this.name = name || null; } Macro.prototype._macro = true; /** Thunk — deferred evaluation for tail-call optimization. */ function _Thunk(expr, env) { this.expr = expr; this.env = env; } _Thunk.prototype._thunk = true; function isThunk(x) { return x && x._thunk; } /** Marker for pre-rendered HTML that bypasses escaping. */ function RawHTML(html) { this.html = html; } RawHTML.prototype._raw = true; function isSym(x) { return x && x._sym === true; } function isKw(x) { return x && x._kw === true; } function isLambda(x) { return x && x._lambda === true; } function isComponent(x) { return x && x._component === true; } function isMacro(x) { return x && x._macro === true; } function isRaw(x) { return x && x._raw === true; } // --- Parser --- var RE_WS = /\s+/y; var RE_COMMENT = /;[^\n]*/y; var RE_STRING = /"(?:[^"\\]|\\[\s\S])*"/y; var RE_NUMBER = /-?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?/y; var RE_KEYWORD = /:[a-zA-Z_~*+\-><=/!?&\[][a-zA-Z0-9_~*+\-><=/!?.:&/\[\]#,]*/y; var RE_SYMBOL = /[a-zA-Z_~*+\-><=/!?&][a-zA-Z0-9_~*+\-><=/!?.:&]*/y; function Tokenizer(text) { this.text = text; this.pos = 0; this.line = 1; this.col = 1; } Tokenizer.prototype._advance = function (count) { for (var i = 0; i < count; i++) { if (this.pos < this.text.length) { if (this.text[this.pos] === "\n") { this.line++; this.col = 1; } else { this.col++; } this.pos++; } } }; Tokenizer.prototype._skip = function () { while (this.pos < this.text.length) { RE_WS.lastIndex = this.pos; var m = RE_WS.exec(this.text); if (m && m.index === this.pos) { this._advance(m[0].length); continue; } RE_COMMENT.lastIndex = this.pos; m = RE_COMMENT.exec(this.text); if (m && m.index === this.pos) { this._advance(m[0].length); continue; } break; } }; Tokenizer.prototype.peek = function () { this._skip(); return this.pos < this.text.length ? this.text[this.pos] : null; }; Tokenizer.prototype.next = function () { this._skip(); if (this.pos >= this.text.length) return null; var ch = this.text[this.pos]; // Delimiters if ("()[]{}".indexOf(ch) !== -1) { this._advance(1); return ch; } // String if (ch === '"') { RE_STRING.lastIndex = this.pos; var m = RE_STRING.exec(this.text); if (!m || m.index !== this.pos) throw parseErr("Unterminated string", this); this._advance(m[0].length); var raw = m[0].slice(1, -1); return raw.replace(/\\n/g, "\n").replace(/\\t/g, "\t") .replace(/\\"/g, '"').replace(/\\[/]/g, "/").replace(/\\\\/g, "\\"); } // Keyword if (ch === ":") { RE_KEYWORD.lastIndex = this.pos; m = RE_KEYWORD.exec(this.text); if (!m || m.index !== this.pos) throw parseErr("Invalid keyword", this); this._advance(m[0].length); return new Keyword(m[0].slice(1)); } // Number (before symbol due to leading -) if (isDigit(ch) || (ch === "-" && this.pos + 1 < this.text.length && (isDigit(this.text[this.pos + 1]) || this.text[this.pos + 1] === "."))) { RE_NUMBER.lastIndex = this.pos; m = RE_NUMBER.exec(this.text); if (m && m.index === this.pos) { this._advance(m[0].length); var s = m[0]; return (s.indexOf(".") !== -1 || s.indexOf("e") !== -1 || s.indexOf("E") !== -1) ? parseFloat(s) : parseInt(s, 10); } } // Symbol RE_SYMBOL.lastIndex = this.pos; m = RE_SYMBOL.exec(this.text); if (m && m.index === this.pos) { this._advance(m[0].length); var name = m[0]; if (name === "true") return true; if (name === "false") return false; if (name === "nil") return NIL; return new Symbol(name); } var ctx = this.text.substring(Math.max(0, this.pos - 40), this.pos + 40); throw parseErr("Unexpected character: " + ch + " | context: «" + ctx.replace(/\n/g, "\\n") + "»", this); }; function isDigit(c) { return c >= "0" && c <= "9"; } function parseErr(msg, tok) { return new Error(msg + " at line " + tok.line + ", col " + tok.col); } function parseExpr(tok) { // Use peek() (raw character) for structural decisions so that string // values like ")" or "(" don't get confused with actual delimiters. var raw = tok.peek(); if (raw === null) throw parseErr("Unexpected end of input", tok); if (raw === ")" || raw === "]" || raw === "}") { tok.next(); // consume the delimiter throw parseErr("Unexpected " + raw, tok); } if (raw === "(") { tok.next(); return parseList(tok, ")"); } if (raw === "[") { tok.next(); return parseList(tok, "]"); } if (raw === "{") { tok.next(); return parseMap(tok); } // Quasiquote syntax if (raw === "`") { tok._advance(1); return [new Symbol("quasiquote"), parseExpr(tok)]; } if (raw === ",") { tok._advance(1); if (tok.pos < tok.text.length && tok.text[tok.pos] === "@") { tok._advance(1); return [new Symbol("splice-unquote"), parseExpr(tok)]; } return [new Symbol("unquote"), parseExpr(tok)]; } return tok.next(); } function parseList(tok, closer) { var items = []; while (true) { var c = tok.peek(); if (c === null) throw parseErr("Unterminated list, expected " + closer, tok); if (c === closer) { tok.next(); return items; } items.push(parseExpr(tok)); } } function parseMap(tok) { var result = {}; while (true) { var c = tok.peek(); if (c === null) throw parseErr("Unterminated map", tok); if (c === "}") { tok.next(); return result; } var key = parseExpr(tok); var keyStr = isKw(key) ? key.name : String(key); result[keyStr] = parseExpr(tok); } } /** Parse a single s-expression. */ function parse(text) { var tok = new Tokenizer(text); var result = parseExpr(tok); if (tok.peek() !== null) throw parseErr("Unexpected content after expression", tok); return result; } /** Parse zero or more s-expressions. */ function parseAll(text) { var tok = new Tokenizer(text); var results = []; while (tok.peek() !== null) results.push(parseExpr(tok)); return results; } /** Serialize a JS object as SX dict {:key "val" ...} for attribute values. */ function _serializeDict(obj) { var parts = []; for (var k in obj) { if (!obj.hasOwnProperty(k)) continue; var v = obj[k]; var vs = typeof v === "string" ? '"' + v.replace(/\\/g, "\\\\").replace(/"/g, '\\"') + '"' : String(v); parts.push(":" + k + " " + vs); } return "{" + parts.join(" ") + "}"; } // --- Primitives --- var PRIMITIVES = {}; // Arithmetic PRIMITIVES["+"] = function () { var s = 0; for (var i = 0; i < arguments.length; i++) s += arguments[i]; return s; }; PRIMITIVES["-"] = function (a, b) { return arguments.length === 1 ? -a : a - b; }; PRIMITIVES["*"] = function () { var s = 1; for (var i = 0; i < arguments.length; i++) s *= arguments[i]; return s; }; PRIMITIVES["/"] = function (a, b) { return a / b; }; PRIMITIVES["mod"] = function (a, b) { return a % b; }; PRIMITIVES["inc"] = function (n) { return n + 1; }; PRIMITIVES["dec"] = function (n) { return n - 1; }; PRIMITIVES["abs"] = Math.abs; PRIMITIVES["floor"] = Math.floor; PRIMITIVES["ceil"] = Math.ceil; PRIMITIVES["round"] = Math.round; PRIMITIVES["min"] = Math.min; PRIMITIVES["max"] = Math.max; PRIMITIVES["sqrt"] = Math.sqrt; PRIMITIVES["pow"] = Math.pow; // Comparison PRIMITIVES["="] = function (a, b) { return a == b; }; // loose, matches Python sx PRIMITIVES["!="] = function (a, b) { return a != b; }; PRIMITIVES["<"] = function (a, b) { return a < b; }; PRIMITIVES[">"] = function (a, b) { return a > b; }; PRIMITIVES["<="] = function (a, b) { return a <= b; }; PRIMITIVES[">="] = function (a, b) { return a >= b; }; // Logic PRIMITIVES["not"] = function (x) { return !isSxTruthy(x); }; // String PRIMITIVES["str"] = function () { var parts = []; for (var i = 0; i < arguments.length; i++) { var v = arguments[i]; if (isNil(v)) continue; parts.push(String(v)); } return parts.join(""); }; PRIMITIVES["upper"] = function (s) { return String(s).toUpperCase(); }; PRIMITIVES["lower"] = function (s) { return String(s).toLowerCase(); }; PRIMITIVES["trim"] = function (s) { return String(s).trim(); }; PRIMITIVES["split"] = function (s, sep) { return String(s).split(sep); }; PRIMITIVES["join"] = function (sep, coll) { return coll.join(sep); }; PRIMITIVES["starts-with?"] = function (s, p) { return String(s).indexOf(p) === 0; }; PRIMITIVES["ends-with?"] = function (s, p) { var str = String(s); return str.indexOf(p, str.length - p.length) !== -1; }; PRIMITIVES["concat"] = function () { var out = []; for (var i = 0; i < arguments.length; i++) out = out.concat(arguments[i]); return out; }; // Predicates PRIMITIVES["nil?"] = function (x) { return isNil(x); }; PRIMITIVES["number?"] = function (x) { return typeof x === "number"; }; PRIMITIVES["string?"] = function (x) { return typeof x === "string"; }; PRIMITIVES["list?"] = function (x) { return Array.isArray(x); }; PRIMITIVES["dict?"] = function (x) { return x !== null && typeof x === "object" && !Array.isArray(x) && !x._sym && !x._kw; }; PRIMITIVES["empty?"] = function (c) { return !c || (Array.isArray(c) ? c.length === 0 : Object.keys(c).length === 0); }; PRIMITIVES["contains?"] = function (c, k) { return typeof c === "string" ? c.indexOf(k) !== -1 : Array.isArray(c) ? c.indexOf(k) !== -1 : k in c; }; PRIMITIVES["odd?"] = function (n) { return n % 2 !== 0; }; PRIMITIVES["even?"] = function (n) { return n % 2 === 0; }; PRIMITIVES["zero?"] = function (n) { return n === 0; }; // Collections PRIMITIVES["list"] = function () { return Array.prototype.slice.call(arguments); }; PRIMITIVES["dict"] = function () { var d = {}; for (var i = 0; i < arguments.length - 1; i += 2) d[arguments[i]] = arguments[i + 1]; return d; }; PRIMITIVES["get"] = function (c, k, def) { var v = (c && c[k]); return v !== undefined ? v : (def !== undefined ? def : NIL); }; PRIMITIVES["len"] = function (c) { return Array.isArray(c) ? c.length : Object.keys(c).length; }; PRIMITIVES["first"] = function (c) { return c && c.length > 0 ? c[0] : NIL; }; PRIMITIVES["last"] = function (c) { return c && c.length > 0 ? c[c.length - 1] : NIL; }; PRIMITIVES["rest"] = function (c) { return c ? c.slice(1) : []; }; PRIMITIVES["nth"] = function (c, n) { return c && n < c.length ? c[n] : NIL; }; PRIMITIVES["slice"] = function (c, start, end) { return c ? (end !== undefined && end !== NIL ? c.slice(start, end) : c.slice(start)) : c; }; PRIMITIVES["cons"] = function (x, c) { return [x].concat(c || []); }; PRIMITIVES["append"] = function (c, x) { return (c || []).concat([x]); }; PRIMITIVES["keys"] = function (d) { return Object.keys(d || {}); }; PRIMITIVES["vals"] = function (d) { var r = []; for (var k in d) r.push(d[k]); return r; }; PRIMITIVES["merge"] = function () { var out = {}; for (var i = 0; i < arguments.length; i++) { var d = arguments[i]; for (var k in d) out[k] = d[k]; } return out; }; PRIMITIVES["assoc"] = function (d) { var out = {}; for (var k in d) out[k] = d[k]; for (var i = 1; i < arguments.length - 1; i += 2) out[arguments[i]] = arguments[i + 1]; return out; }; PRIMITIVES["range"] = function (a, b, step) { var r = []; step = step || 1; if (b === undefined) { b = a; a = 0; } for (var i = a; step > 0 ? i < b : i > b; i += step) r.push(i); return r; }; PRIMITIVES["dissoc"] = function (d) { var out = {}; for (var k in d) out[k] = d[k]; for (var i = 1; i < arguments.length; i++) delete out[arguments[i]]; return out; }; PRIMITIVES["into"] = function (target, src) { if (Array.isArray(target)) return target.concat(src || []); var out = {}; for (var k in target) out[k] = target[k]; for (var k2 in src) out[k2] = src[k2]; return out; }; // String operations PRIMITIVES["replace"] = function (s, from, to) { return s ? String(s).split(from).join(to) : ""; }; PRIMITIVES["upper"] = function (s) { return s ? String(s).toUpperCase() : ""; }; PRIMITIVES["lower"] = function (s) { return s ? String(s).toLowerCase() : ""; }; PRIMITIVES["trim"] = function (s) { return s ? String(s).trim() : ""; }; PRIMITIVES["starts-with?"] = function (s, pfx) { return s ? String(s).indexOf(pfx) === 0 : false; }; PRIMITIVES["ends-with?"] = function (s, sfx) { var str = String(s || ""); return str.indexOf(sfx, str.length - sfx.length) !== -1; }; PRIMITIVES["escape"] = function (s) { if (!s) return ""; return String(s).replace(/&/g, "&").replace(//g, ">").replace(/"/g, """); }; PRIMITIVES["strip-tags"] = function (s) { return s ? String(s).replace(/<[^>]*>/g, "") : ""; }; PRIMITIVES["split"] = function (s, sep) { return s ? String(s).split(sep) : []; }; PRIMITIVES["join"] = function (lst, sep) { return (lst || []).join(sep !== undefined ? sep : ""); }; PRIMITIVES["pluralize"] = function (n, singular, plural) { return n === 1 ? singular : (plural || singular + "s"); }; // Numeric PRIMITIVES["clamp"] = function (val, lo, hi) { return Math.max(lo, Math.min(hi, val)); }; PRIMITIVES["parse-int"] = function (s, def) { var n = parseInt(s, 10); return isNaN(n) ? (def !== undefined ? def : 0) : n; }; PRIMITIVES["format-decimal"] = function (n, places) { return Number(n || 0).toFixed(places !== undefined ? places : 2); }; // Date formatting (basic) PRIMITIVES["format-date"] = function (s, fmt) { if (!s) return ""; try { var d = new Date(s); if (isNaN(d.getTime())) return String(s); // Basic strftime-like: %Y %m %d %H %M %B %b %-d var months = ["January","February","March","April","May","June","July","August","September","October","November","December"]; var short_months = ["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"]; return fmt.replace(/%-d/g, d.getDate()).replace(/%d/g, ("0"+d.getDate()).slice(-2)) .replace(/%B/g, months[d.getMonth()]).replace(/%b/g, short_months[d.getMonth()]) .replace(/%Y/g, d.getFullYear()).replace(/%m/g, ("0"+(d.getMonth()+1)).slice(-2)) .replace(/%H/g, ("0"+d.getHours()).slice(-2)).replace(/%M/g, ("0"+d.getMinutes()).slice(-2)); } catch (e) { return String(s); } }; PRIMITIVES["parse-datetime"] = function (s) { return s ? String(s) : NIL; }; PRIMITIVES["split-ids"] = function (s) { if (!s) return []; return String(s).split(",").map(function(x) { return x.trim(); }).filter(function(x) { return x; }); }; // --- Evaluator --- /** Unwrap thunks by re-entering the evaluator until we get an actual value. */ function trampoline(val) { while (isThunk(val)) val = _sxEval(val.expr, val.env); return val; } /** Public evaluator — trampolines thunks from tail positions. */ function sxEval(expr, env) { return trampoline(_sxEval(expr, env)); } /** Internal evaluator — may return _Thunk for tail positions. */ function _sxEval(expr, env) { // Literals if (typeof expr === "number" || typeof expr === "string" || typeof expr === "boolean") return expr; if (isNil(expr)) return NIL; // Symbol lookup if (isSym(expr)) { var name = expr.name; if (name in env) return env[name]; if (name in PRIMITIVES) return PRIMITIVES[name]; if (name === "true") return true; if (name === "false") return false; if (name === "nil") return NIL; throw new Error("Undefined symbol: " + name); } // Keyword → its name if (isKw(expr)) return expr.name; // Dict literal if (expr && typeof expr === "object" && !Array.isArray(expr) && !expr._sym && !expr._kw && !expr._raw) { var d = {}; for (var dk in expr) d[dk] = sxEval(expr[dk], env); return d; } // List if (!Array.isArray(expr)) return expr; if (expr.length === 0) return []; var head = expr[0]; // Non-callable head → data list if (!isSym(head) && !isLambda(head) && !Array.isArray(head)) { return expr.map(function (x) { return sxEval(x, env); }); } // Special forms if (isSym(head)) { var sf = SPECIAL_FORMS[head.name]; if (sf) return sf(expr, env); var ho = HO_FORMS[head.name]; if (ho) { // If name is also an HTML tag and first arg is Keyword → not a HO call if (!(HTML_TAGS[head.name] && expr.length > 1 && isKw(expr[1]))) return ho(expr, env); } // Macro expansion if (head.name in env) { var macroVal = env[head.name]; if (isMacro(macroVal)) { var expanded = expandMacro(macroVal, expr.slice(1), env); return new _Thunk(expanded, env); } } // HTML tag or component in data position — delegate to renderDOM if (_isRenderExpr(expr)) return renderDOM(expr, env); } // Function call var fn = sxEval(head, env); var args = []; for (var ai = 1; ai < expr.length; ai++) args.push(sxEval(expr[ai], env)); if (typeof fn === "function") return fn.apply(null, args); if (isLambda(fn)) return callLambda(fn, args, env); if (isComponent(fn)) return callComponent(fn, expr.slice(1), env); throw new Error("Not callable: " + fn); } function callLambda(fn, args, callerEnv) { if (args.length !== fn.params.length) { throw new Error((fn.name || "lambda") + " expects " + fn.params.length + " args, got " + args.length); } var local = merge({}, fn.closure, callerEnv); for (var i = 0; i < fn.params.length; i++) local[fn.params[i]] = args[i]; return new _Thunk(fn.body, local); } function callComponent(comp, rawArgs, env) { var kwargs = {}, children = []; var i = 0; while (i < rawArgs.length) { if (isKw(rawArgs[i]) && i + 1 < rawArgs.length) { kwargs[rawArgs[i].name] = sxEval(rawArgs[i + 1], env); i += 2; } else { children.push(sxEval(rawArgs[i], env)); i++; } } var local = merge({}, comp.closure, env); for (var pi = 0; pi < comp.params.length; pi++) { var p = comp.params[pi]; local[p] = (p in kwargs) ? kwargs[p] : NIL; } if (comp.hasChildren) local["children"] = children; return new _Thunk(comp.body, local); } // --- Shared helpers for special/render forms --- function _processBindings(bindings, env) { var local = merge({}, env); if (Array.isArray(bindings)) { if (bindings.length && Array.isArray(bindings[0])) { for (var i = 0; i < bindings.length; i++) { var vname = isSym(bindings[i][0]) ? bindings[i][0].name : bindings[i][0]; local[vname] = sxEval(bindings[i][1], local); } } else { for (var j = 0; j < bindings.length; j += 2) { var vn = isSym(bindings[j]) ? bindings[j].name : bindings[j]; local[vn] = sxEval(bindings[j + 1], local); } } } return local; } function _evalCond(clauses, env) { if (!clauses.length) return null; if (Array.isArray(clauses[0]) && clauses[0].length === 2) { for (var i = 0; i < clauses.length; i++) { var test = clauses[i][0]; if ((isSym(test) && (test.name === "else" || test.name === ":else")) || (isKw(test) && test.name === "else")) return clauses[i][1]; if (isSxTruthy(sxEval(test, env))) return clauses[i][1]; } } else { for (var j = 0; j < clauses.length - 1; j += 2) { var t = clauses[j]; if ((isKw(t) && t.name === "else") || (isSym(t) && (t.name === ":else" || t.name === "else"))) return clauses[j + 1]; if (isSxTruthy(sxEval(t, env))) return clauses[j + 1]; } } return null; } function _logParseError(label, text, err, windowSize) { var colMatch = err.message && err.message.match(/col (\d+)/); var lineMatch = err.message && err.message.match(/line (\d+)/); if (colMatch && text) { var errLine = lineMatch ? parseInt(lineMatch[1]) : 1; var errCol = parseInt(colMatch[1]); var lines = text.split("\n"); var pos = 0; for (var i = 0; i < errLine - 1 && i < lines.length; i++) pos += lines[i].length + 1; pos += errCol; var start = Math.max(0, pos - windowSize); var end = Math.min(text.length, pos + windowSize); console.error("sx.js " + label + ":", err.message, "\n total length:", text.length, "lines:", lines.length, "\n error line " + errLine + ":", lines[errLine - 1] ? lines[errLine - 1].substring(0, 200) : "(no such line)", "\n around error (pos ~" + pos + "):", "\n «" + text.substring(start, pos) + "⛔" + text.substring(pos, end) + "»"); } else { console.error("sx.js " + label + ":", err.message || err); } } // --- Special forms ------------------------------------------------------- var SPECIAL_FORMS = {}; SPECIAL_FORMS["if"] = function (expr, env) { var cond = sxEval(expr[1], env); if (isSxTruthy(cond)) return new _Thunk(expr[2], env); return expr.length > 3 ? new _Thunk(expr[3], env) : NIL; }; SPECIAL_FORMS["when"] = function (expr, env) { if (!isSxTruthy(sxEval(expr[1], env))) return NIL; for (var i = 2; i < expr.length - 1; i++) sxEval(expr[i], env); return new _Thunk(expr[expr.length - 1], env); }; SPECIAL_FORMS["cond"] = function (expr, env) { var branch = _evalCond(expr.slice(1), env); return branch ? new _Thunk(branch, env) : NIL; }; SPECIAL_FORMS["case"] = function (expr, env) { var val = sxEval(expr[1], env); for (var i = 2; i < expr.length - 1; i += 2) { var t = expr[i]; if ((isKw(t) && t.name === "else") || (isSym(t) && (t.name === ":else" || t.name === "else"))) return new _Thunk(expr[i + 1], env); if (val == sxEval(t, env)) return new _Thunk(expr[i + 1], env); } return NIL; }; SPECIAL_FORMS["and"] = function (expr, env) { var result = true; for (var i = 1; i < expr.length; i++) { result = sxEval(expr[i], env); if (!isSxTruthy(result)) return result; } return result; }; SPECIAL_FORMS["or"] = function (expr, env) { var result = false; for (var i = 1; i < expr.length; i++) { result = sxEval(expr[i], env); if (isSxTruthy(result)) return result; } return result; }; SPECIAL_FORMS["let"] = SPECIAL_FORMS["let*"] = function (expr, env) { var local = _processBindings(expr[1], env); for (var k = 2; k < expr.length - 1; k++) sxEval(expr[k], local); return expr.length > 2 ? new _Thunk(expr[expr.length - 1], local) : NIL; }; SPECIAL_FORMS["lambda"] = SPECIAL_FORMS["fn"] = function (expr, env) { var paramsExpr = expr[1], paramNames = []; for (var i = 0; i < paramsExpr.length; i++) { var p = paramsExpr[i]; paramNames.push(isSym(p) ? p.name : String(p)); } return new Lambda(paramNames, expr[2], merge({}, env)); }; SPECIAL_FORMS["define"] = function (expr, env) { var name = expr[1].name; var value = sxEval(expr[2], env); if (isLambda(value) && !value.name) value.name = name; env[name] = value; return value; }; SPECIAL_FORMS["defstyle"] = function (expr, env) { var name = expr[1].name; var value = sxEval(expr[2], env); env[name] = value; return value; }; SPECIAL_FORMS["defcomp"] = function (expr, env) { var nameSym = expr[1]; var compName = nameSym.name.replace(/^~/, ""); var paramsExpr = expr[2]; var params = [], hasChildren = false, inKey = false; for (var i = 0; i < paramsExpr.length; i++) { var p = paramsExpr[i]; if (isSym(p)) { if (p.name === "&key") { inKey = true; continue; } if (p.name === "&rest") { hasChildren = true; continue; } if (inKey || hasChildren) { if (!hasChildren) params.push(p.name); } else params.push(p.name); } } var comp = new Component(compName, params, hasChildren, expr[3], merge({}, env)); env[nameSym.name] = comp; return comp; }; SPECIAL_FORMS["begin"] = SPECIAL_FORMS["do"] = function (expr, env) { for (var i = 1; i < expr.length - 1; i++) sxEval(expr[i], env); return expr.length > 1 ? new _Thunk(expr[expr.length - 1], env) : NIL; }; SPECIAL_FORMS["quote"] = function (expr) { return expr[1]; }; SPECIAL_FORMS["set!"] = function (expr, env) { var v = sxEval(expr[2], env); env[expr[1].name] = v; return v; }; SPECIAL_FORMS["->"] = function (expr, env) { var result = sxEval(expr[1], env); for (var i = 2; i < expr.length; i++) { var form = expr[i]; var fn, args; if (Array.isArray(form)) { fn = sxEval(form[0], env); args = [result]; for (var j = 1; j < form.length; j++) args.push(sxEval(form[j], env)); } else { fn = sxEval(form, env); args = [result]; } if (typeof fn === "function") result = fn.apply(null, args); else if (isLambda(fn)) result = trampoline(callLambda(fn, args, env)); else throw new Error("-> form not callable: " + fn); } return result; }; SPECIAL_FORMS["defmacro"] = function (expr, env) { var nameSym = expr[1]; var paramsExpr = expr[2]; var params = [], restParam = null; for (var i = 0; i < paramsExpr.length; i++) { var p = paramsExpr[i]; if (isSym(p) && p.name === "&rest") { if (i + 1 < paramsExpr.length) { var rp = paramsExpr[i + 1]; restParam = isSym(rp) ? rp.name : String(rp); } break; } if (isSym(p)) params.push(p.name); else if (typeof p === "string") params.push(p); } var macro = new Macro(params, restParam, expr[3], merge({}, env), nameSym.name); env[nameSym.name] = macro; return macro; }; SPECIAL_FORMS["quasiquote"] = function (expr, env) { return qqExpand(expr[1], env); }; function qqExpand(template, env) { if (!Array.isArray(template)) return template; if (!template.length) return []; var head = template[0]; if (isSym(head)) { if (head.name === "unquote") return sxEval(template[1], env); if (head.name === "splice-unquote") throw new Error("splice-unquote not inside a list"); } var result = []; for (var i = 0; i < template.length; i++) { var item = template[i]; if (Array.isArray(item) && item.length === 2 && isSym(item[0]) && item[0].name === "splice-unquote") { var spliced = sxEval(item[1], env); if (Array.isArray(spliced)) { for (var j = 0; j < spliced.length; j++) result.push(spliced[j]); } else if (!isNil(spliced)) result.push(spliced); } else { result.push(qqExpand(item, env)); } } return result; } function expandMacro(macro, rawArgs, env) { var local = merge({}, macro.closure, env); for (var i = 0; i < macro.params.length; i++) { local[macro.params[i]] = i < rawArgs.length ? rawArgs[i] : NIL; } if (macro.restParam !== null) { local[macro.restParam] = rawArgs.slice(macro.params.length); } return sxEval(macro.body, local); } // --- Higher-order forms -------------------------------------------------- var HO_FORMS = {}; HO_FORMS["map"] = function (expr, env) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); return coll.map(function (item) { return isLambda(fn) ? trampoline(callLambda(fn, [item], env)) : fn(item); }); }; HO_FORMS["map-indexed"] = function (expr, env) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); return coll.map(function (item, i) { return isLambda(fn) ? trampoline(callLambda(fn, [i, item], env)) : fn(i, item); }); }; HO_FORMS["filter"] = function (expr, env) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); return coll.filter(function (item) { var r = isLambda(fn) ? trampoline(callLambda(fn, [item], env)) : fn(item); return isSxTruthy(r); }); }; HO_FORMS["reduce"] = function (expr, env) { var fn = sxEval(expr[1], env), acc = sxEval(expr[2], env), coll = sxEval(expr[3], env); for (var i = 0; i < coll.length; i++) acc = isLambda(fn) ? trampoline(callLambda(fn, [acc, coll[i]], env)) : fn(acc, coll[i]); return acc; }; HO_FORMS["some"] = function (expr, env) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); for (var i = 0; i < coll.length; i++) { var r = isLambda(fn) ? trampoline(callLambda(fn, [coll[i]], env)) : fn(coll[i]); if (isSxTruthy(r)) return r; } return NIL; }; HO_FORMS["every?"] = function (expr, env) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); for (var i = 0; i < coll.length; i++) { if (!isSxTruthy(isLambda(fn) ? trampoline(callLambda(fn, [coll[i]], env)) : fn(coll[i]))) return false; } return true; }; HO_FORMS["for-each"] = function (expr, env) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); for (var i = 0; i < coll.length; i++) isLambda(fn) ? trampoline(callLambda(fn, [coll[i]], env)) : fn(coll[i]); return NIL; }; // --- DOM Renderer --- var HTML_TAGS = makeSet( "html head body title meta link style script base noscript " + "header footer main nav aside section article address hgroup " + "h1 h2 h3 h4 h5 h6 " + "div p blockquote pre figure figcaption ul ol li dl dt dd hr " + "a span em strong small s cite q abbr code var samp kbd sub sup " + "i b u mark ruby rt rp bdi bdo br wbr time data " + "ins del " + "img picture source iframe embed object param video audio track canvas map area " + "svg math path circle ellipse line polygon polyline rect g defs use text tspan " + "clipPath mask linearGradient radialGradient stop filter " + "feGaussianBlur feOffset feMerge feMergeNode " + "feTurbulence feColorMatrix feBlend " + "feComponentTransfer feFuncR feFuncG feFuncB feFuncA " + "feDisplacementMap feComposite feFlood feImage " + "feMorphology feSpecularLighting feDiffuseLighting " + "fePointLight feSpotLight feDistantLight " + "animate animateTransform " + "table thead tbody tfoot tr th td caption colgroup col " + "form fieldset legend label input button select option optgroup textarea output " + "datalist progress meter details summary dialog template slot" ); var VOID_ELEMENTS = makeSet( "area base br col embed hr img input link meta param source track wbr" ); var BOOLEAN_ATTRS = makeSet( "async autofocus autoplay checked controls default defer disabled " + "formnovalidate hidden inert ismap loop multiple muted nomodule " + "novalidate open playsinline readonly required reversed selected" ); // SVG elements that need createElementNS var SVG_TAGS = makeSet( "svg path circle ellipse line polygon polyline rect g defs use text tspan " + "clipPath mask linearGradient radialGradient stop filter " + "feGaussianBlur feOffset feMerge feMergeNode " + "feTurbulence feColorMatrix feBlend " + "feComponentTransfer feFuncR feFuncG feFuncB feFuncA " + "feDisplacementMap feComposite feFlood feImage " + "feMorphology feSpecularLighting feDiffuseLighting " + "fePointLight feSpotLight feDistantLight " + "animate animateTransform" ); var SVG_NS = "http://www.w3.org/2000/svg"; var MATH_NS = "http://www.w3.org/1998/Math/MathML"; /** * Render an s-expression to DOM node(s). * Returns a DocumentFragment, Element, or Text node. * @param {*} expr - s-expression * @param {Object} env - variable bindings * @param {string|null} ns - namespace URI (SVG_NS or MATH_NS) when inside svg/math */ function renderDOM(expr, env, ns) { // nil / false → empty if (isNil(expr) || expr === false || expr === true) return document.createDocumentFragment(); // Pre-rendered HTML if (isRaw(expr)) { var tpl = document.createElement("template"); tpl.innerHTML = expr.html; return tpl.content; } // String → text node if (typeof expr === "string") return document.createTextNode(expr); // Number → text node if (typeof expr === "number") return document.createTextNode(String(expr)); // Symbol → evaluate then render if (isSym(expr)) return renderDOM(sxEval(expr, env), env, ns); // Keyword → text if (isKw(expr)) return document.createTextNode(expr.name); // Pre-rendered DOM node → return as-is if (expr && expr.nodeType) return expr; // Dict → empty if (expr && typeof expr === "object" && !Array.isArray(expr)) return document.createDocumentFragment(); // List → dispatch if (Array.isArray(expr)) { if (!expr.length) return document.createDocumentFragment(); return renderList(expr, env, ns); } return document.createTextNode(String(expr)); } /** Render-aware special forms for DOM output. */ var RENDER_FORMS = {}; RENDER_FORMS["if"] = function (expr, env, ns) { var cond = sxEval(expr[1], env); if (isSxTruthy(cond)) return renderDOM(expr[2], env, ns); return expr.length > 3 ? renderDOM(expr[3], env, ns) : document.createDocumentFragment(); }; RENDER_FORMS["when"] = function (expr, env, ns) { if (!isSxTruthy(sxEval(expr[1], env))) return document.createDocumentFragment(); var frag = document.createDocumentFragment(); for (var i = 2; i < expr.length; i++) frag.appendChild(renderDOM(expr[i], env, ns)); return frag; }; RENDER_FORMS["cond"] = function (expr, env, ns) { var branch = _evalCond(expr.slice(1), env); return branch ? renderDOM(branch, env, ns) : document.createDocumentFragment(); }; RENDER_FORMS["let"] = RENDER_FORMS["let*"] = function (expr, env, ns) { var local = _processBindings(expr[1], env); var frag = document.createDocumentFragment(); for (var k = 2; k < expr.length; k++) frag.appendChild(renderDOM(expr[k], local, ns)); return frag; }; RENDER_FORMS["begin"] = RENDER_FORMS["do"] = function (expr, env, ns) { var frag = document.createDocumentFragment(); for (var i = 1; i < expr.length; i++) frag.appendChild(renderDOM(expr[i], env, ns)); return frag; }; RENDER_FORMS["define"] = function (expr, env) { sxEval(expr, env); return document.createDocumentFragment(); }; RENDER_FORMS["defstyle"] = function (expr, env) { sxEval(expr, env); return document.createDocumentFragment(); }; RENDER_FORMS["defcomp"] = function (expr, env) { sxEval(expr, env); return document.createDocumentFragment(); }; RENDER_FORMS["defmacro"] = function (expr, env) { sxEval(expr, env); return document.createDocumentFragment(); }; RENDER_FORMS["defhandler"] = function (expr, env) { sxEval(expr, env); return document.createDocumentFragment(); }; RENDER_FORMS["map"] = function (expr, env, ns) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); var frag = document.createDocumentFragment(); for (var i = 0; i < coll.length; i++) { var val = isLambda(fn) ? renderLambdaDOM(fn, [coll[i]], env, ns) : renderDOM(fn(coll[i]), env, ns); frag.appendChild(val); } return frag; }; RENDER_FORMS["map-indexed"] = function (expr, env, ns) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); var frag = document.createDocumentFragment(); for (var i = 0; i < coll.length; i++) { var val = isLambda(fn) ? renderLambdaDOM(fn, [i, coll[i]], env, ns) : renderDOM(fn(i, coll[i]), env, ns); frag.appendChild(val); } return frag; }; RENDER_FORMS["filter"] = function (expr, env, ns) { var result = sxEval(expr, env); return renderDOM(result, env, ns); }; RENDER_FORMS["for-each"] = function (expr, env, ns) { var fn = sxEval(expr[1], env), coll = sxEval(expr[2], env); var frag = document.createDocumentFragment(); for (var i = 0; i < coll.length; i++) { var val = isLambda(fn) ? renderLambdaDOM(fn, [coll[i]], env, ns) : renderDOM(fn(coll[i]), env, ns); frag.appendChild(val); } return frag; }; function renderLambdaDOM(fn, args, env, ns) { var local = merge({}, fn.closure, env); for (var i = 0; i < fn.params.length; i++) local[fn.params[i]] = args[i]; return renderDOM(fn.body, local, ns); } /** True when the array expr is a render-only form (HTML tag, <>, raw!, ~comp). */ function _isRenderExpr(v) { if (!Array.isArray(v) || !v.length) return false; var h = v[0]; if (!isSym(h)) return false; var n = h.name; return !!(HTML_TAGS[n] || SVG_TAGS[n] || n === "<>" || n === "raw!" || n.charAt(0) === "~" || n.indexOf("html:") === 0 || (n.indexOf("-") > 0 && v.length > 1 && isKw(v[1]))); } function renderComponentDOM(comp, args, env) { var kwargs = {}, children = []; var i = 0; while (i < args.length) { if (isKw(args[i]) && i + 1 < args.length) { // Evaluate kwarg values eagerly in the caller's env so expressions // like (get t "src") resolve while lambda params are still bound. var v = args[i + 1]; if (typeof v === "string" || typeof v === "number" || typeof v === "boolean" || isNil(v) || isKw(v)) { kwargs[args[i].name] = v; } else if (isSym(v)) { kwargs[args[i].name] = sxEval(v, env); } else if (Array.isArray(v) && v.length && isSym(v[0])) { // Expression with Symbol head — evaluate in caller's env. // Render-only forms go through renderDOM; data exprs through sxEval. if (_isRenderExpr(v)) { kwargs[args[i].name] = renderDOM(v, env); } else { kwargs[args[i].name] = sxEval(v, env); } } else { // Data arrays, dicts, etc — evaluate in caller's env kwargs[args[i].name] = sxEval(v, env); } i += 2; } else { children.push(args[i]); i++; } } var local = merge({}, comp.closure, env); for (var pi = 0; pi < comp.params.length; pi++) { var p = comp.params[pi]; local[p] = (p in kwargs) ? kwargs[p] : NIL; } if (comp.hasChildren) { // Pre-render children to a fragment, wrap as RawHTML for raw! compatibility var childFrag = document.createDocumentFragment(); for (var ci = 0; ci < children.length; ci++) childFrag.appendChild(renderDOM(children[ci], env)); local["children"] = childFrag; } return renderDOM(comp.body, local); } function renderList(expr, env, ns) { var head = expr[0]; if (isSym(head)) { var name = head.name; // raw! → insert unescaped if (name === "raw!") { var frag = document.createDocumentFragment(); for (var ri = 1; ri < expr.length; ri++) { var val = sxEval(expr[ri], env); if (typeof val === "string") { var tpl = document.createElement("template"); tpl.innerHTML = val; // Scripts in innerHTML don't execute — recreate them as live elements var deadScripts = tpl.content.querySelectorAll("script"); for (var si = 0; si < deadScripts.length; si++) { var dead = deadScripts[si]; var live = document.createElement("script"); for (var ai = 0; ai < dead.attributes.length; ai++) live.setAttribute(dead.attributes[ai].name, dead.attributes[ai].value); live.textContent = dead.textContent; dead.parentNode.replaceChild(live, dead); } frag.appendChild(tpl.content); } else if (val && val.nodeType) { // Already a DOM node (e.g. from children fragment) frag.appendChild(val.cloneNode ? val.cloneNode(true) : val); } else if (!isNil(val)) { frag.appendChild(document.createTextNode(String(val))); } } return frag; } // <> → fragment if (name === "<>") { var f = document.createDocumentFragment(); for (var fi = 1; fi < expr.length; fi++) f.appendChild(renderDOM(expr[fi], env, ns)); return f; } // html: prefix → force element rendering if (name.indexOf("html:") === 0) return renderElement(name.substring(5), expr.slice(1), env, ns); // Render-aware special forms // If name is also an HTML tag and (keyword arg or SVG/MathML ns) → tag call if (RENDER_FORMS[name]) { if (HTML_TAGS[name] && ((expr.length > 1 && isKw(expr[1])) || ns)) return renderElement(name, expr.slice(1), env, ns); return RENDER_FORMS[name](expr, env, ns); } // Macro expansion if (name in env && isMacro(env[name])) { var mExpanded = expandMacro(env[name], expr.slice(1), env); return renderDOM(mExpanded, env, ns); } // HTML tag if (HTML_TAGS[name]) return renderElement(name, expr.slice(1), env, ns); // Component if (name.charAt(0) === "~") { var comp = env[name]; if (isComponent(comp)) return renderComponentDOM(comp, expr.slice(1), env); // Unknown component — render a visible warning, don't crash console.warn("sx.js: unknown component " + name); var warn = document.createElement("div"); warn.setAttribute("style", "background:#fef2f2;border:1px solid #fca5a5;color:#991b1b;" + "padding:4px 8px;margin:2px;border-radius:4px;font-size:12px;font-family:monospace"); warn.textContent = "Unknown component: " + name; return warn; } // Custom element (hyphenated name with keyword attrs) → render as element if (name.indexOf("-") > 0 && expr.length > 1 && isKw(expr[1])) return renderElement(name, expr.slice(1), env, ns); // SVG/MathML namespace auto-detection: inside (svg ...) or (math ...), // unknown tags are created with the inherited namespace if (ns) return renderElement(name, expr.slice(1), env, ns); // Fallback: evaluate then render return renderDOM(sxEval(expr, env), env, ns); } // Lambda/list head → evaluate if (isLambda(head) || Array.isArray(head)) return renderDOM(sxEval(expr, env), env, ns); // Data list var dl = document.createDocumentFragment(); for (var di = 0; di < expr.length; di++) dl.appendChild(renderDOM(expr[di], env, ns)); return dl; } function renderElement(tag, args, env, ns) { // Detect namespace from tag: svg → SVG_NS, math → MATH_NS if (tag === "svg") ns = SVG_NS; else if (tag === "math") ns = MATH_NS; var el = ns ? document.createElementNS(ns, tag) : (SVG_TAGS[tag] ? document.createElementNS(SVG_NS, tag) : document.createElement(tag)); var i = 0; while (i < args.length) { var arg = args[i]; if (isKw(arg) && i + 1 < args.length) { var attrName = arg.name; var attrVal = sxEval(args[i + 1], env); i += 2; if (isNil(attrVal) || attrVal === false) continue; if (BOOLEAN_ATTRS[attrName]) { if (attrVal) el.setAttribute(attrName, ""); } else if (attrVal === true) { el.setAttribute(attrName, ""); } else { el.setAttribute(attrName, typeof attrVal === "object" && attrVal !== null && !Array.isArray(attrVal) ? _serializeDict(attrVal) : String(attrVal)); } } else { // Child if (!(tag in VOID_ELEMENTS)) { el.appendChild(renderDOM(arg, env, ns)); } i++; } } return el; } // --- Helpers --- function merge(target) { for (var i = 1; i < arguments.length; i++) { var src = arguments[i]; if (src) for (var k in src) target[k] = src[k]; } return target; } function makeSet(str) { var s = {}, parts = str.split(/\s+/); for (var i = 0; i < parts.length; i++) if (parts[i]) s[parts[i]] = true; return s; } /** Convert snake_case kwargs to kebab-case for sx conventions. */ function toKebab(s) { return s.replace(/_/g, "-"); } // --- Public API --- var _componentEnv = {}; // --- Head auto-hoist --- var HEAD_HOIST_SELECTOR = "meta, title, link[rel='canonical'], script[type='application/ld+json']"; function _hoistHeadElements(root) { var els = root.querySelectorAll(HEAD_HOIST_SELECTOR); if (!els.length) return; var head = document.head; for (var i = 0; i < els.length; i++) { var el = els[i]; var tag = el.tagName.toLowerCase(); // For