@flowscripter/dynamic-cli-framework 1.7.5 → 2.1.0

package/src/service/completion/command/CompletionIntegrationSubCommand.ts

@@ -1,16 +1,16 @@
 import process from "node:process";
-import type SubCommand from "../../../api/command/SubCommand.ts";
-import type Option from "../../../api/argument/Option.ts";
-import type Positional from "../../../api/argument/Positional.ts";
-import type Context from "../../../api/Context.ts";
+import type { SubCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { Option } from "@flowscripter/dynamic-cli-framework-api";
+import type { Positional } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import {
   type ArgumentValues,
   ArgumentValueTypeName,
-} from "../../../api/argument/ArgumentValueTypes.ts";
-import { COMPLETION_SERVICE_ID, ShellType } from "../../../api/service/core/CompletionService.ts";
+} from "@flowscripter/dynamic-cli-framework-api";
+import { COMPLETION_SERVICE_ID, ShellType } from "@flowscripter/dynamic-cli-framework-api";
 import type DefaultCompletionService from "../DefaultCompletionService.ts";
-import { Icon, PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
-import type PrinterService from "../../../api/service/core/PrinterService.ts";
+import { Icon, PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
 
 export class CompletionIntegrationSubCommand implements SubCommand {
   readonly name = "integration";

package/src/service/completion/shell/ShellHandler.ts

@@ -1,4 +1,4 @@
-import type { CompletionItem } from "../../../api/service/core/CompletionService.ts";
+import type { CompletionItem } from "@flowscripter/dynamic-cli-framework-api";
 
 export interface CompletionContext {
   readonly line: string;

package/src/service/completion/shell/bash.ts

@@ -1,7 +1,7 @@
 import process from "node:process";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import type { CompletionItem } from "../../../api/service/core/CompletionService.ts";
+import type { CompletionItem } from "@flowscripter/dynamic-cli-framework-api";
 import type ShellHandler from "./ShellHandler.ts";
 import type { CompletionContext } from "./ShellHandler.ts";
 

package/src/service/completion/shell/fish.ts

@@ -1,7 +1,7 @@
 import process from "node:process";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import type { CompletionItem } from "../../../api/service/core/CompletionService.ts";
+import type { CompletionItem } from "@flowscripter/dynamic-cli-framework-api";
 import type ShellHandler from "./ShellHandler.ts";
 import type { CompletionContext } from "./ShellHandler.ts";
 

package/src/service/completion/shell/powershell.ts

@@ -1,7 +1,7 @@
 import process from "node:process";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import type { CompletionItem } from "../../../api/service/core/CompletionService.ts";
+import type { CompletionItem } from "@flowscripter/dynamic-cli-framework-api";
 import type ShellHandler from "./ShellHandler.ts";
 import type { CompletionContext } from "./ShellHandler.ts";
 

package/src/service/completion/shell/zsh.ts

@@ -1,7 +1,7 @@
 import process from "node:process";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import type { CompletionItem } from "../../../api/service/core/CompletionService.ts";
+import type { CompletionItem } from "@flowscripter/dynamic-cli-framework-api";
 import type ShellHandler from "./ShellHandler.ts";
 import type { CompletionContext } from "./ShellHandler.ts";
 

package/src/service/configuration/ConfigurationServiceProvider.ts

@@ -2,31 +2,31 @@ import process from "node:process";
 import path from "node:path";
 import fs from "node:fs/promises";
 import { Stats } from "node:fs";
-import type { ServiceInfo, ServiceProvider } from "../../api/service/ServiceProvider.ts";
+import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
 import ConfigCommand from "./command/ConfigCommand.ts";
 import type {
   ArgumentSingleValueType,
   ArgumentValues,
   PopulatedArgumentValues,
   PopulatedArgumentValueType,
-} from "../../api/argument/ArgumentValueTypes.ts";
+} from "@flowscripter/dynamic-cli-framework-api";
 import getLogger from "../../util/logger.ts";
-import type Context from "../../api/Context.ts";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import DumpConfigCommand from "./command/DumpConfigCommand.ts";
 import {
   KEY_VALUE_SERVICE_ID,
   SECRET_SENTINEL_PREFIX,
-} from "../../api/service/core/KeyValueService.ts";
+} from "@flowscripter/dynamic-cli-framework-api";
 import DefaultKeyValueService from "./DefaultKeyValueService.ts";
 import DefaultSecretService from "./DefaultSecretService.ts";
-import type Command from "../../api/command/Command.ts";
+import type { Command } from "@flowscripter/dynamic-cli-framework-api";
 import argumentValueMerge from "../../runtime/values/argumentValueMerge.ts";
 import {
   isGlobalCommand,
   isGlobalModifierCommand,
   isSubCommand,
 } from "../../runtime/command/CommandTypeGuards.ts";
-import type CLIConfig from "../../api/CLIConfig.ts";
+import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
 import {
   getGlobalCommandValueFromEnvVars,
   getSubCommandValuesFromEnvVars,

package/src/service/configuration/DefaultKeyValueService.ts

@@ -1,5 +1,5 @@
-import type KeyValueService from "../../api/service/core/KeyValueService.ts";
-import { SECRET_SENTINEL_PREFIX } from "../../api/service/core/KeyValueService.ts";
+import type { KeyValueService } from "@flowscripter/dynamic-cli-framework-api";
+import { SECRET_SENTINEL_PREFIX } from "@flowscripter/dynamic-cli-framework-api";
 import type DefaultSecretService from "./DefaultSecretService.ts";
 
 export default class DefaultKeyValueService implements KeyValueService {

package/src/service/configuration/DefaultSecretService.ts

@@ -1,4 +1,4 @@
-import type SecretService from "../../api/service/core/SecretService.ts";
+import type { SecretService } from "@flowscripter/dynamic-cli-framework-api";
 import { secrets as bunSecrets } from "bun";
 
 const MAX_NAME_LENGTH = 255;

package/src/service/configuration/command/ConfigCommand.ts

@@ -1,10 +1,10 @@
-import type GlobalModifierCommand from "../../../api/command/GlobalModifierCommand.ts";
-import type GlobalCommandArgument from "../../../api/argument/GlobalCommandArgument.ts";
+import type { GlobalModifierCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { GlobalCommandArgument } from "@flowscripter/dynamic-cli-framework-api";
 import {
   type ArgumentSingleValueType,
   ArgumentValueTypeName,
-} from "../../../api/argument/ArgumentValueTypes.ts";
-import type Context from "../../../api/Context.ts";
+} from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import type ConfigurationServiceProvider from "../ConfigurationServiceProvider.ts";
 
 /**

package/src/service/configuration/command/DumpConfigCommand.ts

@@ -1,10 +1,10 @@
-import type Context from "../../../api/Context.ts";
-import type GlobalCommand from "../../../api/command/GlobalCommand.ts";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { GlobalCommand } from "@flowscripter/dynamic-cli-framework-api";
 import type ConfigurationServiceProvider from "../ConfigurationServiceProvider.ts";
-import type PrinterService from "../../../api/service/core/PrinterService.ts";
-import { PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
-import type SyntaxHighlighterService from "../../../api/service/core/SyntaxHighlighterService.ts";
-import { SYNTAX_HIGHLIGHTER_SERVICE_ID } from "../../../api/service/core/SyntaxHighlighterService.ts";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { SyntaxHighlighterService } from "@flowscripter/dynamic-cli-framework-api";
+import { SYNTAX_HIGHLIGHTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 
 /**
  * Command which dumps the configuration loaded by the {@link ConfigurationServiceProvider}.

package/src/service/dataDumpGenerator/DataDumpGeneratorServiceProvider.ts

@@ -1,10 +1,10 @@
-import type { ServiceInfo, ServiceProvider } from "../../api/service/ServiceProvider.ts";
+import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultDataDumpGeneratorService from "./DefaultDataDumpGeneratorService.ts";
-import { DATA_DUMP_GENERATOR_SERVICE_ID } from "../../api/service/core/DataDumpGeneratorService.ts";
-import type Context from "../../api/Context.ts";
-import type PrinterService from "../../api/service/core/PrinterService.ts";
-import { PRINTER_SERVICE_ID } from "../../api/service/core/PrinterService.ts";
-import type CLIConfig from "../../api/CLIConfig.ts";
+import { DATA_DUMP_GENERATOR_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
 
 export default class DataDumpGeneratorServiceProvider implements ServiceProvider {
   readonly serviceId: string = DATA_DUMP_GENERATOR_SERVICE_ID;

package/src/service/dataDumpGenerator/DefaultDataDumpGeneratorService.ts

@@ -1,10 +1,10 @@
 import { Buffer } from "node:buffer";
-import type DataDumpGeneratorService from "../../api/service/core/DataDumpGeneratorService.ts";
+import type { DataDumpGeneratorService } from "@flowscripter/dynamic-cli-framework-api";
 import {
   type ByteRangeColor,
   DumpFormat,
   type HexDumpGenerateOptions,
-} from "../../api/service/core/DataDumpGeneratorService.ts";
+} from "@flowscripter/dynamic-cli-framework-api";
 
 export default class DefaultDataDumpGeneratorService implements DataDumpGeneratorService {
   colorEnabled = true;

package/src/service/imagePrinter/DefaultImagePrinterService.ts

@@ -1,5 +1,5 @@
 import ImageRenderer from "../../terminal/ImageRenderer.ts";
-import type ImagePrinterService from "../../api/service/core/ImagePrinterService.ts";
+import type { ImagePrinterService } from "@flowscripter/dynamic-cli-framework-api";
 import type Terminal from "../../terminal/Terminal.ts";
 
 export default class DefaultImagePrinterService implements ImagePrinterService {

package/src/service/imagePrinter/ImagePrinterServiceProvider.ts

@@ -1,8 +1,8 @@
-import type { ServiceInfo, ServiceProvider } from "../../api/service/ServiceProvider.ts";
+import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultImagePrinterService from "./DefaultImagePrinterService.ts";
-import { IMAGE_PRINTER_SERVICE_ID } from "../../api/service/core/ImagePrinterService.ts";
-import type Context from "../../api/Context.ts";
-import type CLIConfig from "../../api/CLIConfig.ts";
+import { IMAGE_PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
 import type Terminal from "../../terminal/Terminal.ts";
 
 export default class ImagePrinterServiceProvider implements ServiceProvider {

package/src/service/plugin/DefaultPluginService.ts

@@ -1,4 +1,4 @@
-import type PluginService from "../../api/service/core/PluginService.ts";
+import type { PluginService } from "@flowscripter/dynamic-cli-framework-api";
 import type {
   MarketplacePluginManager,
   VersionedPluginDescriptor,

package/src/service/plugin/DefaultPluginServiceProvider.ts

@@ -1,8 +1,8 @@
-import type { ServiceInfo, ServiceProvider } from "../../api/service/ServiceProvider.ts";
-import type Context from "../../api/Context.ts";
-import type CLIConfig from "../../api/CLIConfig.ts";
+import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
 import type { MarketplacePluginManager } from "@flowscripter/dynamic-plugin-framework";
-import { PLUGIN_SERVICE_ID } from "../../api/service/core/PluginService.ts";
+import { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultPluginService from "./DefaultPluginService.ts";
 import { PluginGroupCommand } from "./command/PluginGroupCommand.ts";
 

package/src/service/plugin/command/PluginAddSubCommand.ts

@@ -1,11 +1,11 @@
-import type SubCommand from "../../../api/command/SubCommand.ts";
-import type Context from "../../../api/Context.ts";
-import type { ArgumentValues } from "../../../api/argument/ArgumentValueTypes.ts";
-import { ArgumentValueTypeName } from "../../../api/argument/ArgumentValueTypes.ts";
-import type PrinterService from "../../../api/service/core/PrinterService.ts";
-import { Icon, PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
-import { PLUGIN_SERVICE_ID } from "../../../api/service/core/PluginService.ts";
-import type PluginService from "../../../api/service/core/PluginService.ts";
+import type { SubCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { ArgumentValues } from "@flowscripter/dynamic-cli-framework-api";
+import { ArgumentValueTypeName } from "@flowscripter/dynamic-cli-framework-api";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
+import { Icon, PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { PluginService } from "@flowscripter/dynamic-cli-framework-api";
 import type { VersionedPluginDescriptor } from "@flowscripter/dynamic-plugin-framework";
 import { getPluginId } from "./getPluginId.ts";
 

package/src/service/plugin/command/PluginGroupCommand.ts

@@ -1,6 +1,6 @@
-import type GroupCommand from "../../../api/command/GroupCommand.ts";
-import type SubCommand from "../../../api/command/SubCommand.ts";
-import type Context from "../../../api/Context.ts";
+import type { GroupCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { SubCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import { PluginListSubCommand } from "./PluginListSubCommand.ts";
 import { PluginSearchSubCommand } from "./PluginSearchSubCommand.ts";
 import { PluginAddSubCommand } from "./PluginAddSubCommand.ts";

package/src/service/plugin/command/PluginListSubCommand.ts

@@ -1,10 +1,10 @@
-import type SubCommand from "../../../api/command/SubCommand.ts";
-import type Context from "../../../api/Context.ts";
-import type { ArgumentValues } from "../../../api/argument/ArgumentValueTypes.ts";
-import type PrinterService from "../../../api/service/core/PrinterService.ts";
-import { PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
-import { PLUGIN_SERVICE_ID } from "../../../api/service/core/PluginService.ts";
-import type PluginService from "../../../api/service/core/PluginService.ts";
+import type { SubCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { ArgumentValues } from "@flowscripter/dynamic-cli-framework-api";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { PluginService } from "@flowscripter/dynamic-cli-framework-api";
 import { getPluginId } from "./getPluginId.ts";
 
 export class PluginListSubCommand implements SubCommand {

package/src/service/plugin/command/PluginRemoveSubCommand.ts

@@ -1,11 +1,11 @@
-import type SubCommand from "../../../api/command/SubCommand.ts";
-import type Context from "../../../api/Context.ts";
-import type { ArgumentValues } from "../../../api/argument/ArgumentValueTypes.ts";
-import { ArgumentValueTypeName } from "../../../api/argument/ArgumentValueTypes.ts";
-import type PrinterService from "../../../api/service/core/PrinterService.ts";
-import { Icon, PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
-import { PLUGIN_SERVICE_ID } from "../../../api/service/core/PluginService.ts";
-import type PluginService from "../../../api/service/core/PluginService.ts";
+import type { SubCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { ArgumentValues } from "@flowscripter/dynamic-cli-framework-api";
+import { ArgumentValueTypeName } from "@flowscripter/dynamic-cli-framework-api";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
+import { Icon, PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { PluginService } from "@flowscripter/dynamic-cli-framework-api";
 
 export class PluginRemoveSubCommand implements SubCommand {
   readonly name = "remove";

package/src/service/plugin/command/PluginSearchSubCommand.ts

@@ -1,11 +1,11 @@
-import type SubCommand from "../../../api/command/SubCommand.ts";
-import type Context from "../../../api/Context.ts";
-import type { ArgumentValues } from "../../../api/argument/ArgumentValueTypes.ts";
-import { ArgumentValueTypeName } from "../../../api/argument/ArgumentValueTypes.ts";
-import type PrinterService from "../../../api/service/core/PrinterService.ts";
-import { PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
-import { PLUGIN_SERVICE_ID } from "../../../api/service/core/PluginService.ts";
-import type PluginService from "../../../api/service/core/PluginService.ts";
+import type { SubCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { ArgumentValues } from "@flowscripter/dynamic-cli-framework-api";
+import { ArgumentValueTypeName } from "@flowscripter/dynamic-cli-framework-api";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { PluginService } from "@flowscripter/dynamic-cli-framework-api";
 import { getPluginId } from "./getPluginId.ts";
 
 export class PluginSearchSubCommand implements SubCommand {

package/src/service/plugin/command/PluginUpgradeSubCommand.ts

@@ -1,10 +1,10 @@
-import type SubCommand from "../../../api/command/SubCommand.ts";
-import type Context from "../../../api/Context.ts";
-import type { ArgumentValues } from "../../../api/argument/ArgumentValueTypes.ts";
-import type PrinterService from "../../../api/service/core/PrinterService.ts";
-import { Icon, PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
-import { PLUGIN_SERVICE_ID } from "../../../api/service/core/PluginService.ts";
-import type PluginService from "../../../api/service/core/PluginService.ts";
+import type { SubCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { ArgumentValues } from "@flowscripter/dynamic-cli-framework-api";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
+import { Icon, PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { PluginService } from "@flowscripter/dynamic-cli-framework-api";
 import { getPluginId } from "./getPluginId.ts";
 
 export class PluginUpgradeSubCommand implements SubCommand {

package/src/service/prettyPrinter/DefaultPrettyPrinterService.ts

@@ -1,4 +1,4 @@
-import type PrettyPrinterService from "../../api/service/core/PrettyPrinterService.ts";
+import type { PrettyPrinterService } from "@flowscripter/dynamic-cli-framework-api";
 import * as prettier from "prettier";
 import type { Plugin } from "prettier";
 
@@ -8,7 +8,7 @@ import type { Plugin } from "prettier";
  */
 export default class DefaultPrettyPrinterService implements PrettyPrinterService {
   #registeredSyntaxes = new Array<string>();
-  #syntaxNameToPluginnMap = new Map<string, Plugin>();
+  #syntaxNameToPluginnMap = new Map<string, Plugin<unknown>>();
 
   async #populateBuiltInSyntaxes(): Promise<void> {
     const languages = (await prettier.getSupportInfo()).languages;
@@ -43,7 +43,7 @@ export default class DefaultPrettyPrinterService implements PrettyPrinterService
     return prettier.format(text, options);
   }
 
-  async registerSyntax(syntaxName: string, syntaxPlugin: Plugin): Promise<void> {
+  async registerSyntax(syntaxName: string, syntaxPlugin: Plugin<unknown>): Promise<void> {
     if (this.#registeredSyntaxes.length === 0) {
       await this.#populateBuiltInSyntaxes();
     }

package/src/service/prettyPrinter/PrettyPrinterServiceProvider.ts

@@ -1,8 +1,8 @@
-import type { ServiceInfo, ServiceProvider } from "../../api/service/ServiceProvider.ts";
+import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultPrettyPrinterService from "./DefaultPrettyPrinterService.ts";
-import { PRETTY_PRINTER_SERVICE_ID } from "../../api/service/core/PrettyPrinterService.ts";
-import type Context from "../../api/Context.ts";
-import type CLIConfig from "../../api/CLIConfig.ts";
+import { PRETTY_PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
 
 /**
  * Provides a {@link PrettyPrinterService}.

package/src/service/printer/DefaultPrinterService.ts

@@ -1,17 +1,19 @@
 import { default as Spinner } from "./terminal/Spinner.ts";
 import { default as Progress } from "./terminal/Progress.ts";
-import type PrinterService from "../../api/service/core/PrinterService.ts";
+import { default as Quote } from "./terminal/Quote.ts";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
 import {
   type Icon,
   Level,
   type ProgressStyle,
   type SpinnerStyle,
-} from "../../api/service/core/PrinterService.ts";
+} from "@flowscripter/dynamic-cli-framework-api";
 import type Terminal from "../../terminal/Terminal.ts";
 import { Color } from "./terminal/Color.ts";
 import { getDarkModeTheme, getLightModeTheme } from "./terminal/Theme.ts";
 import { WritableStream } from "node:stream/web";
 import type Styler from "../../terminal/Styler.ts";
+
 export default class DefaultPrinterService implements PrinterService {
   readonly stdoutWritable: WritableStream;
   readonly stderrWritable: WritableStream;
@@ -26,6 +28,20 @@ export default class DefaultPrinterService implements PrinterService {
   #encoder = new TextEncoder();
   #spinner: Spinner;
   #progress: Progress;
+  #quote: Quote;
+  #markedLineCount: number | undefined;
+  #markEndedAt: number | undefined;
+
+  #countLines(message: string): number {
+    return message.split("\n").length - (message.endsWith("\n") ? 1 : 0);
+  }
+
+  #recordMarkedWrite(message: string): void {
+    if (this.#markedLineCount === undefined) {
+      return;
+    }
+    this.#markedLineCount += this.#countLines(message);
+  }
 
   async #log(level: number, message: string, icon?: Icon): Promise<void> {
     if (this.#threshold > level) {
@@ -33,9 +49,9 @@ export default class DefaultPrinterService implements PrinterService {
     }
     await this.#spinner.pause();
     await this.#progress.pause();
-    await this.#stderrTerminal.write(
-      `${icon !== undefined ? `${this.#iconDefinitions[icon]} ` : ""}${message}`,
-    );
+    const composed = `${icon !== undefined ? `${this.#iconDefinitions[icon]} ` : ""}${message}`;
+    this.#recordMarkedWrite(composed);
+    await this.#stderrTerminal.write(this.#quote.prefixLines(composed));
     this.#spinner.resume();
     this.#progress.resume();
   }
@@ -58,6 +74,7 @@ export default class DefaultPrinterService implements PrinterService {
     this.#styler.colorEnabled = stderrIsColor;
     this.#spinner = new Spinner(this.#stderrTerminal, this.#styler);
     this.#progress = new Progress(this.#stderrTerminal, this.#styler);
+    this.#quote = new Quote(this.#styler);
     this.darkMode = false;
     this.#iconDefinitions = [this.green("✔"), this.red("✖"), this.yellow("‼"), this.blue("ℹ")];
   }
@@ -256,9 +273,10 @@ export default class DefaultPrinterService implements PrinterService {
     const writer = this.stdoutWritable.getWriter();
     const colorMessage = this.#stdoutIsColor ? this.primary(message) : message;
 
-    const encoded = this.#encoder.encode(
-      `${icon !== undefined ? `${this.#iconDefinitions[icon]} ` : ""}${colorMessage}`,
-    );
+    const composed = `${
+      icon !== undefined ? `${this.#iconDefinitions[icon]} ` : ""
+    }${colorMessage}`;
+    const encoded = this.#encoder.encode(composed);
 
     await writer.ready;
     await writer.write(encoded);
@@ -268,6 +286,50 @@ export default class DefaultPrinterService implements PrinterService {
     this.#progress.resume();
   }
 
+  public startQuote(hexFormattedColor?: string): void {
+    const color = hexFormattedColor
+      ? this.#parseHexColor(hexFormattedColor)
+      : this.#theme[Color.SECONDARY]!;
+    this.#quote.push(color);
+  }
+
+  public endQuote(): void {
+    this.#quote.pop();
+  }
+
+  public startMark(): void {
+    if (this.#markedLineCount !== undefined) {
+      throw new Error("startMark() called while already marking");
+    }
+    this.#markedLineCount = 0;
+    this.#markEndedAt = undefined;
+  }
+
+  public endMark(): void {
+    if (this.#markedLineCount === undefined) {
+      throw new Error("endMark() called without a matching startMark()");
+    }
+    this.#markEndedAt = Date.now();
+  }
+
+  public async clearMarked(minimumDisplayTimeMs = 0): Promise<void> {
+    if (this.#markedLineCount === undefined || this.#markEndedAt === undefined) {
+      throw new Error("clearMarked() called without a preceding endMark()");
+    }
+    if (!this.#stderrTerminal.isTty()) {
+      this.#markedLineCount = undefined;
+      this.#markEndedAt = undefined;
+      return;
+    }
+    const remaining = minimumDisplayTimeMs - (Date.now() - this.#markEndedAt);
+    if (remaining > 0) {
+      await new Promise((resolve) => setTimeout(resolve, remaining));
+    }
+    await this.#stderrTerminal.clearUpLines(this.#markedLineCount);
+    this.#markedLineCount = undefined;
+    this.#markEndedAt = undefined;
+  }
+
   public async setLevel(level: Level): Promise<void> {
     if (this.#threshold > Level.INFO) {
       await this.#spinner.hide();
@@ -281,6 +343,9 @@ export default class DefaultPrinterService implements PrinterService {
   }
 
   public async showSpinner(message?: string, style?: SpinnerStyle): Promise<void> {
+    if (!this.#stderrTerminal.isTty()) {
+      return;
+    }
     await this.#progress.hideAll();
     if (this.#threshold > Level.INFO) {
       return;
@@ -302,6 +367,9 @@ export default class DefaultPrinterService implements PrinterService {
     current = 0,
     style?: ProgressStyle,
   ): Promise<number> {
+    if (!this.#stderrTerminal.isTty()) {
+      return -1;
+    }
     await this.#spinner.hide();
     if (this.#threshold > Level.INFO) {
       return -1;

package/src/service/printer/PrinterServiceProvider.ts

@@ -1,14 +1,14 @@
-import type Context from "../../api/Context.ts";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import LogLevelCommand from "./command/LogLevelCommand.ts";
-import type { ServiceInfo, ServiceProvider } from "../../api/service/ServiceProvider.ts";
-import type PrinterService from "../../api/service/core/PrinterService.ts";
-import { PRINTER_SERVICE_ID } from "../../api/service/core/PrinterService.ts";
+import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
+import type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import DarkModeCommand from "./command/DarkModeCommand.ts";
 import NoColorCommand from "./command/NoColorCommand.ts";
 import NoHyperlinksCommand from "./command/NoHyperlinksCommand.ts";
-import type CLIConfig from "../../api/CLIConfig.ts";
-import type ShutdownService from "../../api/service/core/ShutdownService.ts";
-import { SHUTDOWN_SERVICE_ID } from "../../api/service/core/ShutdownService.ts";
+import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
+import type { ShutdownService } from "@flowscripter/dynamic-cli-framework-api";
+import { SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 
 /**
  * Provides a {@link PrinterService}.

package/src/service/printer/command/DarkModeCommand.ts

@@ -1,10 +1,10 @@
-import type GlobalModifierCommand from "../../../api/command/GlobalModifierCommand.ts";
-import type GlobalCommandArgument from "../../../api/argument/GlobalCommandArgument.ts";
+import type { GlobalModifierCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { GlobalCommandArgument } from "@flowscripter/dynamic-cli-framework-api";
 import {
   type ArgumentSingleValueType,
   ArgumentValueTypeName,
-} from "../../../api/argument/ArgumentValueTypes.ts";
-import type Context from "../../../api/Context.ts";
+} from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import type PrinterServiceProvider from "../PrinterServiceProvider.ts";
 
 /**

package/src/service/printer/command/LogLevelCommand.ts

@@ -1,12 +1,12 @@
-import type GlobalCommandArgument from "../../../api/argument/GlobalCommandArgument.ts";
+import type { GlobalCommandArgument } from "@flowscripter/dynamic-cli-framework-api";
 import {
   type ArgumentSingleValueType,
   ArgumentValueTypeName,
-} from "../../../api/argument/ArgumentValueTypes.ts";
-import type GlobalModifierCommand from "../../../api/command/GlobalModifierCommand.ts";
-import type Context from "../../../api/Context.ts";
+} from "@flowscripter/dynamic-cli-framework-api";
+import type { GlobalModifierCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import type PrinterServiceProvider from "../PrinterServiceProvider.ts";
-import { Level } from "../../../api/service/core/PrinterService.ts";
+import { Level } from "@flowscripter/dynamic-cli-framework-api";
 
 /**
  * Command allowing the setting of the log level for {@link PrinterServiceProvider}.