@almadar/patterns 2.50.0 → 2.52.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-18T10:28:38.516Z",
+  exportedAt: "2026-06-19T09:54:53.846Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -14276,6 +14276,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -14633,6 +14638,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -15011,6 +15021,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -30534,6 +30549,11 @@ var patterns_registry_default = {
                   "asset"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "asset"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -31067,6 +31087,11 @@ var patterns_registry_default = {
                       "asset"
                     ]
                   },
+                  modelUrl: {
+                    types: [
+                      "asset"
+                    ]
+                  },
                   unitType: {
                     types: [
                       "string"
@@ -32744,6 +32769,11 @@ var patterns_registry_default = {
                   "asset"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "asset"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -34443,6 +34473,11 @@ var patterns_registry_default = {
                   "asset"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "asset"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -34820,6 +34855,11 @@ var patterns_registry_default = {
                           "asset"
                         ]
                       },
+                      modelUrl: {
+                        types: [
+                          "asset"
+                        ]
+                      },
                       unitType: {
                         types: [
                           "string"
@@ -35170,6 +35210,11 @@ var patterns_registry_default = {
                           "asset"
                         ]
                       },
+                      modelUrl: {
+                        types: [
+                          "asset"
+                        ]
+                      },
                       unitType: {
                         types: [
                           "string"
@@ -35520,6 +35565,11 @@ var patterns_registry_default = {
                           "asset"
                         ]
                       },
+                      modelUrl: {
+                        types: [
+                          "asset"
+                        ]
+                      },
                       unitType: {
                         types: [
                           "string"
@@ -35870,6 +35920,11 @@ var patterns_registry_default = {
                           "asset"
                         ]
                       },
+                      modelUrl: {
+                        types: [
+                          "asset"
+                        ]
+                      },
                       unitType: {
                         types: [
                           "string"
@@ -36207,6 +36262,11 @@ var patterns_registry_default = {
                       "asset"
                     ]
                   },
+                  modelUrl: {
+                    types: [
+                      "asset"
+                    ]
+                  },
                   unitType: {
                     types: [
                       "string"
@@ -37590,6 +37650,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -37980,6 +38045,11 @@ var patterns_registry_default = {
                   "asset"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "asset"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -43981,6 +44051,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              modelUrl: {
+                types: [
+                  "object"
+                ]
+              },
               unitType: {
                 types: [
                   "string"
@@ -44385,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: [
@@ -44451,6 +44552,11 @@ var patterns_registry_default = {
                       "object"
                     ]
                   },
+                  modelUrl: {
+                    types: [
+                      "object"
+                    ]
+                  },
                   unitType: {
                     types: [
                       "string"
@@ -44573,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: [
@@ -44648,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: [
@@ -44662,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: [
@@ -44751,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: [
@@ -45624,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: [
@@ -46251,7 +46840,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-18T10:28:38.516Z",
+  exportedAt: "2026-06-19T09:54:53.846Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -47769,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"
     }
   }
 };
@@ -47776,7 +48395,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-18T10:28:38.516Z",
+  exportedAt: "2026-06-19T09:54:53.846Z",
   contracts: {
     form: {
       emits: [
@@ -48963,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
     }
   }
 };