@visulima/cerebro 3.0.0-alpha.2 → 3.0.0-alpha.21

package/dist/packem_shared/plugin-manager.d-Dz-wu1tI.d.ts

@@ -0,0 +1,544 @@
+import { TableOptions } from '@visulima/tabular';
+/**
+* Definition for a command-line option.
+*/
+interface OptionDefinition$1 {
+  /**
+  * A getopt-style short option name. Can be any single character except a digit or hyphen.
+  */
+  alias?: string;
+  /**
+  * Any values unaccounted for by an option definition will be set on the `defaultOption`. This flag is typically set
+  * on the most commonly-used option to enable more concise usage.
+  */
+  defaultOption?: boolean;
+  /**
+  * An initial value for the option.
+  */
+  defaultValue?: any;
+  /**
+  * One or more group names the option belongs to.
+  */
+  group?: string | string[];
+  /**
+  * Identical to `multiple` but with greedy parsing disabled.
+  */
+  lazyMultiple?: boolean;
+  /**
+  * Set this flag if the option accepts multiple values. In the output, you will receive an array of values each passed through the `type` function.
+  */
+  multiple?: boolean;
+  /**
+  * The long option name.
+  */
+  name: string;
+  /**
+  * A setter function (you receive the output from this) enabling you to be specific about the type and value received. Typical values
+  * are `String` (the default), `Number` and `Boolean` but you can use a custom function. If no option value was set you will receive `null`.
+  */
+  type?: (input: string) => any;
+}
+/**
+* Error thrown when an option is already set (duplicate assignment).
+*/
+/** A Content section comprises a header and one or more lines of content. */
+interface Content {
+  /**
+  * Overloaded property, accepting data in one of four formats.
+  * 1. A single string (one line of text).
+  * 2. An array of strings (multiple lines of text).
+  * 3. An array of arrays (recordset-style data). In this case, the data will be rendered in table format.
+  * 4. An object with two properties - data and options. In this case, the data and options will be passed directly to the underlying table module for rendering.
+  */
+  content?: string[] | string[][] | string | {
+    data: string[][];
+    options: TableOptions;
+  };
+  /** The section header, always bold and underlined. */
+  header?: string;
+  /** Set to true to avoid indentation and wrapping. Useful for banners. */
+  raw?: boolean;
+}
+/**
+* A flexible object for the many "options" objects we throw around in cerebro.
+*/
+type Options = Record<string | symbol, unknown>;
+/**
+* Type-safe Toolbox interface with customizable options and environment variable types.
+* @template TLogger - The logger type (defaults to Console)
+* @template TOptions - The options type (defaults to Options/Record&lt;string, unknown>)
+* @template TEnv - The environment variables type (defaults to Record&lt;string, unknown>)
+*/
+interface Toolbox<TLogger extends Console = Console, TOptions extends Record<string, unknown> = Options, TEnv extends Record<string, unknown> = Record<string, unknown>> extends Cerebro.ExtensionOverrides {
+  /**
+  * The argument passed to the command.
+  * For example, if you run `cerebro foo bar baz`, then this will be `["foo", "bar", "baz"]`.
+  * @example
+  * ```typescript
+  * cli.addCommand({
+  *   name: "copy",
+  *   argument: {
+  *     name: "files",
+  *     type: String,
+  *     description: "Files to copy"
+  *   },
+  *   execute: ({ argument }) => {
+  *     // argument is an array of strings
+  *     // argument[0] is the first file, argument[1] is the second, etc.
+  *     argument.forEach((file) => console.log(`Copying ${file}...`));
+  *   }
+  * });
+  * ```
+  */
+  argument: string[];
+  argv: ReadonlyArray<string>;
+  /**
+  * The command that is being executed.
+  */
+  command: Command;
+  /**
+  * The name of the command that is being executed.
+  */
+  commandName: string;
+  /**
+  * Environment variables processed from the command definition.
+  * Values are transformed according to their type definitions and default values.
+  * @example
+  * ```typescript
+  * // Define env types when creating command
+  * type MyEnv = { apiKey: string; debug: boolean };
+  *
+  * cli.addCommand({
+  *   name: "build",
+  *   env: [
+  *     { name: "API_KEY", type: String },
+  *     { name: "DEBUG", type: Boolean }
+  *   ],
+  *   execute: ({ env }) => {
+  *     // env.apiKey and env.debug are now typed!
+  *     console.log(env.apiKey, env.debug);
+  *   }
+  * });
+  * ```
+  */
+  env: TEnv;
+  /** The logger instance. */
+  logger: TLogger;
+  /**
+  * Any optional parameters. Typically coming from command-line
+  * argument like this: `--force -p tsconfig-mjson`.
+  * @example
+  * ```typescript
+  * // Define options type for better autocomplete
+  * type MyOptions = {
+  *   output?: string;
+  *   verbose?: boolean;
+  *   port?: number;
+  * };
+  *
+  * cli.addCommand({
+  *   name: "serve",
+  *   options: [
+  *     { name: "output", type: String },
+  *     { name: "verbose", type: Boolean },
+  *     { name: "port", type: Number }
+  *   ],
+  *   execute: ({ options }: { options: MyOptions }) => {
+  *     // options.output, options.verbose, options.port are typed!
+  *     console.log(options.output, options.verbose, options.port);
+  *   }
+  * });
+  * ```
+  */
+  options: TOptions;
+  /**
+  * Raw tokens that command-line-args could not assign to a defined
+  * option — typically everything after a `--` separator, since
+  * cerebro runs the parser with `stopAtFirstUnknown: true`.
+  *
+  * Use this for passthrough patterns like
+  * `my-cmd foo bar -- --flag=value --other`, where everything after
+  * `--` is forwarded to an inner tool (`create-vite`, a template
+  * runner, etc.). Empty array when there was no `--` segment.
+  * @example
+  * ```typescript
+  * cli.addCommand({
+  *   name: "create",
+  *   argument: { name: "template", type: String },
+  *   execute: ({ argument, rawUnknown }) => {
+  *     // `vis create vite my-app -- --template react-ts`
+  *     // → argument === ["vite", "my-app"]
+  *     // → rawUnknown === ["--template", "react-ts"]
+  *     spawnSync("npm", ["create", "vite", ...rawUnknown]);
+  *   },
+  * });
+  * ```
+  */
+  rawUnknown: ReadonlyArray<string>;
+  /**
+  * This is the instance of the CLI that is running the command.
+  */
+  runtime: Cli<TLogger>;
+}
+type TypeConstructor<T> = (value: unknown) => T extends (infer R)[] ? R | undefined : T | undefined;
+/**
+* Type constructor for environment variables.
+* Environment variables are always strings (or undefined), so the transform function receives string | undefined.
+*/
+type EnvTypeConstructor<T> = (value: string | undefined) => T extends (infer R)[] ? R | undefined : T | undefined;
+type MultiplePropertyOptions<T> = T extends ReadonlyArray<unknown> ? {
+  lazyMultiple: true;
+} | {
+  multiple: true;
+} : unknown;
+type OptionDefinition<T> = MultiplePropertyOptions<T> & Omit<OptionDefinition$1, "type|defaultValue"> & {
+  /**
+  * A string or array of strings indicating the conflicting option(s).
+  * Note: The default value for an option does not cause a conflict.
+  */
+  conflicts?: string[] | string;
+  /** An initial value for the option. */
+  defaultValue?: T;
+  /** A string describing the option. */
+  description?: string;
+  /** Option is hidden from help */
+  hidden?: boolean;
+  implies?: Record<string, unknown>; /** Specifies whether the variable is required. */
+  required?: boolean;
+  /**
+  * A setter function (you receive the output from this) enabling you to be specific about the type and value received. Typical values
+  * are `String`, `Number` and `Boolean` but you can use a custom function.
+  */
+  type?: TypeConstructor<T>;
+  /** A string to replace the default type string (e.g. &lt;string>). It's often more useful to set a more descriptive type label, like &lt;ms>, &lt;files>, &lt;command>, etc.. */
+  typeLabel?: string;
+};
+type ArgumentDefinition<T = unknown> = Omit<OptionDefinition<T>, "multiple|lazyMultiple|defaultOption|alias|group|defaultValue">;
+/**
+* Environment variable definition for commands.
+* Used to document and provide type-safe access to environment variables a command supports.
+* @template T The type of the environment variable value
+*/
+interface EnvDefinition<T = string> {
+  /** Default value if the environment variable is not set */
+  defaultValue?: T;
+  /** A description of what the environment variable does */
+  description?: string;
+  /** Environment variable is hidden from help */
+  hidden?: boolean;
+  /** The name of the environment variable */
+  name: string;
+  /**
+  * A transform function to convert the string environment variable value to the desired type.
+  * Typical values are `String`, `Number`, `Boolean` or custom functions.
+  * The function receives `string | undefined` and should return the transformed value.
+  */
+  type?: EnvTypeConstructor<T>;
+  /** A string to replace the default type string (e.g. &lt;string>). Useful for more descriptive type labels. */
+  typeLabel?: string;
+}
+/**
+* Command interface with type-safe options and environment variables.
+* @template O - The option definition type
+* @template TContext - The toolbox context type (allows custom typing for better autocomplete)
+* @example
+* ```typescript
+* // Define your options type for autocomplete
+* type BuildOptions = {
+*   output?: string;
+*   production?: boolean;
+*   watch?: boolean;
+* };
+*
+* type BuildEnv = {
+*   apiKey?: string;
+*   debug?: boolean;
+* };
+*
+* cli.addCommand({
+*   name: "build",
+*   options: [
+*     { name: "output", type: String, alias: "o" },
+*     { name: "production", type: Boolean },
+*     { name: "watch", type: Boolean }
+*   ],
+*   env: [
+*     { name: "API_KEY", type: String },
+*     { name: "DEBUG", type: Boolean }
+*   ],
+*   execute: ({ options, env }: Toolbox<Console, BuildOptions, BuildEnv>) => {
+*     // Full autocomplete on options and env!
+*     console.log(options.output, options.production, env.apiKey);
+*   }
+* });
+* ```
+*/
+/**
+* Handler signature for commands. Used by both `execute` and the resolved default export of `loader`.
+*/
+type CommandExecute<TContext> = ((toolbox: TContext) => Promise<void>) | ((toolbox: TContext) => void);
+/**
+* Module shape returned by a command `loader`. The default export is the command handler.
+*/
+interface LazyCommandModule<TContext> {
+  default: CommandExecute<TContext>;
+}
+interface Command<O extends OptionDefinition<unknown> = OptionDefinition<unknown>, TLogger extends Console = Console, TContext extends Toolbox<TLogger> = Toolbox<TLogger>> {
+  /** Potential other names for this command */
+  alias?: string[] | string;
+  /** Positional argument */
+  argument?: ArgumentDefinition;
+  /** The command path, an array that describes how to get to this command */
+  commandPath?: string[];
+  /** A tweet-sized summary of your command */
+  description?: string;
+  /** Environment variables supported by this command */
+  env?: (EnvDefinition<boolean> | EnvDefinition<number> | EnvDefinition)[];
+  /** The full command examples, can be multiple lines */
+  examples?: string[] | string[][];
+  /**
+  * The function for running your command, can be async.
+  * Either `execute` or `loader` must be provided (but not both).
+  */
+  execute?: CommandExecute<TContext>;
+  /** The path to the file name for this command. */
+  file?: string;
+  /** Group commands together under a heading */
+  group?: string;
+  /** Should your command be shown in the listings  */
+  hidden?: boolean;
+  /**
+  * Lazily loads the command handler on first execution. The module's default export is used as the handler.
+  * Either `execute` or `loader` must be provided (but not both).
+  * Help, completion, and validation work from the metadata declared on this object and never trigger the loader.
+  * @example
+  * ```typescript
+  * cli.addCommand({
+  *   name: "build",
+  *   description: "Build the project",
+  *   options: [{ name: "output", type: String }],
+  *   loader: () => import("./commands/build"),
+  * });
+  *
+  * // commands/build.ts
+  * export default ({ options }) => { ... };
+  * ```
+  */
+  loader?: () => Promise<LazyCommandModule<TContext>>;
+  /** The name of your command */
+  name: string;
+  options?: (O | OptionDefinition<boolean[]> | OptionDefinition<boolean> | OptionDefinition<number[]> | OptionDefinition<number> | OptionDefinition<string[]> | OptionDefinition<string>)[];
+  usage?: Content[];
+}
+type CommandSection = {
+  footer?: string;
+  header?: string;
+};
+type CliRunOptions = {
+  [key: string]: unknown;
+  /**
+  * Whether to automatically dispose/cleanup the CLI instance after execution
+  * @default true
+  */
+  autoDispose?: boolean;
+  shouldExitProcess?: boolean;
+};
+type RunCommandOptions = {
+  /**
+  * Extra options to merge into the command's options.
+  * These will be merged with the command's default options and parsed arguments.
+  * Use this to override or add additional options programmatically.
+  * @default Empty object
+  */
+  [key: string]: unknown;
+  /**
+  * Command-line arguments to pass to the command.
+  * If not provided, uses the default argv from the CLI instance.
+  * These arguments will be parsed and merged with the command's options.
+  * @default Empty array
+  */
+  argv?: string[];
+};
+interface Cli<T extends Console> {
+  /**
+  * Add an arbitrary command to the CLI.
+  * @param command The command to add.
+  * @returns self
+  */
+  addCommand: <OD extends OptionDefinition<unknown> = OptionDefinition<unknown>>(command: Command<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.
+  * @returns self
+  */
+  addPlugin: (plugin: Plugin<T>) => this;
+  /**
+  * Disposes the CLI instance and cleans up resources
+  * @returns void
+  */
+  dispose: () => void;
+  getCliName: () => string;
+  getCommands: () => Map<string, Command<OptionDefinition<unknown>, T>>;
+  getCommandSection: () => CommandSection;
+  getCwd: () => string;
+  /**
+  * Gets all global options (built-in + custom).
+  */
+  getGlobalOptions: () => OptionDefinition<unknown>[];
+  getPackageName: () => string | undefined;
+  getPackageVersion: () => string | undefined;
+  /**
+  * Get the plugin manager instance
+  * @returns The plugin manager
+  */
+  getPluginManager: () => PluginManager<T>;
+  run: (extraOptions?: CliRunOptions) => Promise<void>;
+  /**
+  * Runs a command programmatically from within another command.
+  * This allows commands to call other commands during execution.
+  * @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 (or void if command doesn't return a value)
+  * @throws {Error} If the specified command doesn't exist or command arguments are invalid
+  * @example
+  * ```typescript
+  * cli.addCommand({
+  *   name: 'deploy',
+  *   execute: async ({ runtime, logger }) => {
+  *     logger.info('Building...');
+  *     const buildResult = await runtime.runCommand('build', { argv: ['--production'] });
+  *     // buildResult is the return value from the build command's execute function
+  *
+  *     logger.info('Testing...');
+  *     await runtime.runCommand('test', { argv: ['--coverage'] });
+  *   }
+  * });
+  * ```
+  */
+  runCommand: (commandName: string, options?: RunCommandOptions) => Promise<unknown>;
+  setCommandSection: (commandSection: CommandSection) => this;
+  /**
+  * Set a default command, to display a different command if cli is call without command.
+  * @param commandName
+  * @returns self
+  */
+  setDefaultCommand: (commandName: string) => this;
+}
+/**
+* Any of the output types [[OUTPUT_NORMAL]], [[OUTPUT_RAW]] and [[OUTPUT_PLAIN]].
+*/
+type OutputType = 1 | 2 | 4;
+/**
+* Any of the verbosity types
+* [[VERBOSITY_QUIET]], [[VERBOSITY_NORMAL]], [[VERBOSITY_VERBOSE]] and [[VERBOSITY_DEBUG]].
+*/
+type VERBOSITY_LEVEL = 16 | 32 | 64 | 128 | 256;
+/**
+* Context provided to plugins during initialization
+*/
+interface PluginContext<T extends Console = Console> {
+  /** The CLI instance */
+  cli: Cli<T>;
+  /** Current working directory */
+  cwd: string;
+  /** Logger instance */
+  logger: T;
+}
+/**
+* Plugin interface with lifecycle hooks
+*/
+interface Plugin<T extends Console = Console> {
+  /**
+  * Called after command execution completes successfully
+  * @param toolbox The command toolbox
+  * @param result The result returned by the command
+  */
+  afterCommand?: (toolbox: Toolbox<T>, result: unknown) => Promise<void> | void;
+  /**
+  * Called before command execution
+  * @param toolbox The command toolbox
+  */
+  beforeCommand?: (toolbox: Toolbox<T>) => Promise<void> | void;
+  /** Plugin dependencies (other plugin names that must be loaded first) */
+  dependencies?: string[];
+  /** Plugin description */
+  description?: string;
+  /**
+  * Called during command execution (for plugins that extend toolbox functionality)
+  * @param toolbox The command toolbox
+  */
+  execute?: (toolbox: Toolbox<T>) => Promise<void> | void;
+  /**
+  * Called once during plugin initialization
+  * @param context The plugin context
+  */
+  init?: (context: PluginContext<T>) => Promise<void> | void;
+  /** Plugin name (must be unique) */
+  name: string;
+  /**
+  * Called when an error occurs during command execution
+  * @param error The error that occurred
+  * @param toolbox The command toolbox
+  */
+  onError?: (error: Error, toolbox: Toolbox<T>) => Promise<void> | void;
+  /** Plugin version */
+  version?: string;
+}
+type Logger = Console;
+/**
+* Manages plugin lifecycle and execution
+*/
+declare class PluginManager<T extends Logger = Logger> {
+  private readonly logger;
+  private readonly plugins;
+  private initialized;
+  private cachedDependencyOrder;
+  constructor(logger: T);
+  /**
+  * Checks if any plugins are registered.
+  * @returns True if at least one plugin is registered
+  */
+  hasPlugins(): boolean;
+  /**
+  * Registers a plugin.
+  * @param plugin The plugin to register
+  * @throws {Error} If plugin name is already registered or dependencies are invalid
+  */
+  register(plugin: Plugin<T>): void;
+  /**
+  * Initializes all registered plugins.
+  * @param context The plugin context for initialization
+  */
+  init(context: PluginContext<T>): Promise<void>;
+  /**
+  * Executes a specific lifecycle hook for all plugins.
+  * @param hook The lifecycle hook name
+  * @param toolbox The command toolbox (for command-specific hooks)
+  * @param result The command result (for afterCommand hook)
+  */
+  executeLifecycle(hook: "beforeCommand" | "afterCommand" | "execute", toolbox: Toolbox<T>, result?: unknown): Promise<void>;
+  /**
+  * Executes error handlers for all plugins.
+  * @param error The error that occurred
+  * @param toolbox The command toolbox
+  */
+  executeErrorHandlers(error: Error, toolbox: Toolbox<T>): Promise<void>;
+  /**
+  * Gets all registered plugins in dependency order.
+  * @returns Array of plugins sorted by dependencies
+  */
+  getDependencyOrder(): Plugin<T>[];
+  /**
+  * Validates that all plugin dependencies exist.
+  * @throws {Error} If any dependencies are missing
+  */
+  private validateDependencies;
+}
+export { ArgumentDefinition as A, Command as C, EnvDefinition as E, LazyCommandModule as L, OptionDefinition as O, Plugin as P, RunCommandOptions as R, Toolbox as T, VERBOSITY_LEVEL as V, CommandSection as a, PluginManager as b, CliRunOptions as c, Cli as d, CommandExecute as e, OutputType as f, PluginContext as g };

package/dist/packem_shared/renderError-B_XyYPKJ-B65kP-Ou.js

@@ -0,0 +1,24 @@
+var Q=Object.defineProperty;var N=(r,e)=>Q(r,"name",{value:e,configurable:!0});import{createRequire as X}from"node:module";const Y=X(import.meta.url),S=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,Z=N(r=>{if(typeof S<"u"&&S.versions&&S.versions.node){const[e,t]=S.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return S.getBuiltinModule(r)}return Y(r)},"__cjs_getBuiltinModule"),{createRequire:ee}=Z("node:module");var re=Object.defineProperty,te=N((r,e)=>re(r,"name",{value:e,configurable:!0}),"A$2"),ie=Object.defineProperty,A=te((r,e)=>ie(r,"name",{value:e,configurable:!0}),"$"),ne=Object.defineProperty,oe=A((r,e)=>ne(r,"name",{value:e,configurable:!0}),"r$1");const se=oe(r=>r.replaceAll(/\r\n|\r(?!\n)|\n/gu,`
+`),"normalizeLF"),ae=globalThis.process??Object.create(null),P={versions:{}},T=new Proxy(ae,{get(r,e){if(e in r)return r[e];if(e in P)return P[e]}});var le=Object.defineProperty,ce=A((r,e)=>le(r,"name",{value:e,configurable:!0}),"b");const de=ce((r,e,t,i)=>{const s={column:0,line:-1,...r.start},o={...s,...r.end},n=s.line,l=s.column,d=o.line,c=o.column;let a=Math.max(n-(t+1),0),p=Math.min(e.length,d+i);n===-1&&(a=0),d===-1&&(p=e.length);const g=d-n,m={};if(g)for(let u=0;u<=g;u++){const $=u+n;if(!l)m[$]=!0;else if(u===0){const h=e[$-1]?.length;m[$]=[l,(h??0)-l+1]}else if(u===g)m[$]=[0,c];else{const h=e[$-u]?.length;m[$]=[0,h]}}else l===c?m[n]=l?[l,0]:!0:m[n]=[l,(c??0)-(l??0)];return{end:p,markerLines:m,start:a}},"getMarkerLines");var ue=Object.defineProperty,E=A((r,e)=>ue(r,"name",{value:e,configurable:!0}),"t");const fe=T.platform==="win32"&&!T.env?.WT_SESSION?">":"❯",me=E((r,e,t)=>{const i={linesAbove:2,linesBelow:3,prefix:"",showGutter:!0,tabWidth:4,...t,color:{gutter:E(u=>u,"gutter"),marker:E(u=>u,"marker"),message:E(u=>u,"message"),...t?.color}},s=typeof e.start.column=="number";let o=se(r).split(`
+`);typeof i.tabWidth=="number"&&(o=o.map(u=>u.replaceAll("	"," ".repeat(i.tabWidth))));const{end:n,markerLines:l,start:d}=de(e,o,i.linesAbove,i.linesBelow),c=String(n).length,{gutter:a,marker:p,message:g}=i.color;let m=o.slice(d,n).map((u,$)=>{const h=d+1+$,k=l[h],D=` ${String(h)}`.slice(-c),U=!l[h+1],j=` ${D}${i.showGutter?" |":""}`;if(k){let O="";if(Array.isArray(k)){const H=u.replaceAll(/[^\t]/g," ").slice(0,Math.max(k[0]-1,0)),K=k[1]||1;O=[`
+ `,i.prefix+a(j.replaceAll(/\d/g," "))," ",H,p("^").repeat(K)].join(""),U&&i.message&&(O+=` ${g(i.message)}`)}return[i.prefix+p(fe),a(j),u.length>0?` ${u}`:"",O].join("")}return`${i.prefix} ${a(j)}${u.length>0?` ${u}`:""}`}).join(`
+`);return i.message&&!s&&(m=`${i.prefix+" ".repeat(c+1)+i.message}
+${m}`),m},"codeFrame");var pe=Object.defineProperty,ve=N((r,e)=>pe(r,"name",{value:e,configurable:!0}),"x$1"),ge=Object.defineProperty,$e=ve((r,e)=>ge(r,"name",{value:e,configurable:!0}),"x"),he=Object.defineProperty,v=$e((r,e)=>he(r,"name",{value:e,configurable:!0}),"u");const b=v((r,...e)=>{process.env.DEBUG&&process.env.DEBUG==="true"&&console.debug(`error:parse-stacktrace: ${r}`,...e)},"debugLog"),y="<unknown>",be=/^.*?\s*at\s(?:(.+?\)(?:\s\[.+\])?|\(?.*?)\s?\((?:address\sat\s)?)?(?:async\s)?((?:<anonymous>|[-a-z]+:|.*bundle|\/)?.*?)(?::(\d+))?(?::(\d+))?\)?\s*$/i,ye=/\((\S+)\),\s(<[^>]+>)?:(\d+)?:(\d+)?\)?/,xe=/(.*?):(\d+):(\d+)(?:\s<-\s.+:\d+:\d+)?/,we=/eval\sat\s(<anonymous>)\s\((.*)\)?:(\d+)?:(\d+)\),\s*<anonymous>?:(\d+)?:(\d+)/,Ne=/^\s*in\s(?:([^\\/]+(?:\s\[as\s\S+\])?)\s\(?)?\(at?\s?(.*?):(\d+)(?::(\d+))?\)?\s*$/,Se=/in\s(.*)\s\(at\s(.+)\)\sat/,ke=/^(?:.*@)?(.*):(\d+):(\d+)$/,Ee=/^\s*(.*?)(?:\((.*?)\))?(?:^|@)?((?:[-a-z]+)?:\/.*?|\[native code\]|[^@]*(?:bundle|\d+\.js)|\/[\w\-. \/=]+)(?::(\d+))?(?::(\d+))?\s*$/i,je=/(\S+) line (\d+)(?: > eval line \d+)* > eval/i,Oe=/(\S[^\s[]*\[.*\]|.*?)@(.*):(\d+):(\d+)/,_=/\(error: (.*)\)/,Ae=/at\s/,Le=/^(\S+):(\d+):(\d+)$|^(\S+):(\d+)$/,Me=/^\s+|\s+$/g,Pe=/\S*(?:Error: |AggregateError:)/,C=/^Anonymous function$/,Te=/^\s*in\s.*/,_e=/^.*?\s*at\s.*/,Ce=/^.*?\s*@.*|\[native code\]/,B=v((r,e)=>{const t=r.includes("safari-extension"),i=r.includes("safari-web-extension");return t||i?[r.includes("@")?r.split("@")[0]:y,t?`safari-extension:${e}`:`safari-web-extension:${e}`]:[r,e]},"extractSafariExtensionDetails"),W=v((r,e)=>{const t=xe.exec(e);t&&(r.file=t[1],r.line=+t[2],r.column=+t[3])},"parseMapped"),Be=v(r=>{const e=Se.exec(r);if(e){b(`parse nested node error stack line: "${r}"`,`found: ${JSON.stringify(e)}`);const i=e[2].split(":");return{column:i[2]?+i[2]:void 0,file:i[0],line:i[1]?+i[1]:void 0,methodName:e[1]??y,raw:r,type:void 0}}const t=Ne.exec(r);if(t){b(`parse node error stack line: "${r}"`,`found: ${JSON.stringify(t)}`);const i={column:t[4]?+t[4]:void 0,file:t[2]?t[2].replace(Ae,""):void 0,line:t[3]?+t[3]:void 0,methodName:t[1]??y,raw:r,type:r.startsWith("internal")?"internal":void 0};return W(i,`${t[2]}:${t[3]}:${t[4]}`),i}},"parseNode"),We=v(r=>{const e=be.exec(r);if(e){b(`parse chrome error stack line: "${r}"`,`found: ${JSON.stringify(e)}`);const t=e[2]?.startsWith("native"),i=e[2]?.startsWith("eval")||e[1]?.startsWith("eval");let s,o;if(i){const c=ye.exec(r);if(c){const a=Le.exec(c[1]);a?(e[2]=a[4]??a[1],e[3]=a[5]??a[2],e[4]=a[3]):c[2]&&(e[2]=c[1]),c[2]&&(s={column:c[4]?+c[4]:void 0,file:c[2],line:c[3]?+c[3]:void 0,methodName:"eval",raw:r,type:"eval"})}else{const a=we.exec(r);a&&(o={column:a[4]?+a[4]:void 0,file:a[2],line:a[3]?+a[3]:void 0},s={column:a[6]?+a[6]:void 0,file:a[1],line:a[5]?+a[5]:void 0,methodName:"eval",raw:a[0],type:"eval"})}}const[n,l]=B(e[1]?e[1].replace(C,"<anonymous>"):y,e[2]),d={column:e[4]?+e[4]:void 0,evalOrigin:s,file:l,line:e[3]?+e[3]:void 0,methodName:n,raw:r,type:i?"eval":t?"native":void 0};return o?(d.column=o.column,d.file=o.file,d.line=o.line):W(d,`${l}:${e[3]}:${e[4]}`),d}},"parseChromium"),Ge=v((r,e)=>{const t=Ee.exec(r);if(t){b(`parse gecko error stack line: "${r}"`,`found: ${JSON.stringify(t)}`);const i=t[3]?.includes(" > eval"),s=i&&t[3]&&je.exec(t[3]);let o;i&&s&&(t[3]=s[1],o={column:t[5]?+t[5]:void 0,file:t[3],line:t[4]?+t[4]:void 0,methodName:"eval",raw:r,type:"eval"},t[4]=s[2]);const[n,l]=B(t[1]?t[1].replace(C,"<anonymous>"):y,t[3]);let d;(e?.type==="safari"||!i&&e?.type==="firefox")&&e.column?d=e.column:!i&&t[5]&&(d=+t[5]);let c;return(e?.type==="safari"||!i&&e?.type==="firefox")&&e.line?c=e.line:t[4]&&(c=+t[4]),{column:d,evalOrigin:o,file:l,line:c,methodName:n,raw:r,type:i?"eval":l.includes("[native code]")?"native":void 0}}},"parseGecko"),Re=v((r,e)=>{const t=Oe.exec(r);if(!(t&&t[2].includes(" > eval"))&&t)return b(`parse firefox error stack line: "${r}"`,`found: ${JSON.stringify(t)}`),{column:t[4]?+t[4]:e?.column??void 0,file:t[2],line:t[3]?+t[3]:e?.line??void 0,methodName:t[1]||y,raw:r,type:void 0}},"parseFirefox"),Fe=v(r=>{const e=ke.exec(r);if(e)return b(`parse react android native error stack line: "${r}"`,`found: ${JSON.stringify(e)}`),{column:e[3]?+e[3]:void 0,file:e[1],line:e[2]?+e[2]:void 0,methodName:y,raw:r,type:void 0}},"parseReactAndroidNative"),G=v((r,{filter:e,frameLimit:t=50}={})=>{const i=r;let s=(typeof i.stacktrace=="string"?i.stacktrace:r.stack??"").split(`
+`).map(o=>(_.test(o)?o.replace(_,"$1"):o).replaceAll(Me,"")).filter(o=>!Pe.test(o)&&o!=="eval code");return e&&(s=s.filter(o=>e(o))),s=s.slice(0,t),s.reduce((o,n,l)=>{if(!n||n.length>1024)return o;let d;if(Te.test(n))d=Be(n);else if(_e.test(n))d=We(n);else if(Ce.test(n)){let c;if(l===0){const a=r,p=a.columnNumber,g=a.lineNumber,m=a.line,u=a.column;p||g?c={column:p,line:g,type:"firefox"}:(m||u)&&(c={column:u,line:m,type:"safari"})}d=Re(n,c)??Ge(n,c)}else d=Fe(n);return d?o.push(d):b(`parse error stack line: "${n}"`,"not parser found"),o},[])},"parseStacktrace");var Ie=Object.defineProperty,Ve=N((r,e)=>Ie(r,"name",{value:e,configurable:!0}),"p"),Je=Object.defineProperty,R=Ve((r,e)=>Je(r,"name",{value:e,configurable:!0}),"m");const qe=ee(import.meta.url),x=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,L=R(r=>{if(typeof x<"u"&&x.versions&&x.versions.node){const[e,t]=x.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return x.getBuiltinModule(r)}return qe(r)},"__cjs_getBuiltinModule"),{existsSync:ze,readFileSync:De}=L("node:fs"),{relative:Ue}=L("node:path"),{cwd:He}=x,{fileURLToPath:Ke}=L("node:url");var Qe=Object.defineProperty,f=R((r,e)=>Qe(r,"name",{value:e,configurable:!0}),"o");const w=f((r,e,t)=>t===0?r:e==="	"?r+"	".repeat(t):r+" ".repeat(e*t),"getPrefix"),Xe=f((r,e)=>{const t=r.replace("async file:","file:");return Ue(e,t.startsWith("file:")?Ke(t):t)},"getRelativePath"),Ye=f((r,e,t)=>{if(e)return t.title(r.message);const i=r.message?`: ${r.message}`:"";return t.title(r.name+i)},"getTitleText"),F=f((r,{color:e,hideErrorTitle:t,indentation:i,prefix:s},o)=>`${w(s,i,o)}${Ye(r,t,e)}
+`,"getMessage"),I=f((r,{color:e,indentation:t,prefix:i},s)=>{if(r.hint===void 0)return;const o=w(i,t,s);let n="";if(Array.isArray(r.hint))for(const l of r.hint)n+=`${o+l}
+`;else n+=o+r.hint;return e.hint(n)},"getHint"),M=f((r,{color:e,cwd:t,displayShortPath:i,indentation:s,prefix:o},n=0)=>{const l=i?Xe(r.file,t):r.file,{fileLine:d,method:c}=e;return`${w(o,s,n)}at ${r.methodName?`${c(r.methodName)} `:""}${d(l)}:${d(r.line?.toString()??"")}`},"getMainFrame"),V=f((r,{color:e,indentation:t,linesAbove:i,linesBelow:s,prefix:o,showGutter:n,showLineNumbers:l,tabWidth:d},c)=>{if(r.file===void 0)return;const a=r.file.replace("file://","");if(!ze(a))return;const p=De(a,"utf8");return me(p,{start:{column:r.column,line:r.line}},{color:e,linesAbove:i,linesBelow:s,prefix:w(o,t,c),showGutter:n,showLineNumbers:l,tabWidth:d})},"getCode"),J=f((r,e,t)=>{if(r.errors.length===0)return;let i=`${w(e.prefix,e.indentation,t)}Errors:
+
+`,s=!0;for(const o of r.errors)s?s=!1:i+=`
+
+`,i+=z(o,{...e,framesMaxLimit:1,hideErrorCodeView:e.hideErrorErrorsCodeView},t+1);return`
+${i}`},"getErrors"),q=f((r,e,t)=>{let i=`${w(e.prefix,e.indentation,t)}Caused by:
+
+`;const s=r.cause;i+=F(s,e,t);const o=G(s).shift(),n=I(s,e,t);if(n&&(i+=`${n}
+`),o&&(i+=M(o,e,t),!e.hideErrorCauseCodeView)){const l=V(o,e,t);l!==void 0&&(i+=`
+${l}`)}if(s.cause)i+=`
+${q(s,e,t+1)}`;else if(s instanceof AggregateError){const l=J(s,e,t);l!==void 0&&(i+=`
+${l}`)}return`
+${i}`},"getCause"),Ze=f((r,e)=>(r.length>0?`
+`:"")+r.map(t=>M(t,e)).join(`
+`),"getStacktrace"),z=f((r,e,t)=>{const i={cwd:He(),displayShortPath:!1,filterStacktrace:void 0,framesMaxLimit:Number.POSITIVE_INFINITY,hideErrorCauseCodeView:!1,hideErrorCodeView:!1,hideErrorErrorsCodeView:!1,hideErrorTitle:!1,hideMessage:!1,indentation:4,linesAbove:2,linesBelow:3,prefix:"",showGutter:!0,showLineNumbers:!0,tabWidth:4,...e,color:{fileLine:f(n=>n,"fileLine"),gutter:f(n=>n,"gutter"),hint:f(n=>n,"hint"),marker:f(n=>n,"marker"),message:f(n=>n,"message"),method:f(n=>n,"method"),title:f(n=>n,"title"),...e.color}},s=G(r,{filter:e.filterStacktrace,frameLimit:i.framesMaxLimit}),o=s.shift();return[e.hideMessage?void 0:F(r,i,t),I(r,i,t),o?M(o,i,t):void 0,o&&!i.hideErrorCodeView?V(o,i,t):void 0,r instanceof AggregateError?J(r,i,t):void 0,r.cause===void 0?void 0:q(r,i,t),s.length>0?Ze(s,i):void 0].filter(Boolean).join(`
+`).replaceAll("\\","/")},"internalRenderError"),tr=f((r,e={})=>{if(e.framesMaxLimit!==void 0&&e.framesMaxLimit<=0)throw new RangeError("The 'framesMaxLimit' option must be a positive number");return z(r,e,0)},"renderError");export{tr as G,me as N,G as Q,fe as k};

package/dist/packem_shared/{runtime-process-G-n-wOub.js → runtime-process-DKHFvYkv.js}

@@ -1 +1 @@
-var a=Object.defineProperty;var l=(e,s)=>a(e,"name",{value:s,configurable:!0});var g=Object.defineProperty,r=l((e,s)=>g(e,"name",{value:s,configurable:!0}),"r");const t=r(e=>"Deno"in e,"hasDeno"),i=r(e=>"Bun"in e,"hasBun"),h=r(()=>{if(t(globalThis)){const e=globalThis.Deno,s=e.execPath();let o=s;try{const{importMeta:n}=globalThis;n?.url&&(o=n.url)}catch{}return[s,o,...e.args]}return i(globalThis)?globalThis.Bun.process.argv:process.argv},"getArgv"),b=r(()=>t(globalThis)?globalThis.Deno.cwd():i(globalThis)?globalThis.Bun.process.cwd():process.cwd(),"getCwd"),u=r(()=>{if(t(globalThis)){const e=globalThis.Deno;return new Proxy(e.env.toObject(),{get:r((s,o)=>typeof o=="string"?e.env.get(o):s[o],"get"),has:r((s,o)=>typeof o=="string"?e.env.has(o):o in s,"has"),set:r((s,o,n)=>typeof o=="string"?(n===void 0||e.env.set(o,n),!0):!1,"set")})}return i(globalThis)?globalThis.Bun.process.env:process.env},"getEnv"),T=r(()=>t(globalThis)?[]:i(globalThis)?globalThis.Bun.process.execArgv:process.execArgv,"getExecArgv"),v=r(()=>t(globalThis)?globalThis.Deno.execPath():i(globalThis)?globalThis.Bun.process.execPath:process.execPath,"getExecPath"),p=r(()=>{if(t(globalThis)){const e=globalThis.Deno.build?.os??"unknown";return e==="windows"?"win32":e}return i(globalThis)?globalThis.Bun.platform??"unknown":process.platform},"getPlatform"),f=r(()=>{if(t(globalThis)){const e=globalThis.Deno.build?.arch??"unknown";return e==="x86_64"?"x64":e==="aarch64"?"arm64":e}return i(globalThis)?globalThis.Bun.process.arch:process.arch},"getArch"),x=r(()=>{if(t(globalThis)){const e=globalThis.Deno,s={};return e.version?.deno&&(s.deno=e.version.deno),e.version?.v8&&(s.v8=e.version.v8),e.version?.typescript&&(s.typescript=e.version.typescript),s}if(i(globalThis)){const e=globalThis.Bun,s={...e.process.versions};return e.version&&(s.bun=e.version),s}return process.versions},"getVersions"),d=r((e=0)=>{if(t(globalThis))throw globalThis.Deno.exit(e),new Error("Deno exit failed");if(i(globalThis))throw globalThis.Bun.process.exit(e),new Error("Bun exit failed");process.exit(e)},"exitProcess"),w=r((e,s)=>{if(t(globalThis))return()=>{};if(i(globalThis)){try{const n=globalThis.Bun;if(n.process?.on)return n.process.on(e,s),()=>{n.process?.removeListener&&n.process.removeListener(e,s)}}catch{}return()=>{}}const o=process;return o.on(e,s),()=>{o.removeListener(e,s)}},"onProcessEvent");export{b as a,p as b,f as c,u as d,d as e,h as f,x as g,v as h,T as i,w as o};
+var a=Object.defineProperty;var l=(e,s)=>a(e,"name",{value:s,configurable:!0});var g=Object.defineProperty,r=l((e,s)=>g(e,"name",{value:s,configurable:!0}),"r");const t=r(e=>"Deno"in e,"hasDeno"),i=r(e=>"Bun"in e,"hasBun"),h=r(()=>{if(t(globalThis)){const e=globalThis.Deno,s=e.execPath();let o=s;try{const{importMeta:n}=globalThis;n?.url&&(o=n.url)}catch{}return[s,o,...e.args]}return i(globalThis)?globalThis.Bun.process.argv:process.argv},"getArgv"),b=r(()=>t(globalThis)?globalThis.Deno.cwd():i(globalThis)?globalThis.Bun.process.cwd():process.cwd(),"getCwd"),u=r(()=>{if(t(globalThis)){const e=globalThis.Deno;return new Proxy(e.env.toObject(),{get:r((s,o)=>typeof o=="string"?e.env.get(o):s[o],"get"),has:r((s,o)=>typeof o=="string"?e.env.has(o):o in s,"has"),set:r((s,o,n)=>typeof o=="string"?(n===void 0||e.env.set(o,n),!0):!1,"set")})}return i(globalThis)?globalThis.Bun.process.env:process.env},"getEnv"),T=r(()=>t(globalThis)?[]:i(globalThis)?globalThis.Bun.process.execArgv:process.execArgv,"getExecArgv"),v=r(()=>t(globalThis)?globalThis.Deno.execPath():i(globalThis)?globalThis.Bun.process.execPath:process.execPath,"getExecPath"),p=r(()=>{if(t(globalThis)){const e=globalThis.Deno.build?.os??"unknown";return e==="windows"?"win32":e}return i(globalThis)?globalThis.Bun.platform??"unknown":process.platform},"getPlatform"),f=r(()=>{if(t(globalThis)){const e=globalThis.Deno.build?.arch??"unknown";return e==="x86_64"?"x64":e==="aarch64"?"arm64":e}return i(globalThis)?globalThis.Bun.process.arch:process.arch},"getArch"),x=r(()=>{if(t(globalThis)){const e=globalThis.Deno,s={};return e.version?.deno&&(s.deno=e.version.deno),e.version?.v8&&(s.v8=e.version.v8),e.version?.typescript&&(s.typescript=e.version.typescript),s}if(i(globalThis)){const e=globalThis.Bun,s={...e.process.versions};return e.version&&(s.bun=e.version),s}return process.versions},"getVersions"),d=r((e=0)=>{if(t(globalThis))throw globalThis.Deno.exit(e),new Error("Deno exit failed");if(i(globalThis))throw globalThis.Bun.process.exit(e),new Error("Bun exit failed");process.exit(e)},"exitProcess"),w=r((e,s)=>{if(t(globalThis))return()=>{};if(i(globalThis)){try{const n=globalThis.Bun;if(n.process?.on)return n.process.on(e,s),()=>{n.process?.removeListener&&n.process.removeListener(e,s)}}catch{}return()=>{}}const o=process;return o.on(e,s),()=>{o.removeListener(e,s)}},"onProcessEvent");export{b as a,p as b,f as c,u as d,d as e,T as f,x as g,h,v as i,w as o};

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-Dz-wu1tI.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-B_XyYPKJ-B65kP-Ou.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};