kist 0.1.45 → 0.1.58

package/ts/interface/ActionPlugin.ts

@@ -8,7 +8,54 @@ import { ActionInterface } from "./ActionInterface";
 // Interfaces
 // ============================================================================
 
-// ActionPlugin.ts
+/**
+ * ActionPlugin defines the contract for kist plugins.
+ * Plugins can provide one or more actions to extend kist's functionality.
+ *
+ * Example plugin structure:
+ * ```typescript
+ * import { ActionPlugin, ActionInterface } from 'kist';
+ *
+ * export default {
+ *   version: '1.0.0',
+ *   description: 'My custom kist plugin',
+ *   registerActions() {
+ *     return {
+ *       'MyCustomAction': MyCustomAction
+ *     };
+ *   }
+ * } as ActionPlugin;
+ * ```
+ */
 export interface ActionPlugin {
+    /**
+     * Returns a record of action classes provided by this plugin.
+     * Keys are action names, values are action class constructors.
+     */
     registerActions(): Record<string, new () => ActionInterface>;
+
+    /**
+     * Optional: Plugin version (semantic versioning recommended)
+     */
+    version?: string;
+
+    /**
+     * Optional: Plugin description
+     */
+    description?: string;
+
+    /**
+     * Optional: Plugin author information
+     */
+    author?: string;
+
+    /**
+     * Optional: Plugin repository URL
+     */
+    repository?: string;
+
+    /**
+     * Optional: Keywords for plugin discoverability
+     */
+    keywords?: string[];
 }

package/ts/interface/PluginMetadata.ts

@@ -0,0 +1,43 @@
+// ============================================================================
+// Interface
+// ============================================================================
+
+/**
+ * Metadata for a loaded plugin
+ */
+export interface PluginMetadata {
+    /**
+     * The unique name of the plugin
+     */
+    name: string;
+
+    /**
+     * The version of the plugin
+     */
+    version: string;
+
+    /**
+     * Optional description of the plugin
+     */
+    description?: string;
+
+    /**
+     * List of action names provided by this plugin
+     */
+    actions: string[];
+
+    /**
+     * Optional author information
+     */
+    author?: string;
+
+    /**
+     * Optional repository URL
+     */
+    repository?: string;
+
+    /**
+     * Optional keywords for discoverability
+     */
+    keywords?: string[];
+}

package/ts/interface/SVG.ts

@@ -62,6 +62,7 @@ interface SvgPath {
 /**
  * Example usage of the Svg interface.
  */
+/*
 const exampleSvg: Svg = {
     metadata: {
         name: "Example SVG",
@@ -82,3 +83,4 @@ const exampleSvg: Svg = {
         },
     ],
 };
+*/

package/ts/kist.ts

@@ -6,6 +6,7 @@ import { AbstractProcess } from "./core/abstract/AbstractProcess";
 import { ConfigStore } from "./core/config/ConfigStore";
 import { ActionRegistry } from "./core/pipeline/ActionRegistry";
 import { PipelineManager } from "./core/pipeline/PipelineManager";
+import { PluginManager } from "./core/plugin/PluginManager";
 import { LiveServer } from "./live/LiveServer";
 import { LiveWatcher } from "./live/LiveWatcher";
 
@@ -50,7 +51,7 @@ export class Kist extends AbstractProcess {
 
         try {
             // Initialize the ActionRegistry with available actions
-            this.initializeActionRegistry();
+            await this.initializeActionRegistry();
 
             // Create and run the PipelineManager
             const liveReloadEnabled = ConfigStore.getInstance().get<boolean>(
@@ -76,7 +77,29 @@ export class Kist extends AbstractProcess {
      * Initializes the ActionRegistry with available actions.
      * Automatically registers core actions and discovers external plugins.
      */
-    private initializeActionRegistry(): void {
+    private async initializeActionRegistry(): Promise<void> {
+        this.logInfo("Initializing plugin system...");
+
+        // Initialize and discover plugins first
+        const pluginManager = PluginManager.getInstance();
+        await pluginManager.discoverPlugins({
+            pluginPrefixes: ["@getkist/action-", "kist-plugin-"],
+        });
+
+        // Log loaded plugins
+        const plugins = pluginManager.getLoadedPlugins();
+        if (plugins.length > 0) {
+            this.logInfo(`Loaded ${plugins.length} plugin(s):`);
+            plugins.forEach((plugin) => {
+                this.logInfo(
+                    `  - ${plugin.name} v${plugin.version} (${plugin.actions.length} actions)`,
+                );
+            });
+        } else {
+            this.logDebug("No external plugins found.");
+        }
+
+        // Initialize ActionRegistry (will register core + plugin actions)
         this.logInfo("Initializing ActionRegistry...");
         ActionRegistry.initialize();
         this.logInfo("ActionRegistry initialized successfully.");