/** * 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 isTruthy(x) { return x !== false && !isNil(x) && x !== 0 && x !== ""; } // Note: 0 and "" are falsy in sx but we match Python semantics where // only nil/false/None are falsy for control flow. Revisit if needed. 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; /** 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 = /"(?:[^"\\]|\\.)*"/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; } // ========================================================================= // 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 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["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; }; // ========================================================================= // Evaluator // ========================================================================= 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) 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 sxEval(expanded, 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 sxEval(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 sxEval(comp.body, local); } // --- Special forms ------------------------------------------------------- var SPECIAL_FORMS = {}; SPECIAL_FORMS["if"] = function (expr, env) { var cond = sxEval(expr[1], env); if (isSxTruthy(cond)) return sxEval(expr[2], env); return expr.length > 3 ? sxEval(expr[3], env) : NIL; }; SPECIAL_FORMS["when"] = function (expr, env) { if (!isSxTruthy(sxEval(expr[1], env))) return NIL; var result = NIL; for (var i = 2; i < expr.length; i++) result = sxEval(expr[i], env); return result; }; SPECIAL_FORMS["cond"] = function (expr, env) { var clauses = expr.slice(1); if (!clauses.length) return NIL; // Scheme-style 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 sxEval(clauses[i][1], env); if (isSxTruthy(sxEval(test, env))) return sxEval(clauses[i][1], env); } } else { // Clojure-style 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 sxEval(clauses[j + 1], env); if (isSxTruthy(sxEval(t, env))) return sxEval(clauses[j + 1], env); } } return 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 sxEval(expr[i + 1], env); if (val == sxEval(t, env)) return sxEval(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 bindings = expr[1], local = merge({}, env); if (Array.isArray(bindings)) { if (bindings.length && Array.isArray(bindings[0])) { // Scheme-style 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 { // Clojure-style 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); } } } var result = NIL; for (var k = 2; k < expr.length; k++) result = sxEval(expr[k], local); return result; }; 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["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) { var result = NIL; for (var i = 1; i < expr.length; i++) result = sxEval(expr[i], env); return result; }; 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 = 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) ? 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) ? 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) ? 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) ? 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) ? 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) ? 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) ? 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 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 animate animateTransform" ); var SVG_NS = "http://www.w3.org/2000/svg"; /** * Render an s-expression to DOM node(s). * Returns a DocumentFragment, Element, or Text node. */ function renderDOM(expr, env) { // 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); // 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); } return document.createTextNode(String(expr)); } /** Render-aware special forms for DOM output. */ var RENDER_FORMS = {}; RENDER_FORMS["if"] = function (expr, env) { var cond = sxEval(expr[1], env); if (isSxTruthy(cond)) return renderDOM(expr[2], env); return expr.length > 3 ? renderDOM(expr[3], env) : document.createDocumentFragment(); }; RENDER_FORMS["when"] = function (expr, env) { 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)); return frag; }; RENDER_FORMS["cond"] = function (expr, env) { var clauses = expr.slice(1); if (!clauses.length) return document.createDocumentFragment(); 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 renderDOM(clauses[i][1], env); if (isSxTruthy(sxEval(test, env))) return renderDOM(clauses[i][1], env); } } 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 renderDOM(clauses[j + 1], env); if (isSxTruthy(sxEval(t, env))) return renderDOM(clauses[j + 1], env); } } return document.createDocumentFragment(); }; RENDER_FORMS["let"] = RENDER_FORMS["let*"] = function (expr, env) { var bindings = expr[1], local = merge({}, env); if (Array.isArray(bindings)) { if (bindings.length && Array.isArray(bindings[0])) { for (var i = 0; i < bindings.length; i++) { local[isSym(bindings[i][0]) ? bindings[i][0].name : bindings[i][0]] = sxEval(bindings[i][1], local); } } else { for (var j = 0; j < bindings.length; j += 2) { local[isSym(bindings[j]) ? bindings[j].name : bindings[j]] = sxEval(bindings[j + 1], local); } } } var frag = document.createDocumentFragment(); for (var k = 2; k < expr.length; k++) frag.appendChild(renderDOM(expr[k], local)); return frag; }; RENDER_FORMS["begin"] = RENDER_FORMS["do"] = function (expr, env) { var frag = document.createDocumentFragment(); for (var i = 1; i < expr.length; i++) frag.appendChild(renderDOM(expr[i], env)); return frag; }; RENDER_FORMS["define"] = 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) { 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) : renderDOM(fn(coll[i]), env); frag.appendChild(val); } return frag; }; RENDER_FORMS["map-indexed"] = function (expr, env) { 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) : renderDOM(fn(i, coll[i]), env); frag.appendChild(val); } return frag; }; RENDER_FORMS["filter"] = function (expr, env) { var result = sxEval(expr, env); return renderDOM(result, env); }; RENDER_FORMS["for-each"] = function (expr, env) { 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) : renderDOM(fn(coll[i]), env); frag.appendChild(val); } return frag; }; function renderLambdaDOM(fn, args, env) { 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); } /** 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) === "~"); } 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 — pass through as-is kwargs[args[i].name] = v; } 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) { 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)); return f; } // Render-aware special forms if (RENDER_FORMS[name]) return RENDER_FORMS[name](expr, env); // Macro expansion if (name in env && isMacro(env[name])) { var mExpanded = expandMacro(env[name], expr.slice(1), env); return renderDOM(mExpanded, env); } // HTML tag if (HTML_TAGS[name]) return renderElement(name, expr.slice(1), env); // 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; } // Fallback: evaluate then render return renderDOM(sxEval(expr, env), env); } // Lambda/list head → evaluate if (isLambda(head) || Array.isArray(head)) return renderDOM(sxEval(expr, env), env); // Data list var dl = document.createDocumentFragment(); for (var di = 0; di < expr.length; di++) dl.appendChild(renderDOM(expr[di], env)); return dl; } function renderElement(tag, args, env) { var el = 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, String(attrVal)); } } else { // Child if (!(tag in VOID_ELEMENTS)) { el.appendChild(renderDOM(arg, env)); } i++; } } return el; } // ========================================================================= // String Renderer (for SSR parity / testing) // ========================================================================= function escapeText(s) { return s.replace(/&/g, "&").replace(//g, ">"); } function escapeAttr(s) { return s.replace(/&/g, "&").replace(/"/g, """).replace(//g, ">"); } function renderStr(expr, env) { if (isNil(expr) || expr === false || expr === true) return ""; if (isRaw(expr)) return expr.html; if (typeof expr === "string") return escapeText(expr); if (typeof expr === "number") return escapeText(String(expr)); if (isSym(expr)) return renderStr(sxEval(expr, env), env); if (isKw(expr)) return escapeText(expr.name); if (Array.isArray(expr)) { if (!expr.length) return ""; return renderStrList(expr, env); } if (expr && typeof expr === "object") return ""; return escapeText(String(expr)); } function renderStrList(expr, env) { var head = expr[0]; if (!isSym(head)) { var parts = []; for (var i = 0; i < expr.length; i++) parts.push(renderStr(expr[i], env)); return parts.join(""); } var name = head.name; if (name === "raw!") { var ps = []; for (var ri = 1; ri < expr.length; ri++) { var v = sxEval(expr[ri], env); if (isRaw(v)) ps.push(v.html); else if (typeof v === "string") ps.push(v); else if (!isNil(v)) ps.push(String(v)); } return ps.join(""); } if (name === "<>") { var fs = []; for (var fi = 1; fi < expr.length; fi++) fs.push(renderStr(expr[fi], env)); return fs.join(""); } if (name === "if") { return isSxTruthy(sxEval(expr[1], env)) ? renderStr(expr[2], env) : (expr.length > 3 ? renderStr(expr[3], env) : ""); } if (name === "when") { if (!isSxTruthy(sxEval(expr[1], env))) return ""; var ws = []; for (var wi = 2; wi < expr.length; wi++) ws.push(renderStr(expr[wi], env)); return ws.join(""); } if (name === "let" || name === "let*") { var bindings = expr[1], local = merge({}, env); if (Array.isArray(bindings)) { if (bindings.length && Array.isArray(bindings[0])) { for (var li = 0; li < bindings.length; li++) { local[isSym(bindings[li][0]) ? bindings[li][0].name : bindings[li][0]] = sxEval(bindings[li][1], local); } } else { for (var lj = 0; lj < bindings.length; lj += 2) { local[isSym(bindings[lj]) ? bindings[lj].name : bindings[lj]] = sxEval(bindings[lj + 1], local); } } } var ls = []; for (var lk = 2; lk < expr.length; lk++) ls.push(renderStr(expr[lk], local)); return ls.join(""); } if (name === "begin" || name === "do") { var bs = []; for (var bi = 1; bi < expr.length; bi++) bs.push(renderStr(expr[bi], env)); return bs.join(""); } if (name === "define" || name === "defcomp" || name === "defmacro" || name === "defhandler") { sxEval(expr, env); return ""; } // Macro expansion in string renderer if (name in env && isMacro(env[name])) { var smExp = expandMacro(env[name], expr.slice(1), env); return renderStr(smExp, env); } // Higher-order forms — render-aware (lambda bodies may contain HTML/components) if (name === "map") { var mapFn = sxEval(expr[1], env), mapColl = sxEval(expr[2], env); if (!Array.isArray(mapColl)) return ""; var mapParts = []; for (var mi = 0; mi < mapColl.length; mi++) { if (isLambda(mapFn)) mapParts.push(renderLambdaStr(mapFn, [mapColl[mi]], env)); else mapParts.push(renderStr(mapFn(mapColl[mi]), env)); } return mapParts.join(""); } if (name === "map-indexed") { var mixFn = sxEval(expr[1], env), mixColl = sxEval(expr[2], env); if (!Array.isArray(mixColl)) return ""; var mixParts = []; for (var mxi = 0; mxi < mixColl.length; mxi++) { if (isLambda(mixFn)) mixParts.push(renderLambdaStr(mixFn, [mxi, mixColl[mxi]], env)); else mixParts.push(renderStr(mixFn(mxi, mixColl[mxi]), env)); } return mixParts.join(""); } if (name === "filter") { var filtFn = sxEval(expr[1], env), filtColl = sxEval(expr[2], env); if (!Array.isArray(filtColl)) return ""; var filtParts = []; for (var fli = 0; fli < filtColl.length; fli++) { var keep = isLambda(filtFn) ? callLambda(filtFn, [filtColl[fli]], env) : filtFn(filtColl[fli]); if (isSxTruthy(keep)) filtParts.push(renderStr(filtColl[fli], env)); } return filtParts.join(""); } if (HTML_TAGS[name]) return renderStrElement(name, expr.slice(1), env); if (name.charAt(0) === "~") { var comp = env[name]; if (isComponent(comp)) return renderStrComponent(comp, expr.slice(1), env); // Unknown component — return visible warning console.warn("sx.js: unknown component " + name); return '