@visulima/cerebro 2.1.5 → 3.0.0-alpha.10

package/dist/plugins/runtime-version-check-plugin.js

@@ -1 +1,77 @@
-var a=Object.defineProperty;var p=(r,t)=>a(r,"name",{value:t,configurable:!0});import{d as v,e as d,g as y}from"../packem_shared/runtime-process-G-n-wOub.js";var g=Object.defineProperty,n=p((r,t)=>g(r,"name",{value:t,configurable:!0}),"o");const s=n(r=>{if(!r||typeof r!="string")return 0;const t=r.split(".");if(t.length===0||!t[0])return 0;const e=Number.parseInt(t[0],10);return Number.isNaN(e)?0:e},"parseMajorVersion"),h=n(r=>!r||typeof r!="string"?"":r.replace("v",""),"extractNodeVersion"),l=n(()=>{if(typeof Bun<"u"){const e=Bun.version||"";return{major:s(e),type:"bun",version:e}}if(typeof Deno<"u"){const e=Deno.version?.deno||"";return{major:s(e),type:"deno",version:e}}const r=y().node??"",t=h(r);return{major:s(t),type:"node",version:t}},"detectRuntime"),b=n((r={})=>({description:"Checks if the current runtime version meets the minimum requirement",init:n(async t=>{const e=l(),c={bun:1,deno:1,node:18};let o;try{const u=v().CEREBRO_MIN_NODE_VERSION,m=u===void 0?void 0:Number.parseInt(u,10);o=Number.isNaN(m)?void 0:m}catch{o=void 0}let i;r.runtimes?.[e.type]?.minVersion!==void 0?i=r.runtimes[e.type].minVersion:e.type==="node"&&o!==void 0?i=o:i=c[e.type],e.major<i&&(t.logger.error(`cerebro requires ${e.type} version ${i} or higher. You have ${e.type} ${e.version}. Read our version support policy: https://github.com/visulima/visulima#supported-runtimes`),d(1)),t.logger.debug(`Runtime version check passed: ${e.type} ${e.version} >= ${i}`)},"init"),name:"runtime-version-check",version:"1.0.0"}),"runtimeVersionCheckPlugin");export{b as runtimeVersionCheckPlugin};
+import { d as getEnv, e as exitProcess, a as getVersions } from '../packem_shared/runtime-process-B6ZplyWn.js';
+
+const parseMajorVersion = (versionString) => {
+  if (!versionString || typeof versionString !== "string") {
+    return 0;
+  }
+  const parts = versionString.split(".");
+  if (parts.length === 0 || !parts[0]) {
+    return 0;
+  }
+  const major = Number.parseInt(parts[0], 10);
+  return Number.isNaN(major) ? 0 : major;
+};
+const extractNodeVersion = (processVersion) => {
+  if (!processVersion || typeof processVersion !== "string") {
+    return "";
+  }
+  return processVersion.replace("v", "");
+};
+const detectRuntime = () => {
+  if (typeof Bun !== "undefined") {
+    const version2 = Bun.version || "";
+    const major2 = parseMajorVersion(version2);
+    return { major: major2, type: "bun", version: version2 };
+  }
+  if (typeof Deno !== "undefined") {
+    const version2 = Deno.version?.deno || "";
+    const major2 = parseMajorVersion(version2);
+    return { major: major2, type: "deno", version: version2 };
+  }
+  const versions = getVersions();
+  const nodeVersion = versions.node ?? "";
+  const version = extractNodeVersion(nodeVersion);
+  const major = parseMajorVersion(version);
+  return { major, type: "node", version };
+};
+const runtimeVersionCheckPlugin = (options = {}) => {
+  return {
+    description: "Checks if the current runtime version meets the minimum requirement",
+    init: (context) => {
+      const runtime = detectRuntime();
+      const defaultMinVersions = {
+        bun: 1,
+        deno: 1,
+        node: 18
+      };
+      let envMinVersion;
+      try {
+        const env = getEnv();
+        const envRaw = env.CEREBRO_MIN_NODE_VERSION;
+        const parsed = envRaw === void 0 ? void 0 : Number.parseInt(envRaw, 10);
+        envMinVersion = Number.isNaN(parsed) ? void 0 : parsed;
+      } catch {
+        envMinVersion = void 0;
+      }
+      let minVersion;
+      if (options.runtimes?.[runtime.type]?.minVersion !== void 0) {
+        minVersion = options.runtimes[runtime.type].minVersion;
+      } else if (runtime.type === "node" && envMinVersion !== void 0) {
+        minVersion = envMinVersion;
+      } else {
+        minVersion = defaultMinVersions[runtime.type];
+      }
+      if (runtime.major < minVersion) {
+        context.logger.error(
+          `cerebro requires ${runtime.type} version ${String(minVersion)} or higher. You have ${runtime.type} ${runtime.version}. Read our version support policy: https://github.com/visulima/visulima#supported-runtimes`
+        );
+        exitProcess(1);
+      }
+      context.logger.debug(`Runtime version check passed: ${runtime.type} ${runtime.version} >= ${String(minVersion)}`);
+    },
+    name: "runtime-version-check",
+    version: "1.0.0"
+  };
+};
+
+export { runtimeVersionCheckPlugin };

package/dist/plugins/update-notifier/update-notifier-plugin.js

@@ -1 +1,517 @@
-var m=Object.defineProperty;var I=(t,r)=>m(t,"name",{value:r,configurable:!0});import{d as A}from"../../packem_shared/runtime-process-G-n-wOub.js";var i={},c,U;function l(){return U||(U=1,c=[{name:"Agola CI",constant:"AGOLA",env:"AGOLA_GIT_REF",pr:"AGOLA_PULL_REQUEST_ID"},{name:"Appcircle",constant:"APPCIRCLE",env:"AC_APPCIRCLE",pr:{env:"AC_GIT_PR",ne:"false"}},{name:"AppVeyor",constant:"APPVEYOR",env:"APPVEYOR",pr:"APPVEYOR_PULL_REQUEST_NUMBER"},{name:"AWS CodeBuild",constant:"CODEBUILD",env:"CODEBUILD_BUILD_ARN",pr:{env:"CODEBUILD_WEBHOOK_EVENT",any:["PULL_REQUEST_CREATED","PULL_REQUEST_UPDATED","PULL_REQUEST_REOPENED"]}},{name:"Azure Pipelines",constant:"AZURE_PIPELINES",env:"TF_BUILD",pr:{BUILD_REASON:"PullRequest"}},{name:"Bamboo",constant:"BAMBOO",env:"bamboo_planKey"},{name:"Bitbucket Pipelines",constant:"BITBUCKET",env:"BITBUCKET_COMMIT",pr:"BITBUCKET_PR_ID"},{name:"Bitrise",constant:"BITRISE",env:"BITRISE_IO",pr:"BITRISE_PULL_REQUEST"},{name:"Buddy",constant:"BUDDY",env:"BUDDY_WORKSPACE_ID",pr:"BUDDY_EXECUTION_PULL_REQUEST_ID"},{name:"Buildkite",constant:"BUILDKITE",env:"BUILDKITE",pr:{env:"BUILDKITE_PULL_REQUEST",ne:"false"}},{name:"CircleCI",constant:"CIRCLE",env:"CIRCLECI",pr:"CIRCLE_PULL_REQUEST"},{name:"Cirrus CI",constant:"CIRRUS",env:"CIRRUS_CI",pr:"CIRRUS_PR"},{name:"Cloudflare Pages",constant:"CLOUDFLARE_PAGES",env:"CF_PAGES"},{name:"Cloudflare Workers",constant:"CLOUDFLARE_WORKERS",env:"WORKERS_CI"},{name:"Codefresh",constant:"CODEFRESH",env:"CF_BUILD_ID",pr:{any:["CF_PULL_REQUEST_NUMBER","CF_PULL_REQUEST_ID"]}},{name:"Codemagic",constant:"CODEMAGIC",env:"CM_BUILD_ID",pr:"CM_PULL_REQUEST"},{name:"Codeship",constant:"CODESHIP",env:{CI_NAME:"codeship"}},{name:"Drone",constant:"DRONE",env:"DRONE",pr:{DRONE_BUILD_EVENT:"pull_request"}},{name:"dsari",constant:"DSARI",env:"DSARI"},{name:"Earthly",constant:"EARTHLY",env:"EARTHLY_CI"},{name:"Expo Application Services",constant:"EAS",env:"EAS_BUILD"},{name:"Gerrit",constant:"GERRIT",env:"GERRIT_PROJECT"},{name:"Gitea Actions",constant:"GITEA_ACTIONS",env:"GITEA_ACTIONS"},{name:"GitHub Actions",constant:"GITHUB_ACTIONS",env:"GITHUB_ACTIONS",pr:{GITHUB_EVENT_NAME:"pull_request"}},{name:"GitLab CI",constant:"GITLAB",env:"GITLAB_CI",pr:"CI_MERGE_REQUEST_ID"},{name:"GoCD",constant:"GOCD",env:"GO_PIPELINE_LABEL"},{name:"Google Cloud Build",constant:"GOOGLE_CLOUD_BUILD",env:"BUILDER_OUTPUT"},{name:"Harness CI",constant:"HARNESS",env:"HARNESS_BUILD_ID"},{name:"Heroku",constant:"HEROKU",env:{env:"NODE",includes:"/app/.heroku/node/bin/node"}},{name:"Hudson",constant:"HUDSON",env:"HUDSON_URL"},{name:"Jenkins",constant:"JENKINS",env:["JENKINS_URL","BUILD_ID"],pr:{any:["ghprbPullId","CHANGE_ID"]}},{name:"LayerCI",constant:"LAYERCI",env:"LAYERCI",pr:"LAYERCI_PULL_REQUEST"},{name:"Magnum CI",constant:"MAGNUM",env:"MAGNUM"},{name:"Netlify CI",constant:"NETLIFY",env:"NETLIFY",pr:{env:"PULL_REQUEST",ne:"false"}},{name:"Nevercode",constant:"NEVERCODE",env:"NEVERCODE",pr:{env:"NEVERCODE_PULL_REQUEST",ne:"false"}},{name:"Prow",constant:"PROW",env:"PROW_JOB_ID"},{name:"ReleaseHub",constant:"RELEASEHUB",env:"RELEASE_BUILD_ID"},{name:"Render",constant:"RENDER",env:"RENDER",pr:{IS_PULL_REQUEST:"true"}},{name:"Sail CI",constant:"SAIL",env:"SAILCI",pr:"SAIL_PULL_REQUEST_NUMBER"},{name:"Screwdriver",constant:"SCREWDRIVER",env:"SCREWDRIVER",pr:{env:"SD_PULL_REQUEST",ne:"false"}},{name:"Semaphore",constant:"SEMAPHORE",env:"SEMAPHORE",pr:"PULL_REQUEST_NUMBER"},{name:"Sourcehut",constant:"SOURCEHUT",env:{CI_NAME:"sourcehut"}},{name:"Strider CD",constant:"STRIDER",env:"STRIDER"},{name:"TaskCluster",constant:"TASKCLUSTER",env:["TASK_ID","RUN_ID"]},{name:"TeamCity",constant:"TEAMCITY",env:"TEAMCITY_VERSION"},{name:"Travis CI",constant:"TRAVIS",env:"TRAVIS",pr:{env:"TRAVIS_PULL_REQUEST",ne:"false"}},{name:"Vela",constant:"VELA",env:"VELA",pr:{VELA_PULL_REQUEST:"1"}},{name:"Vercel",constant:"VERCEL",env:{any:["NOW_BUILDER","VERCEL"]},pr:"VERCEL_GIT_PULL_REQUEST_ID"},{name:"Visual Studio App Center",constant:"APPCENTER",env:"APPCENTER_BUILD_ID"},{name:"Woodpecker",constant:"WOODPECKER",env:{CI:"woodpecker"},pr:{CI_BUILD_EVENT:"pull_request"}},{name:"Xcode Cloud",constant:"XCODE_CLOUD",env:"CI_XCODE_PROJECT",pr:"CI_PULL_REQUEST_NUMBER"},{name:"Xcode Server",constant:"XCODE_SERVER",env:"XCS"}]),c}I(l,"requireVendors");var L;function d(){return L||(L=1,(function(t){var r=Object.defineProperty,E=I((n,a)=>r(n,"name",{value:a,configurable:!0}),"t");const s=l(),e=process.env;Object.defineProperty(t,"_vendors",{value:s.map(function(n){return n.constant})}),t.name=null,t.isPR=null,t.id=null,e.CI!=="false"&&s.forEach(function(n){const a=(Array.isArray(n.env)?n.env:[n.env]).every(function(R){return o(R)});t[n.constant]=a,a&&(t.name=n.name,t.isPR=_(n),t.id=n.constant)}),t.isCI=!!(e.CI!=="false"&&(e.BUILD_ID||e.BUILD_NUMBER||e.CI||e.CI_APP_ID||e.CI_BUILD_ID||e.CI_BUILD_NUMBER||e.CI_NAME||e.CONTINUOUS_INTEGRATION||e.RUN_ID||t.name));function o(n){return typeof n=="string"?!!e[n]:"env"in n?e[n.env]&&e[n.env].includes(n.includes):"any"in n?n.any.some(function(a){return!!e[a]}):Object.keys(n).every(function(a){return e[a]===n[a]})}I(o,"checkEnv"),E(o,"checkEnv");function _(n){switch(typeof n.pr){case"string":return!!e[n.pr];case"object":return"env"in n.pr?"any"in n.pr?n.pr.any.some(function(a){return e[n.pr.env]===a}):n.pr.env in e&&e[n.pr.env]!==n.pr.ne:"any"in n.pr?n.pr.any.some(function(a){return!!e[a]}):o(n.pr);default:return null}}I(_,"checkPR"),E(_,"checkPR")})(i)),i}I(d,"requireCiInfo");var P=d(),O=Object.defineProperty,C=I((t,r)=>O(t,"name",{value:r,configurable:!0}),"i");const f=C((t={})=>({beforeCommand:C(async r=>{const{logger:E,runtime:s}=r,e=s.getPackageName(),o=s.getPackageVersion();if(!e||!o){E.debug("Update notifier: package name or version not provided, skipping...");return}const _=A(),n={alwaysRun:!1,debug:_.CEREBRO_OUTPUT_LEVEL==="256",distTag:"latest",pkg:{name:e,version:o},updateCheckInterval:1e3*60*60*24,...t};if(!(n.alwaysRun||!(_.NO_UPDATE_NOTIFIER||_.NODE_ENV==="test"||r.argv.includes("--no-update-notifier")||P.isCI))){E.debug("Update notifier: skipping check (disabled by environment or flags)");return}(E?.raw??E.log)("Checking for updates...");try{const a=await(await import("../../packem_chunks/has-new-version.js").then(R=>R.default))(n);if(a){const[{boxen:R},{dim:v,green:u,reset:T,yellow:D}]=await Promise.all([import("@visulima/boxen"),import("@visulima/colorize")]),p=`Update available ${v(o.toString())}${T(" → ")}${u(a)}`;E.error(R(p,{borderColor:C(S=>D(S),"borderColor"),borderStyle:"round",margin:1,padding:1,textAlignment:"center"}))}}catch(a){E.debug("Update notifier: failed to check for updates",a)}},"beforeCommand"),description:"Checks for package updates and notifies users",name:"update-notifier",version:"1.0.0"}),"updateNotifierPlugin");export{f as updateNotifierPlugin};
+import { d as getEnv } from '../../packem_shared/runtime-process-B6ZplyWn.js';
+
+var ciInfo = {};
+
+var vendors;
+var hasRequiredVendors;
+
+function requireVendors () {
+	if (hasRequiredVendors) return vendors;
+	hasRequiredVendors = 1;
+	vendors = [
+		{
+			name: "Agola CI",
+			constant: "AGOLA",
+			env: "AGOLA_GIT_REF",
+			pr: "AGOLA_PULL_REQUEST_ID"
+		},
+		{
+			name: "Alpic",
+			constant: "ALPIC",
+			env: "ALPIC_HOST"
+		},
+		{
+			name: "Appcircle",
+			constant: "APPCIRCLE",
+			env: "AC_APPCIRCLE",
+			pr: {
+				env: "AC_GIT_PR",
+				ne: "false"
+			}
+		},
+		{
+			name: "AppVeyor",
+			constant: "APPVEYOR",
+			env: "APPVEYOR",
+			pr: "APPVEYOR_PULL_REQUEST_NUMBER"
+		},
+		{
+			name: "AWS CodeBuild",
+			constant: "CODEBUILD",
+			env: "CODEBUILD_BUILD_ARN",
+			pr: {
+				env: "CODEBUILD_WEBHOOK_EVENT",
+				any: [
+					"PULL_REQUEST_CREATED",
+					"PULL_REQUEST_UPDATED",
+					"PULL_REQUEST_REOPENED"
+				]
+			}
+		},
+		{
+			name: "Azure Pipelines",
+			constant: "AZURE_PIPELINES",
+			env: "TF_BUILD",
+			pr: {
+				BUILD_REASON: "PullRequest"
+			}
+		},
+		{
+			name: "Bamboo",
+			constant: "BAMBOO",
+			env: "bamboo_planKey"
+		},
+		{
+			name: "Bitbucket Pipelines",
+			constant: "BITBUCKET",
+			env: "BITBUCKET_COMMIT",
+			pr: "BITBUCKET_PR_ID"
+		},
+		{
+			name: "Bitrise",
+			constant: "BITRISE",
+			env: "BITRISE_IO",
+			pr: "BITRISE_PULL_REQUEST"
+		},
+		{
+			name: "Buddy",
+			constant: "BUDDY",
+			env: "BUDDY_WORKSPACE_ID",
+			pr: "BUDDY_EXECUTION_PULL_REQUEST_ID"
+		},
+		{
+			name: "Buildkite",
+			constant: "BUILDKITE",
+			env: "BUILDKITE",
+			pr: {
+				env: "BUILDKITE_PULL_REQUEST",
+				ne: "false"
+			}
+		},
+		{
+			name: "CircleCI",
+			constant: "CIRCLE",
+			env: "CIRCLECI",
+			pr: "CIRCLE_PULL_REQUEST"
+		},
+		{
+			name: "Cirrus CI",
+			constant: "CIRRUS",
+			env: "CIRRUS_CI",
+			pr: "CIRRUS_PR"
+		},
+		{
+			name: "Cloudflare Pages",
+			constant: "CLOUDFLARE_PAGES",
+			env: "CF_PAGES"
+		},
+		{
+			name: "Cloudflare Workers",
+			constant: "CLOUDFLARE_WORKERS",
+			env: "WORKERS_CI"
+		},
+		{
+			name: "Codefresh",
+			constant: "CODEFRESH",
+			env: "CF_BUILD_ID",
+			pr: {
+				any: [
+					"CF_PULL_REQUEST_NUMBER",
+					"CF_PULL_REQUEST_ID"
+				]
+			}
+		},
+		{
+			name: "Codemagic",
+			constant: "CODEMAGIC",
+			env: "CM_BUILD_ID",
+			pr: "CM_PULL_REQUEST"
+		},
+		{
+			name: "Codeship",
+			constant: "CODESHIP",
+			env: {
+				CI_NAME: "codeship"
+			}
+		},
+		{
+			name: "Drone",
+			constant: "DRONE",
+			env: "DRONE",
+			pr: {
+				DRONE_BUILD_EVENT: "pull_request"
+			}
+		},
+		{
+			name: "dsari",
+			constant: "DSARI",
+			env: "DSARI"
+		},
+		{
+			name: "Earthly",
+			constant: "EARTHLY",
+			env: "EARTHLY_CI"
+		},
+		{
+			name: "Expo Application Services",
+			constant: "EAS",
+			env: "EAS_BUILD"
+		},
+		{
+			name: "Gerrit",
+			constant: "GERRIT",
+			env: "GERRIT_PROJECT"
+		},
+		{
+			name: "Gitea Actions",
+			constant: "GITEA_ACTIONS",
+			env: "GITEA_ACTIONS"
+		},
+		{
+			name: "GitHub Actions",
+			constant: "GITHUB_ACTIONS",
+			env: "GITHUB_ACTIONS",
+			pr: {
+				GITHUB_EVENT_NAME: "pull_request"
+			}
+		},
+		{
+			name: "GitLab CI",
+			constant: "GITLAB",
+			env: "GITLAB_CI",
+			pr: "CI_MERGE_REQUEST_ID"
+		},
+		{
+			name: "GoCD",
+			constant: "GOCD",
+			env: "GO_PIPELINE_LABEL"
+		},
+		{
+			name: "Google Cloud Build",
+			constant: "GOOGLE_CLOUD_BUILD",
+			env: "BUILDER_OUTPUT"
+		},
+		{
+			name: "Harness CI",
+			constant: "HARNESS",
+			env: "HARNESS_BUILD_ID"
+		},
+		{
+			name: "Heroku",
+			constant: "HEROKU",
+			env: {
+				env: "NODE",
+				includes: "/app/.heroku/node/bin/node"
+			}
+		},
+		{
+			name: "Hudson",
+			constant: "HUDSON",
+			env: "HUDSON_URL"
+		},
+		{
+			name: "Jenkins",
+			constant: "JENKINS",
+			env: [
+				"JENKINS_URL",
+				"BUILD_ID"
+			],
+			pr: {
+				any: [
+					"ghprbPullId",
+					"CHANGE_ID"
+				]
+			}
+		},
+		{
+			name: "LayerCI",
+			constant: "LAYERCI",
+			env: "LAYERCI",
+			pr: "LAYERCI_PULL_REQUEST"
+		},
+		{
+			name: "Magnum CI",
+			constant: "MAGNUM",
+			env: "MAGNUM"
+		},
+		{
+			name: "Netlify CI",
+			constant: "NETLIFY",
+			env: "NETLIFY",
+			pr: {
+				env: "PULL_REQUEST",
+				ne: "false"
+			}
+		},
+		{
+			name: "Nevercode",
+			constant: "NEVERCODE",
+			env: "NEVERCODE",
+			pr: {
+				env: "NEVERCODE_PULL_REQUEST",
+				ne: "false"
+			}
+		},
+		{
+			name: "Prow",
+			constant: "PROW",
+			env: "PROW_JOB_ID"
+		},
+		{
+			name: "ReleaseHub",
+			constant: "RELEASEHUB",
+			env: "RELEASE_BUILD_ID"
+		},
+		{
+			name: "Render",
+			constant: "RENDER",
+			env: "RENDER",
+			pr: {
+				IS_PULL_REQUEST: "true"
+			}
+		},
+		{
+			name: "Sail CI",
+			constant: "SAIL",
+			env: "SAILCI",
+			pr: "SAIL_PULL_REQUEST_NUMBER"
+		},
+		{
+			name: "Screwdriver",
+			constant: "SCREWDRIVER",
+			env: "SCREWDRIVER",
+			pr: {
+				env: "SD_PULL_REQUEST",
+				ne: "false"
+			}
+		},
+		{
+			name: "Semaphore",
+			constant: "SEMAPHORE",
+			env: "SEMAPHORE",
+			pr: "PULL_REQUEST_NUMBER"
+		},
+		{
+			name: "Sourcehut",
+			constant: "SOURCEHUT",
+			env: {
+				CI_NAME: "sourcehut"
+			}
+		},
+		{
+			name: "Strider CD",
+			constant: "STRIDER",
+			env: "STRIDER"
+		},
+		{
+			name: "TaskCluster",
+			constant: "TASKCLUSTER",
+			env: [
+				"TASK_ID",
+				"RUN_ID"
+			]
+		},
+		{
+			name: "TeamCity",
+			constant: "TEAMCITY",
+			env: "TEAMCITY_VERSION"
+		},
+		{
+			name: "Travis CI",
+			constant: "TRAVIS",
+			env: "TRAVIS",
+			pr: {
+				env: "TRAVIS_PULL_REQUEST",
+				ne: "false"
+			}
+		},
+		{
+			name: "Vela",
+			constant: "VELA",
+			env: "VELA",
+			pr: {
+				VELA_PULL_REQUEST: "1"
+			}
+		},
+		{
+			name: "Vercel",
+			constant: "VERCEL",
+			env: {
+				any: [
+					"NOW_BUILDER",
+					"VERCEL"
+				]
+			},
+			pr: "VERCEL_GIT_PULL_REQUEST_ID"
+		},
+		{
+			name: "Visual Studio App Center",
+			constant: "APPCENTER",
+			env: "APPCENTER_BUILD_ID"
+		},
+		{
+			name: "Woodpecker",
+			constant: "WOODPECKER",
+			env: {
+				CI: "woodpecker"
+			},
+			pr: {
+				CI_BUILD_EVENT: "pull_request"
+			}
+		},
+		{
+			name: "Xcode Cloud",
+			constant: "XCODE_CLOUD",
+			env: "CI_XCODE_PROJECT",
+			pr: "CI_PULL_REQUEST_NUMBER"
+		},
+		{
+			name: "Xcode Server",
+			constant: "XCODE_SERVER",
+			env: "XCS"
+		}
+	];
+	return vendors;
+}
+
+var hasRequiredCiInfo;
+
+function requireCiInfo () {
+	if (hasRequiredCiInfo) return ciInfo;
+	hasRequiredCiInfo = 1;
+	(function (exports$1) {
+		const vendors = requireVendors();
+		const env = process.env;
+		Object.defineProperty(exports$1, "_vendors", {
+		  value: vendors.map(function(v) {
+		    return v.constant;
+		  })
+		});
+		exports$1.name = null;
+		exports$1.isPR = null;
+		exports$1.id = null;
+		if (env.CI !== "false") {
+		  vendors.forEach(function(vendor) {
+		    const envs = Array.isArray(vendor.env) ? vendor.env : [vendor.env];
+		    const isCI = envs.every(function(obj) {
+		      return checkEnv(obj);
+		    });
+		    exports$1[vendor.constant] = isCI;
+		    if (!isCI) {
+		      return;
+		    }
+		    exports$1.name = vendor.name;
+		    exports$1.isPR = checkPR(vendor);
+		    exports$1.id = vendor.constant;
+		  });
+		}
+		exports$1.isCI = !!(env.CI !== "false" && // Bypass all checks if CI env is explicitly set to 'false'
+		(env.BUILD_ID || // Jenkins, Cloudbees
+		env.BUILD_NUMBER || // Jenkins, TeamCity
+		env.CI || // Travis CI, CircleCI, Cirrus CI, Gitlab CI, Appveyor, CodeShip, dsari, Cloudflare Pages/Workers
+		env.CI_APP_ID || // Appflow
+		env.CI_BUILD_ID || // Appflow
+		env.CI_BUILD_NUMBER || // Appflow
+		env.CI_NAME || // Codeship and others
+		env.CONTINUOUS_INTEGRATION || // Travis CI, Cirrus CI
+		env.RUN_ID || // TaskCluster, dsari
+		exports$1.name || false));
+		function checkEnv(obj) {
+		  if (typeof obj === "string") return !!env[obj];
+		  if ("env" in obj) {
+		    return env[obj.env] && env[obj.env].includes(obj.includes);
+		  }
+		  if ("any" in obj) {
+		    return obj.any.some(function(k) {
+		      return !!env[k];
+		    });
+		  }
+		  return Object.keys(obj).every(function(k) {
+		    return env[k] === obj[k];
+		  });
+		}
+		function checkPR(vendor) {
+		  switch (typeof vendor.pr) {
+		    case "string":
+		      return !!env[vendor.pr];
+		    case "object":
+		      if ("env" in vendor.pr) {
+		        if ("any" in vendor.pr) {
+		          return vendor.pr.any.some(function(key) {
+		            return env[vendor.pr.env] === key;
+		          });
+		        } else {
+		          return vendor.pr.env in env && env[vendor.pr.env] !== vendor.pr.ne;
+		        }
+		      } else if ("any" in vendor.pr) {
+		        return vendor.pr.any.some(function(key) {
+		          return !!env[key];
+		        });
+		      } else {
+		        return checkEnv(vendor.pr);
+		      }
+		    default:
+		      return null;
+		  }
+		} 
+	} (ciInfo));
+	return ciInfo;
+}
+
+var ciInfoExports = requireCiInfo();
+
+const updateNotifierPlugin = (options = {}) => {
+  return {
+    beforeCommand: async (toolbox) => {
+      const { logger, runtime } = toolbox;
+      const packageName = runtime.getPackageName();
+      const packageVersion = runtime.getPackageVersion();
+      if (!packageName || !packageVersion) {
+        logger.debug("Update notifier: package name or version not provided, skipping...");
+        return;
+      }
+      const env = getEnv();
+      const updateNotifierOptions = {
+        alwaysRun: false,
+        debug: env.CEREBRO_OUTPUT_LEVEL === "256",
+        distTag: "latest",
+        pkg: {
+          name: packageName,
+          version: packageVersion
+        },
+        updateCheckInterval: 1e3 * 60 * 60 * 24,
+        ...options
+      };
+      const shouldCheck = Boolean(updateNotifierOptions.alwaysRun) || !(env.NO_UPDATE_NOTIFIER || env.NODE_ENV === "test" || toolbox.argv.includes("--no-update-notifier") || ciInfoExports.isCI);
+      if (!shouldCheck) {
+        logger.debug("Update notifier: skipping check (disabled by environment or flags)");
+        return;
+      }
+      (logger.raw ?? logger.log)("Checking for updates...");
+      try {
+        const hasNewVersion = await import('../../packem_chunks/has-new-version.js').then((m) => m.default);
+        const updateAvailable = await hasNewVersion(updateNotifierOptions);
+        if (updateAvailable) {
+          const [{ boxen }, { dim, green, reset, yellow }] = await Promise.all([import('@visulima/boxen'), import('@visulima/colorize')]);
+          const template = `Update available ${dim(packageVersion)}${reset(" → ")}${green(updateAvailable)}`;
+          logger.error(
+            boxen(template, {
+              borderColor: (border) => yellow(border),
+              borderStyle: "round",
+              margin: 1,
+              padding: 1,
+              textAlignment: "center"
+            })
+          );
+        }
+      } catch (error) {
+        logger.debug("Update notifier: failed to check for updates", error);
+      }
+    },
+    description: "Checks for package updates and notifies users",
+    name: "update-notifier",
+    version: "1.0.0"
+  };
+};
+
+export { updateNotifierPlugin };

package/dist/types/cli.d.ts

@@ -37,6 +37,13 @@ export interface Cli<T extends Console> {
      * @returns self
      */
     addCommand: <OD extends OptionDefinition<unknown> = OptionDefinition<unknown>>(command: ICommand<OD, T>) => this;
+    /**
+     * Add a global option available to all commands.
+     * Global options are parsed alongside command options and shown in help output.
+     * @param option The option definition
+     * @returns self
+     */
+    addGlobalOption: <V = unknown>(option: OptionDefinition<V>) => this;
     /**
      * Add a plugin to extend the CLI functionality
      * @param plugin The plugin to add.
@@ -52,6 +59,10 @@ export interface Cli<T extends Console> {
     getCommands: () => Map<string, ICommand<OptionDefinition<unknown>, T>>;
     getCommandSection: () => CommandSection;
     getCwd: () => string;
+    /**
+     * Gets all global options (built-in + custom).
+     */
+    getGlobalOptions: () => OptionDefinition<unknown>[];
     getPackageName: () => string | undefined;
     getPackageVersion: () => string | undefined;
     /**

package/dist/types/command-line-usage.d.ts

@@ -22,7 +22,7 @@ export interface Content {
 export interface OptionList<O extends OptionDefinition<any> = any> {
     /** If specified, only options from this particular group will be printed.  */
     group?: string[] | string;
-    header?: string | undefined;
+    header?: string;
     /** The names of one of more option definitions to hide from the option list.  */
     hide?: string[] | string;
     /** If specified, the -- prefix will be omitted from the option name. */