@almadar/patterns 2.20.0 → 2.20.2

package/dist/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-05-04T04:46:21.886Z",
+  "exportedAt": "2026-05-04T08:21:23.048Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -3976,9 +3976,10 @@
         },
         "label": {
           "types": [
-            "string"
+            "string",
+            "number"
           ],
-          "description": "Badge label text (alternative to children for schema-driven rendering)"
+          "description": "Badge label text (alternative to children for schema-driven rendering). Numeric values are auto-coerced to string for rendering — common case is unread counts, error counts, status codes, etc."
         },
         "icon": {
           "types": [
@@ -14711,8 +14712,13 @@
           "types": [
             "array"
           ],
-          "description": "Field definitions for rendering each card",
-          "required": true
+          "description": "Field definitions for rendering each card. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either."
+        },
+        "columns": {
+          "types": [
+            "array"
+          ],
+          "description": "Alias for `fields` — the compiler emits `columns` for field defs."
         },
         "itemActions": {
           "types": [
@@ -14868,8 +14874,13 @@
           "types": [
             "array"
           ],
-          "description": "Field definitions for rendering each row",
-          "required": true
+          "description": "Field definitions for rendering each row. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either."
+        },
+        "columns": {
+          "types": [
+            "array"
+          ],
+          "description": "Alias for `fields` — the compiler emits `columns` for field defs."
         },
         "itemActions": {
           "types": [

package/dist/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-05-04T04:46:21.886Z",
+  "exportedAt": "2026-05-04T08:21:23.048Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -3976,9 +3976,10 @@
         },
         "label": {
           "types": [
-            "string"
+            "string",
+            "number"
           ],
-          "description": "Badge label text (alternative to children for schema-driven rendering)"
+          "description": "Badge label text (alternative to children for schema-driven rendering). Numeric values are auto-coerced to string for rendering — common case is unread counts, error counts, status codes, etc."
         },
         "icon": {
           "types": [
@@ -14711,8 +14712,13 @@
           "types": [
             "array"
           ],
-          "description": "Field definitions for rendering each card",
-          "required": true
+          "description": "Field definitions for rendering each card. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either."
+        },
+        "columns": {
+          "types": [
+            "array"
+          ],
+          "description": "Alias for `fields` — the compiler emits `columns` for field defs."
         },
         "itemActions": {
           "types": [
@@ -14868,8 +14874,13 @@
           "types": [
             "array"
           ],
-          "description": "Field definitions for rendering each row",
-          "required": true
+          "description": "Field definitions for rendering each row. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either."
+        },
+        "columns": {
+          "types": [
+            "array"
+          ],
+          "description": "Alias for `fields` — the compiler emits `columns` for field defs."
         },
         "itemActions": {
           "types": [

package/dist/types.d.ts

@@ -28,7 +28,28 @@
  * Reserved for future use: `"entity"`, `"config-binding"`. Add here
  * rather than inventing per-consumer markers.
  */
-export type PropKind = 'event' | 'event-list';
+export type PropKind = 'event' | 'event-ref' | 'event-listen' | 'event-list' | 'callback';
+/**
+ * One field of an emit/listen payload schema, mirrored into the registry
+ * by pattern-sync from a component's `EventEmit<P>` / `EventListen<P>`
+ * brand. Validator (L2.2) compares this against the trait's declared
+ * `emits { EVENT { ... } }` / `listens` payload shape.
+ */
+export interface PatternPayloadField {
+    name: string;
+    type: string;
+    required?: boolean;
+}
+/**
+ * One positional parameter of a React callback prop. Validator (L2.2)
+ * uses the names to verify name-and-type parity with the trait's declared
+ * event payload; codegen (C2) uses the same names to wrap the dispatch
+ * site as `(name) => dispatch('EVENT', { name })`.
+ */
+export interface PatternCallbackArg {
+    name: string;
+    type: string;
+}
 /**
  * Schema describing a single prop in a pattern's propsSchema. Emitted
  * by the pattern-sync tool (`tools/almadar-pattern-sync/`) from a
@@ -57,4 +78,22 @@ export interface PatternPropDef {
      * omitted. Only meaningful alongside `kind: "event-list"`.
      */
     eventField?: string;
+    /**
+     * For `kind: "event-ref"` whose source is `EventEmit<P>`: the
+     * structural shape of `P` — the bus payload the component fires when
+     * the prop is bound. Validator compares against the trait's declared
+     * `emits { EVENT { ... } }` payload.
+     */
+    emitPayloadSchema?: PatternPayloadField[];
+    /**
+     * For `kind: "event-listen"` whose source is `EventListen<P>`: the
+     * structural shape of `P` — the payload the component subscribes to.
+     */
+    listenPayloadSchema?: PatternPayloadField[];
+    /**
+     * For `kind: "callback"`: positional parameter list of the function
+     * type. C2 uses these names to build the named-arg → object-payload
+     * wrapper at the dispatch site.
+     */
+    callbackArgs?: PatternCallbackArg[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/patterns",
-  "version": "2.20.0",
+  "version": "2.20.2",
   "description": "Pattern registry and component mappings for Almadar",
   "type": "module",
   "main": "./dist/index.js",