@effected/cli 0.19.0 → 0.21.0

package/index.d.ts

@@ -1,8 +1,7 @@
-import { Array as Array$1, Cause, Context, Effect, FileSystem, Layer, LogLevel, Logger, MutableRef, Option, Path, Runtime, Schema, Stdio, Terminal } from "effect";
+import { Array as Array$1, Cause, Context, Duration, Effect, FileSystem, Layer, LogLevel, Logger, MutableRef, Option, Path, Runtime, Schema, Stdio, Terminal } from "effect";
 import { Audience, AudienceKind, ColorLevel, CurrentRuntimeEnv, RuntimeEnv, TerminalEnv } from "@effected/env";
 import { CliError, CliOutput, Command, Flag, Param, Prompt } from "effect/cli";
 import { ConfigValidationError } from "@effected/config-file";
-//#region src/Cancelled.d.ts
 declare const Cancelled_base: Schema.Class<Cancelled, Schema.TaggedStruct<"Cancelled", {
   readonly reason: Schema.Literals<readonly ["escape", "interrupt"]>;
 }>, import("effect/Cause").YieldableError>;
@@ -40,8 +39,6 @@ export declare class Cancelled extends Cancelled_base {
    */
   get [Runtime.errorExitCode](): number;
 }
-//#endregion
-//#region src/CliAudience.d.ts
 /**
  * The four parsed audience flags a root command carries once {@link CliAudience.flags} is shared onto it.
  *
@@ -185,8 +182,6 @@ export declare class CliAudience {
     readonly renderErrors?: boolean | undefined;
   }) => Effect.Effect<void, Exclude<E | CliError.UserError, Terminal.QuitError> | CliError.CliError, Exclude<R, Audience> | Audience | Command.Environment>;
 }
-//#endregion
-//#region src/CliColor.d.ts
 /**
  * Whether a CLI's output should carry ANSI colour, decided once and shared by
  * everything that renders — help text, error output, and any rendered result.
@@ -236,8 +231,6 @@ export declare class CliColor {
    */
   static readonly formatterLayer: (overrides?: Partial<CliOutput.Formatter>) => Layer.Layer<never, never, Stdio.Stdio>;
 }
-//#endregion
-//#region src/Glyphs.d.ts
 /**
  * The symbols a theme draws with.
  *
@@ -315,8 +308,6 @@ export declare class Glyphs {
   /** ASCII-only symbols. */
   static readonly ascii: GlyphSet;
 }
-//#endregion
-//#region src/Token.d.ts
 /**
  * A named terminal colour: the eight ANSI colours and their bright variants.
  *
@@ -401,8 +392,6 @@ export declare class Token {
    */
   static readonly style: (style: Style) => Style;
 }
-//#endregion
-//#region src/Status.d.ts
 /**
  * How one status looks: a Unicode glyph, an ASCII fallback, a token and a rank.
  *
@@ -525,8 +514,6 @@ export declare class Status<Names extends string> {
    */
   worstOption(names: ReadonlyArray<Names>): Option.Option<Names>;
 }
-//#endregion
-//#region src/CliTheme.d.ts
 /**
  * The shape of the {@link CliTheme} service: a colour level, a glyph set and the functions that use them.
  *
@@ -663,8 +650,6 @@ export declare class CliTheme extends CliTheme_base {
    */
   static readonly promptTheme: Layer.Layer<never, never, CliTheme>;
 }
-//#endregion
-//#region src/Doc.d.ts
 /**
  * A status as a document stores it: its name and its resolved definition.
  *
@@ -1432,8 +1417,6 @@ export declare class Doc {
    */
   static readonly print: (doc: Document, options?: DocPrintOptions) => Effect.Effect<void, never, CliTheme | TerminalEnv | Audience | CliLinks>;
 }
-//#endregion
-//#region src/CliLinks.d.ts
 /**
  * Whether file links open in an editor.
  *
@@ -1534,8 +1517,6 @@ export declare class CliLinks extends CliLinks_base {
    */
   static readonly linker: (options: CliLinksLinkerOptions) => (target: LinkTarget, label: string) => string;
 }
-//#endregion
-//#region src/CliLogger.d.ts
 /**
  * How a log record is turned into a line.
  *
@@ -1636,8 +1617,6 @@ export declare class CliLogger {
    */
   static readonly layer: (options?: CliLoggerOptions) => Layer.Layer<never>;
 }
-//#endregion
-//#region src/CliLog.d.ts
 /**
  * Options for `CliLog.status`.
  *
@@ -1997,8 +1976,6 @@ export declare class CliLog {
    */
   static readonly component: (name: string) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
 }
-//#endregion
-//#region src/CliEnv.d.ts
 /**
  * Options for {@link CliEnv.layer} and for `CliRuntime.main`'s `env` option.
  *
@@ -2175,8 +2152,6 @@ export declare class CliEnv {
    */
   static readonly layerTest: (options?: CliEnvTestOptions) => Layer.Layer<CliEnvTestServices>;
 }
-//#endregion
-//#region src/CliExit.d.ts
 /**
  * The shape behind {@link CliExit}.
  *
@@ -2241,8 +2216,6 @@ export declare class CliExit extends CliExit_base {
    */
   static readonly set: (code: number) => Effect.Effect<void, never, CliExit>;
 }
-//#endregion
-//#region src/CliFailure.d.ts
 /**
  * The protocol an error class implements to say how a failure is shown: a method under this key that returns the
  * document.
@@ -2346,8 +2319,6 @@ export declare class CliFailure {
    */
   static readonly toDoc: (cause: Cause.Cause<unknown>, options?: CliFailureOptions) => Document;
 }
-//#endregion
-//#region src/CliInteractive.d.ts
 declare const CliInteractive_base: Context.Reference<boolean>;
 /**
  * Whether this run may prompt a person: a human audience, with a terminal on
@@ -2405,8 +2376,6 @@ export declare class CliInteractive extends CliInteractive_base {
    */
   static readonly unless: (condition: boolean) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
 }
-//#endregion
-//#region src/CliMessage.d.ts
 /**
  * Options for {@link CliMessage.status}.
  *
@@ -2475,8 +2444,6 @@ export declare class CliMessage {
    */
   static readonly failure: (text: string) => Effect.Effect<void, never, CliTheme | Audience>;
 }
-//#endregion
-//#region src/CliPrompt.d.ts
 /**
  * Which missing parameter a fallback stands in for, so a non-interactive run can fail with core's own error.
  *
@@ -2563,8 +2530,6 @@ export declare class CliPrompt {
    */
   static readonly gateWizard: Layer.Layer<never>;
 }
-//#endregion
-//#region src/CliRuntime.d.ts
 /**
  * What `render` is told about a failure beyond the squashed error.
  *
@@ -2943,8 +2908,6 @@ export declare class CliRuntime {
   static reported<E extends Error>(error: E, exitCode?: number): E;
   static reported(error: unknown, exitCode?: number): Error;
 }
-//#endregion
-//#region src/ConfigIssueRenderer.d.ts
 /**
  * Turns a `@effected/config-file` `ConfigValidationError` into one line per rejected value.
  *
@@ -2997,8 +2960,6 @@ export declare class ConfigIssueRenderer {
    */
   static readonly render: (error: ConfigValidationError) => ReadonlyArray<string>;
 }
-//#endregion
-//#region src/Fmt.d.ts
 /**
  * Options for {@link Fmt.truncate}.
  *
@@ -3064,18 +3025,23 @@ export declare class Fmt {
    */
   static readonly truncate: (text: string, width: number, options?: TruncateOptions) => string;
   /**
-   * A duration in milliseconds as short human text: `250ms`, `1.2s`, `2s`, `1m 3s`, `2m`, `1h 2m`, `2h`.
+   * A duration as short human text: `250ms`, `1.2s`, `2s`, `1m 3s`, `2m`, `1h 2m`, `2h`.
    *
    * @remarks
    * Under a second it is whole milliseconds; under a minute, seconds to one decimal with a trailing `.0`
    * dropped; under an hour, minutes and whole seconds, with the seconds dropped when zero; from an hour, hours and
    * whole minutes, the seconds dropped. A value that rounds up to the next unit (`999.6` to a second, `59999` to a
    * minute, `3599999` to an hour) is written in that unit, so `1000ms`, `60s` and `60m` never appear. There is no
-   * days unit. A negative or non-finite input is `0ms`.
+   * days unit. The format is bespoke: core's `Duration.format` renders differently.
    *
-   * @param ms - the duration in milliseconds
+   * The input is anything `Duration.Input` admits. A plain number is milliseconds and is used as given, never
+   * converted through a `Duration`, which rounds a fractional millisecond to whole nanoseconds and would move a value
+   * such as `999.4999999` across the rounding boundary. A `bigint` is nanoseconds, as in core. A negative, infinite
+   * or invalid input (a string `Duration.Input` cannot parse) is `0ms`: a formatter in a render path never throws.
+   *
+   * @param input - the duration; a number is milliseconds
    */
-  static readonly duration: (ms: number) => string;
+  static readonly duration: (input: Duration.Input) => string;
   /**
    * A ratio from 0 to 1 as a percentage, or a number already from 0 to 100 with `scale: 100`: `83.3%`, `50%`,
    * `100%`.
@@ -3097,8 +3063,6 @@ export declare class Fmt {
    */
   static readonly plural: (n: number, singular: string, plural?: string) => string;
 }
-//#endregion
-//#region src/GithubAnnotation.d.ts
 /**
  * The severity of a GitHub annotation.
  *
@@ -3151,8 +3115,6 @@ export declare class GithubAnnotation {
    */
   static readonly format: (annotation: GithubAnnotationProperties, message: string) => string;
 }
-//#endregion
-//#region src/NotInteractive.d.ts
 declare const NotInteractive_base: Schema.Class<NotInteractive, Schema.TaggedStruct<"NotInteractive", {}>, import("effect/Cause").YieldableError>;
 /**
  * A command needed to prompt, but there is no terminal to prompt on.
@@ -3186,8 +3148,6 @@ export declare class NotInteractive extends NotInteractive_base {
    */
   get [Runtime.errorExitCode](): number;
 }
-//#endregion
-//#region src/Render.d.ts
 /**
  * Everything a renderer needs to know about where its output is going.
  *
@@ -3491,8 +3451,6 @@ export declare class Render {
    */
   static readonly githubLog: (doc: Document, ctx: RenderContext) => string;
 }
-//#endregion
-//#region src/SchemaIssueRenderer.d.ts
 /**
  * Turns a `SchemaIssue` tree into lines a user can act on.
  *
@@ -3535,6 +3493,5 @@ export declare class SchemaIssueRenderer {
    */
   static readonly render: (issue: unknown) => ReadonlyArray<string>;
 }
-//#endregion
 export type { AnnotationLevel, AnnotationOptions, AudienceFlagInput, Block, BlockOf, CliAudienceFlagsOptions, CliDocSource, CliEnvOptions, CliEnvServices, CliEnvTestOptions, CliEnvTestServices, CliExitShape, CliFailureOptions, CliLinksLinkerOptions, CliLinksOptions, CliLinksShape, CliLogFile, CliLogFileOptions, CliLogOptions, CliLogStatusOptions, CliLoggerOptions, CliMessageOptions, CliPromptFallbackOptions, CliPromptTarget, CliThemeOptions, CliThemeShape, CliThemeTestOptions, Column, CoreStatusName, Counter, CountsOptions, CountsRow, CountsTableOptions, DocPrintOptions, Document, EditorLinks, FailureDetails, GithubAnnotationProperties, GlyphSelectOptions, GlyphSet, Inline, InlineInput, InlineOf, LinkOptions, LinkTarget, ListOptions, MainOptions, NamedColor, OverflowOptions, PercentOptions, RenderContext, RenderContextOfOptions, RenderContextOptions, ReportFailuresOptions, RequiresAudienceFlags, StatusDef, StatusRef, StreamTheme, Style, TableOptions, TokenName, TreeInput, TreeNode, TruncateOptions };
 //# sourceMappingURL=index.d.ts.map

package/internal/ExitRequested.js

@@ -1,6 +1,6 @@
 import { Runtime } from "effect";
 
-//#region src/internal/ExitRequested.ts
+// src/internal/ExitRequested.ts
 /**
 * The failure `CliRuntime.main` raises when a successful program recorded a
 * non-zero exit code through `CliExit`. Private: nothing outside this package
@@ -18,5 +18,4 @@ var ExitRequested = class extends Error {
 	}
 };
 
-//#endregion
 export { ExitRequested };

package/internal/HelpRouting.js

@@ -1,7 +1,7 @@
 import { Console, Effect } from "effect";
 import { CliOutput } from "effect/cli";
 
-//#region src/internal/HelpRouting.ts
+// src/internal/HelpRouting.ts
 const OTHER_METHODS = Object.keys({
 	assert: true,
 	clear: true,
@@ -86,5 +86,4 @@ const routeHelpOnUsageError = (program) => Effect.gen(function* () {
 	return yield* program.pipe(Effect.provideService(CliOutput.Formatter, recording), Effect.provideService(Console.Console, routing), Effect.ensuring(Effect.sync(release)));
 });
 
-//#endregion
 export { routeHelpOnUsageError };

package/internal/ansi.js

@@ -1,4 +1,4 @@
-//#region src/internal/ansi.ts
+// src/internal/ansi.ts
 /** Foreground SGR parameter for each named colour: 30 to 37, then 90 to 97. */
 const NAMED = {
 	black: 30,
@@ -226,5 +226,4 @@ const paintStyle = (style, level, text) => {
 /** The raw opening SGR sequence of a style at a level, `""` at `none` or for a style that paints nothing. */
 const openSequence = (style, level) => level === "none" ? "" : wraps(style, level).toReversed().map((wrap) => wrap.open).join("");
 
-//#endregion
 export { nearest256, openSequence, paintStyle, parseHex };

package/internal/autoFormat.js

@@ -1,7 +1,7 @@
 import { Effect, Option } from "effect";
 import { CurrentRuntimeEnv } from "@effected/env";
 
-//#region src/internal/autoFormat.ts
+// src/internal/autoFormat.ts
 /**
 * Whether the environment says the program runs under GitHub Actions, whose runner reads workflow commands out of
 * the log.
@@ -30,5 +30,4 @@ const autoFormat = (audience) => Effect.gen(function* () {
 	return (yield* underGithubActions) ? "githubLog" : "plain";
 });
 
-//#endregion
 export { autoFormat, underGithubActions };

package/internal/canPrompt.js

@@ -1,6 +1,6 @@
 import { Config, Effect, Option } from "effect";
 
-//#region src/internal/canPrompt.ts
+// src/internal/canPrompt.ts
 /**
 * Whether the terminal facts let a run prompt: a terminal on standard input and on standard output, and a `TERM` that
 * is not `dumb`. A dumb terminal is a terminal, but it cannot move the cursor or take synchronized output, which every
@@ -11,5 +11,4 @@ import { Config, Effect, Option } from "effect";
 */
 const canPrompt = (terminal) => terminal.stdinIsTerminal && terminal.stdout.isTerminal ? Effect.map(Config.option(Config.String("TERM")).pipe(Effect.orElseSucceed(() => Option.none())), (term) => !(Option.isSome(term) && term.value === "dumb")) : Effect.succeed(false);
 
-//#endregion
 export { canPrompt };

package/internal/counts.js

@@ -1,6 +1,6 @@
 import { Fmt } from "../Fmt.js";
 
-//#region src/internal/counts.ts
+// src/internal/counts.ts
 /**
 * The label a counter shows for a count: its one label, or `one` when the count is exactly 1 and `other` otherwise.
 * The count is the counter's own `n`, except in a share headline (`1/3 repos`), which reads by the denominator, the
@@ -80,5 +80,4 @@ const countsTableOf = (block) => {
 	};
 };
 
-//#endregion
 export { columnLabel, counterLabel, countsTableOf, totalOf, visibleCountersOf };

package/internal/diagnostics.js

@@ -1,6 +1,6 @@
 import { Context, LogLevel, Logger, References } from "effect";
 
-//#region src/internal/diagnostics.ts
+// src/internal/diagnostics.ts
 /**
 * The diagnostics threshold reference behind `CliLog.Level`. Lives here so the stderr sink and the file sink share
 * one definition without `CliLog` importing itself.
@@ -28,5 +28,4 @@ const passes = (record, installed) => {
 */
 const formatNdjson = (record) => Logger.formatJson.log(record);
 
-//#endregion
 export { Level, formatNdjson, passes };

package/internal/displayWidth.js

@@ -1,4 +1,4 @@
-//#region src/internal/displayWidth.ts
+// src/internal/displayWidth.ts
 const segmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
 const ANSI = /\u001B\][^\u0007\u001B]*(?:\u0007|\u001B\\)|\u001B\[[0-?]*[ -/]*[@-~]/g;
 const EMOJI = /^\p{RGI_Emoji}$/v;
@@ -31,5 +31,4 @@ const displayWidth = (input) => {
 */
 const graphemes = (input) => Array.from(segmenter.segment(input), (s) => s.segment);
 
-//#endregion
 export { displayWidth, graphemes, stripAnsi };

package/internal/failureTarget.js

@@ -9,7 +9,7 @@ import { Config, Context, Effect, MutableRef, Option } from "effect";
 import { Audience, TerminalEnv } from "@effected/env";
 import { CommandNeutralizer } from "@effected/github-commands";
 
-//#region src/internal/failureTarget.ts
+// src/internal/failureTarget.ts
 /**
 * A cell `CliRuntime.main` provides outside failure reporting and fills from inside it.
 *
@@ -191,5 +191,4 @@ const readSpans = (explicit, envVar) => Effect.gen(function* () {
 	};
 });
 
-//#endregion
 export { FailureTargetCell, currentTarget, fallbackTarget, guardConsumerLines, linesOf, plainFailureLines, readSpans, refreshFailureTarget };

package/internal/fallbackAnswer.js

@@ -1,7 +1,7 @@
 import { Effect } from "effect";
 import { CliError, Prompt } from "effect/cli";
 
-//#region src/internal/fallbackAnswer.ts
+// src/internal/fallbackAnswer.ts
 /**
 * What a fallback hands core when the run is not interactive: `otherwise`, answered, when given (`undefined` counts
 * as not given); otherwise core's own missing-parameter error, so the parse fails exactly as it would with no
@@ -14,5 +14,4 @@ const answerWithoutPerson = (target) => {
 	return Effect.fail("flag" in target ? new CliError.MissingOption({ option: target.flag }) : new CliError.MissingArgument({ argument: target.argument }));
 };
 
-//#endregion
 export { answerWithoutPerson };

package/internal/fileSink.js

@@ -3,7 +3,7 @@ import { formatNdjson, passes } from "./diagnostics.js";
 import { Cause, Console, Effect, Exit, Fiber, FileSystem, Logger, Path, Queue } from "effect";
 import { CommandNeutralizer } from "@effected/github-commands";
 
-//#region src/internal/fileSink.ts
+// src/internal/fileSink.ts
 /** How long closing the scope waits for queued lines to reach the file before giving up on a hung filesystem. */
 const CLOSE_TIMEOUT = "2 seconds";
 /**
@@ -58,5 +58,4 @@ const makeFileSink = (path, installed, underActions) => Effect.gen(function* ()
 	});
 });
 
-//#endregion
 export { makeFileSink };

package/internal/format.js

@@ -1,6 +1,6 @@
 import { SchemaIssue } from "effect";
 
-//#region src/internal/format.ts
+// src/internal/format.ts
 /**
 * Core's structured formatter, with one phrasing override.
 *
@@ -101,5 +101,4 @@ const issueTreeChildren = (entries) => {
 	return [...leaves(root), ...[...root.children].map(([name, child]) => named(name, child))];
 };
 
-//#endregion
 export { formatIssue, issueEntries, issueTreeChildren };

package/internal/isExitCode.js

@@ -1,4 +1,4 @@
-//#region src/internal/isExitCode.ts
+// src/internal/isExitCode.ts
 /**
 * Whether `code` is an exit status a POSIX process can carry: an integer in
 * `0..255`. `NaN`, fractions and out-of-range values all fail — a relational
@@ -8,5 +8,4 @@
 */
 const isExitCode = (code) => Number.isInteger(code) && code >= 0 && code <= 255;
 
-//#endregion
 export { isExitCode };

package/internal/layout.js

@@ -1,7 +1,7 @@
 import { displayWidth, graphemes } from "./displayWidth.js";
 import { sanitize } from "../Fmt.js";
 
-//#region src/internal/layout.ts
+// src/internal/layout.ts
 const pathSeparator = (ctx) => ctx.audience === "agent" ? ctx.glyphs.pathSeparator.agent : ` ${ctx.glyphs.pathSeparator.human} `;
 /** A link target is sanitized like content, and loses its line breaks, which no URL or path holds. */
 const safeTargetText = (text) => sanitize(text).replace(/[\r\n]/g, "");
@@ -246,5 +246,4 @@ const wrapSpans = (spans, width, options) => {
 	return lines.map(spansFromCells);
 };
 
-//#endregion
 export { flatten, paintSpans, truncateSpans, widthOf, wrapSpans };

package/internal/linkScheme.js

@@ -1,6 +1,6 @@
 import { sanitize } from "../Fmt.js";
 
-//#region src/internal/linkScheme.ts
+// src/internal/linkScheme.ts
 /** The URL schemes a link may have, besides a relative URL. */
 const ALLOWED = /* @__PURE__ */ new Set([
 	"http",
@@ -26,5 +26,4 @@ const isAllowedLinkUrl = (url) => {
 	return scheme === null || ALLOWED.has(scheme[1]);
 };
 
-//#endregion
 export { isAllowedLinkUrl };

package/internal/linkTarget.js

@@ -1,4 +1,4 @@
-//#region src/internal/linkTarget.ts
+// src/internal/linkTarget.ts
 const LONE_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g;
 /**
 * A Windows drive path (`C:\x`, `C:/x`): absolute whatever the `Path` flavour, so never resolved against a directory.
@@ -46,5 +46,4 @@ const fileUrlPath = (absolute) => {
 */
 const encodeForOsc8 = (url) => url.replace(LONE_SURROGATE, "�").replace(/[^\x20-\x7e]/gu, (char) => encodeURIComponent(char));
 
-//#endregion
 export { DRIVE, UNC, encodeForOsc8, encodePath, fileUrlPath };

package/internal/logSafety.js

@@ -2,7 +2,7 @@ import { sanitize } from "../Fmt.js";
 import { Context, Option } from "effect";
 import { CurrentRuntimeEnv } from "@effected/env";
 
-//#region src/internal/logSafety.ts
+// src/internal/logSafety.ts
 /**
 * Marks a log line the kit has already rendered, so the logger does not strip the escapes the kit painted into it.
 *
@@ -42,5 +42,4 @@ const sanitizeParts = (message) => {
 */
 const neutralizeJson = (line) => line.replaceAll("##[", "#\\u0023[");
 
-//#endregion
 export { TrustedLine, neutralizeJson, sanitizeParts, underActionsIn };

package/internal/renderAnsi.js

@@ -1,7 +1,7 @@
 import { flatten, paintSpans } from "./layout.js";
 import { renderDoc, showsSuffix, targetText } from "./renderDoc.js";
 
-//#region src/internal/renderAnsi.ts
+// src/internal/renderAnsi.ts
 /**
 * Inline content as styled spans: code painted `accent` with no backticks, and links kept on their spans so that
 * painting wraps them through `ctx.link`.
@@ -48,5 +48,4 @@ const ansi = {
 */
 const renderAnsi = (doc, ctx) => renderDoc(doc, ctx, ansi);
 
-//#endregion
 export { renderAnsi };

package/internal/renderDoc.js

@@ -2,7 +2,7 @@ import { Fmt, sanitize } from "../Fmt.js";
 import { counterLabel, countsTableOf, totalOf, visibleCountersOf } from "./counts.js";
 import { truncateSpans, widthOf, wrapSpans } from "./layout.js";
 
-//#region src/internal/renderDoc.ts
+// src/internal/renderDoc.ts
 const span = (text, token) => token === void 0 ? { text } : {
 	text,
 	token
@@ -319,5 +319,4 @@ const renderDocLines = (doc, ctx, flavour) => {
 */
 const renderDoc = (doc, ctx, flavour) => renderDocLines(doc, ctx, flavour).join("\n");
 
-//#endregion
 export { capOf, isAnnotation, renderDoc, renderDocLines, showsSuffix, targetText, textLines, trimLine };

package/internal/renderGithubLog.js

@@ -2,7 +2,7 @@ import { sanitize } from "../Fmt.js";
 import { plainInline, renderPlainLines } from "./renderPlain.js";
 import { CommandNeutralizer, WorkflowCommand } from "@effected/github-commands";
 
-//#region src/internal/renderGithubLog.ts
+// src/internal/renderGithubLog.ts
 /** Plain lines, neutralized; a block that draws nothing, such as an empty table, gives no line at all. */
 const plainLines = (blocks, ctx) => renderPlainLines(blocks, ctx).flatMap((line) => CommandNeutralizer.lines(line));
 /**
@@ -54,5 +54,4 @@ const blockLines = (block, ctx) => {
 */
 const renderGithubLog = (doc, ctx) => doc.flatMap((block) => blockLines(block, ctx)).join("\n");
 
-//#endregion
 export { renderGithubLog };

package/internal/renderMarkdown.js

@@ -5,7 +5,7 @@ import { DRIVE, encodePath, fileUrlPath } from "./linkTarget.js";
 import { flatten } from "./layout.js";
 import { capOf, isAnnotation, showsSuffix, targetText, textLines } from "./renderDoc.js";
 
-//#region src/internal/renderMarkdown.ts
+// src/internal/renderMarkdown.ts
 /** Marks a line break inside flowing text until the paragraph is split into lines. Sanitized text never holds NUL. */
 const BREAK = "\0";
 /**
@@ -364,5 +364,4 @@ const blockMd = (walk, block, depth, compact = false) => {
 */
 const renderMarkdown = (doc, ctx) => joinBlocks(doc.map((block) => blockMd({ ctx }, block, 0))).join("\n");
 
-//#endregion
 export { renderMarkdown };

package/internal/renderPlain.js

@@ -1,7 +1,7 @@
 import { flatten } from "./layout.js";
 import { renderDocLines, showsSuffix, targetText } from "./renderDoc.js";
 
-//#region src/internal/renderPlain.ts
+// src/internal/renderPlain.ts
 /**
 * Inline content as spans of plain text: code in backticks, and a link as its label followed by its target in
 * parentheses unless the label already is the target. Tokens and links are dropped, as plain text has neither.
@@ -46,5 +46,4 @@ const renderPlainLines = (doc, ctx) => renderDocLines(doc, {
 */
 const renderPlain = (doc, ctx) => renderPlainLines(doc, ctx).join("\n");
 
-//#endregion
 export { plainInline, renderPlain, renderPlainLines };

package/internal/scanAudience.js

@@ -1,4 +1,4 @@
-//#region src/internal/scanAudience.ts
+// src/internal/scanAudience.ts
 /**
 * The one counting rule, shared by the resolver that runs on parsed flags and by {@link scanAudience}, so the two
 * cannot drift: every `--audience` value counts, and a boolean counts only when it is true (`--agent=false` and
@@ -102,5 +102,4 @@ const scanAudience = (argv) => {
 	});
 };
 
-//#endregion
 export { scanAudience, tallyAudience };

package/internal/splitFrame.js

@@ -1,4 +1,4 @@
-//#region src/internal/splitFrame.ts
+// src/internal/splitFrame.ts
 /** What JavaScript's `.` does not match outside dotAll mode: the four line terminators. */
 const isTerminator = (ch) => ch === "\n" || ch === "\r" || ch === "\u2028" || ch === "\u2029";
 /** One UTF-16 unit of JavaScript's `\s`; every character `\s` matches is in the BMP. */
@@ -52,5 +52,4 @@ const splitFrame = (raw) => {
 	};
 };
 
-//#endregion
 export { splitFrame };

package/internal/wizardGate.js

@@ -1,6 +1,6 @@
 import { Context } from "effect";
 
-//#region src/internal/wizardGate.ts
+// src/internal/wizardGate.ts
 /**
 * The exact `CliConfig` object `CliPrompt.gateWizard` produced when it removed `--wizard`, or `undefined` when it
 * removed nothing.
@@ -14,5 +14,4 @@ import { Context } from "effect";
 */
 var WizardDropped = class extends Context.Reference("@effected/cli/WizardDropped", { defaultValue: () => void 0 }) {};
 
-//#endregion
 export { WizardDropped };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effected/cli",
-	"version": "0.19.0",
+	"version": "0.21.0",
 	"private": false,
 	"description": "The presentation boundary of an effect/cli program: audience-aware output, a document IR and renderers, editor links, failure reports and logging, plus opt-in Ink screens, widgets and a live view",
 	"keywords": [
@@ -57,13 +57,13 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@effected/github-commands": "^0.5.0"
+		"@effected/github-commands": "^0.6.1"
 	},
 	"peerDependencies": {
-		"@effected/config-file": "^0.17.0",
-		"@effected/env": "^0.4.0",
-		"@effected/glob": "^0.13.0",
-		"@effected/walker": "^0.18.0",
+		"@effected/config-file": "^0.19.0",
+		"@effected/env": "^0.5.0",
+		"@effected/glob": "^0.14.0",
+		"@effected/walker": "^0.19.0",
 		"@types/react": "^19.3.0",
 		"effect": "^4.0.0",
 		"ink": "^8.0.0",