@flowscripter/dynamic-cli-framework 1.6.2 → 1.7.0

package/cli-plugin.ts

@@ -13,7 +13,18 @@ export type { ArgumentValues } from "./src/api/argument/ArgumentValueTypes.ts";
 export { ArgumentValueTypeName } from "./src/api/argument/ArgumentValueTypes.ts";
 export type { default as Option } from "./src/api/argument/Option.ts";
 export type { default as Positional } from "./src/api/argument/Positional.ts";
-export type { ExtensionDescriptor, ExtensionFactory } from "@flowscripter/dynamic-plugin-framework";
+export type {
+  Plugin,
+  ExtensionDescriptor,
+  ExtensionFactory,
+} from "@flowscripter/dynamic-plugin-framework";
+export type {
+  default as CLIPlugin,
+  CommandFactoryExtensionDescriptor,
+  ServiceProviderFactoryExtensionDescriptor,
+} from "./src/api/plugin/CLIPlugin.ts";
+export { default as createCLIPlugin } from "./src/api/plugin/createCLIPlugin.ts";
+export type { CLIPluginOptions } from "./src/api/plugin/createCLIPlugin.ts";
 
 // Core Service IDs and types
 export { ASCII_BANNER_GENERATOR_SERVICE_ID } from "./src/api/service/core/AsciiBannerGeneratorService.ts";

package/dist/cli-plugin.d.ts

@@ -13,7 +13,10 @@ export type { ArgumentValues } from "./src/api/argument/ArgumentValueTypes.ts";
 export { ArgumentValueTypeName } from "./src/api/argument/ArgumentValueTypes.ts";
 export type { default as Option } from "./src/api/argument/Option.ts";
 export type { default as Positional } from "./src/api/argument/Positional.ts";
-export type { ExtensionDescriptor, ExtensionFactory } from "@flowscripter/dynamic-plugin-framework";
+export type { Plugin, ExtensionDescriptor, ExtensionFactory, } from "@flowscripter/dynamic-plugin-framework";
+export type { default as CLIPlugin, CommandFactoryExtensionDescriptor, ServiceProviderFactoryExtensionDescriptor, } from "./src/api/plugin/CLIPlugin.ts";
+export { default as createCLIPlugin } from "./src/api/plugin/createCLIPlugin.ts";
+export type { CLIPluginOptions } from "./src/api/plugin/createCLIPlugin.ts";
 export { ASCII_BANNER_GENERATOR_SERVICE_ID } from "./src/api/service/core/AsciiBannerGeneratorService.ts";
 export type { default as AsciiBannerGeneratorService } from "./src/api/service/core/AsciiBannerGeneratorService.ts";
 export type { BannerColorEffects, BannerGenerateOptions, ColorEffect, ColorEffectDirection, FixedColorEffect, GradientColorEffect, RainbowColorEffect, } from "./src/api/service/core/AsciiBannerGeneratorService.ts";

package/dist/cli-plugin.d.ts.map

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

package/dist/cli-plugin.js

@@ -62,6 +62,29 @@ var ComplexValueTypeName;
 ((ComplexValueTypeName2) => {
   ComplexValueTypeName2[ComplexValueTypeName2["COMPLEX"] = 5] = "COMPLEX";
 })(ComplexValueTypeName ||= {});
+// src/api/plugin/createCLIPlugin.ts
+function createCLIPlugin(options) {
+  const extensionDescriptors = [];
+  if (options.commandFactory) {
+    const commandFactory = options.commandFactory;
+    extensionDescriptors.push({
+      extensionPoint: DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT,
+      factory: {
+        create: async () => typeof commandFactory === "function" ? commandFactory() : commandFactory
+      }
+    });
+  }
+  if (options.serviceProviderFactory) {
+    const serviceProviderFactory = options.serviceProviderFactory;
+    extensionDescriptors.push({
+      extensionPoint: DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT,
+      factory: {
+        create: async () => typeof serviceProviderFactory === "function" ? serviceProviderFactory() : serviceProviderFactory
+      }
+    });
+  }
+  return { extensionDescriptors, pluginData: options.pluginData };
+}
 // src/api/service/core/AsciiBannerGeneratorService.ts
 var ASCII_BANNER_GENERATOR_SERVICE_ID = "@flowscripter/dynamic-cli-framework/ascii-banner-generator-service";
 // src/api/service/core/KeyValueService.ts
@@ -193,6 +216,7 @@ var ARGUMENT_PROMPTER_SERVICE_ID = "@flowscripter/dynamic-cli-framework/argument
 // src/api/service/core/PluginService.ts
 var PLUGIN_SERVICE_ID = "PLUGIN_SERVICE";
 export {
+  createCLIPlugin,
   Table,
   TREE_PRINTER_SERVICE_ID,
   TABLE_GENERATOR_SERVICE_ID,

package/dist/src/api/plugin/CLIPlugin.d.ts

@@ -0,0 +1,31 @@
+import type { Plugin, ExtensionDescriptor } from "@flowscripter/dynamic-plugin-framework";
+import type CommandFactory from "./CommandFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "./CommandFactory.ts";
+import type ServiceProviderFactory from "./ServiceProviderFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "./ServiceProviderFactory.ts";
+/**
+ * {@link ExtensionDescriptor} for a {@link CommandFactory} extension.
+ */
+export interface CommandFactoryExtensionDescriptor extends ExtensionDescriptor {
+    readonly extensionPoint: typeof DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT;
+    readonly factory: {
+        create(hostData?: Map<string, string>): Promise<CommandFactory>;
+    };
+}
+/**
+ * {@link ExtensionDescriptor} for a {@link ServiceProviderFactory} extension.
+ */
+export interface ServiceProviderFactoryExtensionDescriptor extends ExtensionDescriptor {
+    readonly extensionPoint: typeof DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT;
+    readonly factory: {
+        create(hostData?: Map<string, string>): Promise<ServiceProviderFactory>;
+    };
+}
+/**
+ * A {@link Plugin} for {@link DynamicPluginRuntimeCLI} whose {@link extensionDescriptors} are
+ * limited to the {@link CommandFactory} and {@link ServiceProviderFactory} extension points.
+ */
+export default interface CLIPlugin extends Plugin {
+    readonly extensionDescriptors: ReadonlyArray<CommandFactoryExtensionDescriptor | ServiceProviderFactoryExtensionDescriptor>;
+}
+//# sourceMappingURL=CLIPlugin.d.ts.map

package/dist/src/api/plugin/CLIPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLIPlugin.d.ts","sourceRoot":"","sources":["../../../../src/api/plugin/CLIPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qDAAqD,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,8DAA8D,EAAE,MAAM,6BAA6B,CAAC;AAE7G;;GAEG;AACH,MAAM,WAAW,iCAAkC,SAAQ,mBAAmB;IAC5E,QAAQ,CAAC,cAAc,EAAE,OAAO,qDAAqD,CAAC;IACtF,QAAQ,CAAC,OAAO,EAAE;QAChB,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;KACjE,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,yCAA0C,SAAQ,mBAAmB;IACpF,QAAQ,CAAC,cAAc,EAAE,OAAO,8DAA8D,CAAC;IAC/F,QAAQ,CAAC,OAAO,EAAE;QAChB,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;KACzE,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,SAAU,SAAQ,MAAM;IAC/C,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAC1C,iCAAiC,GAAG,yCAAyC,CAC9E,CAAC;CACH"}

package/dist/src/api/plugin/createCLIPlugin.d.ts

@@ -0,0 +1,14 @@
+import type CommandFactory from "./CommandFactory.ts";
+import type ServiceProviderFactory from "./ServiceProviderFactory.ts";
+import type CLIPlugin from "./CLIPlugin.ts";
+export interface CLIPluginOptions {
+    readonly commandFactory?: CommandFactory | (() => Promise<CommandFactory>);
+    readonly serviceProviderFactory?: ServiceProviderFactory | (() => Promise<ServiceProviderFactory>);
+    readonly pluginData?: ReadonlyMap<string, string>;
+}
+/**
+ * Build a {@link CLIPlugin} from optional {@link CommandFactory} and {@link ServiceProviderFactory}
+ * instances (or factory functions), without needing to hand-construct extension descriptors.
+ */
+export default function createCLIPlugin(options: CLIPluginOptions): CLIPlugin;
+//# sourceMappingURL=createCLIPlugin.d.ts.map

package/dist/src/api/plugin/createCLIPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCLIPlugin.d.ts","sourceRoot":"","sources":["../../../../src/api/plugin/createCLIPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,sBAAsB,CAAC,EAC5B,sBAAsB,GACtB,CAAC,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA4B5E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "description": "A framework for developing CLI applications which supports dynamic discovery and installation of new commands",
   "keywords": [
     "bun",
@@ -48,7 +48,7 @@
     "build": "bun build index.ts cli-plugin.ts --outdir dist --target bun && tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@flowscripter/dynamic-plugin-framework": "1.9.0",
+    "@flowscripter/dynamic-plugin-framework": "1.10.0",
     "emphasize": "^7.0.0",
     "fastest-levenshtein": "^1.0.16",
     "figlet": "^1.11.0",

package/src/api/plugin/CLIPlugin.ts

@@ -0,0 +1,35 @@
+import type { Plugin, ExtensionDescriptor } from "@flowscripter/dynamic-plugin-framework";
+import type CommandFactory from "./CommandFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "./CommandFactory.ts";
+import type ServiceProviderFactory from "./ServiceProviderFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "./ServiceProviderFactory.ts";
+
+/**
+ * {@link ExtensionDescriptor} for a {@link CommandFactory} extension.
+ */
+export interface CommandFactoryExtensionDescriptor extends ExtensionDescriptor {
+  readonly extensionPoint: typeof DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT;
+  readonly factory: {
+    create(hostData?: Map<string, string>): Promise<CommandFactory>;
+  };
+}
+
+/**
+ * {@link ExtensionDescriptor} for a {@link ServiceProviderFactory} extension.
+ */
+export interface ServiceProviderFactoryExtensionDescriptor extends ExtensionDescriptor {
+  readonly extensionPoint: typeof DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT;
+  readonly factory: {
+    create(hostData?: Map<string, string>): Promise<ServiceProviderFactory>;
+  };
+}
+
+/**
+ * A {@link Plugin} for {@link DynamicPluginRuntimeCLI} whose {@link extensionDescriptors} are
+ * limited to the {@link CommandFactory} and {@link ServiceProviderFactory} extension points.
+ */
+export default interface CLIPlugin extends Plugin {
+  readonly extensionDescriptors: ReadonlyArray<
+    CommandFactoryExtensionDescriptor | ServiceProviderFactoryExtensionDescriptor
+  >;
+}

package/src/api/plugin/createCLIPlugin.ts

@@ -0,0 +1,47 @@
+import type CommandFactory from "./CommandFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "./CommandFactory.ts";
+import type ServiceProviderFactory from "./ServiceProviderFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "./ServiceProviderFactory.ts";
+import type CLIPlugin from "./CLIPlugin.ts";
+
+export interface CLIPluginOptions {
+  readonly commandFactory?: CommandFactory | (() => Promise<CommandFactory>);
+  readonly serviceProviderFactory?:
+    | ServiceProviderFactory
+    | (() => Promise<ServiceProviderFactory>);
+  readonly pluginData?: ReadonlyMap<string, string>;
+}
+
+/**
+ * Build a {@link CLIPlugin} from optional {@link CommandFactory} and {@link ServiceProviderFactory}
+ * instances (or factory functions), without needing to hand-construct extension descriptors.
+ */
+export default function createCLIPlugin(options: CLIPluginOptions): CLIPlugin {
+  const extensionDescriptors: CLIPlugin["extensionDescriptors"][number][] = [];
+
+  if (options.commandFactory) {
+    const commandFactory = options.commandFactory;
+    extensionDescriptors.push({
+      extensionPoint: DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT,
+      factory: {
+        create: async () =>
+          typeof commandFactory === "function" ? commandFactory() : commandFactory,
+      },
+    });
+  }
+
+  if (options.serviceProviderFactory) {
+    const serviceProviderFactory = options.serviceProviderFactory;
+    extensionDescriptors.push({
+      extensionPoint: DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT,
+      factory: {
+        create: async () =>
+          typeof serviceProviderFactory === "function"
+            ? serviceProviderFactory()
+            : serviceProviderFactory,
+      },
+    });
+  }
+
+  return { extensionDescriptors, pluginData: options.pluginData };
+}