@soederpop/luca 0.0.36 → 0.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soederpop/luca",
-  "version": "0.0.36",
+  "version": "0.1.0",
   "website": "https://luca.soederpop.com",
   "description": "lightweight universal conversational architecture AKA Le Ultimate Component Architecture AKA Last Universal Common Ancestor, part AI part Human",
   "author": "jon soeder aka the people's champ <jon@soederpop.com>",
@@ -109,7 +109,6 @@
     "detect-port": "^1.5.1",
     "dotenv": "^17.2.4",
     "endent": "^2.1.0",
-    "esbuild-wasm": "0.17.18",
     "excalidraw-to-svg": "^3.1.0",
     "express": "^4.18.2",
     "figlet": "^1.6.0",

package/src/bootstrap/generated.ts

@@ -1,5 +1,5 @@
 // Auto-generated bootstrap content
-// Generated at: 2026-03-28T00:36:31.608Z
+// Generated at: 2026-03-28T05:59:18.171Z
 // Source: docs/bootstrap/*.md, docs/bootstrap/templates/*, docs/examples/*.md, docs/tutorials/*.md
 //
 // Do not edit manually. Run: luca build-bootstrap

package/src/cli/build-info.ts

@@ -1,4 +1,4 @@
 // Generated at compile time — do not edit manually
 export const BUILD_SHA = 'acd8dd0'
 export const BUILD_BRANCH = 'main'
-export const BUILD_DATE = '2026-03-28T00:36:32Z'
+export const BUILD_DATE = '2026-03-28T05:59:19Z'

package/src/commands/console.ts

@@ -38,7 +38,7 @@ async function evalBeforeRepl(evalArg: string, container: any, featureContext: R
 	if (target.type === 'markdown') {
 		await container.docs.load()
 		const doc = await container.docs.parseMarkdownAtPath(target.value)
-		const esbuild = container.feature('esbuild')
+		const transpiler = container.feature('transpiler')
 		const shared = vm.createContext({
 			console, fetch, URL, URLSearchParams,
 			setTimeout, clearTimeout, setInterval, clearInterval,
@@ -59,7 +59,7 @@ async function evalBeforeRepl(evalArg: string, container: any, featureContext: R
 				const needsTransform = lang === 'tsx' || lang === 'jsx'
 				let code = value
 				if (needsTransform) {
-					const { code: transformed } = esbuild.transformSync(value, { loader: lang as 'tsx' | 'jsx', format: 'cjs' })
+					const { code: transformed } = transpiler.transformSync(value, { loader: lang as 'tsx' | 'jsx', format: 'cjs' })
 					code = transformed
 				}
 

package/src/commands/prompt.ts

@@ -722,8 +722,8 @@ async function executePromptFile(resolvedPath: string, container: any, inputs?:
 			capturedLines.length = 0
 			let code = value
 			if (lang === 'tsx' || lang === 'jsx') {
-				const esbuild = container.feature('esbuild')
-				const { code: transformed } = esbuild.transformSync(value, { loader: lang as 'tsx' | 'jsx', format: 'cjs' })
+				const transpiler = container.feature('transpiler')
+				const { code: transformed } = transpiler.transformSync(value, { loader: lang as 'tsx' | 'jsx', format: 'cjs' })
 				code = transformed
 			}
 

package/src/commands/run.ts

@@ -16,37 +16,6 @@ export const argsSchema = CommandOptionsSchema.extend({
 	dontInjectContext: z.boolean().default(false).describe('Skip auto-injecting container context into scripts (run with plain bun instead)'),
 })
 
-/**
- * Convert esbuild ESM output imports/exports to CJS require/module.exports
- * so the code can run in a vm context that provides `require`.
- */
-function esmToCjs(code: string): string {
-	return code
-		// import { a, b } from 'x' → const { a, b } = require('x')
-		.replace(/^import\s+\{([^}]+)\}\s+from\s+(['"][^'"]+['"])\s*;?$/gm,
-			'const {$1} = require($2);')
-		// import x from 'y' → const x = require('y').default ?? require('y')
-		.replace(/^import\s+(\w+)\s+from\s+(['"][^'"]+['"])\s*;?$/gm,
-			'const $1 = require($2).default ?? require($2);')
-		// import * as x from 'y' → const x = require('y')
-		.replace(/^import\s+\*\s+as\s+(\w+)\s+from\s+(['"][^'"]+['"])\s*;?$/gm,
-			'const $1 = require($2);')
-		// import 'y' → require('y')
-		.replace(/^import\s+(['"][^'"]+['"])\s*;?$/gm,
-			'require($1);')
-		// export default → module.exports.default =
-		.replace(/^export\s+default\s+/gm, 'module.exports.default = ')
-		// export { ... } → strip (vars already in scope)
-		.replace(/^export\s+\{[^}]*\}\s*;?$/gm, '')
-		// export const/let/var → const/let/var
-		.replace(/^export\s+(const|let|var)\s+/gm, '$1 ')
-}
-
-function hasTLA(code: string): boolean {
-	// Quick check: contains await outside of async function bodies
-	// This is a heuristic — wrapTopLevelAwait does the real work
-	return /\bawait\b/.test(code) && !/^\s*\(?\s*async\b/.test(code)
-}
 
 function resolveScript(ref: string, context: ContainerContext): string | null {
 	const container = context.container as any
@@ -108,7 +77,7 @@ async function runMarkdown(scriptPath: string, options: z.infer<typeof argsSchem
 
 	const doc = await container.docs.parseMarkdownAtPath(scriptPath)
 
-	const esbuild = container.feature('esbuild')
+	const transpiler = container.feature('transpiler')
 	const ink = container.feature('ink', { enable: true })
 	await ink.loadModules()
 
@@ -128,7 +97,7 @@ async function runMarkdown(scriptPath: string, options: z.infer<typeof argsSchem
 
 	for (const source of blockSources) {
 		const keysBefore = new Set(Object.keys(shared))
-		const { code: transformed } = esbuild.transformSync(source, { loader: 'tsx', format: 'cjs' })
+		const { code: transformed } = transpiler.transformSync(source, { loader: 'tsx', format: 'cjs' })
 
 		await vm.run(transformed, shared)
 
@@ -190,7 +159,7 @@ async function runMarkdown(scriptPath: string, options: z.infer<typeof argsSchem
 			let code = value
 
 			if (needsTransform) {
-				const { code: transformed } = esbuild.transformSync(value, {
+				const { code: transformed } = transpiler.transformSync(value, {
 					loader: lang as 'tsx' | 'jsx',
 					format: 'cjs',
 				})
@@ -229,19 +198,10 @@ async function runScript(scriptPath: string, context: ContainerContext, options:
 	}
 
 	const vm = container.feature('vm')
-	const esbuild = container.feature('esbuild')
+	const transpiler = container.feature('transpiler')
 	const raw = container.fs.readFile(scriptPath)
 
-	let code: string
-	if (hasTLA(raw)) {
-		// TLA is incompatible with CJS format, so transform as ESM (preserves await)
-		// then convert import/export statements to require/module.exports for the vm
-		const { code: esm } = esbuild.transformSync(raw, { format: 'esm' })
-		code = esmToCjs(esm)
-	} else {
-		const { code: cjs } = esbuild.transformSync(raw, { format: 'cjs' })
-		code = cjs
-	}
+	const { code } = transpiler.transformSync(raw, { format: 'cjs' })
 
 	const ctx = {
 		require: vm.createRequireFor(scriptPath),

package/src/introspection/generated.agi.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-28T00:36:29.946Z
+// Generated at: 2026-03-28T05:59:16.407Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -953,77 +953,6 @@ setBuildTimeData('features.git', {
   }
 });
 
-setBuildTimeData('features.esbuild', {
-  "id": "features.esbuild",
-  "description": "A Feature for compiling typescript / esm modules, etc to JavaScript that the container can run at runtime. Uses esbuild for fast, reliable TypeScript/ESM transformation with full format support (esm, cjs, iife).",
-  "shortcut": "features.esbuild",
-  "className": "ESBuild",
-  "methods": {
-    "transformSync": {
-      "description": "/** Transform code synchronously",
-      "parameters": {
-        "code": {
-          "type": "string",
-          "description": "The code to transform"
-        },
-        "options": {
-          "type": "esbuild.TransformOptions",
-          "description": "The options to pass to esbuild"
-        }
-      },
-      "required": [
-        "code"
-      ],
-      "returns": "esbuild.TransformResult"
-    },
-    "transform": {
-      "description": "Transform code asynchronously",
-      "parameters": {
-        "code": {
-          "type": "string",
-          "description": "The code to transform"
-        },
-        "options": {
-          "type": "esbuild.TransformOptions",
-          "description": "The options to pass to esbuild"
-        }
-      },
-      "required": [
-        "code"
-      ],
-      "returns": "Promise<esbuild.TransformResult>"
-    },
-    "bundle": {
-      "description": "Bundle one or more entry points, resolving imports and requires into a single output. Supports Node platform by default so require() and Node builtins are handled. Returns in-memory output files unless write is enabled in options.",
-      "parameters": {
-        "entryPoints": {
-          "type": "string[]",
-          "description": "File paths to bundle from"
-        },
-        "options": {
-          "type": "esbuild.BuildOptions",
-          "description": "esbuild BuildOptions overrides"
-        }
-      },
-      "required": [
-        "entryPoints"
-      ],
-      "returns": "Promise<esbuild.BuildResult>"
-    }
-  },
-  "getters": {},
-  "events": {},
-  "state": {},
-  "options": {},
-  "envVars": [],
-  "examples": [
-    {
-      "language": "ts",
-      "code": "const esbuild = container.feature('esbuild')\nconst result = esbuild.transformSync('const x: number = 1')\nconsole.log(result.code) // 'const x = 1;\\n'"
-    }
-  ]
-});
-
 setBuildTimeData('features.dns', {
   "id": "features.dns",
   "description": "The Dns feature provides structured DNS lookups by wrapping the `dig` CLI. All query methods parse dig output into typed JSON objects, making it easy to explore and audit a domain's DNS configuration programmatically.",
@@ -4994,6 +4923,127 @@ setBuildTimeData('features.docker', {
   }
 });
 
+setBuildTimeData('features.transpiler', {
+  "id": "features.transpiler",
+  "description": "Transpile TypeScript, TSX, and JSX to JavaScript at runtime using Bun's built-in transpiler. Compile code strings on the fly without touching the filesystem or spawning external processes.",
+  "shortcut": "features.transpiler",
+  "className": "Transpiler",
+  "methods": {
+    "transformSync": {
+      "description": "Transform code synchronously",
+      "parameters": {
+        "code": {
+          "type": "string",
+          "description": "The code to transform"
+        },
+        "options": {
+          "type": "TransformOptions",
+          "description": "Transform options (loader, format, minify)",
+          "properties": {
+            "loader": {
+              "type": "'ts' | 'tsx' | 'jsx' | 'js'",
+              "description": ""
+            },
+            "format": {
+              "type": "'esm' | 'cjs'",
+              "description": ""
+            },
+            "minify": {
+              "type": "boolean",
+              "description": ""
+            }
+          }
+        }
+      },
+      "required": [
+        "code"
+      ],
+      "returns": "TransformResult"
+    },
+    "transform": {
+      "description": "Transform code asynchronously",
+      "parameters": {
+        "code": {
+          "type": "string",
+          "description": "The code to transform"
+        },
+        "options": {
+          "type": "TransformOptions",
+          "description": "Transform options (loader, format, minify)",
+          "properties": {
+            "loader": {
+              "type": "'ts' | 'tsx' | 'jsx' | 'js'",
+              "description": ""
+            },
+            "format": {
+              "type": "'esm' | 'cjs'",
+              "description": ""
+            },
+            "minify": {
+              "type": "boolean",
+              "description": ""
+            }
+          }
+        }
+      },
+      "required": [
+        "code"
+      ],
+      "returns": "Promise<TransformResult>"
+    }
+  },
+  "getters": {},
+  "events": {},
+  "state": {},
+  "options": {},
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const transpiler = container.feature('transpiler')\nconst result = transpiler.transformSync('const x: number = 1')\nconsole.log(result.code) // 'const x = 1;\\n'"
+    }
+  ],
+  "types": {
+    "TransformOptions": {
+      "description": "",
+      "properties": {
+        "loader": {
+          "type": "'ts' | 'tsx' | 'jsx' | 'js'",
+          "description": "",
+          "optional": true
+        },
+        "format": {
+          "type": "'esm' | 'cjs'",
+          "description": "",
+          "optional": true
+        },
+        "minify": {
+          "type": "boolean",
+          "description": "",
+          "optional": true
+        }
+      }
+    },
+    "TransformResult": {
+      "description": "",
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": ""
+        },
+        "map": {
+          "type": "string",
+          "description": ""
+        },
+        "warnings": {
+          "type": "any[]",
+          "description": ""
+        }
+      }
+    }
+  }
+});
+
 setBuildTimeData('features.yaml', {
   "id": "features.yaml",
   "description": "The YAML feature provides utilities for parsing and stringifying YAML data. This feature wraps the js-yaml library to provide convenient methods for converting between YAML strings and JavaScript objects. It's automatically attached to Node containers for easy access.",
@@ -18540,7 +18590,7 @@ setContainerBuildTimeData('Container', {
 
 setContainerBuildTimeData('NodeContainer', {
   "className": "NodeContainer",
-  "description": "Server-side container for Node.js and Bun environments. Extends the base Container with file system access, process management, git integration, and other server-side capabilities. Auto-enables core features on construction: fs, proc, git, grep, os, networking, ui, vm, esbuild, helpers. Also attaches Client, Server, Command, Endpoint, and Selector helper types, providing `container.client()`, `container.server()`, `container.command()`, etc. factory methods.",
+  "description": "Server-side container for Node.js and Bun environments. Extends the base Container with file system access, process management, git integration, and other server-side capabilities. Auto-enables core features on construction: fs, proc, git, grep, os, networking, ui, vm, transpiler, helpers. Also attaches Client, Server, Command, Endpoint, and Selector helper types, providing `container.client()`, `container.server()`, `container.command()`, etc. factory methods.",
   "methods": {},
   "getters": {
     "cwd": {
@@ -19566,76 +19616,6 @@ export const introspectionData = [
       }
     }
   },
-  {
-    "id": "features.esbuild",
-    "description": "A Feature for compiling typescript / esm modules, etc to JavaScript that the container can run at runtime. Uses esbuild for fast, reliable TypeScript/ESM transformation with full format support (esm, cjs, iife).",
-    "shortcut": "features.esbuild",
-    "className": "ESBuild",
-    "methods": {
-      "transformSync": {
-        "description": "/** Transform code synchronously",
-        "parameters": {
-          "code": {
-            "type": "string",
-            "description": "The code to transform"
-          },
-          "options": {
-            "type": "esbuild.TransformOptions",
-            "description": "The options to pass to esbuild"
-          }
-        },
-        "required": [
-          "code"
-        ],
-        "returns": "esbuild.TransformResult"
-      },
-      "transform": {
-        "description": "Transform code asynchronously",
-        "parameters": {
-          "code": {
-            "type": "string",
-            "description": "The code to transform"
-          },
-          "options": {
-            "type": "esbuild.TransformOptions",
-            "description": "The options to pass to esbuild"
-          }
-        },
-        "required": [
-          "code"
-        ],
-        "returns": "Promise<esbuild.TransformResult>"
-      },
-      "bundle": {
-        "description": "Bundle one or more entry points, resolving imports and requires into a single output. Supports Node platform by default so require() and Node builtins are handled. Returns in-memory output files unless write is enabled in options.",
-        "parameters": {
-          "entryPoints": {
-            "type": "string[]",
-            "description": "File paths to bundle from"
-          },
-          "options": {
-            "type": "esbuild.BuildOptions",
-            "description": "esbuild BuildOptions overrides"
-          }
-        },
-        "required": [
-          "entryPoints"
-        ],
-        "returns": "Promise<esbuild.BuildResult>"
-      }
-    },
-    "getters": {},
-    "events": {},
-    "state": {},
-    "options": {},
-    "envVars": [],
-    "examples": [
-      {
-        "language": "ts",
-        "code": "const esbuild = container.feature('esbuild')\nconst result = esbuild.transformSync('const x: number = 1')\nconsole.log(result.code) // 'const x = 1;\\n'"
-      }
-    ]
-  },
   {
     "id": "features.dns",
     "description": "The Dns feature provides structured DNS lookups by wrapping the `dig` CLI. All query methods parse dig output into typed JSON objects, making it easy to explore and audit a domain's DNS configuration programmatically.",
@@ -23590,6 +23570,126 @@ export const introspectionData = [
       }
     }
   },
+  {
+    "id": "features.transpiler",
+    "description": "Transpile TypeScript, TSX, and JSX to JavaScript at runtime using Bun's built-in transpiler. Compile code strings on the fly without touching the filesystem or spawning external processes.",
+    "shortcut": "features.transpiler",
+    "className": "Transpiler",
+    "methods": {
+      "transformSync": {
+        "description": "Transform code synchronously",
+        "parameters": {
+          "code": {
+            "type": "string",
+            "description": "The code to transform"
+          },
+          "options": {
+            "type": "TransformOptions",
+            "description": "Transform options (loader, format, minify)",
+            "properties": {
+              "loader": {
+                "type": "'ts' | 'tsx' | 'jsx' | 'js'",
+                "description": ""
+              },
+              "format": {
+                "type": "'esm' | 'cjs'",
+                "description": ""
+              },
+              "minify": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
+          }
+        },
+        "required": [
+          "code"
+        ],
+        "returns": "TransformResult"
+      },
+      "transform": {
+        "description": "Transform code asynchronously",
+        "parameters": {
+          "code": {
+            "type": "string",
+            "description": "The code to transform"
+          },
+          "options": {
+            "type": "TransformOptions",
+            "description": "Transform options (loader, format, minify)",
+            "properties": {
+              "loader": {
+                "type": "'ts' | 'tsx' | 'jsx' | 'js'",
+                "description": ""
+              },
+              "format": {
+                "type": "'esm' | 'cjs'",
+                "description": ""
+              },
+              "minify": {
+                "type": "boolean",
+                "description": ""
+              }
+            }
+          }
+        },
+        "required": [
+          "code"
+        ],
+        "returns": "Promise<TransformResult>"
+      }
+    },
+    "getters": {},
+    "events": {},
+    "state": {},
+    "options": {},
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const transpiler = container.feature('transpiler')\nconst result = transpiler.transformSync('const x: number = 1')\nconsole.log(result.code) // 'const x = 1;\\n'"
+      }
+    ],
+    "types": {
+      "TransformOptions": {
+        "description": "",
+        "properties": {
+          "loader": {
+            "type": "'ts' | 'tsx' | 'jsx' | 'js'",
+            "description": "",
+            "optional": true
+          },
+          "format": {
+            "type": "'esm' | 'cjs'",
+            "description": "",
+            "optional": true
+          },
+          "minify": {
+            "type": "boolean",
+            "description": "",
+            "optional": true
+          }
+        }
+      },
+      "TransformResult": {
+        "description": "",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": ""
+          },
+          "map": {
+            "type": "string",
+            "description": ""
+          },
+          "warnings": {
+            "type": "any[]",
+            "description": ""
+          }
+        }
+      }
+    }
+  },
   {
     "id": "features.yaml",
     "description": "The YAML feature provides utilities for parsing and stringifying YAML data. This feature wraps the js-yaml library to provide convenient methods for converting between YAML strings and JavaScript objects. It's automatically attached to Node containers for easy access.",
@@ -37093,7 +37193,7 @@ export const containerIntrospectionData = [
   },
   {
     "className": "NodeContainer",
-    "description": "Server-side container for Node.js and Bun environments. Extends the base Container with file system access, process management, git integration, and other server-side capabilities. Auto-enables core features on construction: fs, proc, git, grep, os, networking, ui, vm, esbuild, helpers. Also attaches Client, Server, Command, Endpoint, and Selector helper types, providing `container.client()`, `container.server()`, `container.command()`, etc. factory methods.",
+    "description": "Server-side container for Node.js and Bun environments. Extends the base Container with file system access, process management, git integration, and other server-side capabilities. Auto-enables core features on construction: fs, proc, git, grep, os, networking, ui, vm, transpiler, helpers. Also attaches Client, Server, Command, Endpoint, and Selector helper types, providing `container.client()`, `container.server()`, `container.command()`, etc. factory methods.",
     "methods": {},
     "getters": {
       "cwd": {