@flowscripter/dynamic-cli-framework 12.0.1 → 12.1.0

package/dist/index.d.ts

@@ -36,6 +36,9 @@ export { default as DefaultSecretService } from "./src/service/configuration/Def
 export type { SecretsApi } from "./src/service/configuration/DefaultSecretService.ts";
 export { default as ConfigCommand } from "./src/service/configuration/command/ConfigCommand.ts";
 export { default as ConfigurationServiceProvider, type KeyValueServiceScopeType, } from "./src/service/configuration/ConfigurationServiceProvider.ts";
+export type { default as ConfigFormat } from "./src/service/configuration/format/ConfigFormat.ts";
+export type { ConfigData } from "./src/service/configuration/format/ConfigFormat.ts";
+export { default as jsonFormat } from "./src/service/configuration/format/JsonConfigFormat.ts";
 export { default as KeyValueServiceProvider } from "./src/service/configuration/KeyValueServiceProvider.ts";
 export { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 export type { PrinterService } from "@flowscripter/dynamic-cli-framework-api";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -14,6 +14,7 @@ export { default as DefaultKeyValueService } from "./src/service/configuration/D
 export { default as DefaultSecretService } from "./src/service/configuration/DefaultSecretService.js";
 export { default as ConfigCommand } from "./src/service/configuration/command/ConfigCommand.js";
 export { default as ConfigurationServiceProvider, } from "./src/service/configuration/ConfigurationServiceProvider.js";
+export { default as jsonFormat } from "./src/service/configuration/format/JsonConfigFormat.js";
 export { default as KeyValueServiceProvider } from "./src/service/configuration/KeyValueServiceProvider.js";
 export { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 export { Icon, Level, ProgressStyle, SpinnerStyle } from "@flowscripter/dynamic-cli-framework-api";

package/dist/src/cli/BaseCLI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseCLI.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAU3E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAEhD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAC;AAqCpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,YAAW,GAAG;;IAazC,YACE,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,cAAc,EACpC,oBAAoB,EAAE,cAAc,EACpC,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,cAAc,EAAE,QAAQ,EACxB,cAAc,EAAE,QAAQ,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,qBAAqB,EAuEhC;IAED;;;;;;;OAOG;IACI,kBAAkB,CAAC,eAAe,EAAE,eAAe,QAEzD;IAED;;;;;;;;OAQG;IACH;;;;;OAKG;IACI,cAAc,CAAC,IAAI,EAAE,WAAW,QAEtC;IAEM,UAAU,CAAC,OAAO,EAAE,OAAO,QAQjC;IAEK,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CA2QzD;CACF"}
+{"version":3,"file":"BaseCLI.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAW3E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAEhD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAC;AAqCpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,YAAW,GAAG;;IAazC,YACE,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,cAAc,EACpC,oBAAoB,EAAE,cAAc,EACpC,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,cAAc,EAAE,QAAQ,EACxB,cAAc,EAAE,QAAQ,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,qBAAqB,EAwEhC;IAED;;;;;;;OAOG;IACI,kBAAkB,CAAC,eAAe,EAAE,eAAe,QAEzD;IAED;;;;;;;;OAQG;IACH;;;;;OAKG;IACI,cAAc,CAAC,IAAI,EAAE,WAAW,QAEtC;IAEM,UAAU,CAAC,OAAO,EAAE,OAAO,QAQjC;IAEK,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CA4QzD;CACF"}

package/dist/src/cli/BaseCLI.js

@@ -12,6 +12,7 @@ import CommandValidator from "../runtime/command/CommandValidator.js";
 import ShutdownServiceProvider from "../service/shutdown/ShutdownServiceProvider.js";
 import StartupServiceProvider from "../service/startup/StartupServiceProvider.js";
 import { shutdownState } from "../service/shutdown/ShutdownState.js";
+import jsonFormat from "../service/configuration/format/JsonConfigFormat.js";
 import ConfigurationServiceProvider from "../service/configuration/ConfigurationServiceProvider.js";
 import KeyValueServiceProvider from "../service/configuration/KeyValueServiceProvider.js";
 import PrinterServiceProvider from "../service/printer/PrinterServiceProvider.js";
@@ -100,6 +101,7 @@ export default class BaseCLI {
         }
         this.#cliConfig = cliConfig;
         this.#options = {
+            configFormat: jsonFormat,
             configFileSupportEnabled: false,
             envVarsSupportEnabled: false,
             keyValueServiceEnabled: false,
@@ -245,7 +247,7 @@ export default class BaseCLI {
         if (this.#options.pluginServiceEnabled) {
             this.addServiceProvider(new PluginServiceProvider(PLUGIN_SERVICE_PRIORITY, this.#options.pluginServiceRemoteConfig, this.#options.pluginServiceLocalConfig, this.#commandRegistry, this.#serviceProviderRegistry));
         }
-        const configurationServiceProvider = new ConfigurationServiceProvider(CONFIGURATION_SERVICE_PRIORITY, this.#options.envVarsSupportEnabled, this.#options.configFileSupportEnabled, this.#options.secretServiceEnabled);
+        const configurationServiceProvider = new ConfigurationServiceProvider(CONFIGURATION_SERVICE_PRIORITY, this.#options.envVarsSupportEnabled, this.#options.configFileSupportEnabled, this.#options.secretServiceEnabled, this.#options.configFormat);
         this.addServiceProvider(configurationServiceProvider);
         const keyValueServiceProvider = new KeyValueServiceProvider(KEY_VALUE_SERVICE_PRIORITY, configurationServiceProvider, this.#options.keyValueServiceEnabled, this.#options.secretServiceEnabled);
         this.addServiceProvider(keyValueServiceProvider);

package/dist/src/cli/BaseCLIFeatureOptions.d.ts

@@ -1,7 +1,13 @@
+import type ConfigFormat from "../service/configuration/format/ConfigFormat.ts";
 import type { UpgradeLocationsConfig } from "../service/upgrade/UpgradeLocationsConfig.ts";
 import type { NpmjsPluginRepositoryConfig, NpmPluginRepositoryConfig } from "@flowscripter/dynamic-plugin-framework";
 export default interface BaseCLIFeatureOptions {
     readonly configFileSupportEnabled?: boolean;
+    /**
+     * The syntax of the configuration file. Defaults to JSON. YAML and TOML are available from the
+     * `@flowscripter/dynamic-cli-framework/yaml` and `@flowscripter/dynamic-cli-framework/toml` entry points.
+     */
+    readonly configFormat?: ConfigFormat;
     readonly envVarsSupportEnabled?: boolean;
     readonly keyValueServiceEnabled?: boolean;
     readonly secretServiceEnabled?: boolean;

package/dist/src/cli/BaseCLIFeatureOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseCLIFeatureOptions.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLIFeatureOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,KAAK,EACV,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,wCAAwC,CAAC;AAEhD,MAAM,CAAC,OAAO,WAAW,qBAAqB;IAC5C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAClD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IACzD;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,2BAA2B,CAAC;IACjE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,yBAAyB,CAAC;IAC9D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC"}
+{"version":3,"file":"BaseCLIFeatureOptions.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLIFeatureOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,iDAAiD,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,KAAK,EACV,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,wCAAwC,CAAC;AAEhD,MAAM,CAAC,OAAO,WAAW,qBAAqB;IAC5C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAClD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IACzD;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,2BAA2B,CAAC;IACjE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,yBAAyB,CAAC;IAC9D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC"}

package/dist/src/service/configuration/ConfigurationServiceProvider.d.ts

@@ -2,6 +2,7 @@ import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-fra
 import type { SingleValueType, Values, ValueNode, PopulatedValues, PopulatedValueType } from "@flowscripter/dynamic-cli-framework-api";
 import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import type { GroupCommand } from "@flowscripter/dynamic-cli-framework-api";
+import type ConfigFormat from "./format/ConfigFormat.ts";
 import type { Command } from "@flowscripter/dynamic-cli-framework-api";
 import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
 export type KeyValueServiceScopeType = "command" | "service";
@@ -26,7 +27,7 @@ export type KeyValueServiceScopeType = "command" | "service";
  *
  * *Configuration File*
  *
- * A JSON file where the structure matches {@link Values} and the defaults are stored
+ * A file (JSON by default, see {@link ConfigFormat}) where the structure matches {@link Values} and the defaults are stored
  * under a top level `defaults` property. The second level of properties is used to refer to {@link Command.name}
  * (or `<group name>:<member name>` for a member of a {@link GroupCommand}) and the contained values are treated as
  * command {@link Values}. As an example:
@@ -57,7 +58,12 @@ export type KeyValueServiceScopeType = "command" | "service";
  * }
  * ```
  *
- * The default location of the configuration file is `$HOME/.<application_name>.json`. If `$HOME` is not defined no
+ * The syntax of the file is set by the `configFormat` constructor argument: JSON (the default), or YAML or TOML
+ * from the `yaml` and `toml` entry points of this package. The format is never inferred from the file name or
+ * extension and existing files are not migrated between formats. For YAML and TOML, comments and layout in the
+ * existing file are preserved when it is written back.
+ *
+ * The default location of the configuration file is `$HOME/.<application_name>.<format extension>`. If `$HOME` is not defined no
  * default configuration will be used. The location of the configuration file can be modified via the
  * {@link ConfigCommand}.
  *
@@ -113,6 +119,7 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
     readonly envVarsEnabled: boolean;
     readonly configEnabled: boolean;
     readonly secretServiceEnabled: boolean;
+    readonly configFormat: ConfigFormat;
     configLocation: string | undefined;
     defaultsData: Map<string, Values | SingleValueType>;
     /**
@@ -123,8 +130,9 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
      * @param configEnabled optionally enable configuration file support for default argument values.
      * @param secretServiceEnabled optionally enable OS-native secret storage via Bun.secrets for resolving
      * secrets embedded in default argument values: `configEnabled` must be true in this case
+     * @param configFormat optionally set the syntax of the configuration file, defaults to JSON.
      */
-    constructor(servicePriority: number, envVarsEnabled?: boolean, configEnabled?: boolean, secretServiceEnabled?: boolean);
+    constructor(servicePriority: number, envVarsEnabled?: boolean, configEnabled?: boolean, secretServiceEnabled?: boolean, configFormat?: ConfigFormat);
     getServiceInfo(cliConfig: CLIConfig): Promise<ServiceInfo>;
     setConfigLocation(configLocation: string): void;
     /**

package/dist/src/service/configuration/ConfigurationServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigurationServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/configuration/ConfigurationServiceProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE5F,OAAO,KAAK,EACV,eAAe,EACf,MAAM,EACN,SAAS,EACT,eAAe,EACf,kBAAkB,EACnB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAU5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAOvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,CAAC;AAkB7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoGG;AACH,MAAM,CAAC,OAAO,OAAO,4BAA6B,YAAW,eAAe;;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAA4B;IACtD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,SAAgB,cAAc,EAAE,OAAO,CAAC;IACxC,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,SAAgB,oBAAoB,EAAE,OAAO,CAAC;IAGvC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAKnC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAa;IAqBvE;;;;;;;;OAQG;IACH,YACE,eAAe,EAAE,MAAM,EACvB,cAAc,UAAQ,EACtB,aAAa,UAAQ,EACrB,oBAAoB,UAAQ,EAW7B;IAEM,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBhE;IAEM,iBAAiB,CAAC,cAAc,EAAE,MAAM,QAE9C;IAED;;;;;;;;;OASG;IACU,wBAAwB,CACnC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAC,CAsD3D;IAED;;;;;;OAMG;IACI,eAAe,CACpB,SAAS,EAAE,wBAAwB,EACnC,QAAQ,EAAE,MAAM,GACf,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAOxB;IAED;;;;;;OAMG;IACU,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzD;IAEY,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CxD;IA4DM,eAAe,IAAI,MAAM,CAgC/B;CACF"}
+{"version":3,"file":"ConfigurationServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/configuration/ConfigurationServiceProvider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE5F,OAAO,KAAK,EACV,eAAe,EACf,MAAM,EACN,SAAS,EACT,eAAe,EACf,kBAAkB,EACnB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAS5E,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AAIzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAOvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,CAAC;AAkB7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyGG;AACH,MAAM,CAAC,OAAO,OAAO,4BAA6B,YAAW,eAAe;;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAA4B;IACtD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,SAAgB,cAAc,EAAE,OAAO,CAAC;IACxC,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,SAAgB,oBAAoB,EAAE,OAAO,CAAC;IAC9C,SAAgB,YAAY,EAAE,YAAY,CAAC;IAGpC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAQnC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAAa;IAqBvE;;;;;;;;;OASG;IACH,YACE,eAAe,EAAE,MAAM,EACvB,cAAc,UAAQ,EACtB,aAAa,UAAQ,EACrB,oBAAoB,UAAQ,EAC5B,YAAY,GAAE,YAAyB,EAYxC;IAEM,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBhE;IAEM,iBAAiB,CAAC,cAAc,EAAE,MAAM,QAE9C;IAED;;;;;;;;;OASG;IACU,wBAAwB,CACnC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAC,CAsD3D;IAED;;;;;;OAMG;IACI,eAAe,CACpB,SAAS,EAAE,wBAAwB,EACnC,QAAQ,EAAE,MAAM,GACf,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAOxB;IAED;;;;;;OAMG;IACU,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzD;IAEY,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CxD;IAgEM,eAAe,IAAI,MAAM,CAE/B;CAmCF"}

package/dist/src/service/configuration/ConfigurationServiceProvider.js

@@ -8,6 +8,7 @@ import ConfigDumpSubCommand from "./command/ConfigDumpSubCommand.js";
 import ConfigGroupCommand from "./command/ConfigGroupCommand.js";
 import { CONFIGURATION_SERVICE_ID, SECRET_SENTINEL_PREFIX, } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultSecretService from "./DefaultSecretService.js";
+import jsonFormat from "./format/JsonConfigFormat.js";
 import resolveSecrets from "./resolveSecrets.js";
 import argumentValueMerge from "../../runtime/values/argumentValueMerge.js";
 import { isGlobalCommand, isGlobalModifierCommand, isSubCommand, } from "../../runtime/command/CommandTypeGuards.js";
@@ -46,7 +47,7 @@ class ConfigurationServiceImpl {
  *
  * *Configuration File*
  *
- * A JSON file where the structure matches {@link Values} and the defaults are stored
+ * A file (JSON by default, see {@link ConfigFormat}) where the structure matches {@link Values} and the defaults are stored
  * under a top level `defaults` property. The second level of properties is used to refer to {@link Command.name}
  * (or `<group name>:<member name>` for a member of a {@link GroupCommand}) and the contained values are treated as
  * command {@link Values}. As an example:
@@ -77,7 +78,12 @@ class ConfigurationServiceImpl {
  * }
  * ```
  *
- * The default location of the configuration file is `$HOME/.<application_name>.json`. If `$HOME` is not defined no
+ * The syntax of the file is set by the `configFormat` constructor argument: JSON (the default), or YAML or TOML
+ * from the `yaml` and `toml` entry points of this package. The format is never inferred from the file name or
+ * extension and existing files are not migrated between formats. For YAML and TOML, comments and layout in the
+ * existing file are preserved when it is written back.
+ *
+ * The default location of the configuration file is `$HOME/.<application_name>.<format extension>`. If `$HOME` is not defined no
  * default configuration will be used. The location of the configuration file can be modified via the
  * {@link ConfigCommand}.
  *
@@ -132,8 +138,11 @@ export default class ConfigurationServiceProvider {
     envVarsEnabled;
     configEnabled;
     secretServiceEnabled;
+    configFormat;
     // the location of the currently managed configuration data
     configLocation;
+    // the format specific handle for the text last read or written, used to preserve comments and layout on write
+    #configHandle;
     // the configuration data to be used by the CLI runner implementation when setting command defaults.
     // SingleValueType is for GlobalCommandArgument values, Values is for
     // SubCommandArgument values.
@@ -162,8 +171,9 @@ export default class ConfigurationServiceProvider {
      * @param configEnabled optionally enable configuration file support for default argument values.
      * @param secretServiceEnabled optionally enable OS-native secret storage via Bun.secrets for resolving
      * secrets embedded in default argument values: `configEnabled` must be true in this case
+     * @param configFormat optionally set the syntax of the configuration file, defaults to JSON.
      */
-    constructor(servicePriority, envVarsEnabled = false, configEnabled = false, secretServiceEnabled = false) {
+    constructor(servicePriority, envVarsEnabled = false, configEnabled = false, secretServiceEnabled = false, configFormat = jsonFormat) {
         if (!configEnabled && secretServiceEnabled) {
             throw new Error("configEnabled must be true if secretServiceEnabled is true");
         }
@@ -171,6 +181,7 @@ export default class ConfigurationServiceProvider {
         this.envVarsEnabled = envVarsEnabled;
         this.configEnabled = configEnabled;
         this.secretServiceEnabled = secretServiceEnabled;
+        this.configFormat = configFormat;
         this.#configurationService = new ConfigurationServiceImpl(this);
     }
     getServiceInfo(cliConfig) {
@@ -284,10 +295,10 @@ export default class ConfigurationServiceProvider {
         let isDefault = false;
         if (this.configLocation === undefined) {
             isDefault = true;
-            // default to `$HOME/.<application_name>.json`
+            // default to `$HOME/.<application_name>.<format extension>`
             const home = process.env["HOME"];
             if (home) {
-                this.configLocation = path.join(home, `.${context.cliConfig.name.replace(/\W/g, "")}.json`);
+                this.configLocation = path.join(home, `.${context.cliConfig.name.replace(/\W/g, "")}.${this.configFormat.fileExtension}`);
             }
         }
         if (this.configLocation === undefined) {
@@ -316,10 +327,8 @@ export default class ConfigurationServiceProvider {
         try {
             logger.debug("Reading config from: %s", location);
             const data = await fs.readFile(location);
-            const config = JSON.parse(data.toString());
-            if (config === undefined) {
-                return;
-            }
+            const { data: config, handle } = this.configFormat.parse(data.toString());
+            this.#configHandle = handle;
             this.defaultsData.clear();
             this.#commandKeyValueData.clear();
             this.#serviceKeyValueData.clear();
@@ -355,13 +364,21 @@ export default class ConfigurationServiceProvider {
     async #writeConfig(location) {
         logger.debug("Writing config to: %s", location);
         try {
-            await fs.writeFile(location, this.getConfigString());
+            const config = this.#getConfigData();
+            const text = this.#configHandle === undefined
+                ? this.configFormat.serialize(config)
+                : this.configFormat.apply(this.#configHandle, config);
+            await fs.writeFile(location, text);
+            this.#configHandle = this.configFormat.parse(text).handle;
         }
         catch (err) {
             throw new Error(`Failed to write config at location: '${this.configLocation}': ${err}`);
         }
     }
     getConfigString() {
+        return this.configFormat.serialize(this.#getConfigData());
+    }
+    #getConfigData() {
         const config = {};
         if (this.defaultsData.size > 0) {
             config.defaults = Object.fromEntries(this.defaultsData);
@@ -385,6 +402,6 @@ export default class ConfigurationServiceProvider {
                 }
             }
         }
-        return JSON.stringify(config, null, 2);
+        return config;
     }
 }

package/dist/src/service/configuration/format/ConfigFormat.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The top level structure of a configuration file: `defaults` and `key-values` objects.
+ */
+export type ConfigData = Record<string, any>;
+/**
+ * Defines the on-disk syntax of the CLI configuration file.
+ *
+ * The built-in implementation is JSON (the default). YAML and TOML implementations are available
+ * from the `@flowscripter/dynamic-cli-framework/yaml` and `@flowscripter/dynamic-cli-framework/toml`
+ * entry points. Third party formats can be supplied by implementing this interface.
+ */
+export default interface ConfigFormat {
+    /**
+     * The extension (without the leading dot) used for the default configuration file name,
+     * e.g. `json`.
+     */
+    readonly fileExtension: string;
+    /**
+     * Parse configuration file text.
+     *
+     * @returns the parsed `data` and an opaque `handle` retaining whatever the format needs to write
+     * changes back while preserving comments and layout (`undefined` if the format has nothing to retain).
+     * @throws if the text is not valid for this format.
+     */
+    parse(text: string): {
+        data: ConfigData;
+        handle: unknown;
+    };
+    /**
+     * Produce updated file text from a `handle` returned by {@link parse}.
+     *
+     * @param handle the handle returned by {@link parse} for the text being updated.
+     * @param changes the complete updated configuration data. The format reconciles the existing text
+     * with it, leaving unchanged content (including comments) untouched.
+     */
+    apply(handle: unknown, changes: ConfigData): string;
+    /**
+     * Produce new file text from scratch.
+     */
+    serialize(data: ConfigData): string;
+}
+//# sourceMappingURL=ConfigFormat.d.ts.map

package/dist/src/service/configuration/format/ConfigFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigFormat.d.ts","sourceRoot":"","sources":["../../../../../src/service/configuration/format/ConfigFormat.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,WAAW,YAAY;IACnC;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAE3D;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;IAEpD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CACrC"}

package/dist/src/service/configuration/format/JsonConfigFormat.d.ts

@@ -0,0 +1,7 @@
+import type ConfigFormat from "./ConfigFormat.ts";
+/**
+ * The built-in JSON {@link ConfigFormat}. The file is regenerated on write: JSON has no comments to preserve.
+ */
+declare const jsonFormat: ConfigFormat;
+export default jsonFormat;
+//# sourceMappingURL=JsonConfigFormat.d.ts.map

package/dist/src/service/configuration/format/JsonConfigFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonConfigFormat.d.ts","sourceRoot":"","sources":["../../../../../src/service/configuration/format/JsonConfigFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAOlD;;GAEG;AACH,QAAA,MAAM,UAAU,EAAE,YASjB,CAAC;eAEa,UAAU"}

package/dist/src/service/configuration/format/JsonConfigFormat.js

@@ -0,0 +1,17 @@
+function serialize(data) {
+    return JSON.stringify(data, null, 2);
+}
+/**
+ * The built-in JSON {@link ConfigFormat}. The file is regenerated on write: JSON has no comments to preserve.
+ */
+const jsonFormat = {
+    fileExtension: "json",
+    parse(text) {
+        return { data: JSON.parse(text), handle: undefined };
+    },
+    apply(_handle, changes) {
+        return serialize(changes);
+    },
+    serialize,
+};
+export default jsonFormat;

package/dist/src/service/configuration/format/TomlConfigFormat.d.ts

@@ -0,0 +1,10 @@
+import type ConfigFormat from "./ConfigFormat.ts";
+/**
+ * A TOML {@link ConfigFormat} which preserves comments, whitespace and layout when writing changes back.
+ * Dates and times are not supported as configuration values.
+ *
+ * Requires the optional `@decimalturn/toml-patch` peer dependency.
+ */
+declare const tomlFormat: ConfigFormat;
+export default tomlFormat;
+//# sourceMappingURL=TomlConfigFormat.d.ts.map

package/dist/src/service/configuration/format/TomlConfigFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TomlConfigFormat.d.ts","sourceRoot":"","sources":["../../../../../src/service/configuration/format/TomlConfigFormat.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAoElD;;;;;GAKG;AACH,QAAA,MAAM,UAAU,EAAE,YAajB,CAAC;eAEa,UAAU"}

package/dist/src/service/configuration/format/TomlConfigFormat.js

@@ -0,0 +1,78 @@
+import { isDeepStrictEqual } from "node:util";
+import { parse, patch, stringify } from "@decimalturn/toml-patch";
+// new tables nested deeper than this (e.g. `defaults.<command>.<option>`) are left to patch() to
+// lay out as inline tables
+const MAX_TABLE_HEADER_DEPTH = 3;
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function formatKey(key) {
+    return /^[A-Za-z0-9_-]+$/.test(key) ? key : JSON.stringify(key);
+}
+function collectNewTables(existing, updated, path, newTables) {
+    for (const [key, value] of Object.entries(updated)) {
+        if (!isPlainObject(value) || path.length + 1 > MAX_TABLE_HEADER_DEPTH) {
+            continue;
+        }
+        const childPath = [...path, key];
+        const existingChild = isPlainObject(existing) ? existing[key] : undefined;
+        if (existingChild === undefined) {
+            newTables.push(childPath);
+        }
+        collectNewTables(existingChild, value, childPath, newTables);
+    }
+}
+// parse() results do not share prototypes with plain objects
+function plain(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+/**
+ * Append an empty `[table]` header for every new table, so that patch() fills it in at the end
+ * of the file rather than hoisting it to the top as a dotted key. Returns the original text if the
+ * result is not equivalent to it plus the empty tables (e.g. the parent is an inline table which
+ * cannot be extended).
+ */
+function addNewTableHeaders(text, existing, changes) {
+    const newTables = [];
+    collectNewTables(existing, changes, [], newTables);
+    if (newTables.length === 0) {
+        return text;
+    }
+    const expected = structuredClone(existing);
+    for (const tablePath of newTables) {
+        let node = expected;
+        for (const key of tablePath.slice(0, -1)) {
+            node = (node[key] ??= {});
+        }
+        node[tablePath[tablePath.length - 1]] ??= {};
+    }
+    const headers = newTables.map((tablePath) => `[${tablePath.map(formatKey).join(".")}]`);
+    const withHeaders = `${text.trimEnd()}\n\n${headers.join("\n\n")}\n`;
+    try {
+        return isDeepStrictEqual(plain(parse(withHeaders)), plain(expected)) ? withHeaders : text;
+    }
+    catch {
+        return text;
+    }
+}
+/**
+ * A TOML {@link ConfigFormat} which preserves comments, whitespace and layout when writing changes back.
+ * Dates and times are not supported as configuration values.
+ *
+ * Requires the optional `@decimalturn/toml-patch` peer dependency.
+ */
+const tomlFormat = {
+    fileExtension: "toml",
+    parse(text) {
+        return { data: parse(text), handle: text };
+    },
+    apply(handle, changes) {
+        const text = handle;
+        const existing = parse(text);
+        return patch(addNewTableHeaders(text, existing, changes), changes);
+    },
+    serialize(data) {
+        return stringify(data);
+    },
+};
+export default tomlFormat;

package/dist/src/service/configuration/format/YamlConfigFormat.d.ts

@@ -0,0 +1,9 @@
+import type ConfigFormat from "./ConfigFormat.ts";
+/**
+ * A YAML {@link ConfigFormat} which preserves comments, blank lines and key order when writing changes back.
+ *
+ * Requires the optional `yaml` peer dependency.
+ */
+declare const yamlFormat: ConfigFormat;
+export default yamlFormat;
+//# sourceMappingURL=YamlConfigFormat.d.ts.map

package/dist/src/service/configuration/format/YamlConfigFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YamlConfigFormat.d.ts","sourceRoot":"","sources":["../../../../../src/service/configuration/format/YamlConfigFormat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAqClD;;;;GAIG;AACH,QAAA,MAAM,UAAU,EAAE,YA0BjB,CAAC;eAEa,UAAU"}

package/dist/src/service/configuration/format/YamlConfigFormat.js

@@ -0,0 +1,63 @@
+import { Document, isMap, isSeq, parseDocument, stringify } from "yaml";
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function reconcile(doc, path, existing, updated) {
+    if (isPlainObject(existing) && isPlainObject(updated)) {
+        for (const key of Object.keys(existing)) {
+            if (!(key in updated)) {
+                doc.deleteIn([...path, key]);
+            }
+        }
+        for (const key of Object.keys(updated)) {
+            if (key in existing) {
+                reconcile(doc, [...path, key], existing[key], updated[key]);
+            }
+            else {
+                doc.setIn([...path, key], updated[key]);
+            }
+        }
+    }
+    else if (Array.isArray(existing) &&
+        Array.isArray(updated) &&
+        existing.length === updated.length) {
+        updated.forEach((value, index) => reconcile(doc, [...path, index], existing[index], value));
+    }
+    else if (JSON.stringify(existing) !== JSON.stringify(updated)) {
+        doc.setIn(path, updated);
+    }
+}
+/**
+ * A YAML {@link ConfigFormat} which preserves comments, blank lines and key order when writing changes back.
+ *
+ * Requires the optional `yaml` peer dependency.
+ */
+const yamlFormat = {
+    fileExtension: "yaml",
+    parse(text) {
+        const doc = parseDocument(text);
+        if (doc.errors.length > 0) {
+            throw new Error(doc.errors.map((error) => error.message).join("; "));
+        }
+        const data = doc.toJS() ?? {};
+        if (!isPlainObject(data)) {
+            throw new Error("top level YAML value must be a mapping");
+        }
+        return { data, handle: doc };
+    },
+    apply(handle, changes) {
+        const doc = handle;
+        const existing = doc.toJS() ?? {};
+        if (!isMap(doc.contents) && !isSeq(doc.contents)) {
+            doc.contents = doc.createNode(changes);
+        }
+        else {
+            reconcile(doc, [], existing, changes);
+        }
+        return doc.toString();
+    },
+    serialize(data) {
+        return stringify(data);
+    },
+};
+export default yamlFormat;

package/dist/toml.d.ts

@@ -0,0 +1,2 @@
+export { default as tomlFormat } from "./src/service/configuration/format/TomlConfigFormat.ts";
+//# sourceMappingURL=toml.d.ts.map

package/dist/toml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.d.ts","sourceRoot":"","sources":["../toml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,wDAAwD,CAAC"}

package/dist/toml.js

@@ -0,0 +1 @@
+export { default as tomlFormat } from "./src/service/configuration/format/TomlConfigFormat.js";

package/dist/yaml.d.ts

@@ -0,0 +1,2 @@
+export { default as yamlFormat } from "./src/service/configuration/format/YamlConfigFormat.ts";
+//# sourceMappingURL=yaml.d.ts.map

package/dist/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,wDAAwD,CAAC"}

package/dist/yaml.js

@@ -0,0 +1 @@
+export { default as yamlFormat } from "./src/service/configuration/format/YamlConfigFormat.js";

package/index.ts

@@ -68,6 +68,9 @@ export {
   default as ConfigurationServiceProvider,
   type KeyValueServiceScopeType,
 } from "./src/service/configuration/ConfigurationServiceProvider.ts";
+export type { default as ConfigFormat } from "./src/service/configuration/format/ConfigFormat.ts";
+export type { ConfigData } from "./src/service/configuration/format/ConfigFormat.ts";
+export { default as jsonFormat } from "./src/service/configuration/format/JsonConfigFormat.ts";
 export { default as KeyValueServiceProvider } from "./src/service/configuration/KeyValueServiceProvider.ts";
 
 export { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework",
-  "version": "12.0.1",
+  "version": "12.1.0",
   "description": "A framework for developing CLI applications which supports dynamic discovery and installation of new commands",
   "keywords": [
     "bun",
@@ -22,6 +22,8 @@
     "src",
     "index.ts",
     "cli-plugin.ts",
+    "yaml.ts",
+    "toml.ts",
     "README.md",
     "LICENSE"
   ],
@@ -40,6 +42,16 @@
       "bun": "./cli-plugin.ts",
       "types": "./dist/cli-plugin.d.ts",
       "default": "./dist/cli-plugin.js"
+    },
+    "./yaml": {
+      "bun": "./yaml.ts",
+      "types": "./dist/yaml.d.ts",
+      "default": "./dist/yaml.js"
+    },
+    "./toml": {
+      "bun": "./toml.ts",
+      "types": "./dist/toml.d.ts",
+      "default": "./dist/toml.js"
     }
   },
   "publishConfig": {
@@ -61,14 +73,26 @@
     "supports-terminal-graphics": "^0.1.0"
   },
   "devDependencies": {
+    "@decimalturn/toml-patch": "^3.3.1",
     "@types/bun": "^1.4.3",
     "@types/node": "^26.6.5",
     "@types/semver": "^7.8.0",
     "oxfmt": "0.74.0",
-    "oxlint": "1.89.0"
+    "oxlint": "1.89.0",
+    "yaml": "^2.9.1"
   },
   "peerDependencies": {
-    "typescript": "^7.0.2"
+    "@decimalturn/toml-patch": "^3.3.1",
+    "typescript": "^7.0.2",
+    "yaml": "^2.9.1"
+  },
+  "peerDependenciesMeta": {
+    "yaml": {
+      "optional": true
+    },
+    "@decimalturn/toml-patch": {
+      "optional": true
+    }
   },
   "typedocOptions": {
     "readme": "none",

package/src/cli/BaseCLI.ts

@@ -31,6 +31,7 @@ import ShutdownServiceProvider from "../service/shutdown/ShutdownServiceProvider
 import StartupServiceProvider from "../service/startup/StartupServiceProvider.ts";
 import type { StartupTask } from "@flowscripter/dynamic-cli-framework-api";
 import { shutdownState } from "../service/shutdown/ShutdownState.ts";
+import jsonFormat from "../service/configuration/format/JsonConfigFormat.ts";
 import ConfigurationServiceProvider from "../service/configuration/ConfigurationServiceProvider.ts";
 import KeyValueServiceProvider from "../service/configuration/KeyValueServiceProvider.ts";
 import PrinterServiceProvider from "../service/printer/PrinterServiceProvider.ts";
@@ -162,6 +163,7 @@ export default class BaseCLI implements CLI {
     }
     this.#cliConfig = cliConfig;
     this.#options = {
+      configFormat: jsonFormat,
       configFileSupportEnabled: false,
       envVarsSupportEnabled: false,
       keyValueServiceEnabled: false,
@@ -392,6 +394,7 @@ export default class BaseCLI implements CLI {
       this.#options.envVarsSupportEnabled,
       this.#options.configFileSupportEnabled,
       this.#options.secretServiceEnabled,
+      this.#options.configFormat,
     );
     this.addServiceProvider(configurationServiceProvider);
     const keyValueServiceProvider = new KeyValueServiceProvider(

package/src/cli/BaseCLIFeatureOptions.ts

@@ -1,3 +1,4 @@
+import type ConfigFormat from "../service/configuration/format/ConfigFormat.ts";
 import type { UpgradeLocationsConfig } from "../service/upgrade/UpgradeLocationsConfig.ts";
 import type {
   NpmjsPluginRepositoryConfig,
@@ -6,6 +7,11 @@ import type {
 
 export default interface BaseCLIFeatureOptions {
   readonly configFileSupportEnabled?: boolean;
+  /**
+   * The syntax of the configuration file. Defaults to JSON. YAML and TOML are available from the
+   * `@flowscripter/dynamic-cli-framework/yaml` and `@flowscripter/dynamic-cli-framework/toml` entry points.
+   */
+  readonly configFormat?: ConfigFormat;
   readonly envVarsSupportEnabled?: boolean;
   readonly keyValueServiceEnabled?: boolean;
   readonly secretServiceEnabled?: boolean;

package/src/service/configuration/ConfigurationServiceProvider.ts

@@ -22,6 +22,9 @@ import {
 } from "@flowscripter/dynamic-cli-framework-api";
 import type { ConfigurationService } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultSecretService from "./DefaultSecretService.ts";
+import type ConfigFormat from "./format/ConfigFormat.ts";
+import type { ConfigData } from "./format/ConfigFormat.ts";
+import jsonFormat from "./format/JsonConfigFormat.ts";
 import resolveSecrets from "./resolveSecrets.ts";
 import type { Command } from "@flowscripter/dynamic-cli-framework-api";
 import argumentValueMerge from "../../runtime/values/argumentValueMerge.ts";
@@ -77,7 +80,7 @@ class ConfigurationServiceImpl implements ConfigurationService {
  *
  * *Configuration File*
  *
- * A JSON file where the structure matches {@link Values} and the defaults are stored
+ * A file (JSON by default, see {@link ConfigFormat}) where the structure matches {@link Values} and the defaults are stored
  * under a top level `defaults` property. The second level of properties is used to refer to {@link Command.name}
  * (or `<group name>:<member name>` for a member of a {@link GroupCommand}) and the contained values are treated as
  * command {@link Values}. As an example:
@@ -108,7 +111,12 @@ class ConfigurationServiceImpl implements ConfigurationService {
  * }
  * ```
  *
- * The default location of the configuration file is `$HOME/.<application_name>.json`. If `$HOME` is not defined no
+ * The syntax of the file is set by the `configFormat` constructor argument: JSON (the default), or YAML or TOML
+ * from the `yaml` and `toml` entry points of this package. The format is never inferred from the file name or
+ * extension and existing files are not migrated between formats. For YAML and TOML, comments and layout in the
+ * existing file are preserved when it is written back.
+ *
+ * The default location of the configuration file is `$HOME/.<application_name>.<format extension>`. If `$HOME` is not defined no
  * default configuration will be used. The location of the configuration file can be modified via the
  * {@link ConfigCommand}.
  *
@@ -164,10 +172,14 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
   public readonly envVarsEnabled: boolean;
   public readonly configEnabled: boolean;
   public readonly secretServiceEnabled: boolean;
+  public readonly configFormat: ConfigFormat;
 
   // the location of the currently managed configuration data
   public configLocation: string | undefined;
 
+  // the format specific handle for the text last read or written, used to preserve comments and layout on write
+  #configHandle: unknown;
+
   // the configuration data to be used by the CLI runner implementation when setting command defaults.
   // SingleValueType is for GlobalCommandArgument values, Values is for
   // SubCommandArgument values.
@@ -200,12 +212,14 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
    * @param configEnabled optionally enable configuration file support for default argument values.
    * @param secretServiceEnabled optionally enable OS-native secret storage via Bun.secrets for resolving
    * secrets embedded in default argument values: `configEnabled` must be true in this case
+   * @param configFormat optionally set the syntax of the configuration file, defaults to JSON.
    */
   public constructor(
     servicePriority: number,
     envVarsEnabled = false,
     configEnabled = false,
     secretServiceEnabled = false,
+    configFormat: ConfigFormat = jsonFormat,
   ) {
     if (!configEnabled && secretServiceEnabled) {
       throw new Error("configEnabled must be true if secretServiceEnabled is true");
@@ -214,6 +228,7 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
     this.envVarsEnabled = envVarsEnabled;
     this.configEnabled = configEnabled;
     this.secretServiceEnabled = secretServiceEnabled;
+    this.configFormat = configFormat;
 
     this.#configurationService = new ConfigurationServiceImpl(this);
   }
@@ -355,10 +370,13 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
     let isDefault = false;
     if (this.configLocation === undefined) {
       isDefault = true;
-      // default to `$HOME/.<application_name>.json`
+      // default to `$HOME/.<application_name>.<format extension>`
       const home = process.env["HOME"];
       if (home) {
-        this.configLocation = path.join(home, `.${context.cliConfig.name.replace(/\W/g, "")}.json`);
+        this.configLocation = path.join(
+          home,
+          `.${context.cliConfig.name.replace(/\W/g, "")}.${this.configFormat.fileExtension}`,
+        );
       }
     }
     if (this.configLocation === undefined) {
@@ -396,11 +414,9 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
       logger.debug("Reading config from: %s", location);
 
       const data = await fs.readFile(location);
-      const config = JSON.parse(data.toString());
+      const { data: config, handle } = this.configFormat.parse(data.toString());
+      this.#configHandle = handle;
 
-      if (config === undefined) {
-        return;
-      }
       this.defaultsData.clear();
       this.#commandKeyValueData.clear();
       this.#serviceKeyValueData.clear();
@@ -443,13 +459,23 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
     logger.debug("Writing config to: %s", location);
 
     try {
-      await fs.writeFile(location, this.getConfigString());
+      const config = this.#getConfigData();
+      const text =
+        this.#configHandle === undefined
+          ? this.configFormat.serialize(config)
+          : this.configFormat.apply(this.#configHandle, config);
+      await fs.writeFile(location, text);
+      this.#configHandle = this.configFormat.parse(text).handle;
     } catch (err) {
       throw new Error(`Failed to write config at location: '${this.configLocation}': ${err}`);
     }
   }
 
   public getConfigString(): string {
+    return this.configFormat.serialize(this.#getConfigData());
+  }
+
+  #getConfigData(): ConfigData {
     const config: {
       defaults?: Record<string, Values | SingleValueType>;
       "key-values"?: {
@@ -480,6 +506,6 @@ export default class ConfigurationServiceProvider implements ServiceProvider {
         }
       }
     }
-    return JSON.stringify(config, null, 2);
+    return config;
   }
 }

package/src/service/configuration/format/ConfigFormat.ts

@@ -0,0 +1,42 @@
+/**
+ * The top level structure of a configuration file: `defaults` and `key-values` objects.
+ */
+export type ConfigData = Record<string, any>;
+
+/**
+ * Defines the on-disk syntax of the CLI configuration file.
+ *
+ * The built-in implementation is JSON (the default). YAML and TOML implementations are available
+ * from the `@flowscripter/dynamic-cli-framework/yaml` and `@flowscripter/dynamic-cli-framework/toml`
+ * entry points. Third party formats can be supplied by implementing this interface.
+ */
+export default interface ConfigFormat {
+  /**
+   * The extension (without the leading dot) used for the default configuration file name,
+   * e.g. `json`.
+   */
+  readonly fileExtension: string;
+
+  /**
+   * Parse configuration file text.
+   *
+   * @returns the parsed `data` and an opaque `handle` retaining whatever the format needs to write
+   * changes back while preserving comments and layout (`undefined` if the format has nothing to retain).
+   * @throws if the text is not valid for this format.
+   */
+  parse(text: string): { data: ConfigData; handle: unknown };
+
+  /**
+   * Produce updated file text from a `handle` returned by {@link parse}.
+   *
+   * @param handle the handle returned by {@link parse} for the text being updated.
+   * @param changes the complete updated configuration data. The format reconciles the existing text
+   * with it, leaving unchanged content (including comments) untouched.
+   */
+  apply(handle: unknown, changes: ConfigData): string;
+
+  /**
+   * Produce new file text from scratch.
+   */
+  serialize(data: ConfigData): string;
+}

package/src/service/configuration/format/JsonConfigFormat.ts

@@ -0,0 +1,22 @@
+import type ConfigFormat from "./ConfigFormat.ts";
+import type { ConfigData } from "./ConfigFormat.ts";
+
+function serialize(data: ConfigData): string {
+  return JSON.stringify(data, null, 2);
+}
+
+/**
+ * The built-in JSON {@link ConfigFormat}. The file is regenerated on write: JSON has no comments to preserve.
+ */
+const jsonFormat: ConfigFormat = {
+  fileExtension: "json",
+  parse(text: string) {
+    return { data: JSON.parse(text) as ConfigData, handle: undefined };
+  },
+  apply(_handle: unknown, changes: ConfigData): string {
+    return serialize(changes);
+  },
+  serialize,
+};
+
+export default jsonFormat;

package/src/service/configuration/format/TomlConfigFormat.ts

@@ -0,0 +1,92 @@
+import { isDeepStrictEqual } from "node:util";
+import { parse, patch, stringify } from "@decimalturn/toml-patch";
+import type ConfigFormat from "./ConfigFormat.ts";
+import type { ConfigData } from "./ConfigFormat.ts";
+
+// new tables nested deeper than this (e.g. `defaults.<command>.<option>`) are left to patch() to
+// lay out as inline tables
+const MAX_TABLE_HEADER_DEPTH = 3;
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function formatKey(key: string): string {
+  return /^[A-Za-z0-9_-]+$/.test(key) ? key : JSON.stringify(key);
+}
+
+function collectNewTables(
+  existing: unknown,
+  updated: Record<string, unknown>,
+  path: Array<string>,
+  newTables: Array<Array<string>>,
+): void {
+  for (const [key, value] of Object.entries(updated)) {
+    if (!isPlainObject(value) || path.length + 1 > MAX_TABLE_HEADER_DEPTH) {
+      continue;
+    }
+    const childPath = [...path, key];
+    const existingChild = isPlainObject(existing) ? existing[key] : undefined;
+    if (existingChild === undefined) {
+      newTables.push(childPath);
+    }
+    collectNewTables(existingChild, value, childPath, newTables);
+  }
+}
+
+// parse() results do not share prototypes with plain objects
+function plain(value: unknown): unknown {
+  return JSON.parse(JSON.stringify(value));
+}
+
+/**
+ * Append an empty `[table]` header for every new table, so that patch() fills it in at the end
+ * of the file rather than hoisting it to the top as a dotted key. Returns the original text if the
+ * result is not equivalent to it plus the empty tables (e.g. the parent is an inline table which
+ * cannot be extended).
+ */
+function addNewTableHeaders(text: string, existing: ConfigData, changes: ConfigData): string {
+  const newTables: Array<Array<string>> = [];
+  collectNewTables(existing, changes, [], newTables);
+  if (newTables.length === 0) {
+    return text;
+  }
+  const expected = structuredClone(existing);
+  for (const tablePath of newTables) {
+    let node = expected;
+    for (const key of tablePath.slice(0, -1)) {
+      node = (node[key] ??= {}) as ConfigData;
+    }
+    node[tablePath[tablePath.length - 1]!] ??= {};
+  }
+  const headers = newTables.map((tablePath) => `[${tablePath.map(formatKey).join(".")}]`);
+  const withHeaders = `${text.trimEnd()}\n\n${headers.join("\n\n")}\n`;
+  try {
+    return isDeepStrictEqual(plain(parse(withHeaders)), plain(expected)) ? withHeaders : text;
+  } catch {
+    return text;
+  }
+}
+
+/**
+ * A TOML {@link ConfigFormat} which preserves comments, whitespace and layout when writing changes back.
+ * Dates and times are not supported as configuration values.
+ *
+ * Requires the optional `@decimalturn/toml-patch` peer dependency.
+ */
+const tomlFormat: ConfigFormat = {
+  fileExtension: "toml",
+  parse(text: string) {
+    return { data: parse(text) as ConfigData, handle: text };
+  },
+  apply(handle: unknown, changes: ConfigData): string {
+    const text = handle as string;
+    const existing = parse(text) as ConfigData;
+    return patch(addNewTableHeaders(text, existing, changes), changes);
+  },
+  serialize(data: ConfigData): string {
+    return stringify(data);
+  },
+};
+
+export default tomlFormat;

package/src/service/configuration/format/YamlConfigFormat.ts

@@ -0,0 +1,72 @@
+import { Document, isMap, isSeq, parseDocument, stringify } from "yaml";
+import type ConfigFormat from "./ConfigFormat.ts";
+import type { ConfigData } from "./ConfigFormat.ts";
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function reconcile(
+  doc: Document,
+  path: Array<string | number>,
+  existing: unknown,
+  updated: unknown,
+): void {
+  if (isPlainObject(existing) && isPlainObject(updated)) {
+    for (const key of Object.keys(existing)) {
+      if (!(key in updated)) {
+        doc.deleteIn([...path, key]);
+      }
+    }
+    for (const key of Object.keys(updated)) {
+      if (key in existing) {
+        reconcile(doc, [...path, key], existing[key], updated[key]);
+      } else {
+        doc.setIn([...path, key], updated[key]);
+      }
+    }
+  } else if (
+    Array.isArray(existing) &&
+    Array.isArray(updated) &&
+    existing.length === updated.length
+  ) {
+    updated.forEach((value, index) => reconcile(doc, [...path, index], existing[index], value));
+  } else if (JSON.stringify(existing) !== JSON.stringify(updated)) {
+    doc.setIn(path, updated);
+  }
+}
+
+/**
+ * A YAML {@link ConfigFormat} which preserves comments, blank lines and key order when writing changes back.
+ *
+ * Requires the optional `yaml` peer dependency.
+ */
+const yamlFormat: ConfigFormat = {
+  fileExtension: "yaml",
+  parse(text: string) {
+    const doc = parseDocument(text);
+    if (doc.errors.length > 0) {
+      throw new Error(doc.errors.map((error) => error.message).join("; "));
+    }
+    const data = doc.toJS() ?? {};
+    if (!isPlainObject(data)) {
+      throw new Error("top level YAML value must be a mapping");
+    }
+    return { data, handle: doc };
+  },
+  apply(handle: unknown, changes: ConfigData): string {
+    const doc = handle as Document;
+    const existing = doc.toJS() ?? {};
+    if (!isMap(doc.contents) && !isSeq(doc.contents)) {
+      doc.contents = doc.createNode(changes);
+    } else {
+      reconcile(doc, [], existing, changes);
+    }
+    return doc.toString();
+  },
+  serialize(data: ConfigData): string {
+    return stringify(data);
+  },
+};
+
+export default yamlFormat;

package/toml.ts

@@ -0,0 +1 @@
+export { default as tomlFormat } from "./src/service/configuration/format/TomlConfigFormat.ts";

package/yaml.ts

@@ -0,0 +1 @@
+export { default as yamlFormat } from "./src/service/configuration/format/YamlConfigFormat.ts";