@almadar/patterns 1.0.15 → 1.1.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-02-10T15:35:56.769Z";
+var exportedAt$3 = "2026-02-12T06:50:46.522Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -1348,6 +1348,12 @@ var patterns = {
 					"string"
 				],
 				description: "Additional CSS classes"
+			},
+			stepClickEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }"
 			}
 		}
 	},
@@ -1620,6 +1626,18 @@ var patterns = {
 					"string"
 				],
 				description: "Additional CSS classes"
+			},
+			pageChangeEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative page change event — emits UI:{pageChangeEvent} with { page }"
+			},
+			pageSizeChangeEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative page size change event — emits UI:{pageSizeChangeEvent} with { pageSize }"
 			}
 		}
 	},
@@ -1687,6 +1705,12 @@ var patterns = {
 					"string"
 				],
 				description: "Variant for color styling"
+			},
+			actionEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked"
 			}
 		}
 	},
@@ -1758,6 +1782,12 @@ var patterns = {
 					"string"
 				],
 				description: "className prop"
+			},
+			retryEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked"
 			}
 		}
 	},
@@ -1833,6 +1863,18 @@ var patterns = {
 					"string"
 				],
 				description: "Additional CSS classes"
+			},
+			dismissEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative dismiss event — emits UI:{dismissEvent} via eventBus when toast is dismissed"
+			},
+			actionEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked"
 			}
 		}
 	},
@@ -2073,6 +2115,12 @@ var patterns = {
 					"string"
 				],
 				description: "className prop"
+			},
+			closeEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative close event — emits UI:{closeEvent} via eventBus when modal should close"
 			}
 		}
 	},
@@ -2153,6 +2201,12 @@ var patterns = {
 					"string"
 				],
 				description: "Additional class name"
+			},
+			closeEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative close event — emits UI:{closeEvent} via eventBus when drawer should close"
 			}
 		}
 	},
@@ -2425,6 +2479,24 @@ var patterns = {
 					"react.elementtype"
 				],
 				description: "HTML element to render as"
+			},
+			action: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name — emits UI:{action} via eventBus on click"
+			},
+			actionPayload: {
+				types: [
+					"object"
+				],
+				description: "Payload to include with the action event"
+			},
+			hoverEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave"
 			}
 		}
 	},
@@ -2905,8 +2977,7 @@ var patterns = {
 				types: [
 					"function"
 				],
-				description: "Called when a slot is selected",
-				required: true
+				description: "Called when a slot is selected"
 			},
 			onUseItem: {
 				types: [
@@ -2920,6 +2991,24 @@ var patterns = {
 				],
 				description: "Called when an item is dropped"
 			},
+			selectSlotEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{selectSlotEvent} with { index } when a slot is selected"
+			},
+			useItemEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{useItemEvent} with { item } when an item is used"
+			},
+			dropItemEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{dropItemEvent} with { item } when an item is dropped"
+			},
 			showTooltips: {
 				types: [
 					"boolean"
@@ -2988,6 +3077,24 @@ var patterns = {
 				],
 				description: "Called when dialogue is advanced (no choices)"
 			},
+			completeEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{completeEvent} when text animation completes"
+			},
+			choiceEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{choiceEvent} with { choice } when a choice is selected"
+			},
+			advanceEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{advanceEvent} when dialogue is advanced"
+			},
 			className: {
 				types: [
 					"string"
@@ -3079,6 +3186,24 @@ var patterns = {
 					"icon"
 				],
 				description: "Right icon as Lucide icon component (convenience prop)"
+			},
+			action: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name — emits UI:{action} via eventBus on click"
+			},
+			actionPayload: {
+				types: [
+					"object"
+				],
+				description: "Payload to include with the action event"
+			},
+			label: {
+				types: [
+					"string"
+				],
+				description: "Button label text (alternative to children for schema-driven rendering)"
 			}
 		}
 	},
@@ -3178,6 +3303,18 @@ var patterns = {
 					"function"
 				],
 				description: "Click handler"
+			},
+			action: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name — emits UI:{action} via eventBus on click"
+			},
+			actionPayload: {
+				types: [
+					"object"
+				],
+				description: "Payload to include with the action event"
 			}
 		}
 	},
@@ -3294,6 +3431,12 @@ var patterns = {
 					"string"
 				],
 				description: "Additional CSS classes"
+			},
+			action: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name — emits UI:{action} via eventBus on card click"
 			}
 		}
 	},
@@ -3718,6 +3861,12 @@ var patterns = {
 					"string"
 				],
 				description: "className prop"
+			},
+			dismissEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative dismiss event — emits UI:{dismissEvent} via eventBus when alert is dismissed"
 			}
 		}
 	},
@@ -3921,6 +4070,12 @@ var patterns = {
 					"string"
 				],
 				description: "Additional CSS classes"
+			},
+			toggleEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen }"
 			}
 		}
 	},
@@ -4265,6 +4420,12 @@ var patterns = {
 					"boolean"
 				],
 				description: "blur prop"
+			},
+			action: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name — emits UI:{action} via eventBus on click"
 			}
 		}
 	},
@@ -4366,6 +4527,18 @@ var patterns = {
 					"number"
 				],
 				description: "Tab index for focus management"
+			},
+			action: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name — emits UI:{action} via eventBus on click"
+			},
+			actionPayload: {
+				types: [
+					"object"
+				],
+				description: "Payload to include with the action event"
 			}
 		}
 	},
@@ -4380,6 +4553,13 @@ var patterns = {
 		],
 		typicalSize: "small",
 		propsSchema: {
+			highlightType: {
+				types: [
+					"highlighttype"
+				],
+				description: "Type of highlight (determines color)",
+				required: true
+			},
 			isActive: {
 				types: [
 					"boolean"
@@ -4423,12 +4603,17 @@ var patterns = {
 				description: "Highlighted text content",
 				required: true
 			},
-			highlightType: {
+			action: {
 				types: [
-					"highlighttype"
+					"string"
 				],
-				description: "Type of highlight (determines color)",
-				required: true
+				description: "Declarative event name — emits UI:{action} via eventBus on click"
+			},
+			hoverEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false }"
 			}
 		}
 	},
@@ -4611,6 +4796,18 @@ var patterns = {
 				],
 				description: "Called when button is released"
 			},
+			pressEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name emitted on press via useEventBus"
+			},
+			releaseEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name emitted on release via useEventBus"
+			},
 			pressed: {
 				types: [
 					"boolean"
@@ -4842,6 +5039,12 @@ var patterns = {
 					"function"
 				],
 				description: "Optional onClick handler"
+			},
+			action: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name emitted on click via useEventBus"
 			}
 		}
 	},
@@ -5362,6 +5565,12 @@ var patterns = {
 					"string"
 				],
 				description: "Additional CSS classes"
+			},
+			closeEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative close event — emits UI:{closeEvent} via eventBus when panel should close"
 			}
 		}
 	},
@@ -5443,8 +5652,13 @@ var patterns = {
 				types: [
 					"function"
 				],
-				description: "Called when a button is pressed/released",
-				required: true
+				description: "Called when a button is pressed/released"
+			},
+			actionEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name emitted on action via useEventBus"
 			},
 			layout: {
 				types: [
@@ -5486,8 +5700,13 @@ var patterns = {
 				types: [
 					"function"
 				],
-				description: "Called when a direction is pressed/released",
-				required: true
+				description: "Called when a direction is pressed/released"
+			},
+			directionEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name emitted on direction press/release via useEventBus"
 			},
 			size: {
 				types: [
@@ -8321,6 +8540,12 @@ var patterns = {
 				],
 				description: "Callback when the effect animation completes"
 			},
+			completeEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{completeEvent} when the effect animation completes"
+			},
 			className: {
 				types: [
 					"string"
@@ -8472,6 +8697,30 @@ var patterns = {
 				],
 				description: "Tile leave handler"
 			},
+			tileClickEvent: {
+				types: [
+					"string"
+				],
+				description: "--- Declarative event props ---"
+			},
+			unitClickEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click"
+			},
+			tileHoverEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{tileHoverEvent} with { x, y } on tile hover"
+			},
+			tileLeaveEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event: emits UI:{tileLeaveEvent} with {} on tile leave"
+			},
 			scale: {
 				types: [
 					"number"
@@ -9668,77 +9917,289 @@ var integrators = {
 				}
 			}
 		]
-	}
-};
-var categories = [
-	"media",
-	"payment",
-	"messaging",
-	"ai"
-];
-var integratorsRegistry = {
-	version: version$2,
-	exportedAt: exportedAt$2,
-	integrators: integrators,
-	categories: categories
-};
-
-var version$1 = "1.0.0";
-var exportedAt$1 = "2026-02-10T15:35:56.769Z";
-var mappings = {
-	"page-header": {
-		component: "PageHeader",
-		importPath: "@/components/organisms/PageHeader",
-		category: "header"
-	},
-	"entity-list": {
-		component: "List",
-		importPath: "@/components/organisms/List",
-		category: "display"
-	},
-	"entity-table": {
-		component: "DataTable",
-		importPath: "@/components/organisms/DataTable",
-		category: "display"
-	},
-	"entity-cards": {
-		component: "CardGrid",
-		importPath: "@/components/organisms/CardGrid",
-		category: "display"
-	},
-	stats: {
-		component: "StatCard",
-		importPath: "@/components/organisms/StatCard",
-		category: "display"
-	},
-	"detail-panel": {
-		component: "DetailPanel",
-		importPath: "@/components/organisms/DetailPanel",
-		category: "display"
-	},
-	form: {
-		component: "Form",
-		importPath: "@/components/organisms/Form",
-		category: "form"
-	},
-	"form-section": {
-		component: "Form",
-		importPath: "@/components/organisms/Form",
-		category: "form"
-	},
-	"form-actions": {
-		component: "ButtonGroup",
-		importPath: "@/components/molecules/ButtonGroup",
-		category: "form"
 	},
-	"filter-group": {
-		component: "FilterGroup",
-		importPath: "@/components/molecules/FilterGroup",
-		category: "filter"
-	},
-	"search-input": {
-		component: "SearchInput",
-		importPath: "@/components/molecules/SearchInput",
+	github: {
+		name: "github",
+		description: "GitHub integration - Git operations and GitHub REST API",
+		category: "devtools",
+		actions: [
+			{
+				name: "cloneRepo",
+				description: "Clone a repository",
+				params: [
+					{
+						name: "repo",
+						type: "string",
+						required: true,
+						description: "Repository URL or owner/repo"
+					},
+					{
+						name: "branch",
+						type: "string",
+						required: false,
+						description: "Branch to clone"
+					}
+				],
+				responseShape: {
+					path: "string",
+					branch: "string"
+				}
+			},
+			{
+				name: "createBranch",
+				description: "Create a new branch",
+				params: [
+					{
+						name: "repo",
+						type: "string",
+						required: true,
+						description: "Local repo path"
+					},
+					{
+						name: "branch",
+						type: "string",
+						required: true,
+						description: "Branch name"
+					}
+				],
+				responseShape: {
+					branch: "string"
+				}
+			},
+			{
+				name: "commit",
+				description: "Commit changes",
+				params: [
+					{
+						name: "repo",
+						type: "string",
+						required: true,
+						description: "Local repo path"
+					},
+					{
+						name: "message",
+						type: "string",
+						required: true,
+						description: "Commit message"
+					},
+					{
+						name: "files",
+						type: "array",
+						required: false,
+						description: "Files to stage"
+					}
+				],
+				responseShape: {
+					hash: "string",
+					message: "string"
+				}
+			},
+			{
+				name: "push",
+				description: "Push commits to remote",
+				params: [
+					{
+						name: "repo",
+						type: "string",
+						required: true,
+						description: "Local repo path"
+					},
+					{
+						name: "branch",
+						type: "string",
+						required: false,
+						description: "Branch to push"
+					}
+				],
+				responseShape: {
+					success: "boolean"
+				}
+			},
+			{
+				name: "createPR",
+				description: "Create a pull request",
+				params: [
+					{
+						name: "title",
+						type: "string",
+						required: true,
+						description: "PR title"
+					},
+					{
+						name: "body",
+						type: "string",
+						required: false,
+						description: "PR description"
+					},
+					{
+						name: "head",
+						type: "string",
+						required: true,
+						description: "Head branch"
+					},
+					{
+						name: "base",
+						type: "string",
+						required: false,
+						description: "Base branch (default: main)"
+					}
+				],
+				responseShape: {
+					number: "number",
+					url: "string"
+				}
+			},
+			{
+				name: "getPRComments",
+				description: "Fetch pull request comments",
+				params: [
+					{
+						name: "prNumber",
+						type: "number",
+						required: true,
+						description: "PR number"
+					}
+				],
+				responseShape: {
+					comments: "array"
+				}
+			},
+			{
+				name: "listIssues",
+				description: "List issues with optional filters",
+				params: [
+					{
+						name: "state",
+						type: "string",
+						required: false,
+						description: "Issue state: open, closed, all"
+					},
+					{
+						name: "labels",
+						type: "string",
+						required: false,
+						description: "Comma-separated label names"
+					}
+				],
+				responseShape: {
+					issues: "array"
+				}
+			},
+			{
+				name: "getIssue",
+				description: "Get a single issue",
+				params: [
+					{
+						name: "issueNumber",
+						type: "number",
+						required: true,
+						description: "Issue number"
+					}
+				],
+				responseShape: {
+					title: "string",
+					body: "string",
+					state: "string"
+				}
+			}
+		]
+	},
+	cli: {
+		name: "cli",
+		description: "Almadar CLI integration - schema validation and compilation",
+		category: "devtools",
+		actions: [
+			{
+				name: "validate",
+				description: "Validate an orbital schema",
+				params: [
+					{
+						name: "schema",
+						type: "string",
+						required: true,
+						description: "Schema content to validate"
+					}
+				],
+				responseShape: {
+					valid: "boolean",
+					errors: "array",
+					warnings: "array",
+					summary: "string"
+				}
+			}
+		]
+	}
+};
+var categories = [
+	"media",
+	"payment",
+	"messaging",
+	"ai",
+	"devtools"
+];
+var integratorsRegistry = {
+	version: version$2,
+	exportedAt: exportedAt$2,
+	integrators: integrators,
+	categories: categories
+};
+
+var version$1 = "1.0.0";
+var exportedAt$1 = "2026-02-12T06:50:46.522Z";
+var mappings = {
+	"page-header": {
+		component: "PageHeader",
+		importPath: "@/components/organisms/PageHeader",
+		category: "header"
+	},
+	"entity-list": {
+		component: "List",
+		importPath: "@/components/organisms/List",
+		category: "display"
+	},
+	"entity-table": {
+		component: "DataTable",
+		importPath: "@/components/organisms/DataTable",
+		category: "display"
+	},
+	"entity-cards": {
+		component: "CardGrid",
+		importPath: "@/components/organisms/CardGrid",
+		category: "display"
+	},
+	stats: {
+		component: "StatCard",
+		importPath: "@/components/organisms/StatCard",
+		category: "display"
+	},
+	"detail-panel": {
+		component: "DetailPanel",
+		importPath: "@/components/organisms/DetailPanel",
+		category: "display"
+	},
+	form: {
+		component: "Form",
+		importPath: "@/components/organisms/Form",
+		category: "form"
+	},
+	"form-section": {
+		component: "Form",
+		importPath: "@/components/organisms/Form",
+		category: "form"
+	},
+	"form-actions": {
+		component: "ButtonGroup",
+		importPath: "@/components/molecules/ButtonGroup",
+		category: "form"
+	},
+	"filter-group": {
+		component: "FilterGroup",
+		importPath: "@/components/molecules/FilterGroup",
+		category: "filter"
+	},
+	"search-input": {
+		component: "SearchInput",
+		importPath: "@/components/molecules/SearchInput",
 		category: "filter"
 	},
 	"empty-state": {
@@ -10357,7 +10818,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-02-10T15:35:56.769Z";
+var exportedAt = "2026-02-12T06:50:46.522Z";
 var contracts = {
 	form: {
 		emits: [
@@ -14213,6 +14674,96 @@ declare function getAllPatternTypes(): PatternType[];
  */
 declare function getPatternMetadata(patternType: string): any;
 
+/**
+ * Pattern Recommender
+ *
+ * Maps transition context (entity fields, domain category, UI state) to
+ * ranked pattern suggestions using the registry's `suggestedFor` metadata,
+ * category matching, and entity field type heuristics.
+ *
+ * Used by the design-transition tool to include top-N recommendations
+ * in the LLM prompt context.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Context for pattern recommendation.
+ */
+interface RecommendationContext {
+    /** Current state name (e.g., "Browsing", "Creating") */
+    state?: string;
+    /** Triggering event (e.g., "INIT", "CREATE", "VIEW") */
+    event?: string;
+    /** Target UI slot */
+    slot?: 'main' | 'modal' | 'drawer' | 'sidebar' | 'overlay';
+    /** Domain category */
+    domainCategory?: string;
+    /** Entity field types present */
+    entityFieldTypes?: string[];
+    /** Entity has enum fields */
+    hasEnumFields?: boolean;
+    /** Entity has date/timestamp fields */
+    hasDateFields?: boolean;
+    /** Entity has numeric fields */
+    hasNumericFields?: boolean;
+    /** Entity has relation fields */
+    hasRelationFields?: boolean;
+    /** Entity has image/url fields */
+    hasMediaFields?: boolean;
+}
+/**
+ * A pattern recommendation with score and reasoning.
+ */
+interface PatternRecommendation {
+    /** Pattern type name */
+    pattern: PatternType;
+    /** Relevance score (0-100) */
+    score: number;
+    /** Why this pattern was recommended */
+    reason: string;
+    /** Pattern category */
+    category: string;
+    /** Pattern description */
+    description: string;
+    /** Key props to use */
+    keyProps: string[];
+}
+/**
+ * Recommend patterns for a given context.
+ *
+ * Scoring algorithm:
+ * 1. suggestedFor match with domain keywords (+30)
+ * 2. suggestedFor match with event keywords (+25)
+ * 3. Category affinity with slot (+20)
+ * 4. Category affinity with state (+15)
+ * 5. Entity field type bonus (+10 per matching heuristic)
+ * 6. Entity-aware bonus for display patterns (+5)
+ *
+ * @returns Ranked pattern recommendations, highest score first
+ */
+declare function recommendPatterns(context: RecommendationContext, maxResults?: number): PatternRecommendation[];
+/**
+ * Build recommendation context from entity field information.
+ * Analyzes field types to set the boolean flags used by the recommender.
+ */
+declare function buildRecommendationContext(options: {
+    state?: string;
+    event?: string;
+    slot?: 'main' | 'modal' | 'drawer' | 'sidebar' | 'overlay';
+    domainCategory?: string;
+    entityFields?: Array<{
+        name: string;
+        type: string;
+        values?: string[];
+    }>;
+}): RecommendationContext;
+/**
+ * Format recommendations as a concise prompt section.
+ * Used to inject into the design-transition tool's user prompt.
+ */
+declare function formatRecommendationsForPrompt(recommendations: PatternRecommendation[]): string;
+
 declare const registry: {
     version: string;
     exportedAt: string;
@@ -15108,6 +15659,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                stepClickEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "wizard-navigation": {
@@ -15292,6 +15847,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                pageChangeEvent: {
+                    types: string[];
+                    description: string;
+                };
+                pageSizeChangeEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "empty-state": {
@@ -15337,6 +15900,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                actionEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "loading-state": {
@@ -15387,6 +15954,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                retryEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         notification: {
@@ -15437,6 +16008,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                dismissEvent: {
+                    types: string[];
+                    description: string;
+                };
+                actionEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         stats: {
@@ -15597,6 +16176,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                closeEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         drawer: {
@@ -15650,7 +16233,11 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
-            };
+                closeEvent: {
+                    types: string[];
+                    description: string;
+                };
+            };
         };
         "confirm-dialog": {
             type: string;
@@ -15832,6 +16419,18 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                actionPayload: {
+                    types: string[];
+                    description: string;
+                };
+                hoverEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         grid: {
@@ -16154,7 +16753,6 @@ declare const registry: {
                 onSelectSlot: {
                     types: string[];
                     description: string;
-                    required: boolean;
                 };
                 onUseItem: {
                     types: string[];
@@ -16164,6 +16762,18 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                selectSlotEvent: {
+                    types: string[];
+                    description: string;
+                };
+                useItemEvent: {
+                    types: string[];
+                    description: string;
+                };
+                dropItemEvent: {
+                    types: string[];
+                    description: string;
+                };
                 showTooltips: {
                     types: string[];
                     description: string;
@@ -16210,6 +16820,18 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                completeEvent: {
+                    types: string[];
+                    description: string;
+                };
+                choiceEvent: {
+                    types: string[];
+                    description: string;
+                };
+                advanceEvent: {
+                    types: string[];
+                    description: string;
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -16272,6 +16894,18 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                actionPayload: {
+                    types: string[];
+                    description: string;
+                };
+                label: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         badge: {
@@ -16338,6 +16972,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                actionPayload: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         icon: {
@@ -16416,6 +17058,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "progress-bar": {
@@ -16704,6 +17350,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                dismissEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         tooltip: {
@@ -16843,6 +17493,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                toggleEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         container: {
@@ -17078,6 +17732,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         stack: {
@@ -17147,6 +17805,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                actionPayload: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "text-highlight": {
@@ -17156,6 +17822,11 @@ declare const registry: {
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
+                highlightType: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                };
                 isActive: {
                     types: string[];
                     description: string;
@@ -17185,10 +17856,13 @@ declare const registry: {
                     description: string;
                     required: boolean;
                 };
-                highlightType: {
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                hoverEvent: {
                     types: string[];
                     description: string;
-                    required: boolean;
                 };
             };
         };
@@ -17313,6 +17987,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                pressEvent: {
+                    types: string[];
+                    description: string;
+                };
+                releaseEvent: {
+                    types: string[];
+                    description: string;
+                };
                 pressed: {
                     types: string[];
                     description: string;
@@ -17473,6 +18155,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "form-actions": {
@@ -17822,6 +18508,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                closeEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "violation-alert": {
@@ -17877,7 +18567,10 @@ declare const registry: {
                 onAction: {
                     types: string[];
                     description: string;
-                    required: boolean;
+                };
+                actionEvent: {
+                    types: string[];
+                    description: string;
                 };
                 layout: {
                     types: string[];
@@ -17907,7 +18600,10 @@ declare const registry: {
                 onDirection: {
                     types: string[];
                     description: string;
-                    required: boolean;
+                };
+                directionEvent: {
+                    types: string[];
+                    description: string;
                 };
                 size: {
                     types: string[];
@@ -19814,6 +20510,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                completeEvent: {
+                    types: string[];
+                    description: string;
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -19915,6 +20615,22 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                tileClickEvent: {
+                    types: string[];
+                    description: string;
+                };
+                unitClickEvent: {
+                    types: string[];
+                    description: string;
+                };
+                tileHoverEvent: {
+                    types: string[];
+                    description: string;
+                };
+                tileLeaveEvent: {
+                    types: string[];
+                    description: string;
+                };
                 scale: {
                     types: string[];
                     description: string;
@@ -21269,6 +21985,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                stepClickEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "wizard-navigation": {
@@ -21453,6 +22173,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                pageChangeEvent: {
+                    types: string[];
+                    description: string;
+                };
+                pageSizeChangeEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "empty-state": {
@@ -21498,6 +22226,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                actionEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "loading-state": {
@@ -21548,6 +22280,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                retryEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         notification: {
@@ -21598,6 +22334,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                dismissEvent: {
+                    types: string[];
+                    description: string;
+                };
+                actionEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         stats: {
@@ -21758,6 +22502,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                closeEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         drawer: {
@@ -21811,6 +22559,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                closeEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "confirm-dialog": {
@@ -21993,6 +22745,18 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                actionPayload: {
+                    types: string[];
+                    description: string;
+                };
+                hoverEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         grid: {
@@ -22315,7 +23079,6 @@ declare const PATTERN_REGISTRY: {
                 onSelectSlot: {
                     types: string[];
                     description: string;
-                    required: boolean;
                 };
                 onUseItem: {
                     types: string[];
@@ -22325,6 +23088,18 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                selectSlotEvent: {
+                    types: string[];
+                    description: string;
+                };
+                useItemEvent: {
+                    types: string[];
+                    description: string;
+                };
+                dropItemEvent: {
+                    types: string[];
+                    description: string;
+                };
                 showTooltips: {
                     types: string[];
                     description: string;
@@ -22371,6 +23146,18 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                completeEvent: {
+                    types: string[];
+                    description: string;
+                };
+                choiceEvent: {
+                    types: string[];
+                    description: string;
+                };
+                advanceEvent: {
+                    types: string[];
+                    description: string;
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -22433,6 +23220,18 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                actionPayload: {
+                    types: string[];
+                    description: string;
+                };
+                label: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         badge: {
@@ -22499,6 +23298,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                actionPayload: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         icon: {
@@ -22577,6 +23384,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "progress-bar": {
@@ -22865,6 +23676,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                dismissEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         tooltip: {
@@ -23004,6 +23819,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                toggleEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         container: {
@@ -23239,6 +24058,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         stack: {
@@ -23308,6 +24131,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                actionPayload: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "text-highlight": {
@@ -23317,6 +24148,11 @@ declare const PATTERN_REGISTRY: {
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
+                highlightType: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                };
                 isActive: {
                     types: string[];
                     description: string;
@@ -23346,10 +24182,13 @@ declare const PATTERN_REGISTRY: {
                     description: string;
                     required: boolean;
                 };
-                highlightType: {
+                action: {
+                    types: string[];
+                    description: string;
+                };
+                hoverEvent: {
                     types: string[];
                     description: string;
-                    required: boolean;
                 };
             };
         };
@@ -23474,6 +24313,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                pressEvent: {
+                    types: string[];
+                    description: string;
+                };
+                releaseEvent: {
+                    types: string[];
+                    description: string;
+                };
                 pressed: {
                     types: string[];
                     description: string;
@@ -23634,6 +24481,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                action: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "form-actions": {
@@ -23983,6 +24834,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                closeEvent: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "violation-alert": {
@@ -24038,7 +24893,10 @@ declare const PATTERN_REGISTRY: {
                 onAction: {
                     types: string[];
                     description: string;
-                    required: boolean;
+                };
+                actionEvent: {
+                    types: string[];
+                    description: string;
                 };
                 layout: {
                     types: string[];
@@ -24068,7 +24926,10 @@ declare const PATTERN_REGISTRY: {
                 onDirection: {
                     types: string[];
                     description: string;
-                    required: boolean;
+                };
+                directionEvent: {
+                    types: string[];
+                    description: string;
                 };
                 size: {
                     types: string[];
@@ -25975,6 +26836,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                completeEvent: {
+                    types: string[];
+                    description: string;
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -26076,6 +26941,22 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                tileClickEvent: {
+                    types: string[];
+                    description: string;
+                };
+                unitClickEvent: {
+                    types: string[];
+                    description: string;
+                };
+                tileHoverEvent: {
+                    types: string[];
+                    description: string;
+                };
+                tileLeaveEvent: {
+                    types: string[];
+                    description: string;
+                };
                 scale: {
                     types: string[];
                     description: string;
@@ -26889,6 +27770,217 @@ declare const INTEGRATORS_REGISTRY: {
                 };
             })[];
         };
+        github: {
+            name: string;
+            description: string;
+            category: string;
+            actions: ({
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    path: string;
+                    branch: string;
+                    hash?: undefined;
+                    message?: undefined;
+                    success?: undefined;
+                    number?: undefined;
+                    url?: undefined;
+                    comments?: undefined;
+                    issues?: undefined;
+                    title?: undefined;
+                    body?: undefined;
+                    state?: undefined;
+                };
+            } | {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    branch: string;
+                    path?: undefined;
+                    hash?: undefined;
+                    message?: undefined;
+                    success?: undefined;
+                    number?: undefined;
+                    url?: undefined;
+                    comments?: undefined;
+                    issues?: undefined;
+                    title?: undefined;
+                    body?: undefined;
+                    state?: undefined;
+                };
+            } | {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    hash: string;
+                    message: string;
+                    path?: undefined;
+                    branch?: undefined;
+                    success?: undefined;
+                    number?: undefined;
+                    url?: undefined;
+                    comments?: undefined;
+                    issues?: undefined;
+                    title?: undefined;
+                    body?: undefined;
+                    state?: undefined;
+                };
+            } | {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    success: string;
+                    path?: undefined;
+                    branch?: undefined;
+                    hash?: undefined;
+                    message?: undefined;
+                    number?: undefined;
+                    url?: undefined;
+                    comments?: undefined;
+                    issues?: undefined;
+                    title?: undefined;
+                    body?: undefined;
+                    state?: undefined;
+                };
+            } | {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    number: string;
+                    url: string;
+                    path?: undefined;
+                    branch?: undefined;
+                    hash?: undefined;
+                    message?: undefined;
+                    success?: undefined;
+                    comments?: undefined;
+                    issues?: undefined;
+                    title?: undefined;
+                    body?: undefined;
+                    state?: undefined;
+                };
+            } | {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    comments: string;
+                    path?: undefined;
+                    branch?: undefined;
+                    hash?: undefined;
+                    message?: undefined;
+                    success?: undefined;
+                    number?: undefined;
+                    url?: undefined;
+                    issues?: undefined;
+                    title?: undefined;
+                    body?: undefined;
+                    state?: undefined;
+                };
+            } | {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    issues: string;
+                    path?: undefined;
+                    branch?: undefined;
+                    hash?: undefined;
+                    message?: undefined;
+                    success?: undefined;
+                    number?: undefined;
+                    url?: undefined;
+                    comments?: undefined;
+                    title?: undefined;
+                    body?: undefined;
+                    state?: undefined;
+                };
+            } | {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    title: string;
+                    body: string;
+                    state: string;
+                    path?: undefined;
+                    branch?: undefined;
+                    hash?: undefined;
+                    message?: undefined;
+                    success?: undefined;
+                    number?: undefined;
+                    url?: undefined;
+                    comments?: undefined;
+                    issues?: undefined;
+                };
+            })[];
+        };
+        cli: {
+            name: string;
+            description: string;
+            category: string;
+            actions: {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    valid: string;
+                    errors: string;
+                    warnings: string;
+                    summary: string;
+                };
+            }[];
+        };
     };
     categories: string[];
 };
@@ -28148,4 +29240,4 @@ declare function getComponentForPattern(patternType: string): any;
  */
 declare function isEntityAwarePattern(patternType: string): boolean;
 
-export { type AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, type PatternConfig, type PatternProps, type PatternPropsMap, type PatternType, componentMapping, eventContracts, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isEntityAwarePattern, isValidPatternType, patternsRegistry, registry };
+export { type AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, type PatternConfig, type PatternProps, type PatternPropsMap, type PatternRecommendation, type PatternType, type RecommendationContext, buildRecommendationContext, componentMapping, eventContracts, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isEntityAwarePattern, isValidPatternType, patternsRegistry, recommendPatterns, registry };