effect 4.0.0-beta.65 → 4.0.0-beta.67

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

@@ -1 +1 @@
-{"version":3,"file":"Flag.js","names":["dual","Param","string","name","flagKind","boolean","integer","float","date","choiceWithValue","choices","choice","path","options","file","directory","redacted","fileText","fileParse","fileSchema","schema","keyValuePair","none","withAlias","self","alias","withDescription","description","withMetavar","metavar","optional","param","withDefault","withFallbackConfig","config","withFallbackPrompt","prompt","map","f","mapEffect","mapTryCatch","onError","atLeast","min","atMost","max","between","filterMap","onNone","filter","predicate","onFalse","orElse","that","orElseResult","withSchema"],"sources":["../../../src/unstable/cli/Flag.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Flag.js","names":["dual","Param","string","name","flagKind","boolean","integer","float","date","choiceWithValue","choices","choice","path","options","file","directory","redacted","fileText","fileParse","fileSchema","schema","keyValuePair","none","withAlias","self","alias","withDescription","description","withMetavar","metavar","optional","param","withDefault","withFallbackConfig","config","withFallbackPrompt","prompt","map","f","mapEffect","mapTryCatch","onError","atLeast","min","atMost","max","between","filterMap","onNone","filter","predicate","onFalse","orElse","that","orElseResult","withSchema"],"sources":["../../../src/unstable/cli/Flag.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -1,4 +1,27 @@
 /**
+ * The `GlobalFlag` module defines flags that are available to every command in
+ * an Effect CLI application. Global flags are useful for cross-cutting command
+ * line behavior such as printing help, showing the application version,
+ * generating shell completions, or configuring shared handler settings like the
+ * minimum log level.
+ *
+ * **Common tasks**
+ *
+ * - Create an action flag with {@link action} for side effects that should run
+ *   before the selected command, such as `--help` or `--version`
+ * - Create a setting flag with {@link setting} for values that should be made
+ *   available to command handlers through the Effect context
+ * - Reuse the built-in {@link Help}, {@link Version}, {@link Completions}, and
+ *   {@link LogLevel} flags when constructing command runners
+ *
+ * **Gotchas**
+ *
+ * - Action flags are intended to perform their effect and exit instead of
+ *   continuing into the command handler
+ * - Setting flags allocate a distinct context service for each call to
+ *   {@link setting}, so reuse exported settings when handlers need to read the
+ *   same parsed global value
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.ts";
@@ -10,19 +33,19 @@ import * as Flag from "./Flag.ts";
 /**
  * Context passed to action handlers.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface HandlerContext {
-    readonly command: Command.Command<any, unknown, any, unknown, unknown>;
+    readonly command: Command.Command.Any;
     readonly commandPath: ReadonlyArray<string>;
     readonly version: string;
 }
 /**
  * Action flag: side effect + exit (--help, --version, --completions).
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface Action<A> {
     readonly _tag: "Action";
@@ -32,8 +55,8 @@ export interface Action<A> {
 /**
  * Setting flag: configure command handler's environment (--log-level, --config).
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface Setting<Id extends string, A> extends Context.Service<Setting.Identifier<Id>, A> {
     readonly _tag: "Setting";
@@ -41,27 +64,32 @@ export interface Setting<Id extends string, A> extends Context.Service<Setting.I
     readonly flag: Flag.Flag<A>;
 }
 /**
+ * Namespace containing type helpers for global setting flags.
+ *
  * @since 4.0.0
  */
 export declare namespace Setting {
     /**
-     * @since 4.0.0
+     * Type-level service identifier used by `Setting` global flags for the
+     * parsed value associated with a setting id.
+     *
      * @category models
+     * @since 4.0.0
      */
     type Identifier<Id extends string> = `effect/unstable/cli/GlobalFlag/${Id}`;
 }
 /**
  * Global flag discriminated union.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type GlobalFlag<A> = Action<A> | Setting<any, A>;
 /**
  * Creates an Action flag that performs a side effect and exits.
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export declare const action: <A>(options: {
     readonly flag: Flag.Flag<A>;
@@ -70,8 +98,8 @@ export declare const action: <A>(options: {
 /**
  * Creates a Setting flag that configures the command handler's environment.
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export declare const setting: <const Id extends string>(id: Id) => <A>(options: {
     readonly flag: Flag.Flag<A>;
@@ -80,46 +108,46 @@ export declare const setting: <const Id extends string>(id: Id) => <A>(options:
  * The `--help` / `-h` global flag.
  * Shows help documentation for the command.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export declare const Help: Action<boolean>;
 /**
  * The `--version` global flag.
  * Shows version information for the command.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export declare const Version: Action<boolean>;
 /**
  * The `--completions` global flag.
  * Prints shell completion script for the given shell.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export declare const Completions: Action<Option.Option<"bash" | "zsh" | "fish">>;
 /**
  * The `--log-level` global flag.
  * Sets the minimum log level for the command.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export declare const LogLevel: Setting<"log-level", Option.Option<LogLevelType>>;
 /**
  * Built-in global flags in default precedence order.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export declare const BuiltIns: ReadonlyArray<GlobalFlag<any>>;
 /**
  * Built-in setting context identifiers.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type BuiltInSettingContext = Setting.Identifier<"log-level">;
 //# sourceMappingURL=GlobalFlag.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GlobalFlag.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/GlobalFlag.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GlobalFlag.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/GlobalFlag.ts"],"names":[],"mappings":"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"}

package/dist/unstable/cli/GlobalFlag.js

@@ -1,4 +1,27 @@
 /**
+ * The `GlobalFlag` module defines flags that are available to every command in
+ * an Effect CLI application. Global flags are useful for cross-cutting command
+ * line behavior such as printing help, showing the application version,
+ * generating shell completions, or configuring shared handler settings like the
+ * minimum log level.
+ *
+ * **Common tasks**
+ *
+ * - Create an action flag with {@link action} for side effects that should run
+ *   before the selected command, such as `--help` or `--version`
+ * - Create a setting flag with {@link setting} for values that should be made
+ *   available to command handlers through the Effect context
+ * - Reuse the built-in {@link Help}, {@link Version}, {@link Completions}, and
+ *   {@link LogLevel} flags when constructing command runners
+ *
+ * **Gotchas**
+ *
+ * - Action flags are intended to perform their effect and exit instead of
+ *   continuing into the command handler
+ * - Setting flags allocate a distinct context service for each call to
+ *   {@link setting}, so reuse exported settings when handlers need to read the
+ *   same parsed global value
+ *
  * @since 4.0.0
  */
 import * as Console from "../../Console.js";
@@ -16,8 +39,8 @@ import * as HelpInternal from "./internal/help.js";
 /**
  * Creates an Action flag that performs a side effect and exits.
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export const action = options => ({
   _tag: "Action",
@@ -27,8 +50,8 @@ export const action = options => ({
 /**
  * Creates a Setting flag that configures the command handler's environment.
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export const setting = id => options => {
   settingIdCounter += 1;
@@ -47,8 +70,8 @@ let settingIdCounter = 0;
  * The `--help` / `-h` global flag.
  * Shows help documentation for the command.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export const Help = /*#__PURE__*/action({
   flag: /*#__PURE__*/Flag.boolean("help").pipe(/*#__PURE__*/Flag.withAlias("h"), /*#__PURE__*/Flag.withDescription("Show help information")),
@@ -65,8 +88,8 @@ export const Help = /*#__PURE__*/action({
  * The `--version` global flag.
  * Shows version information for the command.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export const Version = /*#__PURE__*/action({
   flag: /*#__PURE__*/Flag.boolean("version").pipe(/*#__PURE__*/Flag.withDescription("Show version information")),
@@ -82,8 +105,8 @@ export const Version = /*#__PURE__*/action({
  * The `--completions` global flag.
  * Prints shell completion script for the given shell.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export const Completions = /*#__PURE__*/action({
   flag: /*#__PURE__*/Flag.choice("completions", ["bash", "zsh", "fish", "sh"]).pipe(Flag.optional, /*#__PURE__*/Flag.map(v => Option.map(v, s => s === "sh" ? "bash" : s)), /*#__PURE__*/Flag.withDescription("Print shell completion script")),
@@ -99,8 +122,8 @@ export const Completions = /*#__PURE__*/action({
  * The `--log-level` global flag.
  * Sets the minimum log level for the command.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export const LogLevel = /*#__PURE__*/setting("log-level")({
   flag: /*#__PURE__*/Flag.choiceWithValue("log-level", [["all", "All"], ["trace", "Trace"], ["debug", "Debug"], ["info", "Info"], ["warn", "Warn"], ["warning", "Warn"], ["error", "Error"], ["fatal", "Fatal"], ["none", "None"]]).pipe(Flag.optional, /*#__PURE__*/Flag.withDescription("Sets the minimum log level"))
@@ -111,8 +134,8 @@ export const LogLevel = /*#__PURE__*/setting("log-level")({
 /**
  * Built-in global flags in default precedence order.
  *
- * @since 4.0.0
  * @category references
+ * @since 4.0.0
  */
 export const BuiltIns = [Help, Version, Completions, LogLevel];
 //# sourceMappingURL=GlobalFlag.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"GlobalFlag.js","names":["Console","Context","Effect","Option","CliOutput","Completions_","Flag","CommandDescriptor","HelpInternal","action","options","_tag","flag","run","setting","id","settingIdCounter","ref","Service","Object","assign","Help","boolean","pipe","withAlias","withDescription","_","command","commandPath","gen","formatter","Formatter","helpDoc","getHelpForCommandPath","BuiltIns","log","formatHelpDoc","Version","version","formatVersion","name","Completions","choice","optional","map","v","s","shell","isNone","descriptor","fromCommand","generate","value","LogLevel","choiceWithValue"],"sources":["../../../src/unstable/cli/GlobalFlag.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"GlobalFlag.js","names":["Console","Context","Effect","Option","CliOutput","Completions_","Flag","CommandDescriptor","HelpInternal","action","options","_tag","flag","run","setting","id","settingIdCounter","ref","Service","Object","assign","Help","boolean","pipe","withAlias","withDescription","_","command","commandPath","gen","formatter","Formatter","helpDoc","getHelpForCommandPath","BuiltIns","log","formatHelpDoc","Version","version","formatVersion","name","Completions","choice","optional","map","v","s","shell","isNone","descriptor","fromCommand","generate","value","LogLevel","choiceWithValue"],"sources":["../../../src/unstable/cli/GlobalFlag.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -1,4 +1,25 @@
 /**
+ * The `HelpDoc` module defines the structured documentation model used by the
+ * unstable CLI package to describe command help. A `HelpDoc` value captures the
+ * user-facing parts of a command, including its description, usage string,
+ * positional arguments, flags, global flags, subcommands, and examples.
+ *
+ * **Common tasks**
+ *
+ * - Build help data from command definitions before rendering it
+ * - Pass command documentation to `CliOutput.Formatter` implementations
+ * - Represent custom help output formats without changing command parsing
+ * - Group subcommands and distinguish local flags from global flags
+ *
+ * **Gotchas**
+ *
+ * - `HelpDoc` is format-agnostic; layout, ANSI styling, and table alignment are
+ *   handled by the output formatter
+ * - Optional argument and flag descriptions use `Option.Option<string>`, while
+ *   optional sections are omitted when they have no entries
+ * - Long names, aliases, and descriptions may require formatter-specific width
+ *   handling when rendering terminal help
+ *
  * @since 4.0.0
  */
 import type { NonEmptyReadonlyArray } from "../../Array.ts";
@@ -9,7 +30,8 @@ import type * as Option from "../../Option.ts";
  * This data structure is independent of formatting, allowing for
  * different output formats (text, markdown, JSON, etc.).
  *
- * @example
+ * **Example** (Defining command help documentation)
+ *
  * ```ts
  * import { Option as O, Context } from "effect"
  * import type * as HelpDoc from "effect/unstable/cli/HelpDoc"
@@ -46,8 +68,8 @@ import type * as Option from "../../Option.ts";
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface HelpDoc {
     /**
@@ -87,8 +109,8 @@ export interface HelpDoc {
 /**
  * Documentation for a command usage example
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface ExampleDoc {
     /**
@@ -103,7 +125,8 @@ export interface ExampleDoc {
 /**
  * Documentation for a single command-line flag/option
  *
- * @example
+ * **Example** (Documenting command flags)
+ *
  * ```ts
  * import { Option as O } from "effect"
  * import type { HelpDoc } from "effect/unstable/cli"
@@ -125,8 +148,8 @@ export interface ExampleDoc {
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface FlagDoc {
     /**
@@ -153,7 +176,8 @@ export interface FlagDoc {
 /**
  * Documentation for a subcommand
  *
- * @example
+ * **Example** (Documenting subcommands)
+ *
  * ```ts
  * import { Option as O, Context } from "effect"
  * import type { HelpDoc } from "effect/unstable/cli"
@@ -185,8 +209,8 @@ export interface FlagDoc {
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface SubcommandDoc {
     /**
@@ -209,8 +233,8 @@ export interface SubcommandDoc {
 /**
  * Documentation for a grouped subcommand listing
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface SubcommandGroupDoc {
     /**
@@ -226,7 +250,8 @@ export interface SubcommandGroupDoc {
 /**
  * Documentation for a positional argument
  *
- * @example
+ * **Example** (Documenting positional arguments)
+ *
  * ```ts
  * import { Option as O, Context } from "effect"
  * import type { HelpDoc } from "effect/unstable/cli"
@@ -257,8 +282,8 @@ export interface SubcommandGroupDoc {
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface ArgDoc {
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"HelpDoc.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/HelpDoc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAChD,OAAO,KAAK,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAE5C;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAErC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IAExD;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAE3C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAA;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAE3C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B"}
+{"version":3,"file":"HelpDoc.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/HelpDoc.ts"],"names":[],"mappings":"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"}

package/dist/unstable/cli/HelpDoc.js

@@ -1,4 +1,25 @@
 /**
+ * The `HelpDoc` module defines the structured documentation model used by the
+ * unstable CLI package to describe command help. A `HelpDoc` value captures the
+ * user-facing parts of a command, including its description, usage string,
+ * positional arguments, flags, global flags, subcommands, and examples.
+ *
+ * **Common tasks**
+ *
+ * - Build help data from command definitions before rendering it
+ * - Pass command documentation to `CliOutput.Formatter` implementations
+ * - Represent custom help output formats without changing command parsing
+ * - Group subcommands and distinguish local flags from global flags
+ *
+ * **Gotchas**
+ *
+ * - `HelpDoc` is format-agnostic; layout, ANSI styling, and table alignment are
+ *   handled by the output formatter
+ * - Optional argument and flag descriptions use `Option.Option<string>`, while
+ *   optional sections are omitted when they have no entries
+ * - Long names, aliases, and descriptions may require formatter-specific width
+ *   handling when rendering terminal help
+ *
  * @since 4.0.0
  */
 export {};