numbl 0.4.7 → 0.4.8

package/dist-cli/cli.js

@@ -39194,6 +39194,8 @@ var SPECIAL_BUILTIN_NAMES = [
   "delete",
   "rmdir",
   "movefile",
+  "copyfile",
+  "fileattrib",
   "unzip",
   "dir",
   "warning",
@@ -39203,6 +39205,7 @@ var SPECIAL_BUILTIN_NAMES = [
   "userpath",
   "getenv",
   "setenv",
+  "maxNumCompThreads",
   "pwd",
   "cd",
   "ode45",
@@ -40144,6 +40147,65 @@ function registerSpecialBuiltins(rt) {
       RTV.char("")
     ];
   });
+  registerSpecial("copyfile", (nargout, args) => {
+    const io = requireFileIO();
+    if (!io.copyfile)
+      throw new RuntimeError("copyfile is not available in this environment");
+    const margs = args.map((a) => ensureRuntimeValue(a));
+    if (margs.length < 1)
+      throw new RuntimeError("copyfile requires at least 1 argument");
+    const source = toString(margs[0]);
+    const destination = margs.length >= 2 ? toString(margs[1]) : rt.system?.cwd() ?? ".";
+    let force = false;
+    if (margs.length >= 3) {
+      const third = toString(margs[2]);
+      if (third.toLowerCase() === "f") force = true;
+    }
+    const ok = io.copyfile(source, destination, force);
+    if (nargout === 0) {
+      if (!ok)
+        throw new RuntimeError(
+          `copyfile: cannot copy '${source}' to '${destination}'`
+        );
+      return void 0;
+    }
+    return nargout <= 1 ? RTV.num(ok ? 1 : 0) : [
+      RTV.num(ok ? 1 : 0),
+      RTV.char(ok ? "" : `Cannot copy '${source}' to '${destination}'`),
+      RTV.char("")
+    ];
+  });
+  registerSpecial("fileattrib", (nargout, args) => {
+    const io = requireFileIO();
+    if (!io.fileattrib)
+      throw new RuntimeError("fileattrib is not available in this environment");
+    const margs = args.map((a) => ensureRuntimeValue(a));
+    if (margs.length < 1)
+      throw new RuntimeError("fileattrib requires at least 1 argument");
+    const p2 = toString(margs[0]);
+    const info = io.fileattrib(p2);
+    if (nargout === 0) {
+      if (!info)
+        throw new RuntimeError(
+          `fileattrib: cannot find '${p2}': No such file or directory`
+        );
+      return void 0;
+    }
+    const values = info ? RTV.struct(
+      /* @__PURE__ */ new Map([
+        ["Name", RTV.char(info.Name)],
+        ["archive", RTV.num(0)],
+        ["system", RTV.num(0)],
+        ["hidden", RTV.num(0)],
+        ["directory", RTV.num(info.directory ? 1 : 0)],
+        ["UserRead", RTV.num(info.UserRead ? 1 : 0)],
+        ["UserWrite", RTV.num(info.UserWrite ? 1 : 0)],
+        ["UserExecute", RTV.num(info.UserExecute ? 1 : 0)]
+      ])
+    ) : RTV.char(`No such file or directory: ${p2}`);
+    if (nargout <= 1) return RTV.num(info ? 1 : 0);
+    return [RTV.num(info ? 1 : 0), values, RTV.char("")];
+  });
   registerSpecial("unzip", (nargout, args) => {
     const io = requireFileIO();
     if (!io.unzip)
@@ -40469,6 +40531,7 @@ function registerSpecialBuiltins(rt) {
     }
     return RTV.char(sys?.getEnv(toString(args[0])) ?? "");
   });
+  registerSpecial("maxNumCompThreads", () => RTV.num(1));
   registerSpecialVoid("setenv", (args) => {
     const sys = rt.system;
     if (args.length === 2) {
@@ -62854,7 +62917,7 @@ function getSourceLine(getSource, file, line) {
 }
 
 // src/numbl-core/version.ts
-var NUMBL_VERSION = "0.4.7";
+var NUMBL_VERSION = "0.4.8";
 
 // src/cli-repl.ts
 import { createInterface } from "readline";
@@ -62870,6 +62933,13 @@ import { join as join4 } from "path";
 import { homedir as homedir2 } from "os";
 
 // src/numbl-core/jsUserFunctions.ts
+function callHandle(handle, args, nargout = 1) {
+  const rt = getCurrentRuntime();
+  if (!rt) {
+    throw new RuntimeError("callHandle: no active runtime to invoke handle");
+  }
+  return rt.index(handle, args, nargout);
+}
 function funcNameFromFile(fileName) {
   const base = fileName.split("/").pop();
   return base.replace(/\.numbl\.js$/, "");
@@ -62915,6 +62985,8 @@ function instantiateWasm(wasmData) {
   const moduleImports = WebAssembly.Module.imports(wasmModule);
   const importObject = {};
   const neededModules = new Set(moduleImports.map((i) => i.module));
+  const callbacks = /* @__PURE__ */ new Map();
+  let nextCbId = 1;
   if (neededModules.has("wasi_snapshot_preview1")) {
     importObject.wasi_snapshot_preview1 = {
       fd_write: () => 0,
@@ -62934,10 +63006,36 @@ function instantiateWasm(wasmData) {
   if (neededModules.has("env")) {
     importObject.env = {
       emscripten_notify_memory_growth: () => {
+      },
+      // Scalar callback: WASM calls back into a registered handle with one
+      // f64 and receives an f64. Exceptions thrown here (incl. a missing id)
+      // propagate out through the WASM call into the apply.
+      numbl_cb_d: (id, x) => {
+        const fn = callbacks.get(id);
+        if (!fn) {
+          throw new RuntimeError(
+            `numbl_cb_d: no callback registered for id ${id}`
+          );
+        }
+        return fn(x);
       }
     };
   }
-  return new WebAssembly.Instance(wasmModule, importObject);
+  const instance = new WebAssembly.Instance(
+    wasmModule,
+    importObject
+  );
+  instance.callbacks = {
+    add(fn) {
+      const id = nextCbId++;
+      callbacks.set(id, fn);
+      return id;
+    },
+    remove(id) {
+      callbacks.delete(id);
+    }
+  };
+  return instance;
 }
 function resolveBindings(file, directives, getWasmInstance, nativeBridge2) {
   const wasmInstance = directives.wasm ? getWasmInstance(directives.wasm) : void 0;
@@ -63012,6 +63110,8 @@ function loadJsUserFunctions(jsFiles, wasmFiles, nativeBridge2) {
       "wasm",
       "native",
       "importJS",
+      "callHandle",
+      "toNumber",
       libFile.source
     );
     const exports = factory(
@@ -63021,7 +63121,9 @@ function loadJsUserFunctions(jsFiles, wasmFiles, nativeBridge2) {
       dummyRegister,
       wasmInstance,
       nativeLib,
-      importJS
+      importJS,
+      callHandle,
+      toNumber
     );
     libCache.set(name, exports);
     return exports;
@@ -63059,6 +63161,8 @@ function loadJsUserFunctions(jsFiles, wasmFiles, nativeBridge2) {
         "wasm",
         "native",
         "importJS",
+        "callHandle",
+        "toNumber",
         file.source
       );
       factory(
@@ -63068,7 +63172,9 @@ function loadJsUserFunctions(jsFiles, wasmFiles, nativeBridge2) {
         registerFn,
         wasmInstance,
         nativeLib,
-        importJS
+        importJS,
+        callHandle,
+        toNumber
       );
       if (!builtin) {
         throw new Error(
@@ -64688,6 +64794,15 @@ __export(interpreterExec_exports, {
   writeLValueBase: () => writeLValueBase
 });
 
+// src/numbl-core/jitDeclineDiagnostics.ts
+var lastDecline = null;
+function recordJitDecline(d) {
+  lastDecline = d;
+}
+function getLastJitDecline() {
+  return lastDecline;
+}
+
 // src/numbl-core/runtime/cow.ts
 function cowCopy(v) {
   if (isRuntimeTensor(v)) {
@@ -64990,14 +65105,16 @@ function execStmtInner(stmt) {
     case "Directive": {
       if (stmt.directive === "assert_jit") {
         const wantC = stmt.args.includes("c");
+        const decline = getLastJitDecline();
+        const why = decline ? ` Most recent JIT decline (${decline.where}, ${decline.kind}): ${decline.message}` : ` (no JIT decline reason was recorded \u2014 the unit may have been declined before lowering, e.g. an unsupported input type.)`;
         if (this.optimization === "1") {
           throw new RuntimeError(
-            `%!numbl:assert_jit: expected the enclosing loop/function/script to be JS-JIT-compiled at --opt 1, but it ran in the interpreter. (Run with --opt 0 to silence.)`
+            `%!numbl:assert_jit: expected the enclosing loop/function/script to be JS-JIT-compiled at --opt 1, but it ran in the interpreter.${why} (Run with --opt 0 to silence.)`
           );
         }
         if (this.optimization === "2" && wantC) {
           throw new RuntimeError(
-            `%!numbl:assert_jit c: expected the enclosing loop/function/script to be C-JIT-compiled at --opt 2, but it ran in the interpreter. (Run with --opt 0 to silence.)`
+            `%!numbl:assert_jit c: expected the enclosing loop/function/script to be C-JIT-compiled at --opt 2, but it ran in the interpreter.${why} (Run with --opt 0 to silence.)`
           );
         }
       }
@@ -78009,6 +78126,30 @@ var sin = defineUnaryRealMath({
   complex: { cFnComplex: "mtoc2_csin", jsFnComplex: cSin }
 });
 
+// src/numbl-core/jit/builtins/defs/math/rand.ts
+var rand = {
+  name: "rand",
+  transfer(argTypes, nargout) {
+    if (nargout > 1) {
+      throw new UnsupportedConstruct(
+        `'rand' does not support multi-output (nargout=${nargout})`
+      );
+    }
+    if (argTypes.length !== 0) {
+      throw new UnsupportedConstruct(
+        `JS-JIT 'rand' supports only the scalar form rand() so far (got ${argTypes.length} arg(s)); matrix/seed forms run in the interpreter`
+      );
+    }
+    return [scalarDouble("nonneg")];
+  },
+  emitJs() {
+    return "$rand()";
+  },
+  call() {
+    return [rngRandom()];
+  }
+};
+
 // src/numbl-core/jit/builtins/defs/math/tan.ts
 var tan = defineUnaryRealMath({
   name: "tan",
@@ -83392,6 +83533,7 @@ for (const b of [
   stdBuiltin,
   min,
   max,
+  rand,
   any,
   all,
   zeros,
@@ -89231,12 +89373,13 @@ function emitJsProgram(prog, opts = {}) {
   const wrapperLines = [];
   if (opts.exposeSpec !== void 0) {
     wrapperLines.push(
-      `return function ($h) { globalThis.$write = $h.write; globalThis.$plotDispatch = $h.plotDispatch; return ${opts.exposeSpec}; };`
+      `return function ($h) { globalThis.$write = $h.write; globalThis.$plotDispatch = $h.plotDispatch; globalThis.$rand = $h.rand; return ${opts.exposeSpec}; };`
     );
   } else {
     wrapperLines.push("function run($h) {");
     wrapperLines.push("  globalThis.$write = $h.write;");
     wrapperLines.push("  globalThis.$plotDispatch = $h.plotDispatch;");
+    wrapperLines.push("  globalThis.$rand = $h.rand;");
     const locals = collectAssignedLocals(prog.topLevelStmts);
     if (locals.length > 0) {
       wrapperLines.push(`  let ${locals.join(", ")};`);
@@ -94431,6 +94574,7 @@ function getOrCreateSession(interp) {
 function buildHostHelpers(rt) {
   return {
     write: (s) => rt.output(s),
+    rand: () => rngRandom(),
     plotDispatch: (name, args) => {
       const runtimeArgs = args.map((a) => jitToNumbl(a));
       const handled = dispatchPlotBuiltin(
@@ -94523,6 +94667,11 @@ var jitCallExecutor = {
       return { specFn };
     } catch (e) {
       if (e instanceof UnsupportedConstruct || e instanceof TypeError2) {
+        recordJitDecline({
+          message: e.message,
+          kind: e.constructor.name,
+          where: "jit-call"
+        });
         return null;
       }
       throw e;
@@ -94649,6 +94798,11 @@ var jitLoopExecutor = {
       return { specFn };
     } catch (e) {
       if (e instanceof UnsupportedConstruct || e instanceof TypeError2) {
+        recordJitDecline({
+          message: e.message,
+          kind: e.constructor.name,
+          where: "jit-loop"
+        });
         return null;
       }
       throw e;
@@ -94789,6 +94943,11 @@ var jitTopLevelExecutor = {
       return { specFn, nargout };
     } catch (e) {
       if (e instanceof UnsupportedConstruct || e instanceof TypeError2) {
+        recordJitDecline({
+          message: e.message,
+          kind: e.constructor.name,
+          where: "jit-top-level"
+        });
         return null;
       }
       throw e;
@@ -95463,7 +95622,8 @@ import {
   rmSync,
   rmdirSync,
   renameSync,
-  chmodSync
+  chmodSync,
+  realpathSync
 } from "fs";
 import { unzipSync } from "fflate";
 import { execFileSync } from "child_process";
@@ -95855,6 +96015,51 @@ var NodeFileIOAdapter = class {
       return false;
     }
   }
+  copyfile(source, destination, force) {
+    try {
+      const src = expandTilde(source);
+      const srcStat = statSync2(src);
+      let dst = expandTilde(destination);
+      try {
+        if (statSync2(dst).isDirectory()) dst = join3(dst, basename(src));
+      } catch {
+      }
+      if (srcStat.isDirectory()) {
+        copyDirRecursive(src, dst);
+        return true;
+      }
+      const parent = dirname(dst);
+      if (parent && parent !== "." && parent !== "/") {
+        mkdirSync(parent, { recursive: true });
+      }
+      if (force) {
+        try {
+          chmodSync(dst, 438);
+        } catch {
+        }
+      }
+      writeFileSync(dst, readFileSync3(src));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  fileattrib(path) {
+    try {
+      const p2 = expandTilde(path);
+      const st2 = statSync2(p2);
+      const mode = st2.mode;
+      return {
+        Name: realpathSync(p2),
+        directory: st2.isDirectory(),
+        UserRead: (mode & 256) !== 0,
+        UserWrite: (mode & 128) !== 0,
+        UserExecute: (mode & 64) !== 0
+      };
+    } catch {
+      return null;
+    }
+  }
   deleteFile(pattern) {
     const p2 = expandTilde(pattern);
     if (p2.includes("*") || p2.includes("?")) {
@@ -98736,6 +98941,9 @@ Options (for build-site):
                        the first script)
   --repo-url <url>   Source repository URL, shown as a link in the deployed
                        site (default: from numbl-project.json)
+  --max-initial-output-panel-height <px>
+                     Cap the initial height (px) of the output panel so the
+                       figure panel below it starts larger (desktop layout)
 
 Options (for parse):
   --dump-ast <file>  Write the AST as indented JSON to <file> (default: stdout)
@@ -99265,6 +99473,9 @@ async function cmdBuildAddon(args) {
 }
 var SITE_DEFAULT_IGNORE_DIRS = /* @__PURE__ */ new Set([".git", ".github", "node_modules"]);
 var SITE_MAX_FILE_BYTES = 25 * 1024 * 1024;
+function isAgentInstructionFile(name) {
+  return name === "GEMINI.md" || /^(CLAUDE|AGENT)[^/]*\.md$/i.test(name);
+}
 function readNumblIgnore(projectDir) {
   const p2 = join7(projectDir, ".numblignore");
   if (!existsSync3(p2)) return [];
@@ -99313,6 +99524,7 @@ function collectSiteFiles(projectDir, outDirAbs, ignore) {
         walk2(full);
       } else if (e.isFile()) {
         if (e.name === ".numblignore" || e.name === ".DS_Store") continue;
+        if (isAgentInstructionFile(e.name)) continue;
         const st2 = statSync3(full);
         if (st2.size > SITE_MAX_FILE_BYTES) {
           console.error(
@@ -99334,6 +99546,7 @@ async function cmdBuildSite(args) {
   let title;
   let entry;
   let repoUrl;
+  let maxInitialOutputPanelHeight;
   const positional = [];
   for (let i = 0; i < args.length; i++) {
     const a = args[i];
@@ -99342,7 +99555,16 @@ async function cmdBuildSite(args) {
     else if (a === "--title") title = args[++i];
     else if (a === "--entry") entry = args[++i];
     else if (a === "--repo-url") repoUrl = args[++i];
-    else if (a.startsWith("-")) {
+    else if (a === "--max-initial-output-panel-height") {
+      const n = Number(args[++i]);
+      if (!Number.isFinite(n) || n <= 0) {
+        console.error(
+          "Error: --max-initial-output-panel-height must be a positive number"
+        );
+        process.exit(1);
+      }
+      maxInitialOutputPanelHeight = n;
+    } else if (a.startsWith("-")) {
       console.error(`Unknown option: ${a}`);
       process.exit(1);
     } else positional.push(a);
@@ -99395,6 +99617,8 @@ async function cmdBuildSite(args) {
   if (title !== void 0) manifest.title = title;
   if (entry !== void 0) manifest.entry = entry;
   if (repoUrl !== void 0) manifest.repository = repoUrl;
+  if (maxInitialOutputPanelHeight !== void 0)
+    manifest.maxInitialOutputPanelHeight = maxInitialOutputPanelHeight;
   if (!manifest.title) manifest.title = basename2(projectDirAbs);
   const zipEntries = {};
   for (const f of collected) {
@@ -99425,6 +99649,11 @@ async function cmdBuildSite(args) {
   let indexHtml = readFileSync6(indexPath, "utf-8");
   indexHtml = indexHtml.includes("<!-- numbl:base -->") ? indexHtml.replace("<!-- numbl:base -->", inject) : indexHtml.replace("</head>", `  ${inject}
   </head>`);
+  const escapeHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  indexHtml = indexHtml.replace(
+    /<title>.*?<\/title>/,
+    `<title>${escapeHtml(manifest.title)}</title>`
+  );
   writeFileSync4(indexPath, indexHtml);
   const redirectTarget = normBase ?? "/";
   writeFileSync4(

package/dist-lib/lib.d.ts

@@ -12,6 +12,10 @@ export { setDelaunayBackend } from "./numbl-core/native/geometry-bridge.js";
 export type { ExecOptions, ExecResult, ProfileData, BuiltinProfileEntry, BuiltinProfileBreakdown, } from "./numbl-core/executeCode.js";
 export type { FileIOAdapter } from "./numbl-core/fileIOAdapter.js";
 export type { SystemAdapter } from "./numbl-core/systemAdapter.js";
+export { VirtualFileSystem } from "./vfs/VirtualFileSystem.js";
+export { BrowserFileIOAdapter } from "./vfs/BrowserFileIOAdapter.js";
+export { BrowserSystemAdapter } from "./vfs/BrowserSystemAdapter.js";
+export type { UihtmlSession } from "./numbl-core/executeCode.js";
 export type { WorkspaceFile, NativeBridge, } from "./numbl-core/workspace/index.js";
 export type { PlotInstruction } from "./graphics/types.js";
 export type { RuntimeValue, RuntimeTensor, RuntimeString, RuntimeLogical, RuntimeCell, RuntimeStruct, RuntimeFunction, RuntimeDictionary, } from "./numbl-core/runtime/index.js";