gofront 0.0.8 → 1.0.0

package/src/{codegen.js → codegen/index.js}

@@ -17,10 +17,26 @@
 //   - make(map[K]V)    → {}
 //   - for range        → for...of with .entries()
 
-import { expressionGenMethods } from "./codegen/expressions.js";
-import { buildSourceMap } from "./codegen/source-map.js";
-import { statementGenMethods } from "./codegen/statements.js";
-import { isComplex, isNumeric } from "./typechecker/types.js";
+import { isComplex, isNumeric } from "../typechecker/types.js";
+import { expressionGenMethods } from "./expressions.js";
+import {
+	HELPER_APPEND,
+	HELPER_CDIV,
+	HELPER_CMUL,
+	HELPER_EQUAL,
+	HELPER_ERROR,
+	HELPER_ERROR_IS,
+	HELPER_LEN,
+	HELPER_PATH_CLEAN,
+	HELPER_S,
+	HELPER_SPRINTF,
+	HELPER_TIME_FMT,
+	HELPER_TIME_PARSE,
+} from "./runtime.js";
+import { buildSourceMap } from "./source-map.js";
+import { statementGenMethods } from "./statements.js";
+import { stdlibGenMethods } from "./stdlib/index.js";
+import { templGenMethods } from "./templ.js";
 
 export class CodeGen {
 	// jsImports:       Map<importPath, string[]> — npm package imports to emit at top of file
@@ -88,43 +104,15 @@ export class CodeGen {
 		this.indent--;
 	}
 
-	generate(program) {
-		// Collect struct names first (needed by zero-value helpers and genCompositeLit)
-		for (const d of program.decls) {
-			if (d.kind === "TypeDecl" && d.type.kind === "StructType") {
-				this.structNames.add(d.name);
-			}
-		}
-
-		// Build a map: typeName → [MethodDecl, ...]
-		const methods = new Map();
-		for (const d of program.decls) {
-			if (d.kind === "MethodDecl") {
-				const name = d.recvType.name;
-				if (!methods.has(name)) methods.set(name, []);
-				methods.get(name).push(d);
-			}
-		}
-
-		// Collect named non-struct types that have methods (emitted as wrapper classes)
-		for (const d of program.decls) {
-			if (
-				d.kind === "TypeDecl" &&
-				d.type.kind !== "StructType" &&
-				d.type.kind !== "InterfaceType" &&
-				(methods.get(d.name) ?? []).length > 0
-			) {
-				this.namedWrapperNames.add(d.name);
-			}
-		}
-
-		// Emit ESM import statements for npm packages
+	_emitJsImports() {
 		for (const [importPath, names] of this.jsImports) {
 			if (names.length === 0) continue;
 			this.line(`import { ${names.join(", ")} } from '${importPath}';`);
 		}
 		if (this.jsImports.size > 0) this.blank();
+	}
 
+	_emitTypeDecls(program, methods) {
 		for (const d of program.decls) {
 			if (d.kind === "TypeDecl") {
 				this._currentSrcFileIdx = d._srcFileIdx ?? 0;
@@ -132,7 +120,9 @@ export class CodeGen {
 				this.blank();
 			}
 		}
+	}
 
+	_emitVarConstDecls(program) {
 		for (const d of program.decls) {
 			if (d.kind === "VarDecl") {
 				this._currentSrcFileIdx = d._srcFileIdx ?? 0;
@@ -145,8 +135,28 @@ export class CodeGen {
 				this.blank();
 			}
 		}
+	}
+
+	_callInitAndMain(initNames, program) {
+		for (const name of initNames) this.line(`${name}();`);
+		if (program.decls.some((d) => d.kind === "FuncDecl" && d.name === "main"))
+			this.line("main();");
+	}
+
+	generate(program) {
+		const methods = this._collectDecls(program);
+		this._emitJsImports();
+		this._emitTypeDecls(program, methods);
+		this._emitVarConstDecls(program);
+		const initNames = this._emitFuncDecls(program);
+		this._callInitAndMain(initNames, program);
+		this._prependHelpers();
+		while (this.out[0] === "") this.out.shift();
+		return this.out.join("\n");
+	}
 
-		// Emit functions — rename duplicate init() to init$0, init$1, etc.
+	// Emits FuncDecl and TemplDecl nodes; returns renamed init function names.
+	_emitFuncDecls(program) {
 		let initCount = 0;
 		const initNames = [];
 		for (const d of program.decls) {
@@ -161,121 +171,73 @@ export class CodeGen {
 					this.genFuncDecl(d);
 				}
 				this.blank();
+			} else if (d.kind === "TemplDecl") {
+				this._currentSrcFileIdx = d._srcFileIdx ?? 0;
+				this.genTemplDecl(d);
+				this.blank();
 			}
 		}
+		return initNames;
+	}
 
-		// Auto-call init() functions, then main()
-		for (const name of initNames) this.line(`${name}();`);
-		const hasMain = program.decls.some(
-			(d) => d.kind === "FuncDecl" && d.name === "main",
-		);
-		if (hasMain) this.line("main();");
+	// Collects struct names, method map, and named wrapper names from program decls.
+	// Returns the method map (typeName → MethodDecl[]).
+	_collectStructNames(program) {
+		for (const d of program.decls) {
+			if (d.kind === "TypeDecl" && d.type.kind === "StructType")
+				this.structNames.add(d.name);
+		}
+	}
 
-		// Prepend runtime helpers that were actually used
-		const helpers = [];
-		if (this._usesLen)
-			helpers.push(
-				"var __len = __len || function(a) { if (a && typeof a === 'object' && !Array.isArray(a)) return Object.keys(a).length; return a?.length ?? 0; };",
-			);
-		if (this._usesAppend)
-			helpers.push(
-				"var __append = __append || function(a, ...b) { return a ? [...a, ...b] : b; };",
-			);
-		if (this._usesSliceGuard)
-			helpers.push("var __s = __s || function(a) { return a || []; };");
-		if (this._usesEqual)
-			helpers.push(
-				'var __equal = __equal || function __equal(a,b){if(a===b)return true;if(a===null||b===null)return false;if(Array.isArray(a)&&Array.isArray(b)){if(a.length!==b.length)return false;for(let i=0;i<a.length;i++)if(!__equal(a[i],b[i]))return false;return true;}if(typeof a==="object"&&typeof b==="object"){const ka=Object.keys(a),kb=Object.keys(b);if(ka.length!==kb.length)return false;for(const k of ka)if(!__equal(a[k],b[k]))return false;return true;}return false;};',
-			);
-		if (this._usesCmul)
-			helpers.push(
-				"var __cmul = __cmul || function(a, b) { return { re: a.re * b.re - a.im * b.im, im: a.re * b.im + a.im * b.re }; };",
-			);
-		if (this._usesCdiv)
-			helpers.push(
-				"var __cdiv = __cdiv || function(a, b) { const d = b.re * b.re + b.im * b.im; return { re: (a.re * b.re + a.im * b.im) / d, im: (a.im * b.re - a.re * b.im) / d }; };",
-			);
-		if (this._usesSprintf)
-			helpers.push(
-				[
-					"var __sprintf = __sprintf || function(f,...a){let i=0;return f.replace(/%([#+\\- 0]*)([0-9]*)\\.?([0-9]*)[sdvftxXqobeEgGw%]/g,(m)=>{",
-					"if(m==='%%')return'%';const fl=m.slice(1,-1),verb=m.slice(-1),v=a[i++];",
-					"const pad=(s,w,z)=>{w=parseInt(w)||0;if(!w)return s;const p=(z?'0':' ').repeat(Math.max(0,w-s.length));return fl.includes('-')?s+p:p+s;};",
-					"const [,flags,width,prec]=m.match(/^%([#+\\- 0]*)([0-9]*)\\.?([0-9]*)/)||[];",
-					"const zero=flags?.includes('0')&&!flags?.includes('-');",
-					"switch(verb){",
-					"case's':return pad(String(v==null?'<nil>':v),width,false);",
-					"case'd':return pad(String(Math.trunc(Number(v))),width,zero);",
-					"case'v':{if(typeof v==='object'&&v!==null&&'re' in v&&'im' in v){const sign=v.im>=0?'+':'';return pad('('+v.re+sign+v.im+'i)',width,false);}return pad(String(v==null?'<nil>':v),width,false);}",
-					"case'f':{const n=Number(v),p=prec!==''?parseInt(prec):6;return pad(n.toFixed(p),width,zero);}",
-					"case't':return pad(String(!!v),width,false);",
-					"case'x':return pad((Number(v)>>>0).toString(16),width,zero);",
-					"case'X':return pad((Number(v)>>>0).toString(16).toUpperCase(),width,zero);",
-					"case'o':return pad((Number(v)>>>0).toString(8),width,zero);",
-					"case'b':return pad((Number(v)>>>0).toString(2),width,zero);",
-					"case'q':return pad('\"'+String(v==null?'':v).replace(/\\\\/g,'\\\\\\\\').replace(/\"/g,'\\\\\"')+'\"',width,false);",
-					"case'e':case'E':{const n=Number(v),p=prec!==''?parseInt(prec):6;return pad(n.toExponential(p),width,zero);}",
-					"case'g':case'G':{const n=Number(v);return pad(prec!==''?n.toPrecision(parseInt(prec)):String(n),width,zero);}",
-					"case'w':return pad(String(v==null?'<nil>':typeof v==='object'&&v.Error?v.Error():v),width,false);",
-					"default:return m;}});",
-					"};",
-				].join(""),
-			);
-		if (this._usesError)
-			helpers.push(
-				"var __error = __error || function(msg, cause) { return { Error() { return msg; }, toString() { return msg; }, _msg: msg, _cause: cause ?? null }; };",
-			);
-		if (this._usesErrorIs)
-			helpers.push(
-				'var __errorIs = __errorIs || function(err, target) { while (err !== null && err !== undefined) { if (err === target) return true; if (typeof err === "object" && typeof target === "object" && err._msg !== undefined && target._msg !== undefined && err._msg === target._msg) return true; err = err?._cause ?? null; } return false; };',
-			);
-		if (this._usesPathClean)
-			helpers.push(
-				'var __pathClean = __pathClean || function(p) { if (!p) return "."; const abs = p.startsWith("/"); const parts = p.split("/").reduce((acc, s) => { if (s === "" || s === ".") return acc; if (s === "..") { if (acc.length && acc[acc.length-1] !== "..") acc.pop(); else if (!abs) acc.push(".."); } else acc.push(s); return acc; }, []); return (abs ? "/" : "") + (parts.join("/") || "."); };',
-			);
-		if (this._usesTimeFmt)
-			helpers.push(
-				[
-					"var __timeFmt = __timeFmt || function(d, layout) {",
-					'const pad = (n, w=2) => String(n).padStart(w, "0");',
-					'const DAYS=["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"];',
-					'const MONTHS=["January","February","March","April","May","June","July","August","September","October","November","December"];',
-					"return layout.replace(/2006|06|Monday|Mon|January|Jan|01|1|02|2|15|PM|3|04|4|05|5|Z07:00|\\.000|\\.999/g, t => {",
-					"switch(t){",
-					'case "2006": return d.getFullYear();',
-					'case "06": return String(d.getFullYear()).slice(-2);',
-					'case "Monday": return DAYS[d.getDay()];',
-					'case "Mon": return DAYS[d.getDay()].slice(0,3);',
-					'case "January": return MONTHS[d.getMonth()];',
-					'case "Jan": return MONTHS[d.getMonth()].slice(0,3);',
-					'case "01": return pad(d.getMonth()+1);',
-					'case "1": return String(d.getMonth()+1);',
-					'case "02": return pad(d.getDate());',
-					'case "2": return String(d.getDate());',
-					'case "15": return pad(d.getHours());',
-					'case "PM": return d.getHours()<12?"AM":"PM";',
-					'case "3": return String(d.getHours()%12||12);',
-					'case "04": return pad(d.getMinutes());',
-					'case "4": return String(d.getMinutes());',
-					'case "05": return pad(d.getSeconds());',
-					'case "5": return String(d.getSeconds());',
-					'case "Z07:00": { const o=-d.getTimezoneOffset(); return o===0?"Z":(o>0?"+":"-")+pad(Math.floor(Math.abs(o)/60))+":"+pad(Math.abs(o)%60); }',
-					'case ".000": return "."+pad(d.getMilliseconds(),3);',
-					'case ".999": return d.getMilliseconds()>0?"."+String(d.getMilliseconds()).replace(/0+$/,""):"";',
-					"default: return t;}});",
-					"};",
-				].join(""),
-			);
-		if (this._usesTimeParse)
-			helpers.push(
-				'var __timeParse = __timeParse || function(layout, value) { try { const d = new Date(value); if (isNaN(d.getTime())) throw 0; return [{_d:d}, null]; } catch { return [{_d:new Date(0)}, "parsing time: cannot parse"]; } };',
-			);
+	_collectMethodMap(program) {
+		const methods = new Map();
+		for (const d of program.decls) {
+			if (d.kind === "MethodDecl") {
+				const name = d.recvType.name;
+				if (!methods.has(name)) methods.set(name, []);
+				methods.get(name).push(d);
+			}
+		}
+		return methods;
+	}
 
-		if (helpers.length > 0) this.out.unshift(...helpers, "");
+	_collectNamedWrappers(program, methods) {
+		for (const d of program.decls) {
+			if (
+				d.kind === "TypeDecl" &&
+				d.type.kind !== "StructType" &&
+				d.type.kind !== "InterfaceType" &&
+				(methods.get(d.name) ?? []).length > 0
+			) {
+				this.namedWrapperNames.add(d.name);
+			}
+		}
+	}
 
-		// Strip leading blank line
-		while (this.out[0] === "") this.out.shift();
-		return this.out.join("\n");
+	_collectDecls(program) {
+		this._collectStructNames(program);
+		const methods = this._collectMethodMap(program);
+		this._collectNamedWrappers(program, methods);
+		return methods;
+	}
+
+	_prependHelpers() {
+		const HELPER_MAP = [
+			[this._usesLen, HELPER_LEN],
+			[this._usesAppend, HELPER_APPEND],
+			[this._usesSliceGuard, HELPER_S],
+			[this._usesEqual, HELPER_EQUAL],
+			[this._usesCmul, HELPER_CMUL],
+			[this._usesCdiv, HELPER_CDIV],
+			[this._usesSprintf, HELPER_SPRINTF],
+			[this._usesError, HELPER_ERROR],
+			[this._usesErrorIs, HELPER_ERROR_IS],
+			[this._usesPathClean, HELPER_PATH_CLEAN],
+			[this._usesTimeFmt, HELPER_TIME_FMT],
+			[this._usesTimeParse, HELPER_TIME_PARSE],
+		];
+		const helpers = HELPER_MAP.filter(([flag]) => flag).map(([, h]) => h);
+		if (helpers.length > 0) this.out.unshift(...helpers, "");
 	}
 
 	// Generate a single bundle from multiple programs (same-package multi-file).
@@ -341,68 +303,75 @@ export class CodeGen {
 		this.line("}");
 	}
 
-	genStruct(name, structTypeAst, methodDecls) {
+	_collectStructFields(name, structTypeAst) {
 		const fields = [];
 		if (this.checker) {
 			const resolved = this.checker.types.get(name)?.underlying;
 			if (resolved?.kind === "struct") {
-				for (const [fName, fType] of resolved.fields.entries()) {
+				for (const [fName, fType] of resolved.fields.entries())
 					fields.push({ name: fName, zero: this.zeroValueForType(fType) });
-				}
 			}
 		} else {
-			// Fallback (e.g. tests without typechecker)
 			for (const f of structTypeAst.fields) {
-				if (f.embedded) continue; // Can't resolve here
+				if (f.embedded) continue;
 				const zero = this.zeroValueForTypeNode(f.type);
 				for (const n of f.names) fields.push({ name: n, zero });
 			}
 		}
+		return fields;
+	}
+
+	_genStructConstructor(fields) {
+		if (fields.length === 0) {
+			this.line("constructor() {}");
+		} else {
+			const params = fields.map((f) => `${f.name} = ${f.zero}`).join(", ");
+			this.line(`constructor({ ${params} } = {}) {`);
+			this.indented(() => {
+				for (const f of fields) this.line(`this.${f.name} = ${f.name};`);
+			});
+			this.line("}");
+		}
+	}
 
+	genStruct(name, structTypeAst, methodDecls) {
+		const fields = this._collectStructFields(name, structTypeAst);
 		this.line(`class ${name} {`);
 		this.indented(() => {
-			if (fields.length === 0) {
-				this.line("constructor() {}");
-			} else {
-				const params = fields.map((f) => `${f.name} = ${f.zero}`).join(", ");
-				this.line(`constructor({ ${params} } = {}) {`);
-				this.indented(() => {
-					for (const f of fields) this.line(`this.${f.name} = ${f.name};`);
-				});
-				this.line("}");
-			}
-
-			// Methods
+			this._genStructConstructor(fields);
 			for (const m of methodDecls) {
 				this.blank();
 				this.genMethod(m);
 			}
-
-			// Delegation stubs for promoted embedded methods
-			if (this.checker) {
-				const resolvedType = this.checker.types.get(name)?.underlying;
-				if (resolvedType?.kind === "struct" && resolvedType._embeds) {
-					const declared = new Set(methodDecls.map((m) => m.name));
-					for (const embed of resolvedType._embeds) {
-						const embedName = embed.kind === "named" ? embed.name : null;
-						if (!embedName) continue;
-						const embedBase = embed.kind === "named" ? embed.underlying : embed;
-						if (embedBase?.kind !== "struct" || !embedBase.methods) continue;
-						for (const [mName] of embedBase.methods.entries()) {
-							if (!declared.has(mName)) {
-								this.blank();
-								this.line(
-									`${mName}(...__a) { return ${embedName}.prototype.${mName}.call(this, ...__a); }`,
-								);
-							}
-						}
-					}
-				}
-			}
+			this._genEmbeddedMethodStubs(name, methodDecls);
 		});
 		this.line("}");
 	}
 
+	_genSingleEmbedStubs(embed, declared) {
+		const embedName = embed.kind === "named" ? embed.name : null;
+		if (!embedName) return;
+		const embedBase = embed.kind === "named" ? embed.underlying : embed;
+		if (embedBase?.kind !== "struct" || !embedBase.methods) return;
+		for (const [mName] of embedBase.methods.entries()) {
+			if (!declared.has(mName)) {
+				this.blank();
+				this.line(
+					`${mName}(...__a) { return ${embedName}.prototype.${mName}.call(this, ...__a); }`,
+				);
+			}
+		}
+	}
+
+	_genEmbeddedMethodStubs(name, methodDecls) {
+		if (!this.checker) return;
+		const resolvedType = this.checker.types.get(name)?.underlying;
+		if (resolvedType?.kind !== "struct" || !resolvedType._embeds) return;
+		const declared = new Set(methodDecls.map((m) => m.name));
+		for (const embed of resolvedType._embeds)
+			this._genSingleEmbedStubs(embed, declared);
+	}
+
 	genMethod(decl, recvField = null) {
 		const params = decl.params.map((p) => p.name).join(", ");
 		const asyncPrefix = decl.async ? "async " : "";
@@ -603,3 +572,5 @@ export class CodeGen {
 
 Object.assign(CodeGen.prototype, statementGenMethods);
 Object.assign(CodeGen.prototype, expressionGenMethods);
+Object.assign(CodeGen.prototype, stdlibGenMethods);
+Object.assign(CodeGen.prototype, templGenMethods);

package/src/codegen/runtime.js

@@ -0,0 +1,151 @@
+// Runtime helpers emitted by the code generator when the corresponding feature is used.
+// Each export is a single JS statement (var __x = __x || function(...){...};) so that
+// multiple compiled files bundled together can safely repeat the declaration.
+
+export const HELPER_LEN = `var __len = __len || function(a) {
+  if (a && typeof a === 'object' && !Array.isArray(a)) return Object.keys(a).length;
+  return a?.length ?? 0;
+};`;
+
+export const HELPER_APPEND =
+	"var __append = __append || function(a, ...b) { return a ? [...a, ...b] : b; };";
+
+export const HELPER_S = "var __s = __s || function(a) { return a || []; };";
+
+export const HELPER_EQUAL = `var __equal = __equal || function __equal(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) if (!__equal(a[i], b[i])) return false;
+    return true;
+  }
+  if (typeof a === "object" && typeof b === "object") {
+    const ka = Object.keys(a), kb = Object.keys(b);
+    if (ka.length !== kb.length) return false;
+    for (const k of ka) if (!__equal(a[k], b[k])) return false;
+    return true;
+  }
+  return false;
+};`;
+
+export const HELPER_CMUL = `var __cmul = __cmul || function(a, b) {
+  return { re: a.re * b.re - a.im * b.im, im: a.re * b.im + a.im * b.re };
+};`;
+
+export const HELPER_CDIV = `var __cdiv = __cdiv || function(a, b) {
+  const d = b.re * b.re + b.im * b.im;
+  return { re: (a.re * b.re + a.im * b.im) / d, im: (a.im * b.re - a.re * b.im) / d };
+};`;
+
+export const HELPER_SPRINTF = `var __sprintf = __sprintf || function(f, ...a) {
+  let i = 0;
+  return f.replace(/%([#+\\- 0]*)([0-9]*)\\.?([0-9]*)[sdvftxXqobeEgGw%]/g, (m) => {
+    if (m === "%%") return "%";
+    const verb = m.slice(-1);
+    const v = a[i++];
+    const [, flags, width, prec] = m.match(/^%([#+\\- 0]*)([0-9]*)\\.?([0-9]*)/) || [];
+    const zero = flags?.includes("0") && !flags?.includes("-");
+    const pad = (s, w, z) => {
+      w = parseInt(w) || 0;
+      if (!w) return s;
+      const p = (z ? "0" : " ").repeat(Math.max(0, w - s.length));
+      return flags.includes("-") ? s + p : p + s;
+    };
+    switch (verb) {
+      case "s": return pad(String(v == null ? "<nil>" : v), width, false);
+      case "d": return pad(String(Math.trunc(Number(v))), width, zero);
+      case "v": {
+        if (typeof v === "object" && v !== null && "re" in v && "im" in v) {
+          const sign = v.im >= 0 ? "+" : "";
+          return pad("(" + v.re + sign + v.im + "i)", width, false);
+        }
+        return pad(String(v == null ? "<nil>" : v), width, false);
+      }
+      case "f": { const n = Number(v), p = prec !== "" ? parseInt(prec) : 6; return pad(n.toFixed(p), width, zero); }
+      case "t": return pad(String(!!v), width, false);
+      case "x": return pad((Number(v) >>> 0).toString(16), width, zero);
+      case "X": return pad((Number(v) >>> 0).toString(16).toUpperCase(), width, zero);
+      case "o": return pad((Number(v) >>> 0).toString(8), width, zero);
+      case "b": return pad((Number(v) >>> 0).toString(2), width, zero);
+      case "q": return pad('"' + String(v == null ? "" : v).replace(/\\\\/g, "\\\\\\\\").replace(/"/g, '\\\\"') + '"', width, false);
+      case "e": case "E": { const n = Number(v), p = prec !== "" ? parseInt(prec) : 6; return pad(n.toExponential(p), width, zero); }
+      case "g": case "G": { const n = Number(v); return pad(prec !== "" ? n.toPrecision(parseInt(prec)) : String(n), width, zero); }
+      case "w": return pad(String(v == null ? "<nil>" : typeof v === "object" && v.Error ? v.Error() : v), width, false);
+      default: return m;
+    }
+  });
+};`;
+
+export const HELPER_ERROR = `var __error = __error || function(msg, cause) {
+  return { Error() { return msg; }, toString() { return msg; }, _msg: msg, _cause: cause ?? null };
+};`;
+
+export const HELPER_ERROR_IS = `var __errorIs = __errorIs || function(err, target) {
+  while (err !== null && err !== undefined) {
+    if (err === target) return true;
+    if (typeof err === "object" && typeof target === "object" &&
+        err._msg !== undefined && target._msg !== undefined &&
+        err._msg === target._msg) return true;
+    err = err?._cause ?? null;
+  }
+  return false;
+};`;
+
+export const HELPER_PATH_CLEAN = `var __pathClean = __pathClean || function(p) {
+  if (!p) return ".";
+  const abs = p.startsWith("/");
+  const parts = p.split("/").reduce((acc, s) => {
+    if (s === "" || s === ".") return acc;
+    if (s === "..") {
+      if (acc.length && acc[acc.length - 1] !== "..") acc.pop();
+      else if (!abs) acc.push("..");
+    } else acc.push(s);
+    return acc;
+  }, []);
+  return (abs ? "/" : "") + (parts.join("/") || ".");
+};`;
+
+export const HELPER_TIME_FMT = `var __timeFmt = __timeFmt || function(d, layout) {
+  const pad = (n, w = 2) => String(n).padStart(w, "0");
+  const DAYS = ["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"];
+  const MONTHS = ["January","February","March","April","May","June","July","August","September","October","November","December"];
+  return layout.replace(/2006|06|Monday|Mon|January|Jan|01|1|02|2|15|PM|3|04|4|05|5|Z07:00|\\.000|\\.999/g, t => {
+    switch (t) {
+      case "2006": return d.getFullYear();
+      case "06":   return String(d.getFullYear()).slice(-2);
+      case "Monday": return DAYS[d.getDay()];
+      case "Mon":    return DAYS[d.getDay()].slice(0, 3);
+      case "January": return MONTHS[d.getMonth()];
+      case "Jan":     return MONTHS[d.getMonth()].slice(0, 3);
+      case "01": return pad(d.getMonth() + 1);
+      case "1":  return String(d.getMonth() + 1);
+      case "02": return pad(d.getDate());
+      case "2":  return String(d.getDate());
+      case "15": return pad(d.getHours());
+      case "PM": return d.getHours() < 12 ? "AM" : "PM";
+      case "3":  return String(d.getHours() % 12 || 12);
+      case "04": return pad(d.getMinutes());
+      case "4":  return String(d.getMinutes());
+      case "05": return pad(d.getSeconds());
+      case "5":  return String(d.getSeconds());
+      case "Z07:00": {
+        const o = -d.getTimezoneOffset();
+        return o === 0 ? "Z" : (o > 0 ? "+" : "-") + pad(Math.floor(Math.abs(o) / 60)) + ":" + pad(Math.abs(o) % 60);
+      }
+      case ".000": return "." + pad(d.getMilliseconds(), 3);
+      case ".999": return d.getMilliseconds() > 0 ? "." + String(d.getMilliseconds()).replace(/0+$/, "") : "";
+      default: return t;
+    }
+  });
+};`;
+
+export const HELPER_TIME_PARSE = `var __timeParse = __timeParse || function(layout, value) {
+  try {
+    const d = new Date(value);
+    if (isNaN(d.getTime())) throw 0;
+    return [{ _d: d }, null];
+  } catch {
+    return [{ _d: new Date(0) }, "parsing time: cannot parse"];
+  }
+};`;