@jakubmazanec/cli 0.2.1-unstable.f940d9d → 0.3.0-next.6fd9f2b

package/README.md

@@ -19,7 +19,7 @@ It cannot be required from a CommonJS module.
 
 #### Prerequisites
 
-- Node.js 16 or later
+- Node.js 20 or later
 - TypeScript 5 or later
 
 ## Usage

package/build/constants.js

@@ -0,0 +1,8 @@
+"use strict";
+import path from "node:path";
+import url from "node:url";
+let directory = path.dirname(url.fileURLToPath(import.meta.url));
+export const PACKAGE_PATH = path.resolve(directory, "..");
+export const CACHE_PATH = path.resolve(PACKAGE_PATH, "node_modules/.cache");
+export const DELIMITER = "$ ";
+//# sourceMappingURL=constants.js.map

package/build/constants.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../source/constants.ts"],
+  "sourcesContent": ["import path from 'node:path';\nimport url from 'node:url';\n\nlet directory = path.dirname(url.fileURLToPath(import.meta.url));\n\nexport const PACKAGE_PATH = path.resolve(directory, '..');\nexport const CACHE_PATH = path.resolve(PACKAGE_PATH, 'node_modules/.cache');\n\nexport const DELIMITER = '$ ';\n"],
+  "mappings": ";AAAA,OAAO,UAAU;AACjB,OAAO,SAAS;AAEhB,IAAI,YAAY,KAAK,QAAQ,IAAI,cAAc,YAAY,GAAG,CAAC;AAExD,aAAM,eAAe,KAAK,QAAQ,WAAW,IAAI;AACjD,aAAM,aAAa,KAAK,QAAQ,cAAc,qBAAqB;AAEnE,aAAM,YAAY;",
+  "names": []
+}

package/build/main.js

@@ -0,0 +1,4 @@
+"use strict";
+export * from "./program.js";
+export * from "./ui.js";
+//# sourceMappingURL=main.js.map

package/build/main.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../source/main.ts"],
+  "sourcesContent": ["export * from './program.js';\nexport * from './ui.js';\n"],
+  "mappings": ";AAAA,cAAc;AACd,cAAc;",
+  "names": []
+}

package/{dist → build}/program/Command.d.ts

@@ -1,4 +1,4 @@
-import { type Argv, type OptionsConfig, type ParametersConfig, type Arguments } from '@jakubmazanec/args';
+import { type Arguments, type Argv, type OptionsConfig, type ParametersConfig } from '@jakubmazanec/args';
 import { type CommandAction } from './CommandAction.js';
 import { type CommandOptions } from './CommandOptions.js';
 import { type Program } from './Program.js';

package/build/program/Command.js

@@ -0,0 +1,70 @@
+"use strict";
+import {
+  parseArguments
+} from "@jakubmazanec/args";
+export class Command {
+  name;
+  description;
+  parameters;
+  options;
+  allowUnknownOptions;
+  allowUnknownParameters;
+  action;
+  /**
+   * @param name Command name, ie. space-separated words consisting only of letters, numbers (but not at the start of the word) or dashes.
+   * @param action Function that runs when command is executed.
+   * @param options Additionl command options.
+   */
+  constructor(name, action, {
+    description,
+    parameters,
+    options,
+    allowUnknownOptions,
+    allowUnknownParameters
+  }) {
+    this.name = name;
+    this.action = action;
+    if (description) {
+      this.description = description;
+    }
+    if (parameters) {
+      this.parameters = parameters;
+    } else {
+      this.parameters = null;
+    }
+    if (options) {
+      this.options = options;
+    } else {
+      this.options = null;
+    }
+    if (allowUnknownOptions) {
+      this.allowUnknownOptions = allowUnknownOptions;
+    } else {
+      this.allowUnknownOptions = false;
+    }
+    if (allowUnknownParameters) {
+      this.allowUnknownParameters = allowUnknownParameters;
+    } else {
+      this.allowUnknownParameters = false;
+    }
+  }
+  /**
+   * Parses a list of command line arguments into an arguments object. Parser is pre-configured based on this command.
+   */
+  parseArguments(argv) {
+    return parseArguments(argv, {
+      commands: [this.name],
+      parameters: this.parameters ?? void 0,
+      options: this.options ?? void 0,
+      allowUnknownOptions: this.allowUnknownOptions,
+      allowUnknownParameters: this.allowUnknownParameters
+    });
+  }
+  /**
+   * Executes command action with provided parsed arguments and {@link Program} instance.
+   */
+  async run(parsedArgs, program) {
+    await this.action(parsedArgs, program);
+  }
+}
+//# sourceMappingURL=Command.js.map

package/build/program/Command.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/program/Command.ts"],
+  "sourcesContent": ["import {\n  type Arguments,\n  type Argv,\n  type OptionsConfig,\n  type ParametersConfig,\n  parseArguments,\n} from '@jakubmazanec/args';\n\nimport {type CommandAction} from './CommandAction.js';\nimport {type CommandOptions} from './CommandOptions.js';\nimport {type Program} from './Program.js';\n\n/**\n * Command encapsulates piece of a CLI's logic and is executed when {@link Program} instance parses that command from the command line arguments.\n */\nexport class Command<\n  A extends string,\n  const B extends ParametersConfig | undefined = undefined,\n  const C extends OptionsConfig | undefined = undefined,\n  D extends boolean = false,\n  E extends boolean = false,\n> {\n  readonly name: A;\n  readonly description?: string;\n  readonly parameters: B extends ParametersConfig ? B : null;\n  readonly options: C extends OptionsConfig ? C : null;\n  readonly allowUnknownOptions: D;\n  readonly allowUnknownParameters: E;\n  private readonly action: CommandAction<A, B, C, D, E>;\n\n  /**\n   * @param name Command name, ie. space-separated words consisting only of letters, numbers (but not at the start of the word) or dashes.\n   * @param action Function that runs when command is executed.\n   * @param options Additionl command options.\n   */\n  constructor(\n    name: A,\n    action: CommandAction<A, B, C, D, E>,\n    {\n      description,\n      parameters,\n      options,\n      allowUnknownOptions,\n      allowUnknownParameters,\n    }: CommandOptions<NonNullable<B>, NonNullable<C>, D, E>,\n  ) {\n    this.name = name;\n    this.action = action;\n\n    if (description) {\n      this.description = description;\n    }\n\n    if (parameters) {\n      this.parameters = parameters as B extends ParametersConfig ? B : null;\n    } else {\n      this.parameters = null as B extends ParametersConfig ? B : null;\n    }\n\n    if (options) {\n      this.options = options as C extends OptionsConfig ? C : null;\n    } else {\n      this.options = null as C extends OptionsConfig ? C : null;\n    }\n\n    if (allowUnknownOptions) {\n      this.allowUnknownOptions = allowUnknownOptions;\n    } else {\n      this.allowUnknownOptions = false as D;\n    }\n\n    if (allowUnknownParameters) {\n      this.allowUnknownParameters = allowUnknownParameters;\n    } else {\n      this.allowUnknownParameters = false as E;\n    }\n  }\n\n  /**\n   * Parses a list of command line arguments into an arguments object. Parser is pre-configured based on this command.\n   */\n  parseArguments(argv: Argv): Arguments<{\n    commands: readonly [A];\n    parameters: B;\n    options: C;\n    allowUnknownOptions: D;\n    allowUnknownParameters: E;\n  }> {\n    return parseArguments(argv, {\n      commands: [this.name],\n      parameters: this.parameters ?? undefined,\n      options: this.options ?? undefined,\n      allowUnknownOptions: this.allowUnknownOptions,\n      allowUnknownParameters: this.allowUnknownParameters,\n    } as {\n      commands: readonly [A];\n      parameters: B;\n      options: C;\n      allowUnknownOptions: D;\n      allowUnknownParameters: E;\n    });\n  }\n\n  /**\n   * Executes command action with provided parsed arguments and {@link Program} instance.\n   */\n  async run(\n    parsedArgs: Arguments<{\n      commands: readonly [A];\n      parameters: B;\n      options: C;\n      allowUnknownOptions: D;\n      allowUnknownParameters: E;\n    }>,\n    program: Program,\n  ): Promise<void> {\n    await this.action(parsedArgs, program);\n  }\n}\n"],
+  "mappings": ";AAAA;AAAA,EAKE;AAAA,OACK;AASA,aAAM,QAMX;AAAA,EACS;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOjB,YACE,MACA,QACA;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GACA;AACA,SAAK,OAAO;AACZ,SAAK,SAAS;AAEd,QAAI,aAAa;AACf,WAAK,cAAc;AAAA,IACrB;AAEA,QAAI,YAAY;AACd,WAAK,aAAa;AAAA,IACpB,OAAO;AACL,WAAK,aAAa;AAAA,IACpB;AAEA,QAAI,SAAS;AACX,WAAK,UAAU;AAAA,IACjB,OAAO;AACL,WAAK,UAAU;AAAA,IACjB;AAEA,QAAI,qBAAqB;AACvB,WAAK,sBAAsB;AAAA,IAC7B,OAAO;AACL,WAAK,sBAAsB;AAAA,IAC7B;AAEA,QAAI,wBAAwB;AAC1B,WAAK,yBAAyB;AAAA,IAChC,OAAO;AACL,WAAK,yBAAyB;AAAA,IAChC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,MAMZ;AACD,WAAO,eAAe,MAAM;AAAA,MAC1B,UAAU,CAAC,KAAK,IAAI;AAAA,MACpB,YAAY,KAAK,cAAc;AAAA,MAC/B,SAAS,KAAK,WAAW;AAAA,MACzB,qBAAqB,KAAK;AAAA,MAC1B,wBAAwB,KAAK;AAAA,IAC/B,CAMC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,IACJ,YAOA,SACe;AACf,UAAM,KAAK,OAAO,YAAY,OAAO;AAAA,EACvC;AACF;",
+  "names": []
+}

package/{dist → build}/program/CommandAction.d.ts

@@ -1,4 +1,4 @@
-import { type OptionsConfig, type ParametersConfig, type Arguments } from '@jakubmazanec/args';
+import { type Arguments, type OptionsConfig, type ParametersConfig } from '@jakubmazanec/args';
 import { type Program } from './Program.js';
 /**
  * Command action.

package/build/program/CommandAction.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=CommandAction.js.map

package/build/program/CommandAction.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/program/CommandArguments.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=CommandArguments.js.map

package/build/program/CommandArguments.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/program/CommandOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=CommandOptions.js.map

package/build/program/CommandOptions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/{dist → build}/program/Program.d.ts

@@ -1,4 +1,4 @@
-import { type ParametersConfig, type Argv, type OptionsConfig } from '@jakubmazanec/args';
+import { type Argv, type OptionsConfig, type ParametersConfig } from '@jakubmazanec/args';
 import { type ComponentType } from 'react';
 import { type FallbackProps } from 'react-error-boundary';
 import { type Command } from './Command.js';

package/build/program/Program.js

@@ -0,0 +1,191 @@
+"use strict";
+import fs from "fs-extra";
+import fetchLatestVersion from "latest-version";
+import path from "path";
+import { CACHE_PATH } from "../constants.js";
+import { Failure, Help } from "../ui.js";
+import { Wrapper } from "../ui/internals.js";
+import { ProgramError } from "./ProgramError.js";
+export class Program {
+  /** Program name. */
+  name;
+  /** More readable program name. */
+  displayName;
+  /** Program version. */
+  version;
+  /** Program latest version. */
+  latestVersion;
+  /** Program description. */
+  description;
+  /** Program executable name. */
+  bin;
+  /** Program commands */
+  commands = [];
+  isRendering = false;
+  streams = {
+    stderr: process.stderr,
+    stdin: process.stdin,
+    stdout: process.stdout
+  };
+  /** Custom error boundary fallback component */
+  ErrorBoundaryFallbackComponent;
+  constructor({
+    name,
+    displayName,
+    version,
+    latestVersion,
+    description,
+    bin,
+    ErrorBoundaryFallbackComponent
+  }) {
+    if (name) {
+      this.name = name;
+    }
+    if (displayName) {
+      this.displayName = displayName;
+    }
+    if (version) {
+      this.version = version;
+    }
+    if (latestVersion) {
+      this.latestVersion = latestVersion;
+    }
+    if (description) {
+      this.description = description;
+    }
+    if (bin) {
+      this.bin = bin;
+    }
+    if (ErrorBoundaryFallbackComponent) {
+      this.ErrorBoundaryFallbackComponent = ErrorBoundaryFallbackComponent;
+    } else {
+      this.ErrorBoundaryFallbackComponent = Failure;
+    }
+  }
+  static async create({
+    name,
+    version,
+    description,
+    bin,
+    ErrorBoundaryFallbackComponent,
+    checkForUpdate
+  }) {
+    let latestVersion;
+    if (checkForUpdate && name) {
+      let cachePath = path.join(CACHE_PATH, name, "latest-version.json");
+      let cachedLatestVersion;
+      try {
+        cachedLatestVersion = await fs.readJson(cachePath);
+      } catch {
+      }
+      if (!cachedLatestVersion || Date.now() - cachedLatestVersion.datetime > 864e4) {
+        latestVersion = await fetchLatestVersion(name);
+        await fs.ensureFile(cachePath);
+        await fs.writeJson(cachePath, {
+          value: latestVersion,
+          datetime: Date.now()
+        });
+      }
+    }
+    return new this({
+      name,
+      version,
+      latestVersion,
+      description,
+      bin,
+      ErrorBoundaryFallbackComponent
+    });
+  }
+  /**
+   * Adds command to the program.
+   *
+   * @param command Command to add.
+   * @returns Program instance.
+   */
+  addCommand(command) {
+    this.commands.push(command);
+    return this;
+  }
+  /**
+   * Renders a React element using Ink and outputs to the configured streams.
+   *
+   * @param element The React element to render.
+   */
+  async renderElement(element) {
+    if (this.isRendering) {
+      throw new ProgramError("NO_NESTED_RENDER");
+    } else {
+      this.isRendering = true;
+    }
+    let { render } = await import("ink");
+    let { createElement } = await import("react");
+    let { stdin, stdout, stderr } = this.streams;
+    try {
+      render(createElement(Wrapper, { program: this }, element), {
+        exitOnCtrlC: true,
+        patchConsole: true,
+        stderr,
+        stdin,
+        stdout
+      });
+    } catch (error) {
+      if (error instanceof Error) {
+        await this.renderElement(
+          createElement(this.ErrorBoundaryFallbackComponent, { error, resetErrorBoundary: () => {
+          } })
+        );
+      }
+    } finally {
+      this.isRendering = false;
+    }
+  }
+  /**
+   * Runs the program.
+   *
+   * @param argv Unparsed command line arguments.
+   */
+  async run(argv) {
+    let hasCommandRun = false;
+    for (let command of this.commands) {
+      let parsedArgs = command.parseArguments(argv);
+      if (parsedArgs.command) {
+        hasCommandRun = true;
+        if (parsedArgs.errors.length) {
+          let { createElement } = await import("react");
+          for (let error of parsedArgs.errors) {
+            process.exitCode = 1;
+            await this.renderElement(
+              createElement(this.ErrorBoundaryFallbackComponent, {
+                error,
+                resetErrorBoundary: () => {
+                }
+              })
+            );
+          }
+        } else {
+          try {
+            await command.run(parsedArgs, this);
+          } catch (error) {
+            let { createElement } = await import("react");
+            if (error instanceof Error) {
+              process.exitCode = 1;
+              await this.renderElement(
+                createElement(this.ErrorBoundaryFallbackComponent, {
+                  error,
+                  resetErrorBoundary: () => {
+                  }
+                })
+              );
+            }
+          }
+          break;
+        }
+      }
+    }
+    if (!hasCommandRun) {
+      let { createElement } = await import("react");
+      await this.renderElement(createElement(Help, { program: this }));
+    }
+  }
+}
+//# sourceMappingURL=Program.js.map

package/build/program/Program.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/program/Program.ts"],
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any -- needed */\nimport {type Argv, type OptionsConfig, type ParametersConfig} from '@jakubmazanec/args';\nimport fs from 'fs-extra';\nimport fetchLatestVersion from 'latest-version';\nimport path from 'path';\nimport {type ComponentType} from 'react';\nimport {type FallbackProps} from 'react-error-boundary';\n\nimport {CACHE_PATH} from '../constants.js';\nimport {Failure, Help} from '../ui.js';\nimport {Wrapper} from '../ui/internals.js';\nimport {type Command} from './Command.js';\nimport {type ProgramCreateOptions} from './ProgramCreateOptions.js';\nimport {ProgramError} from './ProgramError.js';\nimport {type ProgramOptions} from './ProgramOptions.js';\nimport {type ProgramStreams} from './ProgramStreams.js';\n\n/**\n * Program manages and executes {@link Command} instances attached to it based on parsing command line arguments.\n */\nexport class Program {\n  /** Program name. */\n  readonly name?: string;\n\n  /** More readable program name. */\n  readonly displayName?: string;\n\n  /** Program version. */\n  readonly version?: string;\n\n  /** Program latest version. */\n  readonly latestVersion?: string;\n\n  /** Program description. */\n  readonly description?: string;\n\n  /** Program executable name. */\n  readonly bin?: string;\n\n  /** Program commands */\n  readonly commands: Array<\n    Command<string, ParametersConfig | undefined, OptionsConfig | undefined, boolean, boolean>\n  > = [];\n\n  protected isRendering = false;\n\n  readonly streams: ProgramStreams = {\n    stderr: process.stderr,\n    stdin: process.stdin,\n    stdout: process.stdout,\n  };\n\n  /** Custom error boundary fallback component */\n  ErrorBoundaryFallbackComponent: ComponentType<FallbackProps>;\n\n  private constructor({\n    name,\n    displayName,\n    version,\n    latestVersion,\n    description,\n    bin,\n    ErrorBoundaryFallbackComponent,\n  }: ProgramOptions) {\n    if (name) {\n      this.name = name;\n    }\n\n    if (displayName) {\n      this.displayName = displayName;\n    }\n\n    if (version) {\n      this.version = version;\n    }\n\n    if (latestVersion) {\n      this.latestVersion = latestVersion;\n    }\n\n    if (description) {\n      this.description = description;\n    }\n\n    if (bin) {\n      this.bin = bin;\n    }\n\n    if (ErrorBoundaryFallbackComponent) {\n      this.ErrorBoundaryFallbackComponent = ErrorBoundaryFallbackComponent;\n    } else {\n      this.ErrorBoundaryFallbackComponent = Failure;\n    }\n  }\n\n  static async create({\n    name,\n    version,\n    description,\n    bin,\n    ErrorBoundaryFallbackComponent,\n    checkForUpdate,\n  }: ProgramCreateOptions) {\n    let latestVersion: string | undefined;\n\n    if (checkForUpdate && name) {\n      // first we try to read the cached latest version\n      type CachedLatestVersion = {\n        value: string;\n        datetime: number;\n      };\n\n      let cachePath = path.join(CACHE_PATH, name, 'latest-version.json');\n      let cachedLatestVersion: CachedLatestVersion | undefined;\n\n      try {\n        cachedLatestVersion = (await fs.readJson(cachePath)) as CachedLatestVersion;\n      } catch {\n        // no-op\n      }\n\n      // if there is no cache or the cached value is old, refetch and recache\n      if (!cachedLatestVersion || Date.now() - cachedLatestVersion.datetime > 86_400_00) {\n        latestVersion = await fetchLatestVersion(name);\n\n        await fs.ensureFile(cachePath);\n        await fs.writeJson(cachePath, {\n          value: latestVersion,\n          datetime: Date.now(),\n        });\n      }\n    }\n\n    return new this({\n      name,\n      version,\n      latestVersion,\n      description,\n      bin,\n      ErrorBoundaryFallbackComponent,\n    });\n  }\n\n  /**\n   * Adds command to the program.\n   *\n   * @param command Command to add.\n   * @returns Program instance.\n   */\n  addCommand(command: Command<any, any, any, any, any>): this {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- it doesn't matter here; `any` is used to make TypeScript happy in this method, but isn't propagated further.\n    this.commands.push(command);\n\n    return this;\n  }\n\n  /**\n   * Renders a React element using Ink and outputs to the configured streams.\n   *\n   * @param element The React element to render.\n   */\n  async renderElement(element: React.ReactElement): Promise<void> {\n    if (this.isRendering) {\n      throw new ProgramError('NO_NESTED_RENDER');\n    } else {\n      this.isRendering = true;\n    }\n\n    let {render} = await import('ink');\n    let {createElement} = await import('react');\n    let {stdin, stdout, stderr} = this.streams;\n\n    try {\n      render(createElement(Wrapper, {program: this}, element), {\n        exitOnCtrlC: true,\n        patchConsole: true,\n        stderr,\n        stdin,\n        stdout,\n      });\n    } catch (error: unknown) {\n      if (error instanceof Error) {\n        await this.renderElement(\n          createElement(this.ErrorBoundaryFallbackComponent, {error, resetErrorBoundary: () => {}}),\n        );\n      }\n    } finally {\n      this.isRendering = false;\n    }\n  }\n\n  /**\n   * Runs the program.\n   *\n   * @param argv Unparsed command line arguments.\n   */\n  async run(argv: Argv): Promise<void> {\n    let hasCommandRun = false;\n\n    for (let command of this.commands) {\n      let parsedArgs = command.parseArguments(argv);\n\n      if (parsedArgs.command) {\n        hasCommandRun = true;\n\n        if (parsedArgs.errors.length) {\n          let {createElement} = await import('react');\n\n          for (let error of parsedArgs.errors) {\n            process.exitCode = 1;\n\n            await this.renderElement(\n              createElement(this.ErrorBoundaryFallbackComponent, {\n                error,\n                resetErrorBoundary: () => {},\n              }),\n            );\n          }\n        } else {\n          try {\n            await command.run(parsedArgs, this);\n          } catch (error: unknown) {\n            let {createElement} = await import('react');\n\n            if (error instanceof Error) {\n              process.exitCode = 1;\n\n              await this.renderElement(\n                createElement(this.ErrorBoundaryFallbackComponent, {\n                  error,\n                  resetErrorBoundary: () => {},\n                }),\n              );\n            }\n          }\n\n          break;\n        }\n      }\n    }\n\n    if (!hasCommandRun) {\n      let {createElement} = await import('react');\n\n      await this.renderElement(createElement(Help, {program: this}));\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/program/ProgramCreateOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ProgramCreateOptions.js.map

package/build/program/ProgramCreateOptions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/program/ProgramDetail.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ProgramDetail.js.map

package/build/program/ProgramDetail.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/{dist → build}/program/ProgramError.d.ts

@@ -1,4 +1,4 @@
 /**
  * A subclass of `Error` that indicates a program failure.
  */
-export declare const ProgramError: new (code: "NO_NESTED_RENDER", options?: import("@jakubmazanec/error").CustomErrorOptions | undefined) => import("@jakubmazanec/error").CustomError<"NO_NESTED_RENDER" | "UNKNOWN_ERROR">;
+export declare const ProgramError: new (code: "NO_NESTED_RENDER", options?: import("@jakubmazanec/error").CustomErrorOptions | undefined) => import("@jakubmazanec/error").CustomError<"UNKNOWN_ERROR" | "NO_NESTED_RENDER">;

package/build/program/ProgramError.js

@@ -0,0 +1,6 @@
+"use strict";
+import { createCustomError } from "@jakubmazanec/error";
+export const ProgramError = createCustomError("ProgramError", {
+  NO_NESTED_RENDER: "A React render process already exists. This usually occurs by triggering nested render calls."
+});
+//# sourceMappingURL=ProgramError.js.map

package/build/program/ProgramError.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/program/ProgramError.ts"],
+  "sourcesContent": ["import {createCustomError} from '@jakubmazanec/error';\n\n/**\n * A subclass of `Error` that indicates a program failure.\n */\nexport const ProgramError = createCustomError('ProgramError', {\n  NO_NESTED_RENDER:\n    'A React render process already exists. This usually occurs by triggering nested render calls.',\n});\n"],
+  "mappings": ";AAAA,SAAQ,yBAAwB;AAKzB,aAAM,eAAe,kBAAkB,gBAAgB;AAAA,EAC5D,kBACE;AACJ,CAAC;",
+  "names": []
+}

package/build/program/ProgramOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ProgramOptions.js.map

package/build/program/ProgramOptions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/program/ProgramStreams.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ProgramStreams.js.map

package/build/program/ProgramStreams.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/program/getProgramDetail.js

@@ -0,0 +1,25 @@
+"use strict";
+export function getProgramDetail(packageJson) {
+  let programDetail = {};
+  if (packageJson.name) {
+    programDetail.name = packageJson.name;
+  }
+  if (packageJson.version) {
+    programDetail.version = packageJson.version;
+  }
+  if (packageJson.description) {
+    programDetail.description = packageJson.description;
+  }
+  if (packageJson.bin && typeof packageJson.bin !== "string") {
+    let bins = Object.entries(packageJson.bin);
+    if (bins.length === 1) {
+      let firstBin = bins[0];
+      [programDetail.bin] = firstBin;
+    }
+  }
+  if (typeof packageJson.bin === "string" && packageJson.name) {
+    programDetail.bin = packageJson.name;
+  }
+  return programDetail;
+}
+//# sourceMappingURL=getProgramDetail.js.map

package/build/program/getProgramDetail.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/program/getProgramDetail.ts"],
+  "sourcesContent": ["import {type PackageJson} from '@jakubmazanec/zod-utils';\n\nimport {type ProgramDetail} from './ProgramDetail.js';\n\n/**\n * Creates detailed information about a {@lincode Program}.\n */\nexport function getProgramDetail(packageJson: PackageJson) {\n  let programDetail: ProgramDetail = {};\n\n  if (packageJson.name) {\n    programDetail.name = packageJson.name;\n  }\n\n  if (packageJson.version) {\n    programDetail.version = packageJson.version;\n  }\n\n  if (packageJson.description) {\n    programDetail.description = packageJson.description;\n  }\n\n  if (packageJson.bin && typeof packageJson.bin !== 'string') {\n    let bins = Object.entries(packageJson.bin);\n\n    if (bins.length === 1) {\n      let firstBin = bins[0] as [string, string];\n\n      [programDetail.bin] = firstBin;\n    }\n  }\n\n  if (typeof packageJson.bin === 'string' && packageJson.name) {\n    programDetail.bin = packageJson.name;\n  }\n\n  return programDetail;\n}\n"],
+  "mappings": ";AAOO,gBAAS,iBAAiB,aAA0B;AACzD,MAAI,gBAA+B,CAAC;AAEpC,MAAI,YAAY,MAAM;AACpB,kBAAc,OAAO,YAAY;AAAA,EACnC;AAEA,MAAI,YAAY,SAAS;AACvB,kBAAc,UAAU,YAAY;AAAA,EACtC;AAEA,MAAI,YAAY,aAAa;AAC3B,kBAAc,cAAc,YAAY;AAAA,EAC1C;AAEA,MAAI,YAAY,OAAO,OAAO,YAAY,QAAQ,UAAU;AAC1D,QAAI,OAAO,OAAO,QAAQ,YAAY,GAAG;AAEzC,QAAI,KAAK,WAAW,GAAG;AACrB,UAAI,WAAW,KAAK,CAAC;AAErB,OAAC,cAAc,GAAG,IAAI;AAAA,IACxB;AAAA,EACF;AAEA,MAAI,OAAO,YAAY,QAAQ,YAAY,YAAY,MAAM;AAC3D,kBAAc,MAAM,YAAY;AAAA,EAClC;AAEA,SAAO;AACT;",
+  "names": []
+}

package/build/program.js

@@ -0,0 +1,13 @@
+"use strict";
+export * from "./program/Command.js";
+export * from "./program/CommandAction.js";
+export * from "./program/CommandArguments.js";
+export * from "./program/CommandOptions.js";
+export * from "./program/getProgramDetail.js";
+export * from "./program/Program.js";
+export * from "./program/ProgramCreateOptions.js";
+export * from "./program/ProgramDetail.js";
+export * from "./program/ProgramError.js";
+export * from "./program/ProgramOptions.js";
+export * from "./program/ProgramStreams.js";
+//# sourceMappingURL=program.js.map

package/build/program.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../source/program.ts"],
+  "sourcesContent": ["export * from './program/Command.js';\nexport * from './program/CommandAction.js';\nexport * from './program/CommandArguments.js';\nexport * from './program/CommandOptions.js';\nexport * from './program/getProgramDetail.js';\nexport * from './program/Program.js';\nexport * from './program/ProgramCreateOptions.js';\nexport * from './program/ProgramDetail.js';\nexport * from './program/ProgramError.js';\nexport * from './program/ProgramOptions.js';\nexport * from './program/ProgramStreams.js';\n"],
+  "mappings": ";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/build/ui/ErrorDetail.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ErrorDetail.js.map

package/build/ui/ErrorDetail.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/ui/Failure.js

@@ -0,0 +1,20 @@
+"use strict";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import * as colors from "./colors.js";
+import { getErrorDetail } from "./getErrorDetail.js";
+import { Header } from "./Header.js";
+import * as icons from "./icons.js";
+export function Failure({ error, errorDetail, ...boxProps }) {
+  let { label, description, stack, cause } = errorDetail ?? getErrorDetail(error);
+  return /* @__PURE__ */ jsxs(Box, { ...boxProps, flexDirection: "column", children: [
+    /* @__PURE__ */ jsx(Header, { icon: icons.error, children: /* @__PURE__ */ jsx(Text, { color: colors.highlighted, children: label }) }),
+    description ? /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: colors.failure, children: description }) }) : null,
+    stack ? /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: stack }) }) : null,
+    cause ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: cause.description }) }),
+      cause.stack ? /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: cause.stack }) }) : null
+    ] }) : null
+  ] });
+}
+//# sourceMappingURL=Failure.js.map

package/build/ui/Failure.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/ui/Failure.tsx"],
+  "sourcesContent": ["import {Box, type BoxProps, Text} from 'ink';\n\nimport * as colors from './colors.js';\nimport {type ErrorDetail} from './ErrorDetail.js';\nimport {getErrorDetail} from './getErrorDetail.js';\nimport {Header} from './Header.js';\nimport * as icons from './icons.js';\n\n/**\n * {@link Failure} component props.\n */\nexport type FailureProps = BoxProps & {\n  /** Error that describes a failure state. Function {@link getErrorDetail} is used for getting all the information from the error; you can use it to implement own retrieval logic and pass the result as `errorDetail` prop. */\n  error: Error;\n\n  /** Information about the failure state. Overrides information retireved from `error` prop. */\n  errorDetail?: ErrorDetail;\n};\n\n/**\n * A component that renders a failure state.\n */\nexport function Failure({error, errorDetail, ...boxProps}: FailureProps) {\n  let {label, description, stack, cause} = errorDetail ?? getErrorDetail(error);\n\n  return (\n    <Box {...boxProps} flexDirection=\"column\">\n      <Header icon={icons.error}>\n        <Text color={colors.highlighted}>{label}</Text>\n      </Header>\n\n      {description ?\n        <Box flexDirection=\"column\" marginLeft={2}>\n          <Text color={colors.failure}>{description}</Text>\n        </Box>\n      : null}\n\n      {stack ?\n        <Box flexDirection=\"column\" marginTop={1} marginLeft={2}>\n          <Text color={colors.muted}>{stack}</Text>\n        </Box>\n      : null}\n\n      {cause ?\n        <>\n          <Box flexDirection=\"column\" marginTop={1} marginLeft={2}>\n            <Text color={colors.muted}>{cause.description}</Text>\n          </Box>\n\n          {cause.stack ?\n            <Box flexDirection=\"column\" marginTop={1} marginLeft={2}>\n              <Text color={colors.muted}>{cause.stack}</Text>\n            </Box>\n          : null}\n        </>\n      : null}\n    </Box>\n  );\n}\n"],
+  "mappings": ";AA4BQ,SAgBA,UAhBA,KAgBA,YAhBA;AA5BR,SAAQ,KAAoB,YAAW;AAEvC,YAAY,YAAY;AAExB,SAAQ,sBAAqB;AAC7B,SAAQ,cAAa;AACrB,YAAY,WAAW;AAgBhB,gBAAS,QAAQ,EAAC,OAAO,aAAa,GAAG,SAAQ,GAAiB;AACvE,MAAI,EAAC,OAAO,aAAa,OAAO,MAAK,IAAI,eAAe,eAAe,KAAK;AAE5E,SACE,qBAAC,OAAK,GAAG,UAAU,eAAc,UAC/B;AAAA,wBAAC,UAAO,MAAM,MAAM,OAClB,8BAAC,QAAK,OAAO,OAAO,aAAc,iBAAM,GAC1C;AAAA,IAEC,cACC,oBAAC,OAAI,eAAc,UAAS,YAAY,GACtC,8BAAC,QAAK,OAAO,OAAO,SAAU,uBAAY,GAC5C,IACA;AAAA,IAED,QACC,oBAAC,OAAI,eAAc,UAAS,WAAW,GAAG,YAAY,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,iBAAM,GACpC,IACA;AAAA,IAED,QACC,iCACE;AAAA,0BAAC,OAAI,eAAc,UAAS,WAAW,GAAG,YAAY,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,gBAAM,aAAY,GAChD;AAAA,MAEC,MAAM,QACL,oBAAC,OAAI,eAAc,UAAS,WAAW,GAAG,YAAY,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,gBAAM,OAAM,GAC1C,IACA;AAAA,OACJ,IACA;AAAA,KACJ;AAEJ;",
+  "names": []
+}

package/build/ui/Header.js

@@ -0,0 +1,19 @@
+"use strict";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { Spinner } from "./Spinner.js";
+export function Header({
+  children,
+  icon,
+  showSpinner = false,
+  ...boxProps
+}) {
+  return /* @__PURE__ */ jsxs(Box, { ...boxProps, children: [
+    icon || showSpinner ? /* @__PURE__ */ jsxs(Box, { marginRight: 1, children: [
+      showSpinner ? /* @__PURE__ */ jsx(Spinner, {}) : null,
+      !showSpinner && icon ? /* @__PURE__ */ jsx(Text, { children: icon }) : null
+    ] }) : null,
+    /* @__PURE__ */ jsx(Box, { children })
+  ] });
+}
+//# sourceMappingURL=Header.js.map

package/build/ui/Header.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../source/ui/Header.tsx"],
+  "sourcesContent": ["import {Box, type BoxProps, Text} from 'ink';\nimport {type PropsWithChildren} from 'react';\n\nimport {Spinner} from './Spinner.js';\n\n/**\n * {@link Header} component props.\n */\nexport type HeaderProps = BoxProps & {\n  /** Icon (recommended is 1 character) to render before the header itself. */\n  icon?: string;\n\n  /** Show spinner instead of the icon. */\n  showSpinner?: boolean;\n};\n\n/**\n * Header component.\n */\nexport function Header({\n  children,\n  icon,\n  showSpinner = false,\n  ...boxProps\n}: PropsWithChildren<HeaderProps>) {\n  return (\n    <Box {...boxProps}>\n      {icon || showSpinner ?\n        <Box marginRight={1}>\n          {showSpinner ?\n            <Spinner />\n          : null}\n          {!showSpinner && icon ?\n            <Text>{icon}</Text>\n          : null}\n        </Box>\n      : null}\n      <Box>{children}</Box>\n    </Box>\n  );\n}\n"],
+  "mappings": ";AA4BQ,SAEI,KAFJ;AA5BR,SAAQ,KAAoB,YAAW;AAGvC,SAAQ,eAAc;AAgBf,gBAAS,OAAO;AAAA,EACrB;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,GAAG;AACL,GAAmC;AACjC,SACE,qBAAC,OAAK,GAAG,UACN;AAAA,YAAQ,cACP,qBAAC,OAAI,aAAa,GACf;AAAA,oBACC,oBAAC,WAAQ,IACT;AAAA,MACD,CAAC,eAAe,OACf,oBAAC,QAAM,gBAAK,IACZ;AAAA,OACJ,IACA;AAAA,IACF,oBAAC,OAAK,UAAS;AAAA,KACjB;AAEJ;",
+  "names": []
+}