@effected/cli 0.19.0 → 0.21.0

package/testing.d.ts

@@ -1,6 +1,5 @@
 import { Effect, FileSystem, Layer, Path, PlatformError, Scope, Terminal } from "effect";
 import { ChildProcessSpawner } from "effect/process";
-//#region src/CliTest.d.ts
 /**
  * A hermetic temp directory minted by {@link CliTest.sandbox}, removed when its
  * scope closes.
@@ -105,8 +104,6 @@ export declare class CliTest {
    */
   static readonly run: (bin: string, args: ReadonlyArray<string>, options: RunOptions) => Effect.Effect<RunResult, PlatformError.PlatformError, ChildProcessSpawner.ChildProcessSpawner>;
 }
-//#endregion
-//#region src/TestTerminal.d.ts
 /**
  * One key press for {@link TestTerminal}.
  *
@@ -175,6 +172,5 @@ export declare class TestTerminal {
     readonly rows?: number | undefined;
   }) => Effect.Effect<TestTerminalHandle>;
 }
-//#endregion
 export type { KeyInput, RunOptions, RunResult, Sandbox, TestTerminalHandle };
 //# sourceMappingURL=testing.d.ts.map

package/ui/CliUi.js

@@ -18,7 +18,7 @@ import { Cause, Deferred, Effect, Exit, Option, Semaphore } from "effect";
 import { Audience } from "@effected/env";
 import { Prompt } from "effect/cli";
 
-//#region src/ui/CliUi.ts
+// src/ui/CliUi.ts
 /**
 * stdout's theme as the audience sees it: colourless for an agent (as `Render.context` makes it), so a screen's
 * `useTheme`, `Styled` and the widgets' colour-none markers never carry an escape for one. `Audience` is read only when
@@ -159,7 +159,7 @@ var CliUi = class CliUi {
 		const crashed = crash.current;
 		const interrupted = Exit.isFailure(exit) && Cause.hasInterruptsOnly(exit.cause);
 		if (crashed === void 0 || interrupted) return yield* exit;
-		const dies = Exit.isFailure(exit) ? exit.cause.reasons.filter(Cause.isDieReason) : [];
+		const dies = Exit.isFailure(exit) ? exit.cause.reasons.filter((reason) => Cause.isDieReason(reason) && !(reason.defect instanceof Cancelled)) : [];
 		if (dies.some((reason) => reason.defect === crashed.defect)) return yield* exit;
 		return yield* Effect.failCause(Cause.fromReasons([Cause.makeDieReason(crashed.defect), ...dies]));
 	});
@@ -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
@@ -429,5 +429,4 @@ var CliUi = class CliUi {
 	});
 };
 
-//#endregion
 export { CliUi };

package/ui/CliUiLive.js

@@ -17,7 +17,7 @@ import { Cause, Clock, Duration, Effect, Exit, Fiber, Option, PubSub, Pull, Queu
 import { Audience, TerminalEnv } from "@effected/env";
 import { CommandNeutralizer } from "@effected/github-commands";
 
-//#region src/ui/CliUiLive.ts
+// src/ui/CliUiLive.ts
 /**
 * The live tree's height clamp: at most the terminal's rows less one, re-read on every render and when the terminal
 * resizes, so a tall frame never takes Ink's clear-terminal path, which wipes the scrollback. No width: Ink sizes the root itself.
@@ -436,5 +436,4 @@ const live = (options) => Effect.gen(function* () {
 	};
 });
 
-//#endregion
 export { live };

package/ui/Confirm.js

@@ -8,7 +8,7 @@ import { KeyHelp } from "./KeyHelp.js";
 import { Toggle } from "./Toggle.js";
 import { Viewport } from "./Viewport.js";
 
-//#region src/ui/Confirm.ts
+// src/ui/Confirm.ts
 const assertUniqueKeys = (toggles) => {
 	const seen = /* @__PURE__ */ new Set();
 	for (const toggle of toggles) {
@@ -241,5 +241,4 @@ var Confirm = class Confirm {
 	};
 };
 
-//#endregion
 export { Confirm };

package/ui/DocView.js

@@ -3,7 +3,7 @@ import { fromReact, inkModules } from "./internal/ink.js";
 import { screenContext } from "./internal/ScreenContext.js";
 import { useTerminalSize } from "./UiTheme.js";
 
-//#region src/ui/DocView.ts
+// src/ui/DocView.ts
 const OUTSIDE = "@effected/cli/ui: DocView was drawn with no ctx outside a screen, a live view or a UiProvider, so it has no theme";
 /** The context a `DocView` builds from its tree's theme: the theme's own paint, so token overrides hold. */
 const contextOf = (theme, width, neutralize) => ({
@@ -70,5 +70,4 @@ const docView = fromReact((react) => {
 */
 const DocView = (props) => inkModules().react.createElement(docView(), props);
 
-//#endregion
 export { DocView };

package/ui/KeyHelp.js

@@ -4,7 +4,7 @@ import { Styled, useGlyphs, useTerminalSize } from "./UiTheme.js";
 import { KeyTable } from "./KeyTable.js";
 import { lineText } from "./internal/lineText.js";
 
-//#region src/ui/KeyHelp.ts
+// src/ui/KeyHelp.ts
 /** The fewest cells worth giving the widget's own keys when the line is cut; below it they are left out. */
 const MIN_OWN = 4;
 /**
@@ -58,5 +58,4 @@ const KeyHelp = (props) => {
 	return inkModules().react.createElement(Styled, { token: "muted" }, line);
 };
 
-//#endregion
 export { KeyHelp };

package/ui/KeyTable.js

@@ -4,7 +4,7 @@ import { useScreenGuard } from "./internal/ScreenContext.js";
 import { UiKey } from "./UiKey.js";
 import { Option } from "effect";
 
-//#region src/ui/KeyTable.ts
+// src/ui/KeyTable.ts
 /** Arrows under a Unicode glyph set; everything else, and everything under ASCII, as words. */
 const ARROWS = {
 	up: "↑",
@@ -195,5 +195,4 @@ const useKeys = (table, dispatch, options = {}) => {
 	}), { isActive: options.isActive ?? true });
 };
 
-//#endregion
 export { KeyTable, useKeys };

package/ui/MultiSelect.js

@@ -7,7 +7,7 @@ import { lineText } from "./internal/lineText.js";
 import { KeyHelp } from "./KeyHelp.js";
 import { Viewport } from "./Viewport.js";
 
-//#region src/ui/MultiSelect.ts
+// src/ui/MultiSelect.ts
 /** Every item with its section's index, numbered across sections in order. */
 const flatten = (sections) => sections.flatMap((section, index) => section.items.map((item) => ({
 	section: index,
@@ -256,5 +256,4 @@ var MultiSelect = class MultiSelect {
 	};
 };
 
-//#endregion
 export { MultiSelect };

package/ui/Select.js

@@ -8,7 +8,7 @@ import { KeyHelp } from "./KeyHelp.js";
 import { Viewport } from "./Viewport.js";
 import { Option } from "effect";
 
-//#region src/ui/Select.ts
+// src/ui/Select.ts
 const enabled = (choices, index) => index >= 0 && index < choices.length && choices[index]?.disabled !== true;
 /** The nearest enabled index from `from` in `direction`, or `undefined`. */
 const nearest = (choices, from, direction) => {
@@ -226,5 +226,4 @@ var Select = class Select {
 	};
 };
 
-//#endregion
 export { Select };

package/ui/Tabs.js

@@ -4,7 +4,7 @@ import { Styled, useGlyphs, useTerminalSize, useTheme } from "./UiTheme.js";
 import { KeyTable, useKeys } from "./KeyTable.js";
 import { lineText } from "./internal/lineText.js";
 
-//#region src/ui/Tabs.ts
+// src/ui/Tabs.ts
 const step = (index, count, action) => {
 	if (count <= 0) return index;
 	if (action === "prev") return (index - 1 + count) % count;
@@ -198,5 +198,4 @@ var Tabs = class {
 	};
 };
 
-//#endregion
 export { Tabs };

package/ui/TextInput.js

@@ -7,7 +7,7 @@ import { KeyTable } from "./KeyTable.js";
 import { lineText } from "./internal/lineText.js";
 import { KeyHelp } from "./KeyHelp.js";
 
-//#region src/ui/TextInput.ts
+// src/ui/TextInput.ts
 const init = (options = {}) => {
 	const value = options.initial ?? "";
 	return {
@@ -286,5 +286,4 @@ var TextInput = class TextInput {
 	});
 };
 
-//#endregion
 export { TextInput };

package/ui/Toggle.js

@@ -3,7 +3,7 @@ import { inkModules } from "./internal/ink.js";
 import { Styled, useGlyphs, useTerminalSize } from "./UiTheme.js";
 import { lineText } from "./internal/lineText.js";
 
-//#region src/ui/Toggle.ts
+// src/ui/Toggle.ts
 /**
 * An on/off row: a check glyph and a label.
 *
@@ -28,5 +28,4 @@ var Toggle = class {
 	};
 };
 
-//#endregion
 export { Toggle };

package/ui/UiKey.js

@@ -1,11 +1,11 @@
-//#region src/ui/UiKey.ts
+// src/ui/UiKey.ts
 const named = (name) => ({
 	_tag: "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
 */
@@ -40,5 +40,4 @@ const UiKey = {
 	})
 };
 
-//#endregion
 export { UiKey };

package/ui/UiProvider.js

@@ -2,7 +2,7 @@ import { inkModules } from "./internal/ink.js";
 import { screenContext } from "./internal/ScreenContext.js";
 import { uiProviders } from "./internal/UiProviders.js";
 
-//#region src/ui/UiProvider.ts
+// src/ui/UiProvider.ts
 /**
 * Provide the kit's context to an Ink tree the kit did not mount, so `useTheme`, `useGlyphs`, `Styled` and
 * `useTerminalSize` work in it.
@@ -56,5 +56,4 @@ const UiProvider = (props) => {
 	return uiProviders(value, props.children);
 };
 
-//#endregion
 export { UiProvider };

package/ui/UiStreams.js

@@ -1,7 +1,7 @@
 import { processStreams } from "./internal/processStreams.js";
 import { Context } from "effect";
 
-//#region src/ui/UiStreams.ts
+// src/ui/UiStreams.ts
 /**
 * The streams a screen mounts on, the process's own standard streams by default.
 *
@@ -14,5 +14,4 @@ import { Context } from "effect";
 */
 var UiStreams = class extends Context.Reference("@effected/cli/ui/UiStreams", { defaultValue: () => processStreams() }) {};
 
-//#endregion
 export { UiStreams };

package/ui/UiTheme.js

@@ -1,7 +1,7 @@
 import { inkModules } from "./internal/ink.js";
 import { screenContext } from "./internal/ScreenContext.js";
 
-//#region src/ui/UiTheme.ts
+// src/ui/UiTheme.ts
 const OUTSIDE = "@effected/cli/ui: a theme hook was used outside a screen mounted by CliUi.run or a UiProvider";
 const useScreen = () => {
 	const screen = inkModules().react.useContext(screenContext());
@@ -144,5 +144,4 @@ const useTerminalSize = () => {
 	};
 };
 
-//#endregion
 export { Styled, inkProps, useGlyphs, useTerminalSize, useTheme };

package/ui/Viewport.js

@@ -2,7 +2,7 @@ import { inkModules } from "./internal/ink.js";
 import { useTerminalSize } from "./UiTheme.js";
 import { KeyTable } from "./KeyTable.js";
 
-//#region src/ui/Viewport.ts
+// src/ui/Viewport.ts
 /**
 * Throws on a repeated item key. Checked before React sees the rows: React reports a duplicate key on
 * `console.error`, which under a screen's unpatched console lands on the real stderr, over the frame.
@@ -200,5 +200,4 @@ var Viewport = class {
 	};
 };
 
-//#endregion
 export { Viewport };

package/ui/internal/ErrorBoundary.js

@@ -1,6 +1,6 @@
 import { fromReact } from "./ink.js";
 
-//#region src/ui/internal/ErrorBoundary.ts
+// src/ui/internal/ErrorBoundary.ts
 /**
 * The screen's error boundary: catches a render error anywhere in the screen, renders nothing, and reports it.
 *
@@ -26,5 +26,4 @@ const errorBoundary = fromReact((react) => class ScreenErrorBoundary extends rea
 	}
 });
 
-//#endregion
 export { errorBoundary };

package/ui/internal/Holder.js

@@ -1,6 +1,6 @@
 import { fromReact } from "./ink.js";
 
-//#region src/ui/internal/Holder.ts
+// src/ui/internal/Holder.ts
 /**
 * A component that shows one element and lets its owner swap it in place.
 *
@@ -70,5 +70,4 @@ const holderSlot = () => {
 	};
 };
 
-//#endregion
 export { holder, holderSlot };

package/ui/internal/ScreenContext.js

@@ -1,6 +1,6 @@
 import { fromReact, inkModules } from "./ink.js";
 
-//#region src/ui/internal/ScreenContext.ts
+// src/ui/internal/ScreenContext.ts
 /**
 * The React context carrying {@link ScreenContextValue}, built on the loaded React.
 *
@@ -48,5 +48,4 @@ const useScreenGuard = () => {
 	};
 };
 
-//#endregion
 export { screenContext, useScreenCancel, useScreenGuard };

package/ui/internal/UiProviders.js

@@ -1,7 +1,7 @@
 import { inkModules } from "./ink.js";
 import { screenContext } from "./ScreenContext.js";
 
-//#region src/ui/internal/UiProviders.ts
+// src/ui/internal/UiProviders.ts
 /**
 * Wrap `children` in the kit's providers: the theme, the glyph set, the optional size override, and a screen's cancel
 * and defect route when it has them.
@@ -17,5 +17,4 @@ const uiProviders = (value, children) => inkModules().react.createElement(screen
 	children
 });
 
-//#endregion
 export { uiProviders };

package/ui/internal/ink.js

@@ -1,7 +1,7 @@
 import { inkChalk } from "./inkChalk.js";
 import { Effect, Option } from "effect";
 
-//#region src/ui/internal/ink.ts
+// src/ui/internal/ink.ts
 const MISSING_PEERS = "@effected/cli/ui could not load its optional peers ink and react: install both beside @effected/cli to mount a screen";
 const READ_BEFORE_LOAD = "@effected/cli/ui read Ink before loading it: run CliUi.context (or mount a screen with CliUi.run) before rendering UiProvider or a kit component in a tree of your own";
 const UNRESOLVED_CHALK = "@effected/cli/ui could not resolve the chalk Ink uses (is ink bundled?), so Ink decides its own colour level";
@@ -118,5 +118,4 @@ const holdChalkLevel = (found, colour) => Option.match(found, {
 */
 const withInkColour = (colour) => Effect.flatMap(resolveChalk, (found) => holdChalkLevel(found, colour));
 
-//#endregion
 export { fromReact, holdChalkLevel, inkModules, levelOf, loadInk, withInkColour };

package/ui/internal/inkChalk.js

@@ -3,7 +3,7 @@ import { Option } from "effect";
 import { realpathSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
-//#region src/ui/internal/inkChalk.ts
+// src/ui/internal/inkChalk.ts
 const isInkChalk = (value) => (typeof value === "function" || typeof value === "object" && value !== null) && typeof value.level === "number";
 /** The runtime's `import.meta.resolve`, when it has one. */
 const esmResolve = typeof import.meta.resolve === "function" ? (specifier) => import.meta.resolve(specifier) : void 0;
@@ -54,5 +54,4 @@ const inkChalk = async (inkEntryOf = () => resolveInkEntry()) => {
 	}
 };
 
-//#endregion
 export { inkChalk, resolveInkEntry };

package/ui/internal/inkConsole.js

@@ -2,7 +2,7 @@ import { inkModules } from "./ink.js";
 import { UiStreams } from "../UiStreams.js";
 import { Effect, Inspectable } from "effect";
 
-//#region src/ui/internal/inkConsole.ts
+// src/ui/internal/inkConsole.ts
 /** One argument as a console shows it: a string as is, an `Error` with its stack, anything else as data (JSON). */
 const shown = (arg) => arg instanceof Error ? arg.stack ?? String(arg) : Inspectable.toStringUnknown(arg, 0);
 /** A console call's arguments as one line of text, joined by spaces. */
@@ -147,5 +147,4 @@ const makeInkConsole = Effect.gen(function* () {
 	};
 });
 
-//#endregion
 export { makeInkConsole };

package/ui/internal/lazyView.js

@@ -1,6 +1,6 @@
 import { Effect } from "effect";
 
-//#region src/ui/internal/lazyView.ts
+// src/ui/internal/lazyView.ts
 /** Where a lazy view keeps its loader: a `Symbol.for` key, so two copies of the package agree on it. */
 const LOAD = Symbol.for("@effected/cli/ui/lazyView");
 const NOT_LOADED = "@effected/cli/ui: a CliUi.lazyView render was called before its module loaded; only CliUi.live loads it first";
@@ -70,5 +70,4 @@ const loadView = (render) => {
 	}));
 };
 
-//#endregion
 export { LazyViewShapeError, lazyView, loadView };

package/ui/internal/lineText.js

@@ -1,6 +1,6 @@
 import { sanitize } from "../../Fmt.js";
 
-//#region src/ui/internal/lineText.ts
+// src/ui/internal/lineText.ts
 /**
 * Consumer text made safe for one row of a widget: sanitised as `Fmt.sanitize` does (no escape sequence, no other
 * control character), with each line break (CR, LF or CR LF) folded to a space.
@@ -15,5 +15,4 @@ import { sanitize } from "../../Fmt.js";
 */
 const lineText = (text) => sanitize(text).replace(/\r\n|\r|\n/g, " ");
 
-//#endregion
 export { lineText };

package/ui/internal/mountPermit.js

@@ -1,6 +1,6 @@
 import { Semaphore } from "effect";
 
-//#region src/ui/internal/mountPermit.ts
+// src/ui/internal/mountPermit.ts
 /**
 * One Ink mount at a time, process-wide: a `CliUi.run` screen, or one run of a live view.
 *
@@ -12,5 +12,4 @@ import { Semaphore } from "effect";
 */
 const mountPermit = Semaphore.makeUnsafe(1);
 
-//#endregion
 export { mountPermit };

package/ui/internal/processStreams.js

@@ -1,4 +1,4 @@
-//#region src/ui/internal/processStreams.ts
+// src/ui/internal/processStreams.ts
 /**
 * The process's own standard streams, the default `UiStreams`.
 *
@@ -15,5 +15,4 @@ const processStreams = () => ({
 	stderr: process.stderr
 });
 
-//#endregion
 export { processStreams };

package/ui/internal/renderOptions.js

@@ -1,6 +1,6 @@
 import { Context } from "effect";
 
-//#region src/ui/internal/renderOptions.ts
+// src/ui/internal/renderOptions.ts
 /**
 * The render-option overrides in force: none by default. Internal, so `CliUi.run`'s public signature stays as
 * specified; `CliUiTest` sets it.
@@ -9,5 +9,4 @@ import { Context } from "effect";
 */
 var UiRenderOptions = class extends Context.Reference("@effected/cli/ui/UiRenderOptions", { defaultValue: () => ({}) }) {};
 
-//#endregion
 export { UiRenderOptions };

package/ui/testing/CliUiTest.js

@@ -11,7 +11,7 @@ import { Cause, Console, Effect, Exit, Fiber, Inspectable, Layer, Option, Queue,
 import { TerminalEnv } from "@effected/env";
 import { TestClock } from "effect/testing";
 
-//#region src/ui/testing/CliUiTest.ts
+// src/ui/testing/CliUiTest.ts
 /** The tokens, in the order their marker colours are numbered. */
 const TOKENS = [
 	"success",
@@ -786,5 +786,4 @@ var CliUiTest = class {
 	};
 };
 
-//#endregion
 export { CliUiTest };

package/ui/testing/fakeStreams.js

@@ -1,6 +1,6 @@
 import { PassThrough, Writable } from "node:stream";
 
-//#region src/ui/testing/fakeStreams.ts
+// src/ui/testing/fakeStreams.ts
 /** The hide-cursor escape `cli-cursor` writes to a TTY stream as it arms the restore. */
 const HIDE_CURSOR = `${String.fromCharCode(27)}[?25l`;
 /** A cursor-show escape in a listener's source, as `restore-cursor` writes it (`'\u001B[?25h'`) or as the raw byte. */
@@ -101,5 +101,4 @@ const makeFakeStreams = (options = {}) => {
 	};
 };
 
-//#endregion
 export { makeFakeStreams };

package/ui/testing/terminalModel.js

@@ -1,4 +1,4 @@
-//#region src/ui/testing/terminalModel.ts
+// src/ui/testing/terminalModel.ts
 const ESC = String.fromCharCode(27);
 /**
 * A small terminal model for the production render path: what a terminal shows after `written`, as its non-empty
@@ -64,5 +64,4 @@ const screenAfter = (written, rows) => {
 	return lines.map((line) => line.trimEnd()).filter((line) => line !== "");
 };
 
-//#endregion
 export { screenAfter };

package/ui-testing-serializer.d.ts

@@ -1,4 +1,3 @@
-//#region src/ui-testing-serializer.d.ts
 /**
  * `CliUiTest.serializer`: it claims a string carrying escapes or token markup and prints it as token markup with each
  * line's trailing spaces trimmed. See `CliUiTest.serializer` for what it claims.
@@ -9,6 +8,5 @@ declare const serializer: {
   readonly test: (value: unknown) => boolean;
   readonly serialize: (value: unknown) => string;
 };
-//#endregion
 export { serializer as default };
 //# sourceMappingURL=ui-testing-serializer.d.ts.map

package/ui-testing-serializer.js

@@ -1,6 +1,6 @@
 import { CliUiTest } from "./ui/testing/CliUiTest.js";
 
-//#region src/ui-testing-serializer.ts
+// src/ui-testing-serializer.ts
 /**
 * `CliUiTest.serializer` as a module's default export, for Vitest's `snapshotSerializers` config.
 *
@@ -29,5 +29,4 @@ import { CliUiTest } from "./ui/testing/CliUiTest.js";
 */
 const serializer = CliUiTest.serializer;
 
-//#endregion
 export { serializer as default };

package/ui-testing.d.ts

@@ -3,7 +3,6 @@ import { KeyName, LiveHandle, LiveOptions, Screen } from "@effected/cli/ui";
 import { ColorLevel } from "@effected/env";
 import { Cause, Duration, Effect, Exit, Layer, Option, Scope } from "effect";
 import { ReactElement } from "react";
-//#region src/ui/testing/CliUiTest.d.ts
 /**
  * Options for {@link CliUiTest.render}, {@link CliUiTest.view} and {@link CliUiTest.session}, and the terminal's
  * half of {@link CliUiTest.live}'s.
@@ -555,6 +554,5 @@ export declare class CliUiTest {
     readonly serialize: (value: unknown) => string;
   };
 }
-//#endregion
 export type { CliUiTestHandle, CliUiTestLive, CliUiTestNextOptions, CliUiTestOptions, CliUiTestScreen, CliUiTestSession, CliUiTestSessionOptions, CliUiTestView };
 //# sourceMappingURL=ui-testing.d.ts.map