@almadar/patterns 1.1.0 → 1.1.1

package/dist/integrators-registry.json

@@ -494,7 +494,107 @@
           }
         }
       ]
+    },
+    "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"
+          }
+        }
+      ]
     }
   },
-  "categories": ["media", "payment", "messaging", "ai"]
+  "categories": ["media", "payment", "messaging", "ai", "devtools"]
 }

package/dist/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-02-10T15:35:56.769Z",
+  "exportedAt": "2026-02-12T06:50:46.522Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -1349,6 +1349,12 @@
             "string"
           ],
           "description": "Additional CSS classes"
+        },
+        "stepClickEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }"
         }
       }
     },
@@ -1621,6 +1627,18 @@
             "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 }"
         }
       }
     },
@@ -1688,6 +1706,12 @@
             "string"
           ],
           "description": "Variant for color styling"
+        },
+        "actionEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked"
         }
       }
     },
@@ -1759,6 +1783,12 @@
             "string"
           ],
           "description": "className prop"
+        },
+        "retryEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked"
         }
       }
     },
@@ -1834,6 +1864,18 @@
             "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"
         }
       }
     },
@@ -2074,6 +2116,12 @@
             "string"
           ],
           "description": "className prop"
+        },
+        "closeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative close event — emits UI:{closeEvent} via eventBus when modal should close"
         }
       }
     },
@@ -2154,6 +2202,12 @@
             "string"
           ],
           "description": "Additional class name"
+        },
+        "closeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative close event — emits UI:{closeEvent} via eventBus when drawer should close"
         }
       }
     },
@@ -2426,6 +2480,24 @@
             "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"
         }
       }
     },
@@ -2906,8 +2978,7 @@
           "types": [
             "function"
           ],
-          "description": "Called when a slot is selected",
-          "required": true
+          "description": "Called when a slot is selected"
         },
         "onUseItem": {
           "types": [
@@ -2921,6 +2992,24 @@
           ],
           "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"
@@ -2989,6 +3078,24 @@
           ],
           "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"
@@ -3080,6 +3187,24 @@
             "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)"
         }
       }
     },
@@ -3179,6 +3304,18 @@
             "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"
         }
       }
     },
@@ -3295,6 +3432,12 @@
             "string"
           ],
           "description": "Additional CSS classes"
+        },
+        "action": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative event name — emits UI:{action} via eventBus on card click"
         }
       }
     },
@@ -3719,6 +3862,12 @@
             "string"
           ],
           "description": "className prop"
+        },
+        "dismissEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative dismiss event — emits UI:{dismissEvent} via eventBus when alert is dismissed"
         }
       }
     },
@@ -3922,6 +4071,12 @@
             "string"
           ],
           "description": "Additional CSS classes"
+        },
+        "toggleEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen }"
         }
       }
     },
@@ -4266,6 +4421,12 @@
             "boolean"
           ],
           "description": "blur prop"
+        },
+        "action": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative event name — emits UI:{action} via eventBus on click"
         }
       }
     },
@@ -4367,6 +4528,18 @@
             "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"
         }
       }
     },
@@ -4381,6 +4554,13 @@
       ],
       "typicalSize": "small",
       "propsSchema": {
+        "highlightType": {
+          "types": [
+            "highlighttype"
+          ],
+          "description": "Type of highlight (determines color)",
+          "required": true
+        },
         "isActive": {
           "types": [
             "boolean"
@@ -4424,12 +4604,17 @@
           "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 }"
         }
       }
     },
@@ -4612,6 +4797,18 @@
           ],
           "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"
@@ -4843,6 +5040,12 @@
             "function"
           ],
           "description": "Optional onClick handler"
+        },
+        "action": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative event name emitted on click via useEventBus"
         }
       }
     },
@@ -5363,6 +5566,12 @@
             "string"
           ],
           "description": "Additional CSS classes"
+        },
+        "closeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative close event — emits UI:{closeEvent} via eventBus when panel should close"
         }
       }
     },
@@ -5444,8 +5653,13 @@
           "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": [
@@ -5487,8 +5701,13 @@
           "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": [
@@ -8322,6 +8541,12 @@
           ],
           "description": "Callback when the effect animation completes"
         },
+        "completeEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative event: emits UI:{completeEvent} when the effect animation completes"
+        },
         "className": {
           "types": [
             "string"
@@ -8473,6 +8698,30 @@
           ],
           "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"