@effected/cli 0.19.0 → 0.21.0

package/Cancelled.js

@@ -1,6 +1,6 @@
 import { Runtime, Schema } from "effect";
 
-//#region src/Cancelled.ts
+// src/Cancelled.ts
 /**
 * A person backed out of an interactive prompt: they pressed escape, or the
 * prompt was interrupted.
@@ -40,5 +40,4 @@ var Cancelled = class extends Schema.TaggedError()("Cancelled", { reason: Schema
 	}
 };
 
-//#endregion
 export { Cancelled };

package/CliAudience.js

@@ -7,7 +7,7 @@ import { Effect, Option, Stdio } from "effect";
 import { Audience, TerminalEnv } from "@effected/env";
 import { CliConfig, CliError, Command, Flag, GlobalFlag } from "effect/cli";
 
-//#region src/CliAudience.ts
+// src/CliAudience.ts
 const KINDS = [
 	"human",
 	"agent",
@@ -174,5 +174,4 @@ var CliAudience = class CliAudience {
 	static run = (command, config) => Stdio.Stdio.use(({ args }) => Effect.flatMap(args, (argv) => CliAudience.runWith(command, config)(argv)));
 };
 
-//#endregion
 export { CliAudience };

package/CliColor.js

@@ -2,7 +2,7 @@ import { Effect, Layer } from "effect";
 import { TerminalEnv } from "@effected/env";
 import { CliOutput } from "effect/cli";
 
-//#region src/CliColor.ts
+// src/CliColor.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.
@@ -56,5 +56,4 @@ var CliColor = class CliColor {
 	})));
 };
 
-//#endregion
 export { CliColor };

package/CliEnv.js

@@ -5,7 +5,7 @@ import { CliPrompt } from "./CliPrompt.js";
 import { ConfigProvider, Layer, Option } from "effect";
 import { Audience, CurrentRuntimeEnv, TerminalEnv } from "@effected/env";
 
-//#region src/CliEnv.ts
+// src/CliEnv.ts
 /**
 * The environment services a CLI reads, built once and in the right order.
 *
@@ -85,5 +85,4 @@ var CliEnv = class {
 	};
 };
 
-//#endregion
 export { CliEnv };

package/CliExit.js

@@ -1,7 +1,7 @@
 import { isExitCode } from "./internal/isExitCode.js";
 import { Context, Effect, Layer, MutableRef } from "effect";
 
-//#region src/CliExit.ts
+// src/CliExit.ts
 /**
 * The exit code a successful run wants, for commands whose findings are a
 * result rather than a failure (a linter that found problems, say).
@@ -61,5 +61,4 @@ var CliExit = class CliExit extends Context.Service()("@effected/cli/CliExit") {
 	});
 };
 
-//#endregion
 export { CliExit };

package/CliFailure.js

@@ -7,7 +7,7 @@ import { NotInteractive } from "./NotInteractive.js";
 import { Status } from "./Status.js";
 import { Cause, Context, SchemaIssue } from "effect";
 
-//#region src/CliFailure.ts
+// src/CliFailure.ts
 /**
 * The protocol an error class implements to say how a failure is shown: a method under this key that returns the
 * document.
@@ -298,5 +298,4 @@ var CliFailure = class {
 	};
 };
 
-//#endregion
 export { CliDoc, CliFailure };

package/CliInteractive.js

@@ -2,7 +2,7 @@ import { canPrompt } from "./internal/canPrompt.js";
 import { Context, Effect, Layer } from "effect";
 import { Audience, TerminalEnv } from "@effected/env";
 
-//#region src/CliInteractive.ts
+// src/CliInteractive.ts
 /**
 * Whether this run may prompt a person: a human audience, with a terminal on
 * both standard input and standard output, and a `TERM` that is not `dumb`.
@@ -67,5 +67,4 @@ var CliInteractive = class CliInteractive extends Context.Reference("@effected/c
 	});
 };
 
-//#endregion
 export { CliInteractive };

package/CliLinks.js

@@ -5,7 +5,7 @@ import { Config, Context, Effect, FileSystem, Layer, Option, Path } from "effect
 import { CurrentRuntimeEnv } from "@effected/env";
 import { Walker } from "@effected/walker";
 
-//#region src/CliLinks.ts
+// src/CliLinks.ts
 const MODES = [
 	"auto",
 	"vscode",
@@ -150,5 +150,4 @@ const ambientLinksLayer = (options = {}) => Layer.effect(CliLinks, Effect.gen(fu
 	});
 }));
 
-//#endregion
 export { CliLinks, ambientLinksLayer };

package/CliLog.js

@@ -10,7 +10,7 @@ import { Cause, Config, Console, Context, Effect, Layer, LogLevel, Logger, Optio
 import { Audience, CurrentRuntimeEnv, TerminalEnv } from "@effected/env";
 import { CommandNeutralizer } from "@effected/github-commands";
 
-//#region src/CliLog.ts
+// src/CliLog.ts
 /** The most spaces a numeric `indent` writes. */
 const MAX_INDENT = 64;
 /** An indent as written before the glyph: spaces for a number, a string with nothing in it that is not text. */
@@ -342,5 +342,4 @@ const envBuildLogLayer = (options, audienceEnvVar) => Layer.unwrap(Effect.gen(fu
 	})]);
 }));
 
-//#endregion
 export { CliLog, envBuildLogLayer, platformLogLayer };

package/CliLogger.js

@@ -3,7 +3,7 @@ import { TrustedLine, sanitizeParts, underActionsIn } from "./internal/logSafety
 import { Console, LogLevel, Logger, References } from "effect";
 import { CommandNeutralizer } from "@effected/github-commands";
 
-//#region src/CliLogger.ts
+// src/CliLogger.ts
 const defaultRender = (message) => Array.isArray(message) ? message.map(String).join(" ") : String(message);
 /**
 * A `Logger` that renders CLI output rather than service logs: no timestamp, level or fiber id, with every level
@@ -88,5 +88,4 @@ const makeCliLogger = (options = {}, underActions = underActionsIn) => {
 	});
 };
 
-//#endregion
 export { CliLogger, makeCliLogger };

package/CliMessage.js

@@ -6,7 +6,7 @@ import { Console, Effect } from "effect";
 import { Audience } from "@effected/env";
 import { CommandNeutralizer } from "@effected/github-commands";
 
-//#region src/CliMessage.ts
+// src/CliMessage.ts
 /**
 * One-line status messages: a glyph and some text, themed for a person and plain for an agent.
 *
@@ -76,5 +76,4 @@ var CliMessage = class CliMessage {
 	static failure = (text) => CliMessage.status(Status.core, "failure", text);
 };
 
-//#endregion
 export { CliMessage };

package/CliPrompt.js

@@ -5,7 +5,7 @@ import { answerWithoutPerson } from "./internal/fallbackAnswer.js";
 import { Context, Effect, Layer, Queue, Terminal } from "effect";
 import { CliConfig, GlobalFlag, Prompt } from "effect/cli";
 
-//#region src/CliPrompt.ts
+// src/CliPrompt.ts
 /**
 * Prompts that know whether there is a person to ask.
 *
@@ -99,5 +99,4 @@ var CliPrompt = class {
 	}));
 };
 
-//#endregion
 export { CliPrompt };

package/CliRuntime.js

@@ -15,7 +15,7 @@ import { Cause, Effect, Layer, Logger, MutableRef, Runtime } from "effect";
 import { CliError } from "effect/cli";
 import { CommandNeutralizer } from "@effected/github-commands";
 
-//#region src/CliRuntime.ts
+// src/CliRuntime.ts
 const isShowHelp = (u) => CliError.isCliError(u) && u._tag === "ShowHelp";
 /** A `UserError` `Command.runWith` already printed: it sets the mark to `false` after rendering. */
 const isRenderedUserError = (u) => CliError.isCliError(u) && u._tag === "UserError" && Runtime.getErrorReported(u) === false;
@@ -220,5 +220,4 @@ var CliRuntime = class CliRuntime {
 	}
 };
 
-//#endregion
 export { CliRuntime };

package/CliTest.js

@@ -1,7 +1,7 @@
 import { Effect, FileSystem, Path, Stream } from "effect";
 import { ChildProcess, ChildProcessSpawner } from "effect/process";
 
-//#region src/CliTest.ts
+// src/CliTest.ts
 const text = (stream) => Stream.mkString(Stream.decodeText(stream));
 /**
 * Spawn a built CLI bin hermetically and read its exit code and streams as data.
@@ -91,5 +91,4 @@ var CliTest = class {
 	}));
 };
 
-//#endregion
 export { CliTest };

package/CliTheme.js

@@ -5,7 +5,7 @@ import { Config, Context, Effect, Layer, Option } from "effect";
 import { TerminalEnv } from "@effected/env";
 import { Prompt } from "effect/cli";
 
-//#region src/CliTheme.ts
+// src/CliTheme.ts
 /**
 * A stream theme at `color`, over a style resolution and a glyph set: the one way a {@link StreamTheme} is built.
 *
@@ -139,5 +139,4 @@ var CliTheme = class CliTheme extends Context.Service()("@effected/cli/CliTheme"
 	}));
 };
 
-//#endregion
 export { CliTheme, streamThemeAt };

package/ConfigIssueRenderer.js

@@ -1,6 +1,6 @@
 import { formatIssue } from "./internal/format.js";
 
-//#region src/ConfigIssueRenderer.ts
+// src/ConfigIssueRenderer.ts
 /**
 * Turns a `@effected/config-file` `ConfigValidationError` into one line per rejected value.
 *
@@ -54,5 +54,4 @@ var ConfigIssueRenderer = class {
 	static render = (error) => formatIssue(error?.issue);
 };
 
-//#endregion
 export { ConfigIssueRenderer };

package/Doc.js

@@ -3,7 +3,7 @@ import { totalOf, visibleCountersOf } from "./internal/counts.js";
 import { Render } from "./Render.js";
 import { Console, Effect } from "effect";
 
-//#region src/Doc.ts
+// src/Doc.ts
 const isList = (input) => Array.isArray(input);
 const freeze = (value) => Object.freeze(value);
 const frozenArray = (items) => Object.freeze([...items]);
@@ -540,5 +540,4 @@ var Doc = class {
 	});
 };
 
-//#endregion
 export { Doc };

package/Fmt.js

@@ -1,6 +1,7 @@
 import { displayWidth, graphemes, stripAnsi } from "./internal/displayWidth.js";
+import { Duration, Option } from "effect";
 
-//#region src/Fmt.ts
+// src/Fmt.ts
 const CONTROL = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/g;
 /**
 * Text made safe to lay out and print: complete ANSI and OSC sequences removed, every remaining control character
@@ -76,18 +77,27 @@ var Fmt = class {
 		return useEllipsis ? `${out}${ellipsis}` : out;
 	};
 	/**
-	* 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 duration = (ms) => {
+	static duration = (input) => {
+		const ms = typeof input === "number" ? input : Option.match(Duration.fromInput(input), {
+			onNone: () => 0,
+			onSome: Duration.toMillis
+		});
 		const value = Number.isFinite(ms) ? Math.max(0, ms) : 0;
 		const whole = Math.round(value);
 		if (whole < 1e3) return `${whole}ms`;
@@ -129,5 +139,4 @@ var Fmt = class {
 	static plural = (n, singular, plural) => `${n} ${n === 1 ? singular : plural ?? `${singular}s`}`;
 };
 
-//#endregion
 export { Fmt, sanitize };

package/GithubAnnotation.js

@@ -1,6 +1,6 @@
 import { WorkflowCommand } from "@effected/github-commands";
 
-//#region src/GithubAnnotation.ts
+// src/GithubAnnotation.ts
 /**
 * GitHub Actions annotations, as workflow commands.
 *
@@ -36,5 +36,4 @@ var GithubAnnotation = class {
 	};
 };
 
-//#endregion
 export { GithubAnnotation };

package/Glyphs.js

@@ -1,4 +1,4 @@
-//#region src/Glyphs.ts
+// src/Glyphs.ts
 /**
 * The two glyph sets: Unicode, and a plain-ASCII fallback for terminals that cannot draw it.
 *
@@ -79,5 +79,4 @@ var Glyphs = class Glyphs {
 	});
 };
 
-//#endregion
 export { Glyphs };

package/NotInteractive.js

@@ -1,6 +1,6 @@
 import { Runtime, Schema } from "effect";
 
-//#region src/NotInteractive.ts
+// src/NotInteractive.ts
 /**
 * A command needed to prompt, but there is no terminal to prompt on.
 *
@@ -38,5 +38,4 @@ var NotInteractive = class extends Schema.TaggedError()("NotInteractive", {}) {
 	}
 };
 
-//#endregion
 export { NotInteractive };

package/Render.js

@@ -12,7 +12,7 @@ import { Effect } from "effect";
 import { Audience, TerminalEnv } from "@effected/env";
 import { CommandNeutralizer } from "@effected/github-commands";
 
-//#region src/Render.ts
+// src/Render.ts
 /** A renderer's text, with workflow commands neutralized when the context says the runner is reading it. */
 const guarded = (text, ctx) => ctx.neutralizeWorkflowCommands === true ? CommandNeutralizer.text(text) : text;
 /**
@@ -252,5 +252,4 @@ var Render = class {
 	static githubLog = (doc, ctx) => renderGithubLog(doc, ctx);
 };
 
-//#endregion
 export { Render };

package/SchemaIssueRenderer.js

@@ -1,6 +1,6 @@
 import { formatIssue } from "./internal/format.js";
 
-//#region src/SchemaIssueRenderer.ts
+// src/SchemaIssueRenderer.ts
 /**
 * Turns a `SchemaIssue` tree into lines a user can act on.
 *
@@ -44,5 +44,4 @@ var SchemaIssueRenderer = class {
 	static render = (issue) => formatIssue(issue);
 };
 
-//#endregion
 export { SchemaIssueRenderer };

package/Status.js

@@ -1,7 +1,7 @@
 import { sanitize } from "./Fmt.js";
 import { Array, Option } from "effect";
 
-//#region src/Status.ts
+// src/Status.ts
 /**
 * An open vocabulary of statuses.
 *
@@ -162,5 +162,4 @@ var Status = class Status {
 	}
 };
 
-//#endregion
 export { Status };

package/TestTerminal.js

@@ -1,6 +1,6 @@
 import { Effect, Layer, Option, Queue, Terminal } from "effect";
 
-//#region src/TestTerminal.ts
+// src/TestTerminal.ts
 /**
 * A scripted `Terminal` for testing prompts and anything that reads the terminal.
 *
@@ -76,5 +76,4 @@ var TestTerminal = class {
 	});
 };
 
-//#endregion
 export { TestTerminal };

package/Token.js

@@ -1,4 +1,4 @@
-//#region src/Token.ts
+// src/Token.ts
 /** The default style of every token. Deeply frozen: the record is shared. */
 const DEFAULTS = Object.freeze({
 	success: Object.freeze({ fg: "green" }),
@@ -65,5 +65,4 @@ var Token = class {
 	static style = (style) => style;
 };
 
-//#endregion
 export { Token };