@mcmcjs/julia 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shravan Goswami
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @mcmcjs/julia
+
+The bridge to the Julia ecosystem for [MCMC.js](https://github.com/mcmcjs/mcmcjs):
+detecting the installed Julia toolchain (juliaup and Julia), and (later)
+bootstrapping it and running inference via Turing.jl / JuliaBUGS.
+
+> Early alpha: the API is not yet stable.
+
+## License
+
+[MIT](./LICENSE) (c) [Shravan Goswami](https://shravangoswami.com)

package/dist/index.cjs

@@ -0,0 +1,71 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  detectJulia: () => detectJulia,
+  detectJuliaup: () => detectJuliaup,
+  runDoctor: () => runDoctor
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/environment.ts
+var import_node_child_process = require("child_process");
+var import_node_os = require("os");
+var import_node_path = require("path");
+var import_node_util = require("util");
+var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
+var defaultRunner = async (command, args) => {
+  const { stdout } = await execFileAsync(command, args, { timeout: 1e4 });
+  return stdout;
+};
+function candidates(binary) {
+  return [(0, import_node_path.join)((0, import_node_os.homedir)(), ".juliaup", "bin", binary), binary];
+}
+async function detect(binary, parseVersion, runner) {
+  for (const path of candidates(binary)) {
+    try {
+      const version = parseVersion(await runner(path, ["--version"]));
+      if (version) return { found: true, version, path };
+    } catch {
+    }
+  }
+  return { found: false };
+}
+var versionNumber = (stdout) => stdout.match(/(\d+\.\d+\.\d+)/)?.[1];
+function detectJulia(runner = defaultRunner) {
+  return detect("julia", versionNumber, runner);
+}
+function detectJuliaup(runner = defaultRunner) {
+  return detect("juliaup", versionNumber, runner);
+}
+
+// src/doctor.ts
+async function runDoctor(runner) {
+  const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);
+  return { juliaup, julia, ready: julia.found };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectJulia,
+  detectJuliaup,
+  runDoctor
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/environment.ts","../src/doctor.ts"],"sourcesContent":["export type { DoctorReport } from \"./doctor\";\nexport { runDoctor } from \"./doctor\";\nexport type { CommandRunner, ToolInfo } from \"./environment\";\nexport { detectJulia, detectJuliaup } from \"./environment\";\n","import { execFile } from \"node:child_process\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\n/** Information about a detected command-line tool. */\nexport interface ToolInfo {\n  found: boolean;\n  version?: string;\n  path?: string;\n}\n\n/** Runs a command and resolves its stdout. Injectable so detection is testable. */\nexport type CommandRunner = (command: string, args: string[]) => Promise<string>;\n\nconst defaultRunner: CommandRunner = async (command, args) => {\n  const { stdout } = await execFileAsync(command, args, { timeout: 10_000 });\n  return stdout;\n};\n\n// juliaup installs its shims here; we also fall back to whatever is on PATH.\nfunction candidates(binary: string): string[] {\n  return [join(homedir(), \".juliaup\", \"bin\", binary), binary];\n}\n\nasync function detect(\n  binary: string,\n  parseVersion: (stdout: string) => string | undefined,\n  runner: CommandRunner,\n): Promise<ToolInfo> {\n  for (const path of candidates(binary)) {\n    try {\n      const version = parseVersion(await runner(path, [\"--version\"]));\n      if (version) return { found: true, version, path };\n    } catch {\n      // not available at this path; try the next candidate\n    }\n  }\n  return { found: false };\n}\n\nconst versionNumber = (stdout: string): string | undefined => stdout.match(/(\\d+\\.\\d+\\.\\d+)/)?.[1];\n\n/** Detects the Julia runtime via `julia --version`. */\nexport function detectJulia(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"julia\", versionNumber, runner);\n}\n\n/** Detects the juliaup version manager via `juliaup --version`. */\nexport function detectJuliaup(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"juliaup\", versionNumber, runner);\n}\n","import { type CommandRunner, detectJulia, detectJuliaup, type ToolInfo } from \"./environment\";\n\n/** A summary of the Julia toolchain available for inference. */\nexport interface DoctorReport {\n  juliaup: ToolInfo;\n  julia: ToolInfo;\n  /** True when Julia itself is available (the minimum needed to run inference). */\n  ready: boolean;\n}\n\n/** Detects the installed Julia toolchain and reports whether inference can run. */\nexport async function runDoctor(runner?: CommandRunner): Promise<DoctorReport> {\n  const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);\n  return { juliaup, julia, ready: julia.found };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,gCAAyB;AACzB,qBAAwB;AACxB,uBAAqB;AACrB,uBAA0B;AAE1B,IAAM,oBAAgB,4BAAU,kCAAQ;AAYxC,IAAM,gBAA+B,OAAO,SAAS,SAAS;AAC5D,QAAM,EAAE,OAAO,IAAI,MAAM,cAAc,SAAS,MAAM,EAAE,SAAS,IAAO,CAAC;AACzE,SAAO;AACT;AAGA,SAAS,WAAW,QAA0B;AAC5C,SAAO,KAAC,2BAAK,wBAAQ,GAAG,YAAY,OAAO,MAAM,GAAG,MAAM;AAC5D;AAEA,eAAe,OACb,QACA,cACA,QACmB;AACnB,aAAW,QAAQ,WAAW,MAAM,GAAG;AACrC,QAAI;AACF,YAAM,UAAU,aAAa,MAAM,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC9D,UAAI,QAAS,QAAO,EAAE,OAAO,MAAM,SAAS,KAAK;AAAA,IACnD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,EAAE,OAAO,MAAM;AACxB;AAEA,IAAM,gBAAgB,CAAC,WAAuC,OAAO,MAAM,iBAAiB,IAAI,CAAC;AAG1F,SAAS,YAAY,SAAwB,eAAkC;AACpF,SAAO,OAAO,SAAS,eAAe,MAAM;AAC9C;AAGO,SAAS,cAAc,SAAwB,eAAkC;AACtF,SAAO,OAAO,WAAW,eAAe,MAAM;AAChD;;;AC1CA,eAAsB,UAAU,QAA+C;AAC7E,QAAM,CAAC,SAAS,KAAK,IAAI,MAAM,QAAQ,IAAI,CAAC,cAAc,MAAM,GAAG,YAAY,MAAM,CAAC,CAAC;AACvF,SAAO,EAAE,SAAS,OAAO,OAAO,MAAM,MAAM;AAC9C;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,24 @@
+/** Information about a detected command-line tool. */
+interface ToolInfo {
+    found: boolean;
+    version?: string;
+    path?: string;
+}
+/** Runs a command and resolves its stdout. Injectable so detection is testable. */
+type CommandRunner = (command: string, args: string[]) => Promise<string>;
+/** Detects the Julia runtime via `julia --version`. */
+declare function detectJulia(runner?: CommandRunner): Promise<ToolInfo>;
+/** Detects the juliaup version manager via `juliaup --version`. */
+declare function detectJuliaup(runner?: CommandRunner): Promise<ToolInfo>;
+
+/** A summary of the Julia toolchain available for inference. */
+interface DoctorReport {
+    juliaup: ToolInfo;
+    julia: ToolInfo;
+    /** True when Julia itself is available (the minimum needed to run inference). */
+    ready: boolean;
+}
+/** Detects the installed Julia toolchain and reports whether inference can run. */
+declare function runDoctor(runner?: CommandRunner): Promise<DoctorReport>;
+
+export { type CommandRunner, type DoctorReport, type ToolInfo, detectJulia, detectJuliaup, runDoctor };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/** Information about a detected command-line tool. */
+interface ToolInfo {
+    found: boolean;
+    version?: string;
+    path?: string;
+}
+/** Runs a command and resolves its stdout. Injectable so detection is testable. */
+type CommandRunner = (command: string, args: string[]) => Promise<string>;
+/** Detects the Julia runtime via `julia --version`. */
+declare function detectJulia(runner?: CommandRunner): Promise<ToolInfo>;
+/** Detects the juliaup version manager via `juliaup --version`. */
+declare function detectJuliaup(runner?: CommandRunner): Promise<ToolInfo>;
+
+/** A summary of the Julia toolchain available for inference. */
+interface DoctorReport {
+    juliaup: ToolInfo;
+    julia: ToolInfo;
+    /** True when Julia itself is available (the minimum needed to run inference). */
+    ready: boolean;
+}
+/** Detects the installed Julia toolchain and reports whether inference can run. */
+declare function runDoctor(runner?: CommandRunner): Promise<DoctorReport>;
+
+export { type CommandRunner, type DoctorReport, type ToolInfo, detectJulia, detectJuliaup, runDoctor };

package/dist/index.js

@@ -0,0 +1,42 @@
+// src/environment.ts
+import { execFile } from "child_process";
+import { homedir } from "os";
+import { join } from "path";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+var defaultRunner = async (command, args) => {
+  const { stdout } = await execFileAsync(command, args, { timeout: 1e4 });
+  return stdout;
+};
+function candidates(binary) {
+  return [join(homedir(), ".juliaup", "bin", binary), binary];
+}
+async function detect(binary, parseVersion, runner) {
+  for (const path of candidates(binary)) {
+    try {
+      const version = parseVersion(await runner(path, ["--version"]));
+      if (version) return { found: true, version, path };
+    } catch {
+    }
+  }
+  return { found: false };
+}
+var versionNumber = (stdout) => stdout.match(/(\d+\.\d+\.\d+)/)?.[1];
+function detectJulia(runner = defaultRunner) {
+  return detect("julia", versionNumber, runner);
+}
+function detectJuliaup(runner = defaultRunner) {
+  return detect("juliaup", versionNumber, runner);
+}
+
+// src/doctor.ts
+async function runDoctor(runner) {
+  const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);
+  return { juliaup, julia, ready: julia.found };
+}
+export {
+  detectJulia,
+  detectJuliaup,
+  runDoctor
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/environment.ts","../src/doctor.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\n/** Information about a detected command-line tool. */\nexport interface ToolInfo {\n  found: boolean;\n  version?: string;\n  path?: string;\n}\n\n/** Runs a command and resolves its stdout. Injectable so detection is testable. */\nexport type CommandRunner = (command: string, args: string[]) => Promise<string>;\n\nconst defaultRunner: CommandRunner = async (command, args) => {\n  const { stdout } = await execFileAsync(command, args, { timeout: 10_000 });\n  return stdout;\n};\n\n// juliaup installs its shims here; we also fall back to whatever is on PATH.\nfunction candidates(binary: string): string[] {\n  return [join(homedir(), \".juliaup\", \"bin\", binary), binary];\n}\n\nasync function detect(\n  binary: string,\n  parseVersion: (stdout: string) => string | undefined,\n  runner: CommandRunner,\n): Promise<ToolInfo> {\n  for (const path of candidates(binary)) {\n    try {\n      const version = parseVersion(await runner(path, [\"--version\"]));\n      if (version) return { found: true, version, path };\n    } catch {\n      // not available at this path; try the next candidate\n    }\n  }\n  return { found: false };\n}\n\nconst versionNumber = (stdout: string): string | undefined => stdout.match(/(\\d+\\.\\d+\\.\\d+)/)?.[1];\n\n/** Detects the Julia runtime via `julia --version`. */\nexport function detectJulia(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"julia\", versionNumber, runner);\n}\n\n/** Detects the juliaup version manager via `juliaup --version`. */\nexport function detectJuliaup(runner: CommandRunner = defaultRunner): Promise<ToolInfo> {\n  return detect(\"juliaup\", versionNumber, runner);\n}\n","import { type CommandRunner, detectJulia, detectJuliaup, type ToolInfo } from \"./environment\";\n\n/** A summary of the Julia toolchain available for inference. */\nexport interface DoctorReport {\n  juliaup: ToolInfo;\n  julia: ToolInfo;\n  /** True when Julia itself is available (the minimum needed to run inference). */\n  ready: boolean;\n}\n\n/** Detects the installed Julia toolchain and reports whether inference can run. */\nexport async function runDoctor(runner?: CommandRunner): Promise<DoctorReport> {\n  const [juliaup, julia] = await Promise.all([detectJuliaup(runner), detectJulia(runner)]);\n  return { juliaup, julia, ready: julia.found };\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAE1B,IAAM,gBAAgB,UAAU,QAAQ;AAYxC,IAAM,gBAA+B,OAAO,SAAS,SAAS;AAC5D,QAAM,EAAE,OAAO,IAAI,MAAM,cAAc,SAAS,MAAM,EAAE,SAAS,IAAO,CAAC;AACzE,SAAO;AACT;AAGA,SAAS,WAAW,QAA0B;AAC5C,SAAO,CAAC,KAAK,QAAQ,GAAG,YAAY,OAAO,MAAM,GAAG,MAAM;AAC5D;AAEA,eAAe,OACb,QACA,cACA,QACmB;AACnB,aAAW,QAAQ,WAAW,MAAM,GAAG;AACrC,QAAI;AACF,YAAM,UAAU,aAAa,MAAM,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC9D,UAAI,QAAS,QAAO,EAAE,OAAO,MAAM,SAAS,KAAK;AAAA,IACnD,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,EAAE,OAAO,MAAM;AACxB;AAEA,IAAM,gBAAgB,CAAC,WAAuC,OAAO,MAAM,iBAAiB,IAAI,CAAC;AAG1F,SAAS,YAAY,SAAwB,eAAkC;AACpF,SAAO,OAAO,SAAS,eAAe,MAAM;AAC9C;AAGO,SAAS,cAAc,SAAwB,eAAkC;AACtF,SAAO,OAAO,WAAW,eAAe,MAAM;AAChD;;;AC1CA,eAAsB,UAAU,QAA+C;AAC7E,QAAM,CAAC,SAAS,KAAK,IAAI,MAAM,QAAQ,IAAI,CAAC,cAAc,MAAM,GAAG,YAAY,MAAM,CAAC,CAAC;AACvF,SAAO,EAAE,SAAS,OAAO,OAAO,MAAM,MAAM;AAC9C;","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@mcmcjs/julia",
+  "version": "0.1.0",
+  "description": "Julia toolchain detection and the inference runner for MCMC.js.",
+  "keywords": [
+    "mcmc",
+    "julia",
+    "juliaup",
+    "turing",
+    "inference",
+    "runner"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Shravan Goswami",
+    "email": "contact@shravangoswami.com",
+    "url": "https://shravangoswami.com"
+  },
+  "homepage": "https://github.com/mcmcjs/mcmcjs/tree/main/packages/julia#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mcmcjs/mcmcjs.git",
+    "directory": "packages/julia"
+  },
+  "bugs": {
+    "url": "https://github.com/mcmcjs/mcmcjs/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}