sandlot 0.1.1 → 0.1.3

package/dist/internal.d.ts

@@ -71,4 +71,9 @@ export { getSharedModuleRuntimeCode } from "./shared-modules";
  * Format esbuild messages for display.
  */
 export { formatEsbuildMessages } from "./commands";
+/**
+ * Build event emitter for sandbox environments.
+ * Use this for custom build event handling in advanced use cases.
+ */
+export { BuildEmitter } from "./build-emitter";
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM5D;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMhD;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAMrC;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAM9D;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM5D;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMhD;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAMrC;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAM9D;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAMnD;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/internal.js

@@ -675,16 +675,18 @@ var GLOBAL_KEY = "__sandlot_shared_modules__";
 
 class SharedModuleRegistry {
   modules = new Map;
+  exportNames = new Map;
   constructor() {
     globalThis[GLOBAL_KEY] = this;
   }
   register(moduleId, module) {
     this.modules.set(moduleId, module);
+    this.exportNames.set(moduleId, introspectExports(module));
     return this;
   }
   registerAll(modules) {
     for (const [id, mod] of Object.entries(modules)) {
-      this.modules.set(id, mod);
+      this.register(id, mod);
     }
     return this;
   }
@@ -705,13 +707,44 @@ class SharedModuleRegistry {
   list() {
     return [...this.modules.keys()];
   }
+  getExportNames(moduleId) {
+    return this.exportNames.get(moduleId) ?? [];
+  }
   clear() {
     this.modules.clear();
+    this.exportNames.clear();
   }
   get size() {
     return this.modules.size;
   }
 }
+function introspectExports(module) {
+  if (module === null || module === undefined) {
+    return [];
+  }
+  if (typeof module !== "object" && typeof module !== "function") {
+    return [];
+  }
+  const exports = [];
+  for (const key of Object.keys(module)) {
+    if (isValidIdentifier(key)) {
+      exports.push(key);
+    }
+  }
+  return exports;
+}
+function isValidIdentifier(name) {
+  if (name.length === 0)
+    return false;
+  if (!/^[a-zA-Z_$]/.test(name))
+    return false;
+  if (!/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name))
+    return false;
+  const reserved = ["default", "class", "function", "var", "let", "const", "import", "export"];
+  if (reserved.includes(name))
+    return false;
+  return true;
+}
 var defaultRegistry = null;
 function getSharedModuleRegistry() {
   if (!defaultRegistry) {
@@ -731,6 +764,9 @@ function unregisterSharedModule(moduleId) {
 function clearSharedModules() {
   getSharedModuleRegistry().clear();
 }
+function getSharedModuleExports(moduleId) {
+  return getSharedModuleRegistry().getExportNames(moduleId);
+}
 function getSharedModuleRuntimeCode(moduleId) {
   return `
 (function() {
@@ -745,7 +781,21 @@ function getSharedModuleRuntimeCode(moduleId) {
 })()
 `.trim();
 }
-// src/commands.ts
+// src/commands/types.ts
+function formatEsbuildMessages(messages) {
+  if (messages.length === 0)
+    return "";
+  return messages.map((msg) => {
+    if (msg.location) {
+      const { file, line, column } = msg.location;
+      const loc = file ? `${file}${line ? `:${line}` : ""}${column ? `:${column}` : ""}` : "";
+      return loc ? `${loc}: ${msg.text}` : msg.text;
+    }
+    return msg.text;
+  }).join(`
+`);
+}
+// src/commands/compile.ts
 import { defineCommand } from "just-bash/browser";
 
 // src/typechecker.ts
@@ -1081,12 +1131,35 @@ function formatDiagnosticsForAgent(diagnostics) {
 }
 
 // src/bundler.ts
-import * as esbuild from "esbuild-wasm";
+var esbuild = null;
+async function getEsbuild() {
+  if (esbuild)
+    return esbuild;
+  const cdnUrl = `https://esm.sh/esbuild-wasm@${ESBUILD_VERSION}`;
+  const mod = await import(cdnUrl);
+  esbuild = mod.default ?? mod;
+  if (typeof esbuild?.initialize !== "function") {
+    console.error("esbuild-wasm module structure:", mod);
+    throw new Error("Failed to load esbuild-wasm: initialize function not found");
+  }
+  return esbuild;
+}
+var ESBUILD_VERSION = "0.27.2";
 var initialized = false;
 var initPromise = null;
 function getWasmUrl() {
-  const version = "0.27.2";
-  return `https://unpkg.com/esbuild-wasm@${version}/esbuild.wasm`;
+  return `https://unpkg.com/esbuild-wasm@${ESBUILD_VERSION}/esbuild.wasm`;
+}
+function checkCrossOriginIsolation() {
+  if (typeof window === "undefined")
+    return;
+  if (!window.crossOriginIsolated) {
+    console.warn(`[sandlot] Cross-origin isolation is not enabled. esbuild-wasm may have reduced performance or fail on some browsers.
+To enable, add these headers to your dev server:
+  Cross-Origin-Embedder-Policy: require-corp
+  Cross-Origin-Opener-Policy: same-origin
+In Vite, add a plugin to configureServer. See sandlot README for details.`);
+  }
 }
 async function initBundler() {
   if (initialized)
@@ -1095,9 +1168,13 @@ async function initBundler() {
     await initPromise;
     return;
   }
-  initPromise = esbuild.initialize({
-    wasmURL: getWasmUrl()
-  });
+  checkCrossOriginIsolation();
+  initPromise = (async () => {
+    const es = await getEsbuild();
+    await es.initialize({
+      wasmURL: getWasmUrl()
+    });
+  })();
   await initPromise;
   initialized = true;
 }
@@ -1148,8 +1225,8 @@ function createVfsPlugin(options) {
   } = options;
   return {
     name: "virtual-fs",
-    setup(build2) {
-      build2.onResolve({ filter: /.*/ }, async (args) => {
+    setup(build) {
+      build.onResolve({ filter: /.*/ }, async (args) => {
         if (args.kind === "entry-point") {
           return { path: entryPoint, namespace: "vfs" };
         }
@@ -1205,28 +1282,18 @@ function createVfsPlugin(options) {
         }
         return { errors: [{ text: `Cannot resolve: ${args.path} from ${args.resolveDir}` }] };
       });
-      build2.onLoad({ filter: /.*/, namespace: "sandlot-shared" }, (args) => {
-        const contents = `export default ${getSharedModuleRuntimeCode(args.path)};
-export * from ${JSON.stringify(args.path)};
-// Re-export all named exports by importing from registry
-const __mod__ = ${getSharedModuleRuntimeCode(args.path)};
-for (const __k__ in __mod__) {
-  if (__k__ !== 'default') Object.defineProperty(exports, __k__, { 
-    enumerable: true, 
-    get: function() { return __mod__[__k__]; } 
-  });
-}`;
-        const esmContents = `
+      build.onLoad({ filter: /.*/, namespace: "sandlot-shared" }, (args) => {
+        const contents = `
 const __sandlot_mod__ = ${getSharedModuleRuntimeCode(args.path)};
 export default __sandlot_mod__.default ?? __sandlot_mod__;
 ${generateNamedExports(args.path)}
 `;
         return {
-          contents: esmContents.trim(),
+          contents: contents.trim(),
           loader: "js"
         };
       });
-      build2.onLoad({ filter: /.*/, namespace: "vfs" }, async (args) => {
+      build.onLoad({ filter: /.*/, namespace: "vfs" }, async (args) => {
         try {
           const contents = await fs.readFile(args.path);
           includedFiles.add(args.path);
@@ -1245,55 +1312,12 @@ ${generateNamedExports(args.path)}
   };
 }
 function generateNamedExports(moduleId) {
-  const knownExports = {
-    react: [
-      "useState",
-      "useEffect",
-      "useContext",
-      "useReducer",
-      "useCallback",
-      "useMemo",
-      "useRef",
-      "useImperativeHandle",
-      "useLayoutEffect",
-      "useDebugValue",
-      "useDeferredValue",
-      "useTransition",
-      "useId",
-      "useSyncExternalStore",
-      "useInsertionEffect",
-      "useOptimistic",
-      "useActionState",
-      "createElement",
-      "cloneElement",
-      "createContext",
-      "forwardRef",
-      "lazy",
-      "memo",
-      "startTransition",
-      "Children",
-      "Component",
-      "PureComponent",
-      "Fragment",
-      "Profiler",
-      "StrictMode",
-      "Suspense",
-      "version",
-      "isValidElement"
-    ],
-    "react-dom": ["createPortal", "flushSync", "version"],
-    "react-dom/client": ["createRoot", "hydrateRoot"],
-    "react-dom/server": ["renderToString", "renderToStaticMarkup", "renderToPipeableStream"]
-  };
-  const exports = knownExports[moduleId];
-  if (!exports) {
-    return `
-// Dynamic re-export for unknown module
-export const __moduleProxy__ = __sandlot_mod__;
-`;
-  }
-  return exports.map((name) => `export const ${name} = __sandlot_mod__.${name};`).join(`
+  const exports = getSharedModuleExports(moduleId);
+  if (exports.length > 0) {
+    return exports.map((name) => `export const ${name} = __sandlot_mod__.${name};`).join(`
 `);
+  }
+  return `// No exports discovered for "${moduleId}" - use default import or call registerSharedModules() first`;
 }
 async function bundle(options) {
   await initBundler();
@@ -1325,7 +1349,8 @@ async function bundle(options) {
     includedFiles,
     sharedModuleIds
   });
-  const result = await esbuild.build({
+  const es = await getEsbuild();
+  const result = await es.build({
     entryPoints: [normalizedEntry],
     bundle: true,
     write: false,
@@ -1335,7 +1360,8 @@ async function bundle(options) {
     globalName,
     target,
     external,
-    plugins: [plugin]
+    plugins: [plugin],
+    jsx: "automatic"
   });
   const code = result.outputFiles?.[0]?.text ?? "";
   return {
@@ -1358,20 +1384,7 @@ async function bundleAndImport(options) {
   }
 }
 
-// src/commands.ts
-function formatEsbuildMessages(messages) {
-  if (messages.length === 0)
-    return "";
-  return messages.map((msg) => {
-    if (msg.location) {
-      const { file, line, column } = msg.location;
-      const loc = file ? `${file}${line ? `:${line}` : ""}${column ? `:${column}` : ""}` : "";
-      return loc ? `${loc}: ${msg.text}` : msg.text;
-    }
-    return msg.text;
-  }).join(`
-`);
-}
+// src/commands/compile.ts
 function createTscCommand(deps) {
   const { fs, libFiles, tsconfigPath } = deps;
   return defineCommand("tsc", async (args, _ctx) => {
@@ -1436,7 +1449,7 @@ ${formatDiagnosticsForAgent(result.diagnostics.filter((d) => d.category === "war
   });
 }
 function createBuildCommand(deps) {
-  const { fs, libFiles, tsconfigPath, onBuild, sharedModules } = deps;
+  const { fs, libFiles, tsconfigPath, onBuild, getValidation, sharedModules } = deps;
   return defineCommand("build", async (args, _ctx) => {
     let entryPoint = null;
     let skipTypecheck = false;
@@ -1508,8 +1521,39 @@ ${formatted}
         minify,
         sharedModules
       });
+      let loadedModule;
+      try {
+        loadedModule = await loadModule(bundleResult);
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return {
+          stdout: "",
+          stderr: `Build failed: Module failed to load.
+
+${errorMessage}
+`,
+          exitCode: 1
+        };
+      }
+      const validateFn = getValidation?.();
+      let validatedModule = loadedModule;
+      if (validateFn) {
+        try {
+          validatedModule = validateFn(loadedModule);
+        } catch (err) {
+          const errorMessage = err instanceof Error ? err.message : String(err);
+          return {
+            stdout: "",
+            stderr: `Build failed: Validation error.
+
+${errorMessage}
+`,
+            exitCode: 1
+          };
+        }
+      }
       if (onBuild) {
-        await onBuild(bundleResult);
+        await onBuild({ bundle: bundleResult, module: validatedModule });
       }
       let output = `Build successful!
 `;
@@ -1525,6 +1569,15 @@ ${formatted}
       }
       output += `Bundled: ${bundleResult.includedFiles.length} file(s)
 `;
+      const exportNames = Object.keys(loadedModule).filter((k) => !k.startsWith("__"));
+      if (exportNames.length > 0) {
+        output += `Exports: ${exportNames.join(", ")}
+`;
+      }
+      if (validateFn) {
+        output += `Validation: passed
+`;
+      }
       if (bundleResult.warnings.length > 0) {
         output += `
 Build warnings:
@@ -1556,9 +1609,11 @@ ${formatDiagnosticsForAgent(warnings)}
     }
   });
 }
+// src/commands/packages.ts
+import { defineCommand as defineCommand2 } from "just-bash/browser";
 function createInstallCommand(deps) {
   const { fs, typesCache } = deps;
-  return defineCommand("install", async (args, _ctx) => {
+  return defineCommand2("install", async (args, _ctx) => {
     if (args.length === 0) {
       return {
         stdout: "",
@@ -1612,7 +1667,7 @@ Examples:
 }
 function createUninstallCommand(deps) {
   const { fs } = deps;
-  return defineCommand("uninstall", async (args, _ctx) => {
+  return defineCommand2("uninstall", async (args, _ctx) => {
     if (args.length === 0) {
       return {
         stdout: "",
@@ -1657,7 +1712,7 @@ function createUninstallCommand(deps) {
 }
 function createListCommand(deps) {
   const { fs } = deps;
-  return defineCommand("list", async (_args, _ctx) => {
+  return defineCommand2("list", async (_args, _ctx) => {
     try {
       const packages = await listPackages(fs);
       if (packages.length === 0) {
@@ -1687,9 +1742,11 @@ function createListCommand(deps) {
     }
   });
 }
+// src/commands/run.ts
+import { defineCommand as defineCommand3 } from "just-bash/browser";
 function createRunCommand(deps) {
   const { fs, libFiles, tsconfigPath, runOptions = {}, sharedModules } = deps;
-  return defineCommand("run", async (args, _ctx) => {
+  return defineCommand3("run", async (args, _ctx) => {
     let entryPoint = null;
     let skipTypecheck = runOptions.skipTypecheck ?? false;
     let timeout = runOptions.timeout ?? 30000;
@@ -1866,6 +1923,7 @@ ${err.stack}` : "";
     }
   });
 }
+// src/commands/index.ts
 function createDefaultCommands(deps) {
   return [
     createTscCommand(deps),
@@ -1876,6 +1934,26 @@ function createDefaultCommands(deps) {
     createListCommand(deps)
   ];
 }
+// src/build-emitter.ts
+class BuildEmitter {
+  listeners = new Set;
+  emit = async (result) => {
+    const promises = [];
+    for (const listener of this.listeners) {
+      const ret = listener(result);
+      if (ret instanceof Promise) {
+        promises.push(ret);
+      }
+    }
+    await Promise.all(promises);
+  };
+  on(callback) {
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+    };
+  }
+}
 export {
   revokeModuleUrl,
   resolveToEsmUrl,
@@ -1893,5 +1971,6 @@ export {
   createModuleUrl,
   SharedModuleRegistry,
   LibCache,
-  InMemoryTypesCache
+  InMemoryTypesCache,
+  BuildEmitter
 };