@almadar/patterns 2.24.0 → 2.25.1

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-05-09T16:52:32.798Z",
+  exportedAt: "2026-05-11T04:42:37.745Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -15279,6 +15279,12 @@ var patterns_registry_default = {
           ],
           description: "Array of markers to display"
         },
+        routes: {
+          types: [
+            "array"
+          ],
+          description: "Routes (polylines with optional popups) drawn over the tile layer"
+        },
         centerLat: {
           types: [
             "number"
@@ -25882,198 +25888,212 @@ var patterns_registry_default = {
           description: "Click handler for the body of the pill (filter toggle)",
           kind: "callback",
           callbackArgs: []
+        },
+        clickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name dispatched via event bus when the pill body is clicked. Payload: { label }",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "label",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        removeEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name dispatched via event bus when the remove (\xD7) button is clicked. Payload: { label }",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "label",
+              type: "string",
+              required: true
+            }
+          ]
         }
       }
     },
-    "dunning-banner": {
-      type: "dunning-banner",
+    "likert-scale": {
+      type: "likert-scale",
       category: "component",
-      description: "DunningBanner component",
+      description: "LikertScale component",
       suggestedFor: [
-        "dunning",
-        "banner",
-        "dunning banner"
+        "likert",
+        "scale",
+        "likert scale"
       ],
       typicalSize: "medium",
       propsSchema: {
-        severity: {
+        question: {
           types: [
             "string"
           ],
-          description: "severity prop",
-          enumValues: [
-            "soft",
-            "urgent",
-            "final"
-          ]
-        },
-        attemptNumber: {
-          types: [
-            "number"
-          ],
-          description: "attemptNumber prop"
-        },
-        attemptsTotal: {
-          types: [
-            "number"
-          ],
-          description: "attemptsTotal prop"
+          description: "Optional row prompt above the scale"
         },
-        failedAt: {
+        options: {
           types: [
-            "string"
+            "array"
           ],
-          description: "failedAt prop"
+          description: "Scale points (defaults to a 5-point agree/disagree set)"
         },
-        nextRetryAt: {
+        value: {
           types: [
+            "number",
             "string"
           ],
-          description: "nextRetryAt prop"
+          description: "Selected value (controlled)"
         },
-        amountDue: {
+        onChange: {
           types: [
-            "number"
+            "function"
           ],
-          description: "amountDue prop"
+          description: "Change callback",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "value",
+              type: "number"
+            }
+          ]
         },
-        currency: {
+        changeEvent: {
           types: [
             "string"
           ],
-          description: "currency prop"
-        },
-        onUpdatePayment: {
-          types: [
-            "function"
-          ],
-          description: "onUpdatePayment prop",
-          kind: "callback",
-          callbackArgs: []
+          description: "Event name dispatched via event bus on change. Payload: { value: number | string }",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "value",
+              type: "number",
+              required: true
+            }
+          ]
         },
-        onContactSupport: {
+        disabled: {
           types: [
-            "function"
+            "boolean"
           ],
-          description: "onContactSupport prop",
-          kind: "callback",
-          callbackArgs: []
+          description: "Disabled state"
         },
-        onDismiss: {
+        size: {
           types: [
-            "function"
+            "string"
           ],
-          description: "onDismiss prop",
-          kind: "callback",
-          callbackArgs: []
+          description: "Size variant",
+          enumValues: [
+            "sm",
+            "md",
+            "lg"
+          ]
         },
-        dismissible: {
+        variant: {
           types: [
-            "boolean"
+            "string"
           ],
-          description: "dismissible prop"
+          description: "Visual variant: classic radios or pill segmented buttons",
+          enumValues: [
+            "radios",
+            "buttons"
+          ]
         },
         className: {
           types: [
             "string"
           ],
-          description: "className prop"
+          description: "Additional CSS classes"
         }
       }
     },
-    invoice: {
-      type: "invoice",
+    "matrix-question": {
+      type: "matrix-question",
       category: "component",
-      description: "Invoice component",
+      description: "MatrixQuestion component",
       suggestedFor: [
-        "invoice"
+        "matrix",
+        "question",
+        "matrix question"
       ],
       typicalSize: "medium",
       propsSchema: {
-        invoiceNumber: {
-          types: [
-            "string"
-          ],
-          description: "invoiceNumber prop",
-          required: true
-        },
-        status: {
-          types: [
-            "string"
-          ],
-          description: "status prop",
-          enumValues: [
-            "draft",
-            "sent",
-            "paid",
-            "overdue",
-            "void"
-          ]
-        },
-        issuedAt: {
-          types: [
-            "string"
-          ],
-          description: "issuedAt prop",
-          required: true
-        },
-        dueAt: {
+        title: {
           types: [
             "string"
           ],
-          description: "dueAt prop",
-          required: true
-        },
-        from: {
-          types: [
-            "object"
-          ],
-          description: "from prop",
-          required: true
+          description: "Optional title rendered above the matrix"
         },
-        to: {
+        rows: {
           types: [
-            "object"
+            "array"
           ],
-          description: "to prop",
+          description: "Question rows",
           required: true
         },
-        items: {
+        columns: {
           types: [
             "array"
           ],
-          description: "items prop",
-          required: true
+          description: "Column definitions; defaults to 5-point Likert"
         },
-        currency: {
+        values: {
           types: [
-            "string"
+            "object"
           ],
-          description: "currency prop"
+          description: "Selected value per row, keyed by rowId"
         },
-        taxRateDefault: {
+        onChange: {
           types: [
-            "number"
+            "function"
           ],
-          description: "taxRateDefault prop"
+          description: "Change handler invoked with rowId and selected column value",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "rowId",
+              type: "string"
+            },
+            {
+              name: "value",
+              type: "number"
+            }
+          ]
         },
-        notes: {
+        changeEvent: {
           types: [
             "string"
           ],
-          description: "notes prop"
+          description: "Event name dispatched via event bus when a row's value changes. Payload: { rowId, value }",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "rowId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "value",
+              type: "number",
+              required: true
+            }
+          ]
         },
-        paymentUrl: {
+        disabled: {
           types: [
-            "string"
+            "boolean"
           ],
-          description: "paymentUrl prop"
+          description: "Disable all inputs"
         },
         size: {
           types: [
             "string"
           ],
-          description: "size prop",
+          description: "Visual size",
           enumValues: [
             "sm",
             "md"
@@ -26083,636 +26103,83 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "className prop"
+          description: "Additional CSS classes"
         }
       }
     },
-    "kitchen-display-strip": {
-      type: "kitchen-display-strip",
+    "qr-scanner": {
+      type: "qr-scanner",
       category: "component",
-      description: "KitchenDisplayStrip component",
+      description: "QrScanner component",
       suggestedFor: [
-        "kitchen",
-        "display",
-        "strip",
-        "kitchen display strip"
+        "scanner",
+        "qr scanner"
       ],
       typicalSize: "medium",
       propsSchema: {
-        orderId: {
-          types: [
-            "string"
-          ],
-          description: "orderId prop",
-          required: true
-        },
-        tableLabel: {
+        onScan: {
           types: [
-            "string"
+            "function"
           ],
-          description: "tableLabel prop"
+          description: "onScan prop",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "result",
+              type: "object"
+            }
+          ]
         },
-        serverName: {
+        scanEvent: {
           types: [
             "string"
           ],
-          description: "serverName prop"
+          description: "scanEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "text",
+              type: "string",
+              required: true
+            },
+            {
+              name: "format",
+              type: "string",
+              required: true
+            },
+            {
+              name: "timestamp",
+              type: "number",
+              required: true
+            }
+          ]
         },
-        items: {
+        onError: {
           types: [
-            "array"
+            "function"
           ],
-          description: "items prop",
-          required: true
+          description: "onError prop",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "error",
+              type: "object"
+            }
+          ]
         },
-        status: {
+        facingMode: {
           types: [
             "string"
           ],
-          description: "status prop",
+          description: "facingMode prop",
           enumValues: [
-            "pending",
-            "preparing",
-            "ready",
-            "served"
+            "environment",
+            "user"
           ]
         },
-        receivedAt: {
+        paused: {
           types: [
-            "number"
-          ],
-          description: "receivedAt prop",
-          required: true
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "size prop",
-          enumValues: [
-            "sm",
-            "md"
-          ]
-        },
-        onMarkReady: {
-          types: [
-            "function"
-          ],
-          description: "onMarkReady prop",
-          kind: "callback",
-          callbackArgs: []
-        },
-        onMarkServed: {
-          types: [
-            "function"
-          ],
-          description: "onMarkServed prop",
-          kind: "callback",
-          callbackArgs: []
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
-        }
-      }
-    },
-    "likert-scale": {
-      type: "likert-scale",
-      category: "component",
-      description: "LikertScale component",
-      suggestedFor: [
-        "likert",
-        "scale",
-        "likert scale"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        question: {
-          types: [
-            "string"
-          ],
-          description: "Optional row prompt above the scale"
-        },
-        options: {
-          types: [
-            "array"
-          ],
-          description: "Scale points (defaults to a 5-point agree/disagree set)"
-        },
-        value: {
-          types: [
-            "number",
-            "string"
-          ],
-          description: "Selected value (controlled)"
-        },
-        onChange: {
-          types: [
-            "function"
-          ],
-          description: "Change callback",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "value",
-              type: "number"
-            }
-          ]
-        },
-        disabled: {
-          types: [
-            "boolean"
-          ],
-          description: "Disabled state"
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "Size variant",
-          enumValues: [
-            "sm",
-            "md",
-            "lg"
-          ]
-        },
-        variant: {
-          types: [
-            "string"
-          ],
-          description: "Visual variant: classic radios or pill segmented buttons",
-          enumValues: [
-            "radios",
-            "buttons"
-          ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        }
-      }
-    },
-    "listing-card": {
-      type: "listing-card",
-      category: "display",
-      description: "ListingCard component",
-      suggestedFor: [
-        "listing",
-        "card",
-        "listing card"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        title: {
-          types: [
-            "string"
-          ],
-          description: "title prop",
-          required: true
-        },
-        imageUrl: {
-          types: [
-            "string"
-          ],
-          description: "imageUrl prop",
-          required: true
-        },
-        imageAlt: {
-          types: [
-            "string"
-          ],
-          description: "imageAlt prop"
-        },
-        price: {
-          types: [
-            "string"
-          ],
-          description: "Pre-formatted price string (e.g. '$525,000', '$45/hr')"
-        },
-        location: {
-          types: [
-            "string"
-          ],
-          description: "location prop"
-        },
-        rating: {
-          types: [
-            "number"
-          ],
-          description: "Numeric rating 0-5"
-        },
-        reviewCount: {
-          types: [
-            "number"
-          ],
-          description: "reviewCount prop"
-        },
-        facts: {
-          types: [
-            "array"
-          ],
-          description: "2-4 quick stats with optional icons"
-        },
-        badge: {
-          types: [
-            "string"
-          ],
-          description: "badge prop",
-          enumValues: [
-            "new",
-            "featured",
-            "price-drop",
-            "sold",
-            "pending"
-          ]
-        },
-        favorite: {
-          types: [
-            "boolean"
-          ],
-          description: "favorite prop"
-        },
-        onFavoriteToggle: {
-          types: [
-            "function"
-          ],
-          description: "onFavoriteToggle prop",
-          kind: "callback",
-          callbackArgs: []
-        },
-        onClick: {
-          types: [
-            "function"
-          ],
-          description: "onClick prop",
-          kind: "callback",
-          callbackArgs: []
-        },
-        href: {
-          types: [
-            "string"
-          ],
-          description: "Optional link target. When provided, the card renders as an <a> wrapper."
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "size prop",
-          enumValues: [
-            "sm",
-            "md",
-            "lg"
-          ]
-        },
-        layout: {
-          types: [
-            "string"
-          ],
-          description: "layout prop",
-          enumValues: [
-            "vertical",
-            "horizontal"
-          ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
-        }
-      }
-    },
-    "matrix-question": {
-      type: "matrix-question",
-      category: "component",
-      description: "MatrixQuestion component",
-      suggestedFor: [
-        "matrix",
-        "question",
-        "matrix question"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        title: {
-          types: [
-            "string"
-          ],
-          description: "Optional title rendered above the matrix"
-        },
-        rows: {
-          types: [
-            "array"
-          ],
-          description: "Question rows",
-          required: true
-        },
-        columns: {
-          types: [
-            "array"
-          ],
-          description: "Column definitions; defaults to 5-point Likert"
-        },
-        values: {
-          types: [
-            "object"
-          ],
-          description: "Selected value per row, keyed by rowId"
-        },
-        onChange: {
-          types: [
-            "function"
-          ],
-          description: "Change handler invoked with rowId and selected column value",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "rowId",
-              type: "string"
-            },
-            {
-              name: "value",
-              type: "number"
-            }
-          ]
-        },
-        disabled: {
-          types: [
-            "boolean"
-          ],
-          description: "Disable all inputs"
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "Visual size",
-          enumValues: [
-            "sm",
-            "md"
-          ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        }
-      }
-    },
-    "moderation-queue-row": {
-      type: "moderation-queue-row",
-      category: "component",
-      description: "ModerationQueueRow component",
-      suggestedFor: [
-        "moderation",
-        "queue",
-        "row",
-        "moderation queue row"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        contentId: {
-          types: [
-            "string"
-          ],
-          description: "contentId prop",
-          required: true
-        },
-        authorName: {
-          types: [
-            "string"
-          ],
-          description: "authorName prop",
-          required: true
-        },
-        authorAvatarUrl: {
-          types: [
-            "string"
-          ],
-          description: "authorAvatarUrl prop"
-        },
-        contentPreview: {
-          types: [
-            "string"
-          ],
-          description: "contentPreview prop",
-          required: true
-        },
-        contentType: {
-          types: [
-            "string"
-          ],
-          description: "contentType prop"
-        },
-        flaggedAt: {
-          types: [
-            "string"
-          ],
-          description: "flaggedAt prop",
-          required: true
-        },
-        flagReason: {
-          types: [
-            "string"
-          ],
-          description: "flagReason prop",
-          enumValues: [
-            "spam",
-            "abuse",
-            "off-topic",
-            "misinformation",
-            "nsfw",
-            "other"
-          ]
-        },
-        flagCount: {
-          types: [
-            "number"
-          ],
-          description: "flagCount prop"
-        },
-        reportedBy: {
-          types: [
-            "string"
-          ],
-          description: "reportedBy prop"
-        },
-        onApprove: {
-          types: [
-            "function"
-          ],
-          description: "onApprove prop",
-          kind: "callback",
-          callbackArgs: []
-        },
-        onReject: {
-          types: [
-            "function"
-          ],
-          description: "onReject prop",
-          kind: "callback",
-          callbackArgs: []
-        },
-        onEscalate: {
-          types: [
-            "function"
-          ],
-          description: "onEscalate prop",
-          kind: "callback",
-          callbackArgs: []
-        },
-        onView: {
-          types: [
-            "function"
-          ],
-          description: "onView prop",
-          kind: "callback",
-          callbackArgs: []
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
-        }
-      }
-    },
-    "modifier-group": {
-      type: "modifier-group",
-      category: "component",
-      description: "ModifierGroup Molecule Component  Restaurant POS item-customization selector with required/optional/multi constraints. Renders radio inputs for `single` constraint and checkboxes for `multi`. Reports validation errors inline when the current selection violates the constraint.  **Atomic Design**: Composed using Typography atom and native form controls.",
-      suggestedFor: [
-        "modifier",
-        "group",
-        "modifier group"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        groupId: {
-          types: [
-            "string"
-          ],
-          description: "groupId prop",
-          required: true
-        },
-        title: {
-          types: [
-            "string"
-          ],
-          description: "title prop",
-          required: true
-        },
-        description: {
-          types: [
-            "string"
-          ],
-          description: "description prop"
-        },
-        options: {
-          types: [
-            "array"
-          ],
-          description: "options prop",
-          required: true
-        },
-        constraint: {
-          types: [
-            "object"
-          ],
-          description: "constraint prop",
-          required: true
-        },
-        selected: {
-          types: [
-            "array"
-          ],
-          description: "selected prop"
-        },
-        onChange: {
-          types: [
-            "function"
-          ],
-          description: "onChange prop",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "selected",
-              type: "array"
-            }
-          ]
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "size prop",
-          enumValues: [
-            "sm",
-            "md"
-          ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
-        }
-      }
-    },
-    "qr-scanner": {
-      type: "qr-scanner",
-      category: "component",
-      description: "QrScanner component",
-      suggestedFor: [
-        "scanner",
-        "qr scanner"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        onScan: {
-          types: [
-            "function"
-          ],
-          description: "onScan prop",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "result",
-              type: "object"
-            }
-          ]
-        },
-        onError: {
-          types: [
-            "function"
-          ],
-          description: "onError prop",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "error",
-              type: "object"
-            }
-          ]
-        },
-        facingMode: {
-          types: [
-            "string"
-          ],
-          description: "facingMode prop",
-          enumValues: [
-            "environment",
-            "user"
-          ]
-        },
-        paused: {
-          types: [
-            "boolean"
+            "boolean"
           ],
           description: "paused prop"
         },
@@ -26742,108 +26209,6 @@ var patterns_registry_default = {
         }
       }
     },
-    "ticket-stub": {
-      type: "ticket-stub",
-      category: "component",
-      description: "TicketStub component",
-      suggestedFor: [
-        "ticket",
-        "stub",
-        "ticket stub"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        eventName: {
-          types: [
-            "string"
-          ],
-          description: "eventName prop",
-          required: true
-        },
-        date: {
-          types: [
-            "string"
-          ],
-          description: "date prop"
-        },
-        venue: {
-          types: [
-            "string"
-          ],
-          description: "venue prop"
-        },
-        tier: {
-          types: [
-            "string"
-          ],
-          description: "tier prop",
-          required: true
-        },
-        price: {
-          types: [
-            "string",
-            "number"
-          ],
-          description: "price prop",
-          required: true
-        },
-        currency: {
-          types: [
-            "string"
-          ],
-          description: "currency prop"
-        },
-        attendeeName: {
-          types: [
-            "string"
-          ],
-          description: "attendeeName prop"
-        },
-        ticketCode: {
-          types: [
-            "string"
-          ],
-          description: "ticketCode prop",
-          required: true
-        },
-        qrValue: {
-          types: [
-            "string"
-          ],
-          description: "qrValue prop"
-        },
-        variant: {
-          types: [
-            "string"
-          ],
-          description: "variant prop",
-          enumValues: [
-            "general",
-            "vip",
-            "early-bird",
-            "student",
-            "custom"
-          ]
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "size prop",
-          enumValues: [
-            "sm",
-            "md",
-            "lg"
-          ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
-        }
-      }
-    },
     "vote-stack": {
       type: "vote-stack",
       category: "component",
@@ -26869,7 +26234,8 @@ var patterns_registry_default = {
           description: "Current user's vote (null = no vote cast)",
           enumValues: [
             "up",
-            "down"
+            "down",
+            "none"
           ]
         },
         onVote: {
@@ -26882,174 +26248,61 @@ var patterns_registry_default = {
             {
               name: "next",
               type: "string"
-            }
-          ]
-        },
-        disabled: {
-          types: [
-            "boolean"
-          ],
-          description: "Disabled state"
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "Size variant",
-          enumValues: [
-            "sm",
-            "md",
-            "lg"
-          ]
-        },
-        variant: {
-          types: [
-            "string"
-          ],
-          description: "Layout orientation. `vertical` = forum/Q&A column; `horizontal` = compact row.",
-          enumValues: [
-            "vertical",
-            "horizontal"
-          ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        label: {
-          types: [
-            "string"
-          ],
-          description: "Accessible label for the group"
-        }
-      }
-    },
-    "work-order-card": {
-      type: "work-order-card",
-      category: "display",
-      description: "WorkOrderCard component",
-      suggestedFor: [
-        "work",
-        "order",
-        "card",
-        "work order card"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        orderId: {
-          types: [
-            "string"
-          ],
-          description: 'Work order identifier (e.g. "WO-1042")',
-          required: true
-        },
-        customerName: {
-          types: [
-            "string"
-          ],
-          description: "Customer name",
-          required: true
-        },
-        serviceType: {
-          types: [
-            "string"
-          ],
-          description: 'Service type description (e.g. "Plumbing repair")',
-          required: true
-        },
-        address: {
-          types: [
-            "string"
-          ],
-          description: "Service address",
-          required: true
-        },
-        scheduledAt: {
-          types: [
-            "string"
-          ],
-          description: "Scheduled date/time, rendered as-is"
-        },
-        etaMinutes: {
-          types: [
-            "number"
-          ],
-          description: "ETA in minutes; surfaced only when status is 'en-route'"
-        },
-        assignedTo: {
-          types: [
-            "string"
-          ],
-          description: 'Assigned technician name; rendered as "Unassigned" when omitted'
+            }
+          ]
         },
-        status: {
+        voteEvent: {
           types: [
             "string"
           ],
-          description: "Current dispatch status",
-          enumValues: [
-            "created",
-            "assigned",
-            "en-route",
-            "on-site",
-            "completed",
-            "cancelled"
+          description: "Event name dispatched on the bus when a vote is cast. Payload: { next: VoteValue }.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "next",
+              type: "string",
+              required: true
+            }
           ]
         },
-        priority: {
+        disabled: {
           types: [
-            "string"
+            "boolean"
           ],
-          description: "Priority level",
-          enumValues: [
-            "low",
-            "normal",
-            "high",
-            "urgent"
-          ]
+          description: "Disabled state"
         },
         size: {
           types: [
             "string"
           ],
-          description: "Card size affecting padding and typography",
+          description: "Size variant",
           enumValues: [
             "sm",
             "md",
             "lg"
           ]
         },
-        onAssign: {
-          types: [
-            "function"
-          ],
-          description: "Handler for the Assign action",
-          kind: "callback",
-          callbackArgs: []
-        },
-        onViewRoute: {
+        variant: {
           types: [
-            "function"
+            "string"
           ],
-          description: "Handler for the View Route action",
-          kind: "callback",
-          callbackArgs: []
+          description: "Layout orientation. `vertical` = forum/Q&A column; `horizontal` = compact row.",
+          enumValues: [
+            "vertical",
+            "horizontal"
+          ]
         },
-        onMarkCompleted: {
+        className: {
           types: [
-            "function"
+            "string"
           ],
-          description: "Handler for the Mark Completed action",
-          kind: "callback",
-          callbackArgs: []
+          description: "Additional CSS classes"
         },
-        className: {
+        label: {
           types: [
             "string"
           ],
-          description: "Additional class names"
+          description: "Accessible label for the group"
         }
       }
     },
@@ -27067,16 +26320,18 @@ var patterns_registry_default = {
       propsSchema: {
         questions: {
           types: [
-            "array"
+            "array",
+            "object"
           ],
           description: "questions prop",
           required: true
         },
         rules: {
           types: [
-            "array"
+            "array",
+            "object"
           ],
-          description: "rules prop",
+          description: "Rules. Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.data`). Narrowed to `[]` internally when the value isn't an array.",
           required: true
         },
         onRulesChange: {
@@ -27092,6 +26347,20 @@ var patterns_registry_default = {
             }
           ]
         },
+        rulesChangeEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name dispatched via event bus when rules change. Payload: `{ rules }`.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "rules",
+              type: "array",
+              required: true
+            }
+          ]
+        },
         readOnly: {
           types: [
             "boolean"
@@ -27186,6 +26455,67 @@ var patterns_registry_default = {
             }
           ]
         },
+        voteEvent: {
+          types: [
+            "string"
+          ],
+          description: "voteEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "nodeId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "vote",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        replyEvent: {
+          types: [
+            "string"
+          ],
+          description: "replyEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "parentNodeId",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        flagEvent: {
+          types: [
+            "string"
+          ],
+          description: "flagEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "nodeId",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        continueThreadEvent: {
+          types: [
+            "string"
+          ],
+          description: "continueThreadEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "nodeId",
+              type: "string",
+              required: true
+            }
+          ]
+        },
         showActions: {
           types: [
             "boolean"
@@ -27216,7 +26546,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "initialBlocks prop"
+          description: "Initial block payload. Accepts strongly-typed RichBlock[] from native callers and the wider EntityRow[] shape that orb-bound traits emit (orb `[object]` lowers to `Record<string, FieldValue | undefined>[]`, which is structurally EntityRow[]). Items missing id/type are normalized into paragraph blocks at mount."
         },
         onChange: {
           types: [
@@ -27231,6 +26561,20 @@ var patterns_registry_default = {
             }
           ]
         },
+        changeEvent: {
+          types: [
+            "string"
+          ],
+          description: "changeEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "blocks",
+              type: "array",
+              required: true
+            }
+          ]
+        },
         readOnly: {
           types: [
             "boolean"
@@ -27257,92 +26601,230 @@ var patterns_registry_default = {
         }
       }
     },
-    "route-map": {
-      type: "route-map",
+    "version-diff": {
+      type: "version-diff",
       category: "display",
-      description: "RouteMap component",
+      description: "VersionDiff component",
+      suggestedFor: [
+        "version",
+        "diff",
+        "version diff"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        revisions: {
+          types: [
+            "array",
+            "object"
+          ],
+          description: "All available revisions (at least 2). Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.revisions`). Narrowed to `[]` internally when the value isn't an array.",
+          required: true
+        },
+        beforeId: {
+          types: [
+            "string"
+          ],
+          description: 'Currently selected "before" revision id.'
+        },
+        afterId: {
+          types: [
+            "string"
+          ],
+          description: 'Currently selected "after" revision id.'
+        },
+        view: {
+          types: [
+            "string"
+          ],
+          description: "Display mode.",
+          enumValues: [
+            "side-by-side",
+            "inline"
+          ]
+        },
+        onSelectBefore: {
+          types: [
+            "function"
+          ],
+          description: 'Called when the user picks a different "before" revision.',
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            }
+          ]
+        },
+        onSelectAfter: {
+          types: [
+            "function"
+          ],
+          description: 'Called when the user picks a different "after" revision.',
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            }
+          ]
+        },
+        onRevert: {
+          types: [
+            "function"
+          ],
+          description: 'Called when the user clicks the revert button (passes the "before" id).',
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            }
+          ]
+        },
+        selectBeforeEvent: {
+          types: [
+            "string"
+          ],
+          description: 'Event name dispatched via event bus when the "before" revision changes. Payload: { id }.',
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "id",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        selectAfterEvent: {
+          types: [
+            "string"
+          ],
+          description: 'Event name dispatched via event bus when the "after" revision changes. Payload: { id }.',
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "id",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        revertEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name dispatched via event bus when the user clicks revert. Payload: { id }.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "id",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        language: {
+          types: [
+            "string"
+          ],
+          description: "Language label (informational)."
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes."
+        }
+      }
+    },
+    "option-constraint-group": {
+      type: "option-constraint-group",
+      category: "component",
+      description: 'OptionConstraintGroup Molecule Component  Generic constrained option selector (radio for "single", checkbox for "multi") with required/optional/multi constraints. Renders radio inputs for `single` constraint and checkboxes for `multi`. Reports validation errors inline when the current selection violates the constraint.  **Atomic Design**: Composed using Typography atom and native form controls.',
       suggestedFor: [
-        "route",
-        "map",
-        "route map"
+        "option",
+        "constraint",
+        "group",
+        "option constraint group"
       ],
-      typicalSize: "large",
+      typicalSize: "medium",
       propsSchema: {
-        stops: {
+        groupId: {
           types: [
-            "array"
+            "string"
           ],
-          description: "stops prop",
+          description: "groupId prop",
           required: true
         },
-        origin: {
+        title: {
           types: [
-            "object"
+            "string"
           ],
-          description: "origin prop"
+          description: "title prop",
+          required: true
         },
-        selectedStopId: {
+        description: {
           types: [
             "string"
           ],
-          description: "selectedStopId prop"
+          description: "description prop"
         },
-        editable: {
+        options: {
           types: [
-            "boolean"
+            "array"
           ],
-          description: "editable prop"
+          description: "options prop",
+          required: true
         },
-        onSelectStop: {
+        constraint: {
           types: [
-            "function"
+            "object"
           ],
-          description: "onSelectStop prop",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "id",
-              type: "string"
-            }
-          ]
+          description: "constraint prop",
+          required: true
+        },
+        selected: {
+          types: [
+            "array"
+          ],
+          description: "selected prop"
         },
-        onReorderStops: {
+        onChange: {
           types: [
             "function"
           ],
-          description: "onReorderStops prop",
+          description: "onChange prop",
           kind: "callback",
           callbackArgs: [
             {
-              name: "newOrder",
+              name: "selected",
               type: "array"
             }
           ]
         },
-        onSkipStop: {
+        changeEvent: {
           types: [
-            "function"
+            "string"
           ],
-          description: "onSkipStop prop",
-          kind: "callback",
-          callbackArgs: [
+          description: "changeEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
             {
-              name: "id",
-              type: "string"
+              name: "selected",
+              type: "array",
+              required: true
             }
           ]
         },
-        totalDistanceKm: {
-          types: [
-            "number"
-          ],
-          description: "totalDistanceKm prop"
-        },
-        totalDurationMinutes: {
+        size: {
           types: [
-            "number"
+            "string"
           ],
-          description: "totalDurationMinutes prop"
+          description: "size prop",
+          enumValues: [
+            "sm",
+            "md"
+          ]
         },
         className: {
           types: [
@@ -27352,23 +26834,23 @@ var patterns_registry_default = {
         }
       }
     },
-    "table-floor-plan": {
-      type: "table-floor-plan",
-      category: "display",
-      description: "TableFloorPlan component",
+    "positioned-canvas": {
+      type: "positioned-canvas",
+      category: "game",
+      description: "PositionedCanvas component",
       suggestedFor: [
-        "table",
-        "floor",
-        "plan",
-        "table floor plan"
+        "positioned",
+        "canvas",
+        "positioned canvas"
       ],
-      typicalSize: "large",
+      typicalSize: "medium",
       propsSchema: {
-        tables: {
+        items: {
           types: [
-            "array"
+            "array",
+            "object"
           ],
-          description: "tables prop",
+          description: "Items to render. Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.data`). The molecule narrows non-array values to `[]` and validates element shape at render time via the `id` / `x` / `y` guards.",
           required: true
         },
         width: {
@@ -27429,183 +26911,49 @@ var patterns_registry_default = {
             }
           ]
         },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
-        }
-      }
-    },
-    "vendor-onboarding-stepper": {
-      type: "vendor-onboarding-stepper",
-      category: "game",
-      description: "VendorOnboardingStepper component",
-      suggestedFor: [
-        "vendor",
-        "onboarding",
-        "stepper",
-        "vendor onboarding stepper"
-      ],
-      typicalSize: "large",
-      propsSchema: {
-        initialStep: {
+        selectEvent: {
           types: [
             "string"
           ],
-          description: "initialStep prop",
-          enumValues: [
-            "business-info",
-            "tax-id",
-            "bank-link",
-            "identity-verify",
-            "review",
-            "submitted"
-          ]
-        },
-        initialState: {
-          types: [
-            "object"
-          ],
-          description: "initialState prop"
-        },
-        onSubmit: {
-          types: [
-            "function"
-          ],
-          description: "onSubmit prop",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "state",
-              type: "object"
-            }
-          ]
-        },
-        onStepChange: {
-          types: [
-            "function"
-          ],
-          description: "onStepChange prop",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "step",
-              type: "string"
-            }
-          ]
-        },
-        onSaveDraft: {
-          types: [
-            "function"
-          ],
-          description: "onSaveDraft prop",
-          kind: "callback",
-          callbackArgs: [
+          description: "selectEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
             {
-              name: "state",
-              type: "object"
+              name: "id",
+              type: "string",
+              required: true
             }
           ]
         },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
-        }
-      }
-    },
-    "version-diff": {
-      type: "version-diff",
-      category: "display",
-      description: "VersionDiff component",
-      suggestedFor: [
-        "version",
-        "diff",
-        "version diff"
-      ],
-      typicalSize: "large",
-      propsSchema: {
-        revisions: {
-          types: [
-            "array"
-          ],
-          description: "All available revisions (at least 2).",
-          required: true
-        },
-        beforeId: {
-          types: [
-            "string"
-          ],
-          description: 'Currently selected "before" revision id.'
-        },
-        afterId: {
-          types: [
-            "string"
-          ],
-          description: 'Currently selected "after" revision id.'
-        },
-        view: {
+        moveEvent: {
           types: [
             "string"
           ],
-          description: "Display mode.",
-          enumValues: [
-            "side-by-side",
-            "inline"
-          ]
-        },
-        onSelectBefore: {
-          types: [
-            "function"
-          ],
-          description: 'Called when the user picks a different "before" revision.',
-          kind: "callback",
-          callbackArgs: [
+          description: "moveEvent prop",
+          kind: "event-ref",
+          emitPayloadSchema: [
             {
               name: "id",
-              type: "string"
-            }
-          ]
-        },
-        onSelectAfter: {
-          types: [
-            "function"
-          ],
-          description: 'Called when the user picks a different "after" revision.',
-          kind: "callback",
-          callbackArgs: [
+              type: "string",
+              required: true
+            },
             {
-              name: "id",
-              type: "string"
-            }
-          ]
-        },
-        onRevert: {
-          types: [
-            "function"
-          ],
-          description: 'Called when the user clicks the revert button (passes the "before" id).',
-          kind: "callback",
-          callbackArgs: [
+              name: "x",
+              type: "number",
+              required: true
+            },
             {
-              name: "id",
-              type: "string"
+              name: "y",
+              type: "number",
+              required: true
             }
           ]
         },
-        language: {
-          types: [
-            "string"
-          ],
-          description: "Language label (informational)."
-        },
         className: {
           types: [
             "string"
           ],
-          description: "Additional CSS classes."
+          description: "className prop"
         }
       }
     },
@@ -28535,7 +27883,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-05-09T16:52:32.798Z",
+  exportedAt: "2026-05-11T04:42:37.745Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -30335,66 +29683,26 @@ var component_mapping_default = {
       importPath: "@/components/atoms/FilterPill",
       category: "filter"
     },
-    "dunning-banner": {
-      component: "DunningBanner",
-      importPath: "@/components/molecules/DunningBanner",
-      category: "component"
-    },
-    invoice: {
-      component: "Invoice",
-      importPath: "@/components/molecules/Invoice",
-      category: "component"
-    },
-    "kitchen-display-strip": {
-      component: "KitchenDisplayStrip",
-      importPath: "@/components/molecules/KitchenDisplayStrip",
-      category: "component"
-    },
     "likert-scale": {
       component: "LikertScale",
       importPath: "@/components/molecules/LikertScale",
       category: "component"
     },
-    "listing-card": {
-      component: "ListingCard",
-      importPath: "@/components/molecules/ListingCard",
-      category: "display"
-    },
     "matrix-question": {
       component: "MatrixQuestion",
       importPath: "@/components/molecules/MatrixQuestion",
       category: "component"
     },
-    "moderation-queue-row": {
-      component: "ModerationQueueRow",
-      importPath: "@/components/molecules/ModerationQueueRow",
-      category: "component"
-    },
-    "modifier-group": {
-      component: "ModifierGroup",
-      importPath: "@/components/molecules/ModifierGroup",
-      category: "component"
-    },
     "qr-scanner": {
       component: "QrScanner",
       importPath: "@/components/molecules/QrScanner",
       category: "component"
     },
-    "ticket-stub": {
-      component: "TicketStub",
-      importPath: "@/components/molecules/TicketStub",
-      category: "component"
-    },
     "vote-stack": {
       component: "VoteStack",
       importPath: "@/components/molecules/VoteStack",
       category: "component"
     },
-    "work-order-card": {
-      component: "WorkOrderCard",
-      importPath: "@/components/molecules/WorkOrderCard",
-      category: "display"
-    },
     "branching-logic-builder": {
       component: "BranchingLogicBuilder",
       importPath: "@/components/organisms/BranchingLogicBuilder",
@@ -30410,26 +29718,21 @@ var component_mapping_default = {
       importPath: "@/components/organisms/RichBlockEditor",
       category: "display"
     },
-    "route-map": {
-      component: "RouteMap",
-      importPath: "@/components/organisms/RouteMap",
-      category: "display"
-    },
-    "table-floor-plan": {
-      component: "TableFloorPlan",
-      importPath: "@/components/organisms/TableFloorPlan",
-      category: "display"
-    },
-    "vendor-onboarding-stepper": {
-      component: "VendorOnboardingStepper",
-      importPath: "@/components/organisms/VendorOnboardingStepper",
-      category: "game"
-    },
     "version-diff": {
       component: "VersionDiff",
       importPath: "@/components/organisms/VersionDiff",
       category: "display"
     },
+    "option-constraint-group": {
+      component: "OptionConstraintGroup",
+      importPath: "@/components/molecules/OptionConstraintGroup",
+      category: "component"
+    },
+    "positioned-canvas": {
+      component: "PositionedCanvas",
+      importPath: "@/components/molecules/PositionedCanvas",
+      category: "game"
+    },
     heading: {
       component: "Typography",
       importPath: "@/components/atoms/Typography",
@@ -30446,7 +29749,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-05-09T16:52:32.798Z",
+  exportedAt: "2026-05-11T04:42:37.745Z",
   contracts: {
     form: {
       emits: [