@visulima/vis 1.0.0-alpha.10 → 1.0.0-alpha.11

package/dist/packem_chunks/handler24.js

@@ -1 +1,110 @@
-var b=Object.defineProperty;var j=(t,e)=>b(t,"name",{value:e,configurable:!0});import{createTaskGraph as v}from"@visulima/task-runner";import{r as y,s as E}from"./bin.js";var T=Object.defineProperty,w=j((t,e)=>T(t,"name",{value:e,configurable:!0}),"h");const O=w((t,e)=>{const s=new Map;for(const[i,r]of Object.entries(t.dependencies))for(const f of r){const c=s.get(f)??[];c.push(i),s.set(f,c)}if(!t.tasks[e])return;const a=new Set([e]),o=[{node:e,path:[e]}];for(;o.length>0;){const i=o.shift();if(t.roots.includes(i.node))return i.path;for(const r of s.get(i.node)??[])a.has(r)||(a.add(r),o.push({node:r,path:[r,...i.path]}))}return[e]},"findShortestPathToRoot"),x=w((t,e)=>{const s=[];for(const[a,o]of Object.entries(t.dependencies))o.includes(e)&&s.push(a);return s.sort()},"collectParents"),I=w(async({argument:t,logger:e,visConfig:s,workspaceRoot:a})=>{if(!a)throw new Error("Could not determine workspace root.");const o=t[0];if(!o)throw new Error("No task ID specified. Usage: vis task-why <project>:<target>");if(!o.includes(":"))throw new Error(`Invalid task ID "${o}" — expected format "project:target".`);const{packageJsons:i,workspace:r}=y(a,s),f=E(a,r,i),[c,k]=o.split(":",2),$=r.projects[c];if(!$)throw new Error(`Unknown project "${c}".`);if(!$.targets?.[k])throw new Error(`Project "${c}" has no target "${k}".`);const m=Object.entries(r.projects).flatMap(([n,u])=>Object.keys(u.targets??{}).map(h=>({id:`${n}:${h}`,outputs:[],overrides:{},target:{project:n,target:h}}))),p=v(m,{projectGraph:f,workspace:r});if(!p.tasks[o])throw new Error(`Task "${o}" is not reachable in the graph.`);const d=O(p,o),g=x(p,o);if(e.info(""),e.info(`Why ${o}?`),e.info(""),d&&d.length>1){e.info("Shortest path from a root to this task:");for(const[n,u]of d.entries()){const h=n===0?"  ":`${"  ".repeat(n+1)}└─ `;e.info(`${h}${u}`)}e.info("")}else e.info("  This task is itself a root — nothing upstream depends on it."),e.info("");if(g.length>0){e.info(`Directly depended on by ${g.length} task(s):`);for(const n of g)e.info(`  - ${n}`);e.info("")}const l=p.dependencies[o]??[];if(l.length>0){e.info(`This task depends on ${l.length} task(s):`);for(const n of[...l].sort())e.info(`  - ${n}`);e.info("")}},"execute");export{I as default};
+import { createTaskGraph } from '@visulima/task-runner';
+import { d as discoverWorkspace, b as buildProjectGraph } from './bin.js';
+
+const findShortestPathToRoot = (graph, target) => {
+  const reverse = /* @__PURE__ */ new Map();
+  for (const [parent, deps] of Object.entries(graph.dependencies)) {
+    for (const dep of deps) {
+      const list = reverse.get(dep) ?? [];
+      list.push(parent);
+      reverse.set(dep, list);
+    }
+  }
+  if (!graph.tasks[target]) {
+    return void 0;
+  }
+  const visited = /* @__PURE__ */ new Set([target]);
+  const queue = [{ node: target, path: [target] }];
+  while (queue.length > 0) {
+    const current = queue.shift();
+    if (graph.roots.includes(current.node)) {
+      return current.path;
+    }
+    for (const parent of reverse.get(current.node) ?? []) {
+      if (visited.has(parent)) {
+        continue;
+      }
+      visited.add(parent);
+      queue.push({ node: parent, path: [parent, ...current.path] });
+    }
+  }
+  return [target];
+};
+const collectParents = (graph, target) => {
+  const parents = [];
+  for (const [parent, deps] of Object.entries(graph.dependencies)) {
+    if (deps.includes(target)) {
+      parents.push(parent);
+    }
+  }
+  return parents.sort();
+};
+const execute = async ({ argument, logger, visConfig, workspaceRoot: wsRoot }) => {
+  if (!wsRoot) {
+    throw new Error("Could not determine workspace root.");
+  }
+  const taskId = argument[0];
+  if (!taskId) {
+    throw new Error("No task ID specified. Usage: vis task-why <project>:<target>");
+  }
+  if (!taskId.includes(":")) {
+    throw new Error(`Invalid task ID "${taskId}" — expected format "project:target".`);
+  }
+  const { packageJsons, workspace } = discoverWorkspace(wsRoot, visConfig);
+  const projectGraph = buildProjectGraph(wsRoot, workspace, packageJsons);
+  const [projectName, targetName] = taskId.split(":", 2);
+  const project = workspace.projects[projectName];
+  if (!project) {
+    throw new Error(`Unknown project "${projectName}".`);
+  }
+  if (!project.targets?.[targetName]) {
+    throw new Error(`Project "${projectName}" has no target "${targetName}".`);
+  }
+  const allInitialTasks = Object.entries(workspace.projects).flatMap(
+    ([name, proj]) => Object.keys(proj.targets ?? {}).map((t) => {
+      return {
+        id: `${name}:${t}`,
+        outputs: [],
+        overrides: {},
+        target: { project: name, target: t }
+      };
+    })
+  );
+  const graph = createTaskGraph(allInitialTasks, { projectGraph, workspace });
+  if (!graph.tasks[taskId]) {
+    throw new Error(`Task "${taskId}" is not reachable in the graph.`);
+  }
+  const path = findShortestPathToRoot(graph, taskId);
+  const parents = collectParents(graph, taskId);
+  logger.info("");
+  logger.info(`Why ${taskId}?`);
+  logger.info("");
+  if (path && path.length > 1) {
+    logger.info("Shortest path from a root to this task:");
+    for (const [index, node] of path.entries()) {
+      const prefix = index === 0 ? "  " : `${"  ".repeat(index + 1)}└─ `;
+      logger.info(`${prefix}${node}`);
+    }
+    logger.info("");
+  } else {
+    logger.info("  This task is itself a root — nothing upstream depends on it.");
+    logger.info("");
+  }
+  if (parents.length > 0) {
+    logger.info(`Directly depended on by ${parents.length} task(s):`);
+    for (const parent of parents) {
+      logger.info(`  - ${parent}`);
+    }
+    logger.info("");
+  }
+  const directDeps = graph.dependencies[taskId] ?? [];
+  if (directDeps.length > 0) {
+    logger.info(`This task depends on ${directDeps.length} task(s):`);
+    for (const dep of [...directDeps].sort()) {
+      logger.info(`  - ${dep}`);
+    }
+    logger.info("");
+  }
+};
+
+export { execute as default };

package/dist/packem_chunks/handler25.js

@@ -1,5 +1,402 @@
-var P=Object.defineProperty;var v=(e,n)=>P(e,"name",{value:n,configurable:!0});import{createRequire as R}from"node:module";import{green as S,red as W,yellow as A,dim as d}from"@visulima/colorize";import{join as N}from"@visulima/path";import{p as o}from"./bin.js";import{S as w,g as C,w as j,b as B,p as q,f as k,a as M,c as H,u as y,d as K,e as O,h as D}from"../packem_shared/toolchain-DQfTQY8E.js";const I=R(import.meta.url),$=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,b=v(e=>{if(typeof $<"u"&&$.versions&&$.versions.node){const[n,i]=$.versions.node.split(".").map(Number);if(n>22||n===22&&i>=3||n===20&&i>=16)return $.getBuiltinModule(e)}return I(e)},"__cjs_getBuiltinModule"),{spawnSync:U}=b("node:child_process"),{writeFileSync:F}=b("node:fs");var L=Object.defineProperty,f=v((e,n)=>L(e,"name",{value:n,configurable:!0}),"d");const x=["bun","deno","go","node","npm","pnpm","python","ruby","rust","yarn"],G=f(e=>x.includes(e),"isKnownTool"),p=f(e=>e?S("✓"):W("✗"),"icon"),T=A("⚠"),J=f(e=>{if(e.installed){const n=e.version?` v${e.version}`:"",i=e.configFiles.length>0?` (${e.configFiles.join(", ")})`:"";return`${p(!0)} ${e.name}${n}${i}`}return`${T} ${e.name} — referenced by ${e.configFiles.join(", ")} but not installed`},"renderManagerLine"),z=f(e=>{if(e.matches)return"";const{manager:n}=e;return n.name==="none"?d("→ (no manager)"):n.name==="self-activate"?"":n.installed?d(`→ ${n.name}`):d(`→ ${n.name} (missing)`)},"renderToolManager"),Q=f(e=>e.matches?p(!0):e.actual?T:p(!1),"toolIcon"),V=f(e=>{if(o.info(""),o.info(d("── Toolchain ───────────────────────")),e.detected.length===0)o.info(`  ${p(!1)} No version manager detected`),o.notice(`  Install one of: ${w.join(", ")}`);else for(const n of e.detected)o.info(`  ${J(n)}`);if(o.info(""),e.tools.length===0){o.info(`  ${d("No tool pins found — add engines.node, .nvmrc, or a manager config file.")}`);return}o.info(d("── Tools ───────────────────────────"));for(const n of e.tools){const i=`${n.expected.tool} ${n.expected.version}`,s=n.actual?`actual ${n.actual}`:"not installed",t=n.matches?"":d(` [${n.expected.source}]`),r=z(n),u=r===""?"":` ${r}`;o.info(`  ${Q(n)} ${i} — ${s}${t}${u}`),n.manager.note&&o.notice(`     ${n.manager.note}`)}},"printStatus"),X=f((e,n,i)=>{const s=C(e,n);if(i.json){process.stdout.write(`${JSON.stringify({detected:s.detected.map(r=>({binPath:r.binPath??null,configFiles:r.configFiles,installed:r.installed,name:r.name,version:r.version??null})),tools:s.tools.map(r=>({actual:r.actual??null,expected:r.expected.version,manager:r.manager.name,managerInstalled:r.manager.installed,matches:r.matches,note:r.manager.note??null,source:r.expected.source,tool:r.expected.tool}))},void 0,2)}
-`);return}V(s);const t=s.tools.filter(r=>!r.matches);t.length>0&&(o.info(""),o.notice("  Run `vis toolchain install` to install pinned versions.")),i.exitCode&&t.length>0&&(process.exitCode=1)},"executeStatus"),Y=f(e=>{const n=new Map;for(const i of e){const s=n.get(i.manager.name);s?s.push(i):n.set(i.manager.name,[i])}return n},"groupByManager"),_=f((e,n,i)=>U(e,n,{cwd:i,stdio:"inherit"}).status??1,"runInvocation"),Z=f((e,n,i)=>{const s=C(e,n),t=s.tools.filter(c=>!c.matches);if(t.length===0){o.success("Everything already matches — nothing to install.");return}const r=t.some(c=>c.manager.name!=="self-activate"&&c.manager.name!=="none");if(s.detected.length===0&&r){o.error(`No version manager detected. Install one of: ${w.join(", ")}.`),process.exitCode=1;return}const u=Y(t);let l=!1,g=0;for(const[c,m]of u){if(c==="self-activate"){for(const{expected:a}of m){if(a.source==="packageManager")o.info(`${d("$")} (${a.tool} will self-activate from packageManager on next invocation)`);else if(o.info(`${d("$")} Writing packageManager=${a.tool}@${a.version}`),i.dryRun)l=!0;else try{j(e,a),l=!0}catch(h){o.error(h.message),g=1}o.notice(`  ${a.tool} ${a.version} — no install needed`)}continue}if(c==="none"){for(const{expected:a}of m)o.warn(`Cannot install ${a.tool} ${a.version} — no manager can handle it.`);g=1;continue}if(!s.detected.find(a=>a.name===c)?.installed){o.error(`${c} is referenced but not on PATH — install it first, then rerun \`vis toolchain install\`.`),g=1;continue}const E=m.map(a=>B(c,a.expected)).filter(Boolean);for(const a of E){if(!a)continue;if(a.bin==="nvm"&&a.args.length===0){o.error("nvm is a shell function — run `nvm install` in your shell, then rerun `vis toolchain install`."),a.hint&&o.notice(`  ${a.hint}`),g=1;continue}if(o.info(`${d("$")} ${a.bin} ${a.args.join(" ")}`),a.hint&&o.notice(`  ${a.hint}`),i.dryRun){l=!0;continue}const h=_(a.bin,a.args,e);if(l=!0,h!==0){g=h;break}}}if(g!==0){process.exitCode=g;return}l&&o.success("Toolchain installed.")},"executeInstall"),ee=f((e,n,i,s)=>{if(!i)throw new Error("Usage: vis toolchain use <tool>@<version> (e.g. vis toolchain use node@22.13.0)");const t=q(i);if(!t)throw new Error(`Could not parse "${i}". Expected "<tool>@<version>" where <tool> is one of ${x.join(", ")}.`);const r=k(e),u=M(t,r,n);if(u.name==="none"){o.error(`No manager can pin ${t.tool}. Install one of: ${w.join(", ")}.`),process.exitCode=1;return}if(!u.installed){o.error(`The best manager for ${t.tool} (${u.name}) is not on PATH. ${u.note??""}`),process.exitCode=1;return}const l=H(u.name,t);if(!l){o.error(`${u.name} cannot pin ${t.tool}. Use a different manager, or set \`toolchain.tools.${t.tool}\` in vis.config.ts.`),process.exitCode=1;return}if(u.name==="self-activate"){if(o.info(`${d("→")} Writing packageManager field to package.json...`),s.dryRun){o.notice(`  Would set packageManager: "${t.tool}@${t.version}"`);return}try{const c=j(e,t);if(!c){o.error(`Refusing to pin non-package-manager tool ${t.tool} via the packageManager field.`),process.exitCode=1;return}if(o.success(`Set packageManager: "${c}" — ${t.tool} will activate this version on next invocation.`),s.engines!==!1){const m=y(e,t);m&&o.success(`Updated package.json engines.${t.tool} → ${m}.`)}}catch(c){o.error(c.message),process.exitCode=1}return}if(l.args.length===0&&u.name==="nvm"&&t.tool==="node"){const c=N(e,".nvmrc");if(o.info(`${d("→")} Writing ${c}...`),s.dryRun){o.notice(`  Would write ${t.version} to .nvmrc`);return}try{F(c,`${t.version}
-`)}catch(m){o.error(`Failed to write .nvmrc: ${m.message}`),process.exitCode=1;return}o.success(`Wrote ${t.version} to .nvmrc.`),o.notice("  nvm is a shell function — run `nvm use` to activate it in this shell.");return}if(l.args.length===0){o.error(`${u.name} cannot pin ${t.tool} from a subprocess. ${l.configChange?.hint??""}`),l.configChange&&o.notice(`  Edit ${l.configChange.file} by hand and rerun \`vis toolchain status\` to verify.`),process.exitCode=1;return}if(o.info(`${d("$")} ${l.bin} ${l.args.join(" ")}`),l.configChange&&o.notice(`  Will update ${l.configChange.file} — ${l.configChange.hint}`),s.dryRun)return;const g=_(l.bin,l.args,e);if(g!==0){process.exitCode=g;return}if(o.success(`Pinned ${t.tool} to ${t.version}.`),s.engines!==!1)try{const c=y(e,t);c&&o.success(`Updated package.json engines.${t.tool} → ${c}.`)}catch(c){o.warn(`Could not update engines.${t.tool}: ${c.message}`)}},"executeUse"),ne=f((e,n,i)=>{if(!i)throw new Error("Usage: vis toolchain which <tool> (e.g. vis toolchain which node)");const s=i.toLowerCase();if(!G(s))throw new Error(`Unknown tool "${i}". Known: ${x.join(", ")}.`);const t=k(e),r=M({source:"vis.config.ts",tool:s,version:"*"},t,n),u=r.installed&&r.name!=="self-activate"&&r.name!=="none"?t.find(g=>g.name===r.name):void 0,l=u?K(u,s):O(s);if(!l){o.error(`${i} not found in PATH${u?` or via ${u.name}`:""}.`),process.exitCode=1;return}process.stdout.write(`${l}
-`)},"executeWhich"),oe=f((e,n)=>{const i=D(e,n);process.stdout.write(`${i.name}
-`)},"executeDetect"),le=f(async({argument:e,options:n,visConfig:i,workspaceRoot:s})=>{if(!s)throw new Error("Could not determine workspace root. Run inside a monorepo.");const t=e[0]??"status",r=i?.toolchain;switch(t){case"detect":{oe(s,r);return}case"install":{Z(s,r,n);return}case"status":{X(s,r,n);return}case"use":{ee(s,r,e[1],n);return}case"which":{ne(s,r,e[1]);return}default:throw new Error(`Unknown toolchain action "${t}". Known: status, detect, install, use, which.`)}},"execute");export{le as default};
+import { createRequire as __cjs_createRequire } from "node:module";
+
+const __cjs_require = __cjs_createRequire(import.meta.url);
+
+const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
+
+const __cjs_getBuiltinModule = (module) => {
+    // Check if we're in Node.js and version supports getBuiltinModule
+    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
+        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
+        // Node.js 20.16.0+ and 22.3.0+
+        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
+            return __cjs_getProcess.getBuiltinModule(module);
+        }
+    }
+    // Fallback to createRequire
+    return __cjs_require(module);
+};
+
+const {
+  spawnSync
+} = __cjs_getBuiltinModule("node:child_process");
+const {
+  writeFileSync
+} = __cjs_getBuiltinModule("node:fs");
+import { dim, green, red, yellow } from '@visulima/colorize';
+import { join } from '@visulima/path';
+import { p as pail } from './bin.js';
+import { f as findInstalledManagers, a as resolveManagerFor, b as resolveToolBinary, c as findOnPathByAlias, p as parseUseArgument, S as SUPPORTED_MANAGERS, d as buildUseInvocation, w as writePackageManagerField, u as updateEnginesField, g as getToolchainStatus, e as buildInstallInvocation, h as pickPrimaryManager } from '../packem_shared/toolchain-BdZd9eBi.js';
+
+const KNOWN_TOOLS = ["bun", "deno", "go", "node", "npm", "pnpm", "python", "ruby", "rust", "yarn"];
+const isKnownTool = (value) => KNOWN_TOOLS.includes(value);
+const icon = (ok) => ok ? green("✓") : red("✗");
+const warnIcon = yellow("⚠");
+const renderManagerLine = (manager) => {
+  if (manager.installed) {
+    const ver = manager.version ? ` v${manager.version}` : "";
+    const cfg = manager.configFiles.length > 0 ? ` (${manager.configFiles.join(", ")})` : "";
+    return `${icon(true)} ${manager.name}${ver}${cfg}`;
+  }
+  return `${warnIcon} ${manager.name} — referenced by ${manager.configFiles.join(", ")} but not installed`;
+};
+const renderToolManager = (tool) => {
+  if (tool.matches) {
+    return "";
+  }
+  const { manager } = tool;
+  if (manager.name === "none") {
+    return dim("→ (no manager)");
+  }
+  if (manager.name === "self-activate") {
+    return "";
+  }
+  return manager.installed ? dim(`→ ${manager.name}`) : dim(`→ ${manager.name} (missing)`);
+};
+const toolIcon = (tool) => {
+  if (tool.matches) {
+    return icon(true);
+  }
+  return tool.actual ? warnIcon : icon(false);
+};
+const printStatus = (status) => {
+  pail.info("");
+  pail.info(dim("── Toolchain ───────────────────────"));
+  if (status.detected.length === 0) {
+    pail.info(`  ${icon(false)} No version manager detected`);
+    pail.notice(`  Install one of: ${SUPPORTED_MANAGERS.join(", ")}`);
+  } else {
+    for (const manager of status.detected) {
+      pail.info(`  ${renderManagerLine(manager)}`);
+    }
+  }
+  pail.info("");
+  if (status.tools.length === 0) {
+    pail.info(`  ${dim("No tool pins found — add engines.node, .nvmrc, or a manager config file.")}`);
+    return;
+  }
+  pail.info(dim("── Tools ───────────────────────────"));
+  for (const tool of status.tools) {
+    const expected = `${tool.expected.tool} ${tool.expected.version}`;
+    const actualText = tool.actual ? `actual ${tool.actual}` : "not installed";
+    const source = tool.matches ? "" : dim(` [${tool.expected.source}]`);
+    const managerText = renderToolManager(tool);
+    const suffix = managerText === "" ? "" : ` ${managerText}`;
+    pail.info(`  ${toolIcon(tool)} ${expected} — ${actualText}${source}${suffix}`);
+    if (tool.manager.note) {
+      pail.notice(`     ${tool.manager.note}`);
+    }
+  }
+};
+const executeStatus = (workspaceRoot, toolchainConfig, options) => {
+  const status = getToolchainStatus(workspaceRoot, toolchainConfig);
+  if (options.json) {
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          detected: status.detected.map((m) => {
+            return {
+              binPath: m.binPath ?? null,
+              configFiles: m.configFiles,
+              installed: m.installed,
+              name: m.name,
+              version: m.version ?? null
+            };
+          }),
+          tools: status.tools.map((t) => {
+            return {
+              actual: t.actual ?? null,
+              expected: t.expected.version,
+              manager: t.manager.name,
+              managerInstalled: t.manager.installed,
+              matches: t.matches,
+              note: t.manager.note ?? null,
+              source: t.expected.source,
+              tool: t.expected.tool
+            };
+          })
+        },
+        void 0,
+        2
+      )}
+`
+    );
+    return;
+  }
+  printStatus(status);
+  const mismatches = status.tools.filter((t) => !t.matches);
+  if (mismatches.length > 0) {
+    pail.info("");
+    pail.notice("  Run `vis toolchain install` to install pinned versions.");
+  }
+  if (options.exitCode && mismatches.length > 0) {
+    process.exitCode = 1;
+  }
+};
+const groupByManager = (tools) => {
+  const groups = /* @__PURE__ */ new Map();
+  for (const tool of tools) {
+    const bucket = groups.get(tool.manager.name);
+    if (bucket) {
+      bucket.push(tool);
+    } else {
+      groups.set(tool.manager.name, [tool]);
+    }
+  }
+  return groups;
+};
+const runInvocation = (bin, args, cwd) => {
+  const result = spawnSync(bin, args, { cwd, stdio: "inherit" });
+  return result.status ?? 1;
+};
+const executeInstall = (workspaceRoot, toolchainConfig, options) => {
+  const status = getToolchainStatus(workspaceRoot, toolchainConfig);
+  const mismatches = status.tools.filter((t) => !t.matches);
+  if (mismatches.length === 0) {
+    pail.success("Everything already matches — nothing to install.");
+    return;
+  }
+  const needsRealManager = mismatches.some((m) => m.manager.name !== "self-activate" && m.manager.name !== "none");
+  if (status.detected.length === 0 && needsRealManager) {
+    pail.error(`No version manager detected. Install one of: ${SUPPORTED_MANAGERS.join(", ")}.`);
+    process.exitCode = 1;
+    return;
+  }
+  const groups = groupByManager(mismatches);
+  let ranAnything = false;
+  let exitCode = 0;
+  for (const [managerName, tools] of groups) {
+    if (managerName === "self-activate") {
+      for (const { expected } of tools) {
+        if (expected.source === "packageManager") {
+          pail.info(`${dim("$")} (${expected.tool} will self-activate from packageManager on next invocation)`);
+        } else {
+          pail.info(`${dim("$")} Writing packageManager=${expected.tool}@${expected.version}`);
+          if (options.dryRun) {
+            ranAnything = true;
+          } else {
+            try {
+              writePackageManagerField(workspaceRoot, expected);
+              ranAnything = true;
+            } catch (error) {
+              pail.error(error.message);
+              exitCode = 1;
+            }
+          }
+        }
+        pail.notice(`  ${expected.tool} ${expected.version} — no install needed`);
+      }
+      continue;
+    }
+    if (managerName === "none") {
+      for (const { expected } of tools) {
+        pail.warn(`Cannot install ${expected.tool} ${expected.version} — no manager can handle it.`);
+      }
+      exitCode = 1;
+      continue;
+    }
+    const manager = status.detected.find((d) => d.name === managerName);
+    if (!manager?.installed) {
+      pail.error(`${managerName} is referenced but not on PATH — install it first, then rerun \`vis toolchain install\`.`);
+      exitCode = 1;
+      continue;
+    }
+    const invocations = tools.map((t) => buildInstallInvocation(managerName, t.expected)).filter(Boolean);
+    for (const invocation of invocations) {
+      if (!invocation) {
+        continue;
+      }
+      if (invocation.bin === "nvm" && invocation.args.length === 0) {
+        pail.error("nvm is a shell function — run `nvm install` in your shell, then rerun `vis toolchain install`.");
+        if (invocation.hint) {
+          pail.notice(`  ${invocation.hint}`);
+        }
+        exitCode = 1;
+        continue;
+      }
+      pail.info(`${dim("$")} ${invocation.bin} ${invocation.args.join(" ")}`);
+      if (invocation.hint) {
+        pail.notice(`  ${invocation.hint}`);
+      }
+      if (options.dryRun) {
+        ranAnything = true;
+        continue;
+      }
+      const status_ = runInvocation(invocation.bin, invocation.args, workspaceRoot);
+      ranAnything = true;
+      if (status_ !== 0) {
+        exitCode = status_;
+        break;
+      }
+    }
+  }
+  if (exitCode !== 0) {
+    process.exitCode = exitCode;
+    return;
+  }
+  if (ranAnything) {
+    pail.success("Toolchain installed.");
+  }
+};
+const executeUse = (workspaceRoot, toolchainConfig, rawSpec, options) => {
+  if (!rawSpec) {
+    throw new Error("Usage: vis toolchain use <tool>@<version> (e.g. vis toolchain use node@22.13.0)");
+  }
+  const spec = parseUseArgument(rawSpec);
+  if (!spec) {
+    throw new Error(`Could not parse "${rawSpec}". Expected "<tool>@<version>" where <tool> is one of ${KNOWN_TOOLS.join(", ")}.`);
+  }
+  const detected = findInstalledManagers(workspaceRoot);
+  const manager = resolveManagerFor(spec, detected, toolchainConfig);
+  if (manager.name === "none") {
+    pail.error(`No manager can pin ${spec.tool}. Install one of: ${SUPPORTED_MANAGERS.join(", ")}.`);
+    process.exitCode = 1;
+    return;
+  }
+  if (!manager.installed) {
+    pail.error(`The best manager for ${spec.tool} (${manager.name}) is not on PATH. ${manager.note ?? ""}`);
+    process.exitCode = 1;
+    return;
+  }
+  const invocation = buildUseInvocation(manager.name, spec);
+  if (!invocation) {
+    pail.error(`${manager.name} cannot pin ${spec.tool}. Use a different manager, or set \`toolchain.tools.${spec.tool}\` in vis.config.ts.`);
+    process.exitCode = 1;
+    return;
+  }
+  if (manager.name === "self-activate") {
+    pail.info(`${dim("→")} Writing packageManager field to package.json...`);
+    if (options.dryRun) {
+      pail.notice(`  Would set packageManager: "${spec.tool}@${spec.version}"`);
+      return;
+    }
+    try {
+      const written = writePackageManagerField(workspaceRoot, spec);
+      if (!written) {
+        pail.error(`Refusing to pin non-package-manager tool ${spec.tool} via the packageManager field.`);
+        process.exitCode = 1;
+        return;
+      }
+      pail.success(`Set packageManager: "${written}" — ${spec.tool} will activate this version on next invocation.`);
+      if (options.engines !== false) {
+        const updated = updateEnginesField(workspaceRoot, spec);
+        if (updated) {
+          pail.success(`Updated package.json engines.${spec.tool} → ${updated}.`);
+        }
+      }
+    } catch (error) {
+      pail.error(error.message);
+      process.exitCode = 1;
+    }
+    return;
+  }
+  if (invocation.args.length === 0 && manager.name === "nvm" && spec.tool === "node") {
+    const nvmrcPath = join(workspaceRoot, ".nvmrc");
+    pail.info(`${dim("→")} Writing ${nvmrcPath}...`);
+    if (options.dryRun) {
+      pail.notice(`  Would write ${spec.version} to .nvmrc`);
+      return;
+    }
+    try {
+      writeFileSync(nvmrcPath, `${spec.version}
+`);
+    } catch (error) {
+      pail.error(`Failed to write .nvmrc: ${error.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    pail.success(`Wrote ${spec.version} to .nvmrc.`);
+    pail.notice("  nvm is a shell function — run `nvm use` to activate it in this shell.");
+    return;
+  }
+  if (invocation.args.length === 0) {
+    pail.error(`${manager.name} cannot pin ${spec.tool} from a subprocess. ${invocation.configChange?.hint ?? ""}`);
+    if (invocation.configChange) {
+      pail.notice(`  Edit ${invocation.configChange.file} by hand and rerun \`vis toolchain status\` to verify.`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+  pail.info(`${dim("$")} ${invocation.bin} ${invocation.args.join(" ")}`);
+  if (invocation.configChange) {
+    pail.notice(`  Will update ${invocation.configChange.file} — ${invocation.configChange.hint}`);
+  }
+  if (options.dryRun) {
+    return;
+  }
+  const status_ = runInvocation(invocation.bin, invocation.args, workspaceRoot);
+  if (status_ !== 0) {
+    process.exitCode = status_;
+    return;
+  }
+  pail.success(`Pinned ${spec.tool} to ${spec.version}.`);
+  if (options.engines !== false) {
+    try {
+      const updated = updateEnginesField(workspaceRoot, spec);
+      if (updated) {
+        pail.success(`Updated package.json engines.${spec.tool} → ${updated}.`);
+      }
+    } catch (error) {
+      pail.warn(`Could not update engines.${spec.tool}: ${error.message}`);
+    }
+  }
+};
+const executeWhich = (workspaceRoot, toolchainConfig, rawTool) => {
+  if (!rawTool) {
+    throw new Error("Usage: vis toolchain which <tool> (e.g. vis toolchain which node)");
+  }
+  const normalized = rawTool.toLowerCase();
+  if (!isKnownTool(normalized)) {
+    throw new Error(`Unknown tool "${rawTool}". Known: ${KNOWN_TOOLS.join(", ")}.`);
+  }
+  const detected = findInstalledManagers(workspaceRoot);
+  const resolved = resolveManagerFor({ source: "vis.config.ts", tool: normalized, version: "*" }, detected, toolchainConfig);
+  const manager = resolved.installed && resolved.name !== "self-activate" && resolved.name !== "none" ? detected.find((d) => d.name === resolved.name) : void 0;
+  const binary = manager ? resolveToolBinary(manager, normalized) : findOnPathByAlias(normalized);
+  if (!binary) {
+    pail.error(`${rawTool} not found in PATH${manager ? ` or via ${manager.name}` : ""}.`);
+    process.exitCode = 1;
+    return;
+  }
+  process.stdout.write(`${binary}
+`);
+};
+const executeDetect = (workspaceRoot, toolchainConfig) => {
+  const primary = pickPrimaryManager(workspaceRoot, toolchainConfig);
+  process.stdout.write(`${primary.name}
+`);
+};
+const execute = async ({ argument, options, visConfig, workspaceRoot: wsRoot }) => {
+  if (!wsRoot) {
+    throw new Error("Could not determine workspace root. Run inside a monorepo.");
+  }
+  const action = argument[0] ?? "status";
+  const toolchainConfig = visConfig?.toolchain;
+  switch (action) {
+    case "detect": {
+      executeDetect(wsRoot, toolchainConfig);
+      return;
+    }
+    case "install": {
+      executeInstall(wsRoot, toolchainConfig, options);
+      return;
+    }
+    case "status": {
+      executeStatus(wsRoot, toolchainConfig, options);
+      return;
+    }
+    case "use": {
+      executeUse(wsRoot, toolchainConfig, argument[1], options);
+      return;
+    }
+    case "which": {
+      executeWhich(wsRoot, toolchainConfig, argument[1]);
+      return;
+    }
+    default: {
+      throw new Error(`Unknown toolchain action "${action}". Known: status, detect, install, use, which.`);
+    }
+  }
+};
+
+export { execute as default };

package/dist/packem_chunks/handler26.js

@@ -1 +1,13 @@
-var f=Object.defineProperty;var s=(e,o)=>f(e,"name",{value:o,configurable:!0});import{J as p,h as u}from"./bin.js";var d=Object.defineProperty,g=s((e,o)=>d(e,"name",{value:o,configurable:!0}),"c");const x=g(async({argument:e,logger:o,options:c,visConfig:n,workspaceRoot:t})=>{const i=e||[],a=t??process.cwd(),l=p(a,{configBackend:n?.install?.backend}),r=u(l,i,c.recursive||!1,a,o);r!==0&&(process.exitCode=r)},"execute");export{x as default};
+import { r as resolveInstaller, B as runUnlink } from './bin.js';
+
+const execute = async ({ argument, logger, options, visConfig, workspaceRoot: wsRoot }) => {
+  const packages = argument || [];
+  const cwd = wsRoot ?? process.cwd();
+  const pm = resolveInstaller(cwd, { configBackend: visConfig?.install?.backend });
+  const code = runUnlink(pm, packages, options.recursive || false, cwd, logger);
+  if (code !== 0) {
+    process.exitCode = code;
+  }
+};
+
+export { execute as default };

package/dist/packem_chunks/handler27.js

@@ -1,3 +1,63 @@
-var a=Object.defineProperty;var s=(n,e)=>a(n,"name",{value:e,configurable:!0});import{createRequire as f}from"node:module";import{m as v}from"./bin.js";const d=f(import.meta.url),t=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,l=s(n=>{if(typeof t<"u"&&t.versions&&t.versions.node){const[e,r]=t.versions.node.split(".").map(Number);if(e>22||e===22&&r>=3||e===20&&r>=16)return t.getBuiltinModule(n)}return d(n)},"__cjs_getBuiltinModule"),{execSync:p,spawnSync:m}=l("node:child_process");var g=Object.defineProperty,y=s((n,e)=>g(n,"name",{value:e,configurable:!0}),"r");const w=y(async({argument:n,logger:e,options:r})=>{const c=n?.[0];e.info("info: checking for updates...");const o=v.version;let i;try{const u=p("npm view @visulima/vis version",{encoding:"utf8"}).trim();i=c??u}catch{throw new Error("Failed to query npm registry. Check your network connection.")}if(o===i&&!r.force){e.info(`
-✓ Already up to date (${o})`);return}if(r.check){o===i?e.info(`✓ Already up to date (${o})`):e.info(`info: found @visulima/vis@${i} (current: ${o})`);return}if(e.info(`info: found @visulima/vis@${i} (current: ${o})`),e.info("info: installing..."),m("npm",["install","-g",`@visulima/vis@${i}`],{encoding:"utf8",stdio:"inherit"}).status!==0)throw new Error("Failed to update. Try running with sudo or fix npm permissions.");e.info(`
-✓ Updated @visulima/vis from ${o} → ${i}`)},"execute");export{w as default};
+import { createRequire as __cjs_createRequire } from "node:module";
+
+const __cjs_require = __cjs_createRequire(import.meta.url);
+
+const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
+
+const __cjs_getBuiltinModule = (module) => {
+    // Check if we're in Node.js and version supports getBuiltinModule
+    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
+        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
+        // Node.js 20.16.0+ and 22.3.0+
+        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
+            return __cjs_getProcess.getBuiltinModule(module);
+        }
+    }
+    // Fallback to createRequire
+    return __cjs_require(module);
+};
+
+const {
+  execSync,
+  spawnSync
+} = __cjs_getBuiltinModule("node:child_process");
+import { C as pkg } from './bin.js';
+
+const execute = async ({ argument, logger, options }) => {
+  const targetVersion = argument?.[0];
+  logger.info("info: checking for updates...");
+  const currentVersion = pkg.version;
+  let latestVersion;
+  try {
+    const result2 = execSync("npm view @visulima/vis version", { encoding: "utf8" }).trim();
+    latestVersion = targetVersion ?? result2;
+  } catch {
+    throw new Error("Failed to query npm registry. Check your network connection.");
+  }
+  if (currentVersion === latestVersion && !options.force) {
+    logger.info(`
+✓ Already up to date (${currentVersion})`);
+    return;
+  }
+  if (options.check) {
+    if (currentVersion === latestVersion) {
+      logger.info(`✓ Already up to date (${currentVersion})`);
+    } else {
+      logger.info(`info: found @visulima/vis@${latestVersion} (current: ${currentVersion})`);
+    }
+    return;
+  }
+  logger.info(`info: found @visulima/vis@${latestVersion} (current: ${currentVersion})`);
+  logger.info("info: installing...");
+  const result = spawnSync("npm", ["install", "-g", `@visulima/vis@${latestVersion}`], {
+    encoding: "utf8",
+    stdio: "inherit"
+  });
+  if (result.status !== 0) {
+    throw new Error("Failed to update. Try running with sudo or fix npm permissions.");
+  }
+  logger.info(`
+✓ Updated @visulima/vis from ${currentVersion} → ${latestVersion}`);
+};
+
+export { execute as default };

package/dist/packem_chunks/handler28.js

@@ -1 +1,34 @@
-var p=Object.defineProperty;var t=(o,a)=>p(o,"name",{value:a,configurable:!0});import{J as f,i as d}from"./bin.js";import{o as g}from"../packem_shared/utils-DrNg0XTR.js";var v=Object.defineProperty,u=t((o,a)=>v(o,"name",{value:a,configurable:!0}),"c");const k=u(async({argument:o,logger:a,options:e,visConfig:n,workspaceRoot:i})=>{const s=o;if(!s||s.length===0)throw new Error("No packages specified. Usage: vis why <package...>");const l=i??process.cwd(),c=f(l,{configBackend:n?.install?.backend}),r=d(c,{depth:e.depth===void 0?void 0:Number(e.depth),dev:e.dev||!1,filter:g(e.filter),global:e.global||!1,json:e.json||!1,long:e.long||!1,noOptional:e.noOptional||!1,packages:s,parseable:e.parseable||!1,prod:e.prod||!1,recursive:e.recursive||!1},l,a);r!==0&&r!==1&&(process.exitCode=r)},"execute");export{k as default};
+import { r as resolveInstaller, E as runWhy } from './bin.js';
+import { t as toStringArray } from '../packem_shared/utils-CthVdBPS.js';
+
+const execute = async ({ argument, logger, options, visConfig, workspaceRoot: wsRoot }) => {
+  const packages = argument;
+  if (!packages || packages.length === 0) {
+    throw new Error("No packages specified. Usage: vis why <package...>");
+  }
+  const cwd = wsRoot ?? process.cwd();
+  const pm = resolveInstaller(cwd, { configBackend: visConfig?.install?.backend });
+  const code = runWhy(
+    pm,
+    {
+      depth: options.depth === void 0 ? void 0 : Number(options.depth),
+      dev: options.dev || false,
+      filter: toStringArray(options.filter),
+      global: options.global || false,
+      json: options.json || false,
+      long: options.long || false,
+      noOptional: options.noOptional || false,
+      packages,
+      parseable: options.parseable || false,
+      prod: options.prod || false,
+      recursive: options.recursive || false
+    },
+    cwd,
+    logger
+  );
+  if (code !== 0 && code !== 1) {
+    process.exitCode = code;
+  }
+};
+
+export { execute as default };