@synergenius/flow-weaver 0.17.0 → 0.17.2

package/dist/jsdoc-parser.d.ts

@@ -5,6 +5,7 @@
  */
 import type { FunctionLike } from './function-like.js';
 import type { TDataType, TPortConfig, TMergeStrategy, TNodeTagAST } from './ast/types.js';
+import type { TagHandlerRegistry } from './parser/tag-registry.js';
 export interface JSDocNodeTypeConfig {
     name?: string;
     label?: string;
@@ -200,67 +201,6 @@ export interface JSDocWorkflowConfig {
         limit: number;
         period?: string;
     };
-    /** @secret declarations */
-    secrets?: Array<{
-        name: string;
-        description?: string;
-        platform?: 'github' | 'gitlab' | 'all';
-        scope?: string;
-    }>;
-    /** @runner default execution environment */
-    runner?: string;
-    /** @cache configurations */
-    caches?: Array<{
-        strategy: string;
-        path?: string;
-        key?: string;
-    }>;
-    /** @artifact declarations */
-    artifacts?: Array<{
-        name: string;
-        path: string;
-        retention?: number;
-    }>;
-    /** @environment declarations */
-    environments?: Array<{
-        name: string;
-        url?: string;
-        reviewers?: number;
-    }>;
-    /** @matrix strategy */
-    matrix?: {
-        dimensions: Record<string, string[]>;
-        include?: Record<string, string>[];
-        exclude?: Record<string, string>[];
-    };
-    /** @service containers */
-    services?: Array<{
-        name: string;
-        image: string;
-        env?: Record<string, string>;
-        ports?: string[];
-    }>;
-    /** @concurrency control */
-    concurrency?: {
-        group: string;
-        cancelInProgress?: boolean;
-    };
-    /** Extended CI/CD triggers from @trigger push/pull_request/dispatch/tag */
-    cicdTriggers?: Array<{
-        type: 'push' | 'pull_request' | 'schedule' | 'dispatch' | 'tag';
-        branches?: string[];
-        paths?: string[];
-        pathsIgnore?: string[];
-        pattern?: string;
-        types?: string[];
-        cron?: string;
-        inputs?: Record<string, {
-            description?: string;
-            required?: boolean;
-            default?: string;
-            type?: string;
-        }>;
-    }>;
     /** @deploy target key=value pairs */
     deploy?: Record<string, Record<string, unknown>>;
 }
@@ -297,13 +237,17 @@ export interface JSDocPatternConfig {
 }
 export declare class JSDocParser {
     /**
-     * Parse @flowWeaver nodeType from JSDoc comments
+     * Parse @flowWeaver nodeType from JSDoc comments.
+     * When a TagHandlerRegistry is provided, unknown tags are checked against it
+     * before being reported as warnings.
      */
-    parseNodeType(func: FunctionLike, warnings: string[]): JSDocNodeTypeConfig | null;
+    parseNodeType(func: FunctionLike, warnings: string[], tagRegistry?: TagHandlerRegistry): JSDocNodeTypeConfig | null;
     /**
-     * Parse @flowWeaver workflow from JSDoc comments
+     * Parse @flowWeaver workflow from JSDoc comments.
+     * When a TagHandlerRegistry is provided, unknown tags are checked against it
+     * before being reported as warnings.
      */
-    parseWorkflow(func: FunctionLike, warnings: string[]): JSDocWorkflowConfig | null;
+    parseWorkflow(func: FunctionLike, warnings: string[], tagRegistry?: TagHandlerRegistry): JSDocWorkflowConfig | null;
     /**
      * Parse @flowWeaver pattern from JSDoc comments
      */
@@ -400,12 +344,9 @@ export declare class JSDocParser {
     private parseCoerceTag;
     /**
      * Parse @trigger tag using Chevrotain parser.
+     * Delegates unrecognized trigger formats to the tag registry (e.g. CI/CD triggers).
      */
     private parseTriggerTag;
-    /**
-     * Parse a CI/CD-specific trigger type (push, pull_request, dispatch, tag, schedule).
-     */
-    private parseCICDTrigger;
     /**
      * Parse @cancelOn tag using Chevrotain parser.
      */
@@ -414,61 +355,18 @@ export declare class JSDocParser {
      * Parse @throttle tag using Chevrotain parser.
      */
     private parseThrottleTag;
-    /**
-     * Dispatch a CI/CD or @deploy tag to the appropriate parser.
-     * Consolidates all deployment-related cases from the main switch.
-     */
-    private handleDeploymentTag;
     /**
      * Parse @deploy tag.
      * Format: @deploy <target> key=value key2="value with spaces" key3=123 key4=true
      *
      * Examples:
      *   @deploy github-actions action="actions/checkout@v4"
-     *   @deploy inngest durableSteps=true framework="next" retries=3
-     *   @deploy lambda memory=256 timeout=30
+     *   @deploy my-target durableSteps=true framework="next" retries=3
+     *   @deploy another-target memory=256 timeout=30
      *
      * Values are auto-coerced: "true"/"false" → boolean, numeric strings → number.
      */
     private parseDeployTag;
-    /**
-     * Parse @secret tag.
-     * Format: @secret NAME - description
-     * Optional: @secret NAME scope="deploy" platform="github" - description
-     */
-    private parseSecretTag;
-    /**
-     * Parse @cache tag.
-     * Format: @cache strategy [key="file"] [path="dir"]
-     */
-    private parseCacheTag;
-    /**
-     * Parse @artifact tag.
-     * Format: @artifact name path="dist/" [retention=5]
-     */
-    private parseArtifactTag;
-    /**
-     * Parse @environment tag.
-     * Format: @environment name [url="..."] [reviewers=N]
-     */
-    private parseEnvironmentTag;
-    /**
-     * Parse @matrix tag.
-     * Format: @matrix dim1="val1,val2" dim2="val3,val4"
-     * Or: @matrix include dim1="val1" dim2="val2"
-     * Or: @matrix exclude dim1="val1" dim2="val2"
-     */
-    private parseMatrixTag;
-    /**
-     * Parse @service tag.
-     * Format: @service name image="..." [env="K=V,K2=V2"] [ports="5432:5432"]
-     */
-    private parseServiceTag;
-    /**
-     * Parse @concurrency tag.
-     * Format: @concurrency group="name" [cancel-in-progress=true]
-     */
-    private parseConcurrencyTag;
     /**
      * Parse default value from string
      */