@effected/cli 0.20.0 → 0.21.0

package/Fmt.js

@@ -1,4 +1,5 @@
 import { displayWidth, graphemes, stripAnsi } from "./internal/displayWidth.js";
+import { Duration, Option } from "effect";
 
 // src/Fmt.ts
 const CONTROL = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/g;
@@ -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`;

package/index.d.ts

@@ -1,4 +1,4 @@
-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";
@@ -3025,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%`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effected/cli",
-	"version": "0.20.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,10 +57,10 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@effected/github-commands": "^0.6.0"
+		"@effected/github-commands": "^0.6.1"
 	},
 	"peerDependencies": {
-		"@effected/config-file": "^0.18.0",
+		"@effected/config-file": "^0.19.0",
 		"@effected/env": "^0.5.0",
 		"@effected/glob": "^0.14.0",
 		"@effected/walker": "^0.19.0",

package/ui/CliUi.js

@@ -306,7 +306,7 @@ var CliUi = class CliUi {
 	* so core renders its own message and `CliRuntime.main` exits `64`. Name the parameter with `flag` (the name
 	* without dashes) or `argument` so that error can be built.
 	*
-	* The options are {@link @effected/cli!CliPromptFallbackOptions}, the same as `CliPrompt.fallback`'s, and `clear`
+	* The options are `CliPromptFallbackOptions` (from `@effected/cli`), the same as `CliPrompt.fallback`'s, and `clear`
 	* as for {@link CliUi.run}.
 	*
 	* It runs during parsing, whose environment is core's alone, so it reads `CliTheme` if one is there: with

package/ui/UiKey.js

@@ -5,7 +5,7 @@ const named = (name) => ({
 });
 const CONTROL = /[\u0000-\u001f\u007f]/;
 /**
-* Normalising Ink's input into {@link UiKey}s.
+* Normalising Ink's input into {@link (UiKey:type)}s.
 *
 * @public
 */

package/ui.d.ts

@@ -484,7 +484,7 @@ export declare class CliUi {
    * so core renders its own message and `CliRuntime.main` exits `64`. Name the parameter with `flag` (the name
    * without dashes) or `argument` so that error can be built.
    *
-   * The options are {@link @effected/cli!CliPromptFallbackOptions}, the same as `CliPrompt.fallback`'s, and `clear`
+   * The options are `CliPromptFallbackOptions` (from `@effected/cli`), the same as `CliPrompt.fallback`'s, and `clear`
    * as for {@link CliUi.run}.
    *
    * It runs during parsing, whose environment is core's alone, so it reads `CliTheme` if one is there: with
@@ -619,7 +619,7 @@ export type UiKey = {
   readonly char: string;
 };
 /**
- * Normalising Ink's input into {@link UiKey}s.
+ * Normalising Ink's input into {@link (UiKey:type)}s.
  *
  * @public
  */
@@ -1517,8 +1517,8 @@ interface TextInputScreenOptions {
    * does the scrollback; erase the frame as well with `clear: true` on the run when even the mask's length should not
    * stay behind.
    *
-   * The message `validate` returns is drawn as it is, unmasked: a message that echoes the value (`"ghp_abc is a
-   * token"`) draws the secret in the frame. Say what is wrong without quoting the value.
+   * The message `validate` returns is drawn as it is, unmasked: a message that echoes the value
+   * (`"ghp_abc is a token"`) draws the secret in the frame. Say what is wrong without quoting the value.
    */
   readonly mask?: string | true | ((value: string) => boolean);
 }
@@ -1665,7 +1665,7 @@ declare const UiStreams_base: Context.Reference<UiStreamsShape>;
  */
 export declare class UiStreams extends UiStreams_base {}
 /**
- * The styling props of an Ink `Text` that a {@link @effected/cli!Style} maps to.
+ * The styling props of an Ink `Text` that a `Style` (from `@effected/cli`) maps to.
  *
  * @public
  */