@visulima/cerebro 3.0.0-alpha.3 → 3.0.0-alpha.30

package/dist/plugins/error-handler-plugin.d.ts

@@ -1,21 +1,23 @@
-import type { RenderErrorOptions } from "@visulima/error";
-import type { Plugin } from "../types/plugin.d.ts";
-export type ErrorHandlerOptions = {
-    /** Show detailed error information including stack traces and code frames (default: false) */
-    detailed?: boolean;
-    /** Exit process after handling error (default: true) */
-    exitOnError?: boolean;
-    /** Custom error formatter function */
-    formatter?: (error: Error) => string;
-    /** Whether to log errors (default: true) */
-    logErrors?: boolean;
-    /** Options for renderError from \@visulima/error (only used when detailed is true) */
-    renderOptions?: Partial<RenderErrorOptions>;
+import { O as Options$1 } from "../packem_shared/index.d-Br8HpP0A.js";
+import { P as Plugin } from "../packem_shared/plugin-manager.d-BSQtHbWS.js";
+import '@visulima/tabular';
+type ErrorHandlerOptions = {
+  /** Show detailed error information including stack traces and code frames (default: false) */
+  detailed?: boolean;
+  /** Exit process after handling error (default: true) */
+  exitOnError?: boolean;
+  /** Custom error formatter function */
+  formatter?: (error: Error) => string;
+  /** Whether to log errors (default: true) */
+  logErrors?: boolean;
+  /** Options for renderError from \@visulima/error (only used when detailed is true) */
+  renderOptions?: Partial<Options$1>;
 };
 /**
- * Create an error handler plugin for enhanced error reporting.
- * Uses \@visulima/error for beautiful error formatting with code frames and stack traces.
- * @param options Error handler configuration options
- * @returns Plugin instance
- */
-export declare const errorHandlerPlugin: (options?: ErrorHandlerOptions) => Plugin;
+* Create an error handler plugin for enhanced error reporting.
+* Uses \@visulima/error for beautiful error formatting with code frames and stack traces.
+* @param options Error handler configuration options
+* @returns Plugin instance
+*/
+declare const errorHandlerPlugin: (options?: ErrorHandlerOptions) => Plugin;
+export { ErrorHandlerOptions, errorHandlerPlugin };

package/dist/plugins/error-handler-plugin.js

@@ -1 +1 @@
-var u=Object.defineProperty;var i=(e,r)=>u(e,"name",{value:r,configurable:!0});import{G as h}from"../packem_shared/renderError-ZMlMvw1N-eVUSdl6c.js";import{e as p}from"../packem_shared/runtime-process-G-n-wOub.js";var E=Object.defineProperty,a=i((e,r)=>E(e,"name",{value:r,configurable:!0}),"n");const P=a((e={})=>({description:"Enhanced error handling and reporting with beautiful code frames",name:"error-handler",onError:a(async(r,t)=>{const{logger:o,runtime:l}=t,{detailed:s=!1,exitOnError:d=!0,formatter:n,logErrors:f=!0,renderOptions:c={}}=e;if(f)if(n)o.error(n(r));else if(s){const g=l.getCwd(),m=h(r,{cwd:g,hideErrorCodeView:!1,hideErrorTitle:!1,hideMessage:!1,linesAbove:2,linesBelow:3,...c});o.error(m)}else o.error(r);d&&p(1)},"handleError"),version:"1.0.0"}),"errorHandlerPlugin");export{P as errorHandlerPlugin};
+var u=Object.defineProperty;var n=(e,r)=>u(e,"name",{value:r,configurable:!0});import{G as h}from"../packem_shared/renderError-DxgI44AK-DFDWFoCr.js";import{e as p}from"../packem_shared/runtime-process-DKHFvYkv.js";var E=Object.defineProperty,a=n((e,r)=>E(e,"name",{value:r,configurable:!0}),"n");const P=a((e={})=>({description:"Enhanced error handling and reporting with beautiful code frames",name:"error-handler",onError:a((r,t)=>{const{logger:o,runtime:l}=t,{detailed:s=!1,exitOnError:d=!0,formatter:i,logErrors:f=!0,renderOptions:g={}}=e;if(f)if(i)o.error(i(r));else if(s){const c=l.getCwd(),m=h(r,{cwd:c,hideErrorCodeView:!1,hideErrorTitle:!1,hideMessage:!1,linesAbove:2,linesBelow:3,...g});o.error(m)}else o.error(r);d&&p(1)},"handleError"),version:"1.0.0"}),"errorHandlerPlugin");export{P as errorHandlerPlugin};

package/dist/plugins/runtime-version-check-plugin.d.ts

@@ -1,23 +1,25 @@
-import type { Plugin } from "../types/plugin.d.ts";
-export type RuntimeType = "bun" | "deno" | "node";
-export type RuntimeVersionRequirement = {
-    /** Minimum version required */
-    minVersion: number;
+import { P as Plugin } from "../packem_shared/plugin-manager.d-BSQtHbWS.js";
+import '@visulima/tabular';
+type RuntimeType = "bun" | "deno" | "node";
+type RuntimeVersionRequirement = {
+  /** Minimum version required */
+  minVersion: number;
 };
-export type RuntimeVersionCheckOptions = {
-    /** Runtime version requirements for specific runtimes */
-    runtimes?: {
-        /** Minimum Bun version requirement */
-        bun?: RuntimeVersionRequirement;
-        /** Minimum Deno version requirement */
-        deno?: RuntimeVersionRequirement;
-        /** Minimum Node.js version requirement */
-        node?: RuntimeVersionRequirement;
-    };
+type RuntimeVersionCheckOptions = {
+  /** Runtime version requirements for specific runtimes */
+  runtimes?: {
+    /** Minimum Bun version requirement */
+    bun?: RuntimeVersionRequirement;
+    /** Minimum Deno version requirement */
+    deno?: RuntimeVersionRequirement;
+    /** Minimum Node.js version requirement */
+    node?: RuntimeVersionRequirement;
+  };
 };
 /**
- * Create a runtime version check plugin that supports Node.js, Bun, and Deno.
- * @param options Configuration for runtime version requirements
- * @returns Plugin instance that validates runtime version on initialization
- */
-export declare const runtimeVersionCheckPlugin: (options?: RuntimeVersionCheckOptions) => Plugin;
+* Create a runtime version check plugin that supports Node.js, Bun, and Deno.
+* @param options Configuration for runtime version requirements
+* @returns Plugin instance that validates runtime version on initialization
+*/
+declare const runtimeVersionCheckPlugin: (options?: RuntimeVersionCheckOptions) => Plugin;
+export { RuntimeType, RuntimeVersionCheckOptions, RuntimeVersionRequirement, runtimeVersionCheckPlugin };

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

@@ -1 +1 @@
-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};
+var v=Object.defineProperty;var p=(r,t)=>v(r,"name",{value:t,configurable:!0});import{d as a,e as d,g}from"../packem_shared/runtime-process-DKHFvYkv.js";var y=Object.defineProperty,n=p((r,t)=>y(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=g().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(t=>{const e=l(),c={bun:1,deno:1,node:18};let o;try{const u=a().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 ${String(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} >= ${String(i)}`)},"init"),name:"runtime-version-check",version:"1.0.0"}),"runtimeVersionCheckPlugin");export{b as runtimeVersionCheckPlugin};

package/dist/plugins/update-notifier/update-notifier-plugin.d.ts

@@ -1,9 +1,22 @@
-import type { Plugin } from "../../types/plugin.d.ts";
-import type { UpdateNotifierOptions } from "./has-new-version.d.ts";
-export type UpdateNotifierPluginOptions = Partial<Omit<UpdateNotifierOptions, "debug" | "pkg">>;
+import { P as Plugin } from "../../packem_shared/plugin-manager.d-BSQtHbWS.js";
+import '@visulima/tabular';
+type UpdateNotifierOptions = {
+  alwaysRun?: boolean;
+  debug?: boolean;
+  distTag?: string;
+  pkg: {
+    name: string;
+    version: string;
+  };
+  registryUrl?: string;
+  shouldNotifyInNpmScript?: boolean;
+  updateCheckInterval?: number;
+};
+type UpdateNotifierPluginOptions = Partial<Omit<UpdateNotifierOptions, "debug" | "pkg">>;
 /**
- * Create an update notifier plugin that checks for package updates.
- * @param options Update notifier configuration options.
- * @returns Plugin instance.
- */
-export declare const updateNotifierPlugin: (options?: UpdateNotifierPluginOptions) => Plugin;
+* Create an update notifier plugin that checks for package updates.
+* @param options Update notifier configuration options.
+* @returns Plugin instance.
+*/
+declare const updateNotifierPlugin: (options?: UpdateNotifierPluginOptions) => Plugin;
+export { UpdateNotifierPluginOptions, updateNotifierPlugin };

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

@@ -1 +1 @@
-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};
+var f=Object.defineProperty;var E=(e,r)=>f(e,"name",{value:r,configurable:!0});import{d as T}from"../../packem_shared/runtime-process-DKHFvYkv.js";var P=Object.defineProperty,i=E((e,r)=>P(e,"name",{value:r,configurable:!0}),"t");function A(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}E(A,"getDefaultExportFromCjs");i(A,"getDefaultExportFromCjs");function O(e){return e&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}E(O,"getDefaultExportFromNamespaceIfPresent");i(O,"getDefaultExportFromNamespaceIfPresent");function S(e){return e&&Object.prototype.hasOwnProperty.call(e,"default")&&Object.keys(e).length===1?e.default:e}E(S,"getDefaultExportFromNamespaceIfNotNamed");i(S,"getDefaultExportFromNamespaceIfNotNamed");function N(e){if(Object.prototype.hasOwnProperty.call(e,"__esModule"))return e;var r=e.default;if(typeof r=="function"){var o=i(E(function c(){var t=!1;try{t=this instanceof c}catch{}return t?Reflect.construct(r,arguments,this.constructor):r.apply(this,arguments)},"a"),"a");o.prototype=r.prototype}else o={};return Object.defineProperty(o,"__esModule",{value:!0}),Object.keys(e).forEach(function(c){var t=Object.getOwnPropertyDescriptor(e,c);Object.defineProperty(o,c,t.get?t:{enumerable:!0,get:i(function(){return e[c]},"get")})}),o}E(N,"getAugmentedNamespace");i(N,"getAugmentedNamespace");var u={},R,p;function B(){return p||(p=1,R=[{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"}]),R}E(B,"requireVendors");var U;function g(){return U||(U=1,(function(e){var r=Object.defineProperty,o=E((n,a)=>r(n,"name",{value:a,configurable:!0}),"t");const c=B(),t=process.env;Object.defineProperty(e,"_vendors",{value:c.map(function(n){return n.constant})}),e.name=null,e.isPR=null,e.id=null,t.CI!=="false"&&c.forEach(function(n){const a=(Array.isArray(n.env)?n.env:[n.env]).every(function(_){return s(_)});e[n.constant]=a,a&&(e.name=n.name,e.isPR=I(n),e.id=n.constant)}),e.isCI=!!(t.CI!=="false"&&(t.BUILD_ID||t.BUILD_NUMBER||t.CI||t.CI_APP_ID||t.CI_BUILD_ID||t.CI_BUILD_NUMBER||t.CI_NAME||t.CONTINUOUS_INTEGRATION||t.RUN_ID||e.name));function s(n){return typeof n=="string"?!!t[n]:"env"in n?t[n.env]&&t[n.env].includes(n.includes):"any"in n?n.any.some(function(a){return!!t[a]}):Object.keys(n).every(function(a){return t[a]===n[a]})}E(s,"checkEnv"),o(s,"checkEnv");function I(n){switch(typeof n.pr){case"string":return!!t[n.pr];case"object":return"env"in n.pr?"any"in n.pr?n.pr.any.some(function(a){return t[n.pr.env]===a}):n.pr.env in t&&t[n.pr.env]!==n.pr.ne:"any"in n.pr?n.pr.any.some(function(a){return!!t[a]}):s(n.pr);default:return null}}E(I,"checkPR"),o(I,"checkPR")})(u)),u}E(g,"requireCiInfo");var y=g(),b=Object.defineProperty,C=E((e,r)=>b(e,"name",{value:r,configurable:!0}),"i");const V=C((e={})=>({beforeCommand:C(async r=>{const{logger:o,runtime:c}=r,t=c.getPackageName(),s=c.getPackageVersion();if(!t||!s){o.debug("Update notifier: package name or version not provided, skipping...");return}const I=T(),n={alwaysRun:!1,debug:I.CEREBRO_OUTPUT_LEVEL==="256",distTag:"latest",pkg:{name:t,version:s},updateCheckInterval:1e3*60*60*24,...e};if(!(n.alwaysRun||!(I.NO_UPDATE_NOTIFIER||I.NODE_ENV==="test"||r.argv.includes("--no-update-notifier")||y.isCI))){o.debug("Update notifier: skipping check (disabled by environment or flags)");return}(o.raw??o.log)("Checking for updates...");try{const a=await(await import("../../packem_chunks/has-new-version.js").then(_=>_.default))(n);if(a){const[{boxen:_},{dim:l,green:L,reset:v,yellow:m}]=await Promise.all([import("@visulima/boxen"),import("@visulima/colorize")]),D=`Update available ${l(s)}${v(" → ")}${L(a)}`;o.error(_(D,{borderColor:C(d=>m(d),"borderColor"),borderStyle:"round",margin:1,padding:1,textAlignment:"center"}))}}catch(a){o.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{V as updateNotifierPlugin};

package/dist/util/general/compile-cache.d.ts

@@ -0,0 +1,41 @@
+/**
+* V8 compile cache helper for faster CLI startup.
+*
+* Enables the V8 compile cache so that subsequent runs of the CLI skip
+* re-parsing and re-compiling JavaScript/TypeScript source files. This
+* can reduce startup time by 30-70% for large CLI tools.
+*
+* ## When to use
+*
+* Call `enableCompileCache()` early in your CLI entry point, after heap
+* tuning but before importing heavy modules:
+*
+* ```typescript
+* // bin.ts
+* import { applyHeapTuning } from "@visulima/cerebro/heap-tuning";
+* import { enableCompileCache } from "@visulima/cerebro/compile-cache";
+*
+* applyHeapTuning();
+* enableCompileCache();
+*
+* import { createCerebro } from "@visulima/cerebro";
+* // ... rest of your CLI setup
+* ```
+*
+* ## How it works
+*
+* 1. Tries `module.enableCompileCache()` (Node.js 22.8+ native API) which
+*    stores compiled bytecode alongside source files for instant reuse.
+* 2. If that's unavailable, falls back to the `v8-compile-cache` npm package
+*    which achieves a similar effect on older Node.js versions.
+* 3. If neither is available, silently does nothing — startup is just slower.
+* @module
+*/
+/**
+* Enable V8 compile cache for faster subsequent CLI startups.
+*
+* Safe to call unconditionally — silently no-ops if the runtime doesn't
+* support compile caching or the fallback package isn't installed.
+*/
+declare const enableCompileCache: () => void;
+export { enableCompileCache as default };

package/dist/util/general/compile-cache.js

@@ -0,0 +1 @@
+var t=Object.defineProperty;var r=(e,a)=>t(e,"name",{value:a,configurable:!0});var c=Object.defineProperty,n=r((e,a)=>c(e,"name",{value:a,configurable:!0}),"o");const l=n(()=>{try{const e=require("node:module");if(typeof e.enableCompileCache=="function"){e.enableCompileCache();return}}catch{}try{require("v8-compile-cache")}catch{}},"enableCompileCache");export{l as default};

package/dist/util/general/heap-tuning.d.ts

@@ -0,0 +1,18 @@
+interface HeapTuningOptions {
+  /**
+  * Fraction of total system memory to allocate as `--max-old-space-size`.
+  * Must be between 0 and 1. Default: `0.75` (75%).
+  */
+  maxOldSpacePercent?: number;
+}
+/**
+* Apply heap memory tuning to the current process.
+*
+* When tuning is needed, this function re-spawns the process with computed
+* V8 memory flags and **never returns** — the parent exits with the child's
+* exit code. When no tuning is needed (flags already set), it returns
+* immediately.
+* @param options Optional configuration for heap tuning.
+*/
+declare const applyHeapTuning: (options?: HeapTuningOptions) => void;
+export { type HeapTuningOptions, applyHeapTuning };

package/dist/util/general/heap-tuning.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var p=(e,s)=>h(e,"name",{value:s,configurable:!0});import{createRequire as x}from"node:module";import{f as b,h as z,i as j,d as M,e as d}from"../../packem_shared/runtime-process-DKHFvYkv.js";const _=x(import.meta.url),o=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,g=p(e=>{if(typeof o<"u"&&o.versions&&o.versions.node){const[s,t]=o.versions.node.split(".").map(Number);if(s>22||s===22&&t>=3||s===20&&t>=16)return o.getBuiltinModule(e)}return _(e)},"__cjs_getBuiltinModule"),{execFileSync:y}=g("node:child_process"),{totalmem:S}=g("node:os");var P=Object.defineProperty,n=p((e,s)=>P(e,"name",{value:s,configurable:!0}),"r");const T=/--max-old-space-size=(\d+)/,q=/--max-semi-space-size=(\d+)/,A=n(e=>Math.floor(S()/1024/1024*e),"getDefaultMaxOldSpaceSize"),E=n(e=>e<=512?4:e<=1024?8:e<=2048?16:e<=4096?32:e<=8192?64:Math.floor(Math.log2(e))*8,"getSemiSpaceSize"),f=n((e,s)=>{for(const t of s){const i=e.exec(t);if(i)return Number.parseInt(i[1],10)}},"extractFlag"),H=n(e=>{const s=e?.maxOldSpacePercent??.75,t=[...b()],i=[...z()],a=f(T,t),c=f(q,t);if(a!==void 0&&c!==void 0)return;const l=a??A(s),m=c??E(l),r=[];if(a===void 0&&r.push(`--max-old-space-size=${String(l)}`),c===void 0&&r.push(`--max-semi-space-size=${String(m)}`),r.length!==0)try{y(j(),[...r,...t,...i.slice(1)],{env:M(),stdio:"inherit"}),d(0)}catch(v){const u=v.status;d(typeof u=="number"?u:1)}},"applyHeapTuning");export{H as applyHeapTuning};

package/package.json

@@ -1,40 +1,38 @@
 {
   "name": "@visulima/cerebro",
-  "version": "3.0.0-alpha.3",
+  "version": "3.0.0-alpha.30",
   "description": "A delightful toolkit for building cross-runtime CLIs for Node.js, Deno, and Bun.",
   "keywords": [
-    "visulima",
-    "command",
-    "line",
-    "class",
-    "terminal",
     "ansi",
-    "cli",
-    "opts",
-    "nopt",
-    "options",
     "args",
+    "argument",
     "argv",
-    "interactive",
-    "commander",
     "clap",
+    "class",
+    "cli",
     "cli-app",
-    "minimist",
+    "command",
     "command line apps",
     "command-line-usage",
-    "option",
-    "parser",
-    "argument",
+    "commander",
     "flag",
     "gluegun",
+    "interactive",
+    "line",
     "meow",
+    "minimist",
+    "nopt",
     "oclif",
+    "option",
+    "options",
+    "opts",
+    "parser",
+    "terminal",
+    "visulima",
     "yargs"
   ],
   "homepage": "https://visulima.com/packages/cerebro",
-  "bugs": {
-    "url": "https://github.com/visulima/visulima/issues"
-  },
+  "bugs": "https://github.com/visulima/visulima/issues",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
@@ -90,6 +88,14 @@
       "types": "./dist/plugins/update-notifier/update-notifier-plugin.d.ts",
       "default": "./dist/plugins/update-notifier/update-notifier-plugin.js"
     },
+    "./compile-cache": {
+      "types": "./dist/util/general/compile-cache.d.ts",
+      "default": "./dist/util/general/compile-cache.js"
+    },
+    "./heap-tuning": {
+      "types": "./dist/util/general/heap-tuning.d.ts",
+      "default": "./dist/util/general/heap-tuning.js"
+    },
     "./logger/pail": {
       "types": "./dist/logger/create-pail-logger.d.ts",
       "default": "./dist/logger/create-pail-logger.js"
@@ -103,15 +109,15 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@visulima/colorize": "2.0.0-alpha.3",
-    "@visulima/tabular": "4.0.0-alpha.3",
+    "@visulima/colorize": "2.0.0-alpha.13",
+    "@visulima/tabular": "4.0.0-alpha.13",
     "fastest-levenshtein": "^1.0.16"
   },
   "peerDependencies": {
-    "@bomb.sh/tab": "^0.0.7",
-    "@visulima/boxen": "3.0.0-alpha.3",
-    "@visulima/find-cache-dir": "3.0.0-alpha.2",
-    "@visulima/pail": "4.0.0-alpha.3",
+    "@bomb.sh/tab": "0.0.15",
+    "@visulima/boxen": "3.0.0-alpha.12",
+    "@visulima/find-cache-dir": "3.0.0-alpha.11",
+    "@visulima/pail": "4.0.0-alpha.20",
     "github-slugger": "2.0.0"
   },
   "peerDependenciesMeta": {
@@ -132,7 +138,7 @@
     }
   },
   "engines": {
-    "node": ">=22.13 <=25.x"
+    "node": "^22.14.0 || >=24.10.0"
   },
   "os": [
     "darwin",

package/dist/cli.d.ts

@@ -1,203 +0,0 @@
-import PluginManager from "./plugin-manager.d.ts";
-import type { Cli as ICli, CliRunOptions, CommandSection as ICommandSection, RunCommandOptions } from "./types/cli.d.ts";
-import type { Command as ICommand, OptionDefinition } from "./types/command.d.ts";
-import type { Plugin } from "./types/plugin.d.ts";
-export type CliOptions<T extends Console = Console> = {
-    argv?: ReadonlyArray<string>;
-    cwd?: string;
-    logger?: T;
-    packageName?: string;
-    packageVersion?: string;
-};
-export declare class Cli<T extends Console = Console> implements ICli<T> {
-    #private;
-    /**
-     * Create a new CLI instance.
-     * @param cliName
-     * @param options The options for the CLI.
-     * @param options.argv The command line arguments.
-     * @param options.cwd The current working directory.
-     * @param options.logger The logger to use.
-     * @param options.packageName
-     * @param options.packageVersion
-     */
-    constructor(cliName: string, options?: CliOptions<T>);
-    /**
-     * Sets the command section configuration for help display.
-     *
-     * This affects how the CLI name and version are displayed in help output.
-     * @param commandSection The command section configuration
-     * @returns The CLI instance for method chaining
-     * @example
-     * ```typescript
-     * cli.setCommandSection({
-     *   header: 'My App v2.0.0',
-     *   footer: 'For more info, visit https://example.com'
-     * });
-     * ```
-     */
-    setCommandSection(commandSection: ICommandSection): this;
-    /**
-     * Gets the current command section configuration.
-     * @returns The command section configuration
-     */
-    getCommandSection(): ICommandSection;
-    /**
-     * Sets the default command to run when no command is specified.
-     *
-     * By default, this is set to 'help'. The command must already be registered
-     * with the CLI instance.
-     * @param commandName The command name to use as the default
-     * @returns The CLI instance for method chaining
-     * @example
-     * ```typescript
-     * cli.setDefaultCommand('start');
-     * ```
-     */
-    setDefaultCommand(commandName: string): this;
-    /**
-     * Gets the current default command.
-     * @returns The name of the default command
-     */
-    get defaultCommand(): string;
-    /**
-     * Adds a command to the CLI.
-     *
-     * Commands define the available operations that users can execute.
-     * Each command can have options, arguments, aliases, and custom execution logic.
-     * @template OD - The option definition type for the command
-     * @param command The command configuration object
-     * @returns The CLI instance for method chaining
-     * @throws {CerebroError} If the command name already exists or validation fails
-     * @example
-     * ```typescript
-     * cli.addCommand({
-     *   name: 'build',
-     *   description: 'Build the project',
-     *   options: [
-     *     {
-     *       name: 'output',
-     *       alias: 'o',
-     *       type: String,
-     *       description: 'Output directory'
-     *     }
-     *   ],
-     *   execute: ({ options }) => {
-     *     console.log(`Building to ${options.output || 'dist'}`);
-     *   }
-     * });
-     * ```
-     */
-    addCommand<OD extends OptionDefinition<unknown> = OptionDefinition<unknown>>(command: ICommand<OD, T>): this;
-    /**
-     * Adds a plugin to extend the CLI functionality.
-     *
-     * Plugins can hook into various lifecycle events and modify the toolbox
-     * to provide additional functionality to commands.
-     * @param plugin The plugin to register
-     * @returns The CLI instance for method chaining
-     * @example
-     * ```typescript
-     * cli.addPlugin({
-     *   name: 'logger',
-     *   execute: (toolbox) => {
-     *     toolbox.logger = createCustomLogger();
-     *   }
-     * });
-     * ```
-     */
-    addPlugin(plugin: Plugin<T>): this;
-    /**
-     * Gets the plugin manager instance for advanced plugin management.
-     * @returns The plugin manager instance
-     */
-    getPluginManager(): PluginManager<T>;
-    /**
-     * Gets the CLI application name.
-     */
-    getCliName(): string;
-    /**
-     * Gets the package version if configured.
-     * @returns The package version or undefined
-     */
-    getPackageVersion(): string | undefined;
-    /**
-     * Gets the package name if configured.
-     * @returns The package name or undefined
-     */
-    getPackageName(): string | undefined;
-    /**
-     * Gets all registered commands.
-     * @returns A map of command names to command definitions
-     */
-    getCommands(): Map<string, ICommand<OptionDefinition<unknown>, T>>;
-    /**
-     * Gets the current working directory.
-     * @returns The current working directory path
-     */
-    getCwd(): string;
-    /**
-     * Disposes the CLI instance and cleans up resources.
-     *
-     * This method removes event listeners and performs cleanup to prevent memory leaks.
-     * Call this method when the CLI instance is no longer needed, especially in long-running
-     * processes or when creating multiple CLI instances.
-     * @example
-     * ```typescript
-     * const cli = new Cerebro('my-app');
-     * // ... use the cli
-     * cli.dispose(); // Clean up when done
-     * ```
-     */
-    dispose(): void;
-    /**
-     * Runs the CLI application.
-     *
-     * This method parses command line arguments, executes the appropriate command,
-     * and handles the complete CLI lifecycle including plugin initialization,
-     * error handling, process termination, and automatic cleanup.
-     * @param extraOptions Additional options to pass to commands
-     * @param extraOptions.shouldExitProcess Whether to exit the process after execution (default: true)
-     * @param extraOptions.autoDispose Whether to automatically cleanup/dispose resources after execution (default: true)
-     * @returns A promise that resolves when execution completes
-     * @throws {CommandNotFoundError} If the specified command doesn't exist
-     * @throws {Error} If command arguments are invalid or conflicting options are provided
-     * @example
-     * ```typescript
-     * // Run with default behavior (exits process and auto-disposes)
-     * await cli.run();
-     *
-     * // Run without exiting (for testing)
-     * await cli.run({ shouldExitProcess: false });
-     *
-     * // Run without auto-disposing (for reuse)
-     * await cli.run({ autoDispose: false });
-     * ```
-     */
-    run(extraOptions?: CliRunOptions): Promise<void>;
-    /**
-     * Runs a command programmatically from within another command.
-     *
-     * This method allows commands to call other commands during execution,
-     * enabling composition of commands and reusable command logic.
-     * @param commandName The name of the command to execute
-     * @param options Optional options including argv and other command options
-     * @returns A promise that resolves with the command's result
-     * @throws {CommandNotFoundError} If the specified command doesn't exist
-     * @throws {CerebroError} If command validation fails
-     * @example
-     * ```typescript
-     * cli.addCommand({
-     *   name: 'deploy',
-     *   execute: async ({ runtime, logger }) => {
-     *     logger.info('Building...');
-     *     await runtime.runCommand('build', { argv: ['--production'] });
-     *
-     *     logger.info('Testing...');
-     *     await runtime.runCommand('test', { argv: ['--coverage'] });
-     *   }
-     * });
-     * ```
-     */
-    runCommand(commandName: string, options?: RunCommandOptions): Promise<unknown>;
-}

package/dist/constants.d.ts

@@ -1,29 +0,0 @@
-/**
- * Output with this option will be formatted.
- */
-export declare const OUTPUT_NORMAL = 1;
-/**
- * Output with this option will be passed as-is.
- */
-export declare const OUTPUT_RAW = 2;
-/**
- * Output with this option will have any formatting stripped away.
- */
-export declare const OUTPUT_PLAIN = 4;
-/**
- * Output with this verbosity won't write anything at all.
- */
-export declare const VERBOSITY_QUIET = 16;
-/**
- * Output with this verbosity will write default content.
- */
-export declare const VERBOSITY_NORMAL = 32;
-/**
- * Output with this verbosity will be more detailed.
- */
-export declare const VERBOSITY_VERBOSE = 64;
-/**
- * Output with this verbosity will reveal internals.
- */
-export declare const VERBOSITY_DEBUG = 128;
-export declare const POSITIONALS_KEY = "positionals";

package/dist/default-env.d.ts

@@ -1,7 +0,0 @@
-import type { EnvDefinition } from "./types/command.d.ts";
-/**
- * Default environment variables used by Cerebro CLI framework.
- * These are displayed in the help output.
- */
-declare const defaultEnv: (EnvDefinition<string> | EnvDefinition<number> | EnvDefinition<boolean>)[];
-export default defaultEnv;

package/dist/default-options.d.ts

@@ -1,3 +0,0 @@
-import type { OptionDefinition } from "./types/command.d.ts";
-declare const defaultOptions: OptionDefinition<boolean>[];
-export default defaultOptions;

package/dist/empty-toolbox.d.ts

@@ -1,15 +0,0 @@
-import type { Toolbox as IToolbox } from "./types/toolbox.d.ts";
-declare class EmptyToolbox implements Partial<IToolbox> {
-    [x: string]: unknown;
-    result?: unknown;
-    argv?: IToolbox["argv"];
-    options?: IToolbox["options"];
-    argument?: IToolbox["argument"];
-    command: IToolbox["command"];
-    commandName: IToolbox["commandName"];
-    env?: IToolbox["env"];
-    logger?: IToolbox["logger"];
-    runtime?: IToolbox["runtime"];
-    constructor(commandName: IToolbox["commandName"], command: IToolbox["command"]);
-}
-export default EmptyToolbox;

package/dist/errors/cerebro-error.d.ts

@@ -1,10 +0,0 @@
-import { VisulimaError } from "@visulima/error";
-/**
- * Base error class for Cerebro CLI operations.
- */
-declare class CerebroError extends VisulimaError {
-    readonly code: string;
-    readonly context?: Record<string, unknown>;
-    constructor(message: string, code: string, context?: Record<string, unknown>);
-}
-export default CerebroError;