@almadar/patterns 2.49.0 → 2.51.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-18T09:49:37.603Z",
+  exportedAt: "2026-06-18T22:45:03.741Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -7597,16 +7597,10 @@ var patterns_registry_default = {
         },
         onValueChange: {
           types: [
-            "function"
+            "function",
+            "string"
           ],
-          description: "Value-based callback \u2014 receives the selected string (or string[] for multiple).",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "value",
-              type: "string"
-            }
-          ]
+          description: "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback."
         }
       }
     },
@@ -14282,6 +14276,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -14639,6 +14638,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -15017,6 +15021,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -30540,6 +30549,11 @@ var patterns_registry_default = {
                   "asset"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "asset"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -31073,6 +31087,11 @@ var patterns_registry_default = {
                       "asset"
                     ]
                   },
+                  modelUrl: {
+                    types: [
+                      "asset"
+                    ]
+                  },
                   unitType: {
                     types: [
                       "string"
@@ -32750,6 +32769,11 @@ var patterns_registry_default = {
                   "asset"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "asset"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -34449,6 +34473,11 @@ var patterns_registry_default = {
                   "asset"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "asset"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -34826,6 +34855,11 @@ var patterns_registry_default = {
                           "asset"
                         ]
                       },
+                      modelUrl: {
+                        types: [
+                          "asset"
+                        ]
+                      },
                       unitType: {
                         types: [
                           "string"
@@ -35176,6 +35210,11 @@ var patterns_registry_default = {
                           "asset"
                         ]
                       },
+                      modelUrl: {
+                        types: [
+                          "asset"
+                        ]
+                      },
                       unitType: {
                         types: [
                           "string"
@@ -35526,6 +35565,11 @@ var patterns_registry_default = {
                           "asset"
                         ]
                       },
+                      modelUrl: {
+                        types: [
+                          "asset"
+                        ]
+                      },
                       unitType: {
                         types: [
                           "string"
@@ -35876,6 +35920,11 @@ var patterns_registry_default = {
                           "asset"
                         ]
                       },
+                      modelUrl: {
+                        types: [
+                          "asset"
+                        ]
+                      },
                       unitType: {
                         types: [
                           "string"
@@ -36213,6 +36262,11 @@ var patterns_registry_default = {
                       "asset"
                     ]
                   },
+                  modelUrl: {
+                    types: [
+                      "asset"
+                    ]
+                  },
                   unitType: {
                     types: [
                       "string"
@@ -37596,6 +37650,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -37986,6 +38045,11 @@ var patterns_registry_default = {
                   "asset"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "asset"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -43987,6 +44051,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -44391,10 +44460,36 @@ var patterns_registry_default = {
             },
             {
               name: "event",
-              type: "object"
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  clientX: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  clientY: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  button: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "clientX",
+                  "clientY",
+                  "button"
+                ]
+              }
             }
-          ],
-          nonEmittable: true
+          ]
         },
         onUnitClick: {
           types: [
@@ -44457,6 +44552,11 @@ var patterns_registry_default = {
                       "object"
                     ]
                   },
+                  modelUrl: {
+                    types: [
+                      "object"
+                    ]
+                  },
                   unitType: {
                     types: [
                       "string"
@@ -44579,10 +44679,36 @@ var patterns_registry_default = {
             },
             {
               name: "event",
-              type: "object"
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  clientX: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  clientY: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  button: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "clientX",
+                  "clientY",
+                  "button"
+                ]
+              }
             }
-          ],
-          nonEmittable: true
+          ]
         },
         onFeatureClick: {
           types: [
@@ -44654,10 +44780,36 @@ var patterns_registry_default = {
             },
             {
               name: "event",
-              type: "object"
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  clientX: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  clientY: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  button: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "clientX",
+                  "clientY",
+                  "button"
+                ]
+              }
             }
-          ],
-          nonEmittable: true
+          ]
         },
         onCanvasClick: {
           types: [
@@ -44668,10 +44820,36 @@ var patterns_registry_default = {
           callbackArgs: [
             {
               name: "event",
-              type: "object"
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  clientX: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  clientY: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  button: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "clientX",
+                  "clientY",
+                  "button"
+                ]
+              }
             }
-          ],
-          nonEmittable: true
+          ]
         },
         onTileHover: {
           types: [
@@ -44757,10 +44935,36 @@ var patterns_registry_default = {
             },
             {
               name: "event",
-              type: "object"
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  clientX: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  clientY: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  button: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "clientX",
+                  "clientY",
+                  "button"
+                ]
+              }
             }
-          ],
-          nonEmittable: true
+          ]
         },
         onUnitAnimation: {
           types: [
@@ -45630,6 +45834,385 @@ var patterns_registry_default = {
           }
         }
       }
+    },
+    "activation-block": {
+      type: "activation-block",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "ActivationBlock component",
+      suggestedFor: [
+        "activation",
+        "block",
+        "activation block"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        question: {
+          types: [
+            "string"
+          ],
+          description: "The prior-knowledge question",
+          required: true
+        },
+        savedResponse: {
+          types: [
+            "string"
+          ],
+          description: "Pre-filled response from saved state"
+        },
+        saveEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name emitted on save/skip (as `UI:<saveEvent>`). Defaults to 'SAVE_ACTIVATION'.",
+          default: "SAVE_ACTIVATION"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "bloom-quiz-block": {
+      type: "bloom-quiz-block",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "BloomQuizBlock component",
+      suggestedFor: [
+        "bloom",
+        "quiz",
+        "block",
+        "bloom quiz block"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        level: {
+          types: [
+            "string"
+          ],
+          description: "level prop",
+          required: true,
+          enumValues: [
+            "remember",
+            "understand",
+            "apply",
+            "analyze",
+            "evaluate",
+            "create"
+          ]
+        },
+        question: {
+          types: [
+            "string"
+          ],
+          description: "question prop",
+          required: true
+        },
+        answer: {
+          types: [
+            "string"
+          ],
+          description: "answer prop",
+          required: true
+        },
+        index: {
+          types: [
+            "number"
+          ],
+          description: "Zero-based index (used in the emitted event payload)"
+        },
+        isAnswered: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the learner has already answered"
+        },
+        answerEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name emitted on first reveal (as `UI:<answerEvent>`). Defaults to 'ANSWER_BLOOM'.",
+          default: "ANSWER_BLOOM"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "connection-block": {
+      type: "connection-block",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "ConnectionBlock component",
+      suggestedFor: [
+        "connection",
+        "block",
+        "connection block"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        content: {
+          types: [
+            "string"
+          ],
+          description: "Markdown content summarising what the learner already knows",
+          required: true
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "reflection-block": {
+      type: "reflection-block",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "ReflectionBlock component",
+      suggestedFor: [
+        "reflection",
+        "block",
+        "reflection block"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        prompt: {
+          types: [
+            "string"
+          ],
+          description: "The reflection prompt",
+          required: true
+        },
+        index: {
+          types: [
+            "number"
+          ],
+          description: "Zero-based index of this block (used in the emitted event payload)",
+          required: true
+        },
+        savedNote: {
+          types: [
+            "string"
+          ],
+          description: "Pre-filled note from saved state"
+        },
+        saveEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name emitted on save (as `UI:<saveEvent>`). Defaults to 'SAVE_REFLECTION'.",
+          default: "SAVE_REFLECTION"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "code-runner-panel": {
+      type: "code-runner-panel",
+      category: "display",
+      tier: "organisms",
+      family: "core",
+      description: "CodeRunnerPanel component",
+      suggestedFor: [
+        "code",
+        "runner",
+        "panel",
+        "code runner panel"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        code: {
+          types: [
+            "string"
+          ],
+          description: "Initial code content",
+          required: true
+        },
+        language: {
+          types: [
+            "string"
+          ],
+          description: "Programming language for syntax highlighting",
+          required: true
+        },
+        runnable: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the panel allows running (false = read-only code block)",
+          default: true
+        },
+        onRun: {
+          types: [
+            "function"
+          ],
+          description: "Simulate executing the code. Omit to render a read-only block. Real execution is a separate future track \u2014 this callback supplies deterministic simulated output for UI feedback.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "code",
+              type: "string"
+            }
+          ],
+          renderCallback: true
+        },
+        runEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name to emit on run (emitted as `UI:<runEvent>`). Defaults to 'RUN_CODE'.",
+          default: "RUN_CODE"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "segment-renderer": {
+      type: "segment-renderer",
+      category: "display",
+      tier: "organisms",
+      family: "core",
+      description: "SegmentRenderer component",
+      suggestedFor: [
+        "segment",
+        "renderer",
+        "segment renderer"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        segments: {
+          types: [
+            "array"
+          ],
+          description: "Parsed lesson segments (see `parseLessonSegments`)",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              type: {
+                types: [
+                  "unknown"
+                ]
+              },
+              content: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "type",
+              "content"
+            ]
+          }
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes for the root container"
+        },
+        containerClassName: {
+          types: [
+            "string"
+          ],
+          description: "CSS classes for the outer wrapping div"
+        },
+        userProgress: {
+          types: [
+            "object"
+          ],
+          description: "User progress for restoring activation/reflection state",
+          properties: {
+            activationResponse: {
+              types: [
+                "string"
+              ]
+            },
+            reflectionNotes: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            bloomAnswered: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "boolean"
+                ]
+              }
+            }
+          }
+        },
+        onRunCodeSimulation: {
+          types: [
+            "function"
+          ],
+          description: "Simulate executing runnable code blocks. Omit to render runnable blocks as read-only. Real execution is a future track.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "code",
+              type: "string"
+            },
+            {
+              name: "language",
+              type: "string"
+            }
+          ],
+          renderCallback: true
+        },
+        onRenderVisualization: {
+          types: [
+            "function"
+          ],
+          description: "Optional render slot for `visualization` segment types. When not provided, visualization segments are silently skipped. Callers can wire this to any custom component or orbital generator.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "type",
+              type: "string"
+            },
+            {
+              name: "description",
+              type: "string"
+            },
+            {
+              name: "index",
+              type: "number"
+            }
+          ],
+          renderCallback: true
+        }
+      }
     }
   },
   categories: [
@@ -46257,7 +46840,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-18T09:49:37.603Z",
+  exportedAt: "2026-06-18T22:45:03.741Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -47775,6 +48358,36 @@ var component_mapping_default = {
       component: "GameCanvas3DWorldMapTemplate",
       importPath: "@/components/templates/GameCanvas3DWorldMapTemplate",
       category: "game"
+    },
+    "activation-block": {
+      component: "ActivationBlock",
+      importPath: "@/components/molecules/ActivationBlock",
+      category: "component"
+    },
+    "bloom-quiz-block": {
+      component: "BloomQuizBlock",
+      importPath: "@/components/molecules/BloomQuizBlock",
+      category: "component"
+    },
+    "connection-block": {
+      component: "ConnectionBlock",
+      importPath: "@/components/molecules/ConnectionBlock",
+      category: "component"
+    },
+    "reflection-block": {
+      component: "ReflectionBlock",
+      importPath: "@/components/molecules/ReflectionBlock",
+      category: "component"
+    },
+    "code-runner-panel": {
+      component: "CodeRunnerPanel",
+      importPath: "@/components/organisms/CodeRunnerPanel",
+      category: "display"
+    },
+    "segment-renderer": {
+      component: "SegmentRenderer",
+      importPath: "@/components/organisms/SegmentRenderer",
+      category: "display"
     }
   }
 };
@@ -47782,7 +48395,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-18T09:49:37.603Z",
+  exportedAt: "2026-06-18T22:45:03.741Z",
   contracts: {
     form: {
       emits: [
@@ -48969,6 +49582,58 @@ var event_contracts_default = {
       ],
       requires: [],
       entityAware: true
+    },
+    "activation-block": {
+      emits: [
+        {
+          event: "SAVE_ACTIVATION",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: false
+    },
+    "bloom-quiz-block": {
+      emits: [
+        {
+          event: "ANSWER_BLOOM",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: false
+    },
+    "reflection-block": {
+      emits: [
+        {
+          event: "SAVE_REFLECTION",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: false
+    },
+    "code-runner-panel": {
+      emits: [
+        {
+          event: "RUN_CODE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: false
     }
   }
 };