effect 4.0.0-beta.66 → 4.0.0-beta.67

package/dist/unstable/cli/CliError.d.ts

@@ -1,14 +1,15 @@
 import * as Runtime from "../../Runtime.ts";
 import * as Schema from "../../Schema.ts";
 /**
- * @since 4.0.0
  * @category type id
+ * @since 4.0.0
  */
 declare const TypeId = "~effect/cli/CliError";
 /**
  * Type guard to check if a value is a CLI error.
  *
- * @example
+ * **Example** (Checking CLI errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -31,14 +32,15 @@ declare const TypeId = "~effect/cli/CliError";
  * })
  * ```
  *
- * @since 4.0.0
  * @category guards
+ * @since 4.0.0
  */
 export declare const isCliError: (u: unknown) => u is CliError;
 /**
  * Union type representing all possible CLI error conditions.
  *
- * @example
+ * **Example** (Handling CLI errors)
+ *
  * ```ts
  * import type { CliError } from "effect/unstable/cli"
  *
@@ -63,8 +65,8 @@ export declare const isCliError: (u: unknown) => u is CliError;
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type CliError = UnrecognizedOption | DuplicateOption | MissingOption | MissingArgument | InvalidValue | UnknownSubcommand | ShowHelp | UserError;
 declare const UnrecognizedOption_base: Schema.Class<UnrecognizedOption, Schema.Struct<{
@@ -76,7 +78,8 @@ declare const UnrecognizedOption_base: Schema.Class<UnrecognizedOption, Schema.S
 /**
  * Error thrown when an unrecognized option is encountered.
  *
- * @example
+ * **Example** (Creating unrecognized option errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -102,15 +105,19 @@ declare const UnrecognizedOption_base: Schema.Class<UnrecognizedOption, Schema.S
  * })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare class UnrecognizedOption extends UnrecognizedOption_base {
     /**
+     * Marks this value as a CLI parsing error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cli/CliError";
     /**
+     * Formats the unrecognized option with command context and suggestions.
+     *
      * @since 4.0.0
      */
     get message(): string;
@@ -124,7 +131,8 @@ declare const DuplicateOption_base: Schema.Class<DuplicateOption, Schema.Struct<
 /**
  * Error thrown when duplicate option names are detected between parent and child commands.
  *
- * @example
+ * **Example** (Creating duplicate option errors)
+ *
  * ```ts
  * import { CliError } from "effect/unstable/cli"
  *
@@ -139,15 +147,19 @@ declare const DuplicateOption_base: Schema.Class<DuplicateOption, Schema.Struct<
  * // Parent will always claim this flag (Mode A semantics). Consider renaming one of them to avoid confusion."
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare class DuplicateOption extends DuplicateOption_base {
     /**
+     * Marks this value as a CLI configuration error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cli/CliError";
     /**
+     * Explains which parent and child commands define the duplicate option.
+     *
      * @since 4.0.0
      */
     get message(): string;
@@ -159,7 +171,8 @@ declare const MissingOption_base: Schema.Class<MissingOption, Schema.Struct<{
 /**
  * Error thrown when a required option is missing.
  *
- * @example
+ * **Example** (Creating missing option errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -182,15 +195,19 @@ declare const MissingOption_base: Schema.Class<MissingOption, Schema.Struct<{
  *   })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare class MissingOption extends MissingOption_base {
     /**
+     * Marks this value as a missing CLI option error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cli/CliError";
     /**
+     * Formats the missing required flag for display.
+     *
      * @since 4.0.0
      */
     get message(): string;
@@ -202,7 +219,8 @@ declare const MissingArgument_base: Schema.Class<MissingArgument, Schema.Struct<
 /**
  * Error thrown when a required positional argument is missing.
  *
- * @example
+ * **Example** (Creating missing argument errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -224,15 +242,19 @@ declare const MissingArgument_base: Schema.Class<MissingArgument, Schema.Struct<
  *   })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare class MissingArgument extends MissingArgument_base {
     /**
+     * Marks this value as a missing CLI argument error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cli/CliError";
     /**
+     * Formats the missing required positional argument for display.
+     *
      * @since 4.0.0
      */
     get message(): string;
@@ -247,7 +269,8 @@ declare const InvalidValue_base: Schema.Class<InvalidValue, Schema.Struct<{
 /**
  * Error thrown when an option or argument value is invalid.
  *
- * @example
+ * **Example** (Creating invalid value errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -274,15 +297,19 @@ declare const InvalidValue_base: Schema.Class<InvalidValue, Schema.Struct<{
  * // "Invalid value for argument <count>: "abc". Expected: integer"
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare class InvalidValue extends InvalidValue_base {
     /**
+     * Marks this value as an invalid CLI value error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cli/CliError";
     /**
+     * Formats the invalid flag or argument value with the expected input.
+     *
      * @since 4.0.0
      */
     get message(): string;
@@ -296,7 +323,8 @@ declare const UnknownSubcommand_base: Schema.Class<UnknownSubcommand, Schema.Str
 /**
  * Error thrown when an unknown subcommand is encountered.
  *
- * @example
+ * **Example** (Creating unknown subcommand errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -325,15 +353,19 @@ declare const UnknownSubcommand_base: Schema.Class<UnknownSubcommand, Schema.Str
  *   })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare class UnknownSubcommand extends UnknownSubcommand_base {
     /**
+     * Marks this value as an unknown CLI subcommand error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cli/CliError";
     /**
+     * Formats the unknown subcommand with parent command context and suggestions.
+     *
      * @since 4.0.0
      */
     get message(): string;
@@ -345,7 +377,8 @@ declare const UserError_base: Schema.Class<UserError, Schema.Struct<{
 /**
  * Wrapper for user (handler) errors to unify under CLI error channel when desired.
  *
- * @example
+ * **Example** (Wrapping user errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -374,21 +407,25 @@ declare const UserError_base: Schema.Class<UserError, Schema.Struct<{
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare class UserError extends UserError_base {
     /**
+     * Marks this value as a user handler error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cli/CliError";
 }
 /**
- * Represents errors that should not trigger the display of the CLI's help
- * documentation.
+ * Schema for concrete CLI errors that can be reported together with help output.
+ *
+ * This excludes `ShowHelp` itself, allowing parse and validation errors to be
+ * stored in `ShowHelp.errors` without nesting another help-control value.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare const NonShowHelpErrors: Schema.Union<readonly [
     typeof UnrecognizedOption,
@@ -400,8 +437,14 @@ export declare const NonShowHelpErrors: Schema.Union<readonly [
     typeof UserError
 ]>;
 /**
- * @since 4.0.0
+ * Type of CLI errors that are not `ShowHelp`.
+ *
+ * These errors can be accumulated and attached to `ShowHelp.errors` when the
+ * runner should display help along with the underlying parse or validation
+ * failures.
+ *
  * @category models
+ * @since 4.0.0
  */
 export type NonShowHelpErrors = typeof NonShowHelpErrors.Type;
 declare const ShowHelp_base: Schema.Class<ShowHelp, Schema.Struct<{
@@ -410,11 +453,14 @@ declare const ShowHelp_base: Schema.Class<ShowHelp, Schema.Struct<{
     readonly errors: Schema.$Array<Schema.Union<readonly [typeof UnrecognizedOption, typeof DuplicateOption, typeof MissingOption, typeof MissingArgument, typeof InvalidValue, typeof UnknownSubcommand, typeof UserError]>>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
- * Control flow indicator when help is requested via --help flag.
- * This is not an error but uses the error channel for control flow.
+ * Control-flow value that asks the CLI runner to render help for a command path.
+ *
+ * It is used for explicit help requests and for parse or validation failures
+ * that should be shown with help text. When `errors` is non-empty, the runtime
+ * exit code is `1`; otherwise it is `0`.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export declare class ShowHelp extends ShowHelp_base {
     readonly [TypeId] = "~effect/cli/CliError";

package/dist/unstable/cli/CliError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CliError.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/CliError.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC;;;GAGG;AACH,QAAA,MAAM,MAAM,yBAAyB,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,QAA4C,CAAA;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,eAAe,GACf,YAAY,GACZ,iBAAiB,GACjB,QAAQ,GACR,SAAS,CAAA;;;;;;;AAEb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,kBAAmB,SAAQ,uBAKtC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;OAEG;IACH,IAAa,OAAO,WAQnB;CACF;;;;;;;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,SAAQ,oBAKnC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;OAEG;IACH,IAAa,OAAO,WAGnB;CACF;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAc,SAAQ,kBAGjC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;OAEG;IACH,IAAa,OAAO,WAEnB;CACF;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAgB,SAAQ,oBAGnC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;OAEG;IACH,IAAa,OAAO,WAEnB;CACF;;;;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,YAAa,SAAQ,iBAMhC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;OAEG;IACH,IAAa,OAAO,WAKnB;CACF;;;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,iBAAkB,SAAQ,sBAKrC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;OAEG;IACH,IAAa,OAAO,WAOnB;CACF;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,SAAU,SAAQ,cAG7B;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAC1C,SAAS;IACP,OAAO,kBAAkB;IACzB,OAAO,eAAe;IACtB,OAAO,aAAa;IACpB,OAAO,eAAe;IACtB,OAAO,YAAY;IACnB,OAAO,iBAAiB;IACxB,OAAO,SAAS;CACjB,CASD,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;;;;;;AAE7D;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,aAI5B;IACA,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B,SAAkB,CAAC,OAAO,CAAC,aAAa,CAAC,SAA6B;IACtE,SAAkB,CAAC,OAAO,CAAC,aAAa,CAAC,SAAQ;IAEjD,IAAa,OAAO,WAEnB;CACF"}
+{"version":3,"file":"CliError.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/CliError.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC;;;GAGG;AACH,QAAA,MAAM,MAAM,yBAAyB,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,QAA4C,CAAA;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,eAAe,GACf,YAAY,GACZ,iBAAiB,GACjB,QAAQ,GACR,SAAS,CAAA;;;;;;;AAEb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,kBAAmB,SAAQ,uBAKtC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;;;OAIG;IACH,IAAa,OAAO,WAQnB;CACF;;;;;;;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAgB,SAAQ,oBAKnC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;;;OAIG;IACH,IAAa,OAAO,WAGnB;CACF;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAc,SAAQ,kBAGjC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;;;OAIG;IACH,IAAa,OAAO,WAEnB;CACF;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,eAAgB,SAAQ,oBAGnC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;;;OAIG;IACH,IAAa,OAAO,WAEnB;CACF;;;;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,YAAa,SAAQ,iBAMhC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;;;OAIG;IACH,IAAa,OAAO,WAKnB;CACF;;;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,iBAAkB,SAAQ,sBAKrC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B;;;;OAIG;IACH,IAAa,OAAO,WAOnB;CACF;;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,SAAU,SAAQ,cAG7B;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;CAC3B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAC1C,SAAS;IACP,OAAO,kBAAkB;IACzB,OAAO,eAAe;IACtB,OAAO,aAAa;IACpB,OAAO,eAAe;IACtB,OAAO,YAAY;IACnB,OAAO,iBAAiB;IACxB,OAAO,SAAS;CACjB,CASD,CAAA;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;;;;;;AAE7D;;;;;;;;;GASG;AACH,qBAAa,QAAS,SAAQ,aAI5B;IACA,QAAQ,CAAC,CAAC,MAAM,CAAC,0BAAS;IAE1B,SAAkB,CAAC,OAAO,CAAC,aAAa,CAAC,SAA6B;IACtE,SAAkB,CAAC,OAAO,CAAC,aAAa,CAAC,SAAQ;IAEjD,IAAa,OAAO,WAEnB;CACF"}

package/dist/unstable/cli/CliError.js

@@ -1,18 +1,43 @@
 /**
+ * The `CliError` module defines the structured error model used by the
+ * unstable CLI parser and runner. It distinguishes command-line parse failures,
+ * CLI definition problems, explicit help requests, and user handler failures so
+ * applications can report errors consistently while still pattern matching on
+ * the exact cause.
+ *
+ * **Common tasks**
+ *
+ * - Detect CLI errors at runtime with {@link isCliError}
+ * - Represent parse failures such as unknown flags, missing required inputs, or
+ *   invalid argument values
+ * - Attach parse or validation errors to {@link ShowHelp} when the runner should
+ *   render help text together with the failure
+ * - Preserve command handler failures with {@link UserError}
+ *
+ * **Gotchas**
+ *
+ * - {@link ShowHelp} is a control-flow error, not a parse failure; it exits with
+ *   code `0` for explicit help and `1` when it carries errors
+ * - Duplicate option names between parent and child commands are rejected
+ *   because the parent command claims the flag before the child can see it
+ * - Suggestion-bearing errors keep suggestions separate from the primary cause
+ *   so help renderers can decide how much guidance to display
+ *
  * @since 4.0.0
  */
 import * as Predicate from "../../Predicate.js";
 import * as Runtime from "../../Runtime.js";
 import * as Schema from "../../Schema.js";
 /**
- * @since 4.0.0
  * @category type id
+ * @since 4.0.0
  */
 const TypeId = "~effect/cli/CliError";
 /**
  * Type guard to check if a value is a CLI error.
  *
- * @example
+ * **Example** (Checking CLI errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -35,14 +60,15 @@ const TypeId = "~effect/cli/CliError";
  * })
  * ```
  *
- * @since 4.0.0
  * @category guards
+ * @since 4.0.0
  */
 export const isCliError = u => Predicate.hasProperty(u, TypeId);
 /**
  * Error thrown when an unrecognized option is encountered.
  *
- * @example
+ * **Example** (Creating unrecognized option errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -68,8 +94,8 @@ export const isCliError = u => Predicate.hasProperty(u, TypeId);
  * })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class UnrecognizedOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/UnrecognizedOption`)({
   _tag: /*#__PURE__*/Schema.tag("UnrecognizedOption"),
@@ -78,10 +104,14 @@ export class UnrecognizedOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId
   suggestions: /*#__PURE__*/Schema.Array(Schema.String)
 }) {
   /**
+   * Marks this value as a CLI parsing error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Formats the unrecognized option with command context and suggestions.
+   *
    * @since 4.0.0
    */
   get message() {
@@ -93,7 +123,8 @@ export class UnrecognizedOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId
 /**
  * Error thrown when duplicate option names are detected between parent and child commands.
  *
- * @example
+ * **Example** (Creating duplicate option errors)
+ *
  * ```ts
  * import { CliError } from "effect/unstable/cli"
  *
@@ -108,8 +139,8 @@ export class UnrecognizedOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId
  * // Parent will always claim this flag (Mode A semantics). Consider renaming one of them to avoid confusion."
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class DuplicateOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/DuplicateOption`)({
   _tag: /*#__PURE__*/Schema.tag("DuplicateOption"),
@@ -118,10 +149,14 @@ export class DuplicateOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/D
   childCommand: Schema.String
 }) {
   /**
+   * Marks this value as a CLI configuration error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Explains which parent and child commands define the duplicate option.
+   *
    * @since 4.0.0
    */
   get message() {
@@ -131,7 +166,8 @@ export class DuplicateOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/D
 /**
  * Error thrown when a required option is missing.
  *
- * @example
+ * **Example** (Creating missing option errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -154,18 +190,22 @@ export class DuplicateOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/D
  *   })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class MissingOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/MissingOption`)({
   _tag: /*#__PURE__*/Schema.tag("MissingOption"),
   option: Schema.String
 }) {
   /**
+   * Marks this value as a missing CLI option error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Formats the missing required flag for display.
+   *
    * @since 4.0.0
    */
   get message() {
@@ -175,7 +215,8 @@ export class MissingOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/Mis
 /**
  * Error thrown when a required positional argument is missing.
  *
- * @example
+ * **Example** (Creating missing argument errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -197,18 +238,22 @@ export class MissingOption extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/Mis
  *   })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class MissingArgument extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/MissingArgument`)({
   _tag: /*#__PURE__*/Schema.tag("MissingArgument"),
   argument: Schema.String
 }) {
   /**
+   * Marks this value as a missing CLI argument error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Formats the missing required positional argument for display.
+   *
    * @since 4.0.0
    */
   get message() {
@@ -218,7 +263,8 @@ export class MissingArgument extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/M
 /**
  * Error thrown when an option or argument value is invalid.
  *
- * @example
+ * **Example** (Creating invalid value errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -245,8 +291,8 @@ export class MissingArgument extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/M
  * // "Invalid value for argument <count>: "abc". Expected: integer"
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class InvalidValue extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/InvalidValue`)({
   _tag: /*#__PURE__*/Schema.tag("InvalidValue"),
@@ -256,10 +302,14 @@ export class InvalidValue extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/Inva
   kind: /*#__PURE__*/Schema.Union([/*#__PURE__*/Schema.Literal("flag"), /*#__PURE__*/Schema.Literal("argument")])
 }) {
   /**
+   * Marks this value as an invalid CLI value error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Formats the invalid flag or argument value with the expected input.
+   *
    * @since 4.0.0
    */
   get message() {
@@ -272,7 +322,8 @@ export class InvalidValue extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/Inva
 /**
  * Error thrown when an unknown subcommand is encountered.
  *
- * @example
+ * **Example** (Creating unknown subcommand errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -301,8 +352,8 @@ export class InvalidValue extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/Inva
  *   })
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class UnknownSubcommand extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/UnknownSubcommand`)({
   _tag: /*#__PURE__*/Schema.tag("UnknownSubcommand"),
@@ -311,10 +362,14 @@ export class UnknownSubcommand extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}
   suggestions: /*#__PURE__*/Schema.Array(Schema.String)
 }) {
   /**
+   * Marks this value as an unknown CLI subcommand error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Formats the unknown subcommand with parent command context and suggestions.
+   *
    * @since 4.0.0
    */
   get message() {
@@ -325,7 +380,8 @@ export class UnknownSubcommand extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}
 /**
  * Wrapper for user (handler) errors to unify under CLI error channel when desired.
  *
- * @example
+ * **Example** (Wrapping user errors)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { CliError } from "effect/unstable/cli"
@@ -354,32 +410,39 @@ export class UnknownSubcommand extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class UserError extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/UserError`)({
   _tag: /*#__PURE__*/Schema.tag("UserError"),
   cause: Schema.Defect
 }) {
   /**
+   * Marks this value as a user handler error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
 }
 /**
- * Represents errors that should not trigger the display of the CLI's help
- * documentation.
+ * Schema for concrete CLI errors that can be reported together with help output.
+ *
+ * This excludes `ShowHelp` itself, allowing parse and validation errors to be
+ * stored in `ShowHelp.errors` without nesting another help-control value.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export const NonShowHelpErrors = /*#__PURE__*/Schema.Union([UnrecognizedOption, DuplicateOption, MissingOption, MissingArgument, InvalidValue, UnknownSubcommand, UserError]);
 /**
- * Control flow indicator when help is requested via --help flag.
- * This is not an error but uses the error channel for control flow.
+ * Control-flow value that asks the CLI runner to render help for a command path.
+ *
+ * It is used for explicit help requests and for parse or validation failures
+ * that should be shown with help text. When `errors` is non-empty, the runtime
+ * exit code is `1`; otherwise it is `0`.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export class ShowHelp extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/ShowHelp`)({
   _tag: /*#__PURE__*/Schema.tag("ShowHelp"),

package/dist/unstable/cli/CliError.js.map

@@ -1 +1 @@
-{"version":3,"file":"CliError.js","names":["Predicate","Runtime","Schema","TypeId","isCliError","u","hasProperty","UnrecognizedOption","ErrorClass","_tag","tag","option","String","command","optional","Array","suggestions","message","suggestionText","length","join","baseMessage","DuplicateOption","parentCommand","childCommand","MissingOption","MissingArgument","argument","InvalidValue","value","expected","kind","Union","Literal","UnknownSubcommand","subcommand","parent","UserError","cause","Defect","NonShowHelpErrors","ShowHelp","commandPath","errors","errorExitCode","errorReported"],"sources":["../../../src/unstable/cli/CliError.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"CliError.js","names":["Predicate","Runtime","Schema","TypeId","isCliError","u","hasProperty","UnrecognizedOption","ErrorClass","_tag","tag","option","String","command","optional","Array","suggestions","message","suggestionText","length","join","baseMessage","DuplicateOption","parentCommand","childCommand","MissingOption","MissingArgument","argument","InvalidValue","value","expected","kind","Union","Literal","UnknownSubcommand","subcommand","parent","UserError","cause","Defect","NonShowHelpErrors","ShowHelp","commandPath","errors","errorExitCode","errorReported"],"sources":["../../../src/unstable/cli/CliError.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}