@almadar/std 16.243.0 → 16.244.0

package/behaviors/registry/ui/core/organisms/ui-segment-renderer.orb

@@ -19,6 +19,60 @@
         "parent": "trt_01KXG04SYNY0B326SBBN7KCRAW",
         "renames": []
       },
+      "evt_01M458N6P062ZD3DSTR9K0AY43": {
+        "bakedName": "@config.askEvent",
+        "curName": "@config.askEvent",
+        "id": "evt_01M458N6P062ZD3DSTR9K0AY43",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SYNY0B326SBBN7KCRAW",
+        "renames": []
+      },
+      "evt_01M458N6P0A77V2AD2ED983CT3": {
+        "bakedName": "@config.noteEvent",
+        "curName": "@config.noteEvent",
+        "id": "evt_01M458N6P0A77V2AD2ED983CT3",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SYNY0B326SBBN7KCRAW",
+        "renames": []
+      },
+      "evt_01M458N6P0CVA84D14F7QQ70FH": {
+        "bakedName": "@config.bloomAnswerEvent",
+        "curName": "@config.bloomAnswerEvent",
+        "id": "evt_01M458N6P0CVA84D14F7QQ70FH",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SYNY0B326SBBN7KCRAW",
+        "renames": []
+      },
+      "evt_01M458N6P0H1AZT11P3E8H577T": {
+        "bakedName": "@config.reflectionSaveEvent",
+        "curName": "@config.reflectionSaveEvent",
+        "id": "evt_01M458N6P0H1AZT11P3E8H577T",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SYNY0B326SBBN7KCRAW",
+        "renames": []
+      },
+      "evt_01M458N6P0P9RX6ER58JN0KZ1T": {
+        "bakedName": "@config.annotationEvent",
+        "curName": "@config.annotationEvent",
+        "id": "evt_01M458N6P0P9RX6ER58JN0KZ1T",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SYNY0B326SBBN7KCRAW",
+        "renames": []
+      },
+      "evt_01M458N6P0YNK7FQ12KMC9T30R": {
+        "bakedName": "@config.activationSaveEvent",
+        "curName": "@config.activationSaveEvent",
+        "id": "evt_01M458N6P0YNK7FQ12KMC9T30R",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SYNY0B326SBBN7KCRAW",
+        "renames": []
+      },
       "orb_01KXG04SYNCGV24X7FRR7TRH6N": {
         "bakedName": "SegmentRendererOrbital",
         "curName": "SegmentRendererOrbital",
@@ -80,6 +134,51 @@
         {
           "category": "interaction",
           "config": {
+            "activationSaveEvent": {
+              "default": "ACTIVATION_SAVE",
+              "description": "Event emitted when the activation prompt is saved or skipped (as `UI:<activationSaveEvent>`)",
+              "label": "Activation Save Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "annotationEvent": {
+              "default": "ANNOTATION",
+              "description": "Event emitted when a highlighted passage is clicked (as `UI:<annotationEvent>`)",
+              "label": "Annotation Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "annotations": {
+              "default": [],
+              "description": "Passages to highlight. Each `text` is matched exactly against the markdown segments, first segment whose source contains it, first occurrence inside one rendered text node (outside code); one that spans formatting is not highlighted.",
+              "items": {
+                "properties": {
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "kind": {
+                    "name": "kind",
+                    "required": true,
+                    "type": "string",
+                    "values": [
+                      "question",
+                      "note"
+                    ]
+                  },
+                  "text": {
+                    "name": "text",
+                    "required": true,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Annotations",
+              "tier": "presentation",
+              "type": "[SegmentRendererAnnotationsItem]"
+            },
             "ariaBusy": {
               "description": "This region is updating; assistive technology waits before announcing it.",
               "label": "Aria-busy",
@@ -169,6 +268,26 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "askEvent": {
+              "default": "ASK",
+              "description": "Event emitted when the reader picks Ask on selected text (as `UI:<askEvent>`)",
+              "label": "Ask Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "askLabel": {
+              "description": "Ask action label (default: translated)",
+              "label": "Ask Label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "bloomAnswerEvent": {
+              "default": "BLOOM_ANSWER",
+              "description": "Event emitted on the first reveal of a Bloom question (as `UI:<bloomAnswerEvent>`)",
+              "label": "Bloom Answer Event",
+              "tier": "presentation",
+              "type": "event"
+            },
             "className": {
               "description": "Additional CSS classes for the root container",
               "label": "Class Name",
@@ -217,6 +336,32 @@
               "tier": "presentation",
               "type": "string"
             },
+            "lesson": {
+              "description": "Raw lesson markdown with learning tags; parsed with `parseLessonSegments` and rendered",
+              "label": "Lesson",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "noteEvent": {
+              "default": "NOTE",
+              "description": "Event emitted when the reader picks Note on selected text (as `UI:<noteEvent>`)",
+              "label": "Note Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "noteLabel": {
+              "description": "Note action label (default: translated)",
+              "label": "Note Label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "reflectionSaveEvent": {
+              "default": "REFLECTION_SAVE",
+              "description": "Event emitted when a reflection note is saved (as `UI:<reflectionSaveEvent>`)",
+              "label": "Reflection Save Event",
+              "tier": "presentation",
+              "type": "event"
+            },
             "role": {
               "description": "WAI-ARIA role when the element's native semantics don't describe it.",
               "label": "Role",
@@ -307,41 +452,220 @@
               ]
             },
             "segments": {
-              "default": [
-                {
-                  "answer": "Answer",
-                  "question": "Question",
-                  "type": "quiz"
-                },
-                {
-                  "answer": "Answer 2",
-                  "question": "Question 2",
-                  "type": "quiz"
-                }
-              ],
-              "description": "Parsed lesson segments (see `parseLessonSegments`)",
+              "default": [],
+              "description": "Parsed lesson segments (see `parseLessonSegments`). Ignored when `lesson` is given.",
               "items": {
                 "properties": {
-                  "answer": {
-                    "name": "answer",
-                    "required": true,
-                    "type": "string"
+                  "SegmentRendererSegmentsItemActivate": {
+                    "name": "SegmentRendererSegmentsItemActivate",
+                    "properties": {
+                      "question": {
+                        "name": "question",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "activate"
+                        ]
+                      }
+                    },
+                    "type": "object"
                   },
-                  "question": {
-                    "name": "question",
-                    "required": true,
-                    "type": "string"
+                  "SegmentRendererSegmentsItemBloom": {
+                    "name": "SegmentRendererSegmentsItemBloom",
+                    "properties": {
+                      "answer": {
+                        "name": "answer",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "level": {
+                        "name": "level",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "remember",
+                          "understand",
+                          "apply",
+                          "analyze",
+                          "evaluate",
+                          "create"
+                        ]
+                      },
+                      "question": {
+                        "name": "question",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "bloom"
+                        ]
+                      }
+                    },
+                    "type": "object"
                   },
-                  "type": {
-                    "name": "type",
-                    "required": true,
-                    "type": "string",
-                    "values": [
-                      "quiz"
-                    ]
+                  "SegmentRendererSegmentsItemCode": {
+                    "name": "SegmentRendererSegmentsItemCode",
+                    "properties": {
+                      "content": {
+                        "name": "content",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "language": {
+                        "name": "language",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "runnable": {
+                        "name": "runnable",
+                        "required": false,
+                        "type": "boolean"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "code"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "SegmentRendererSegmentsItemConnect": {
+                    "name": "SegmentRendererSegmentsItemConnect",
+                    "properties": {
+                      "content": {
+                        "name": "content",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "connect"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "SegmentRendererSegmentsItemMarkdown": {
+                    "name": "SegmentRendererSegmentsItemMarkdown",
+                    "properties": {
+                      "content": {
+                        "name": "content",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "markdown"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "SegmentRendererSegmentsItemQuiz": {
+                    "name": "SegmentRendererSegmentsItemQuiz",
+                    "properties": {
+                      "answer": {
+                        "name": "answer",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "question": {
+                        "name": "question",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "quiz"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "SegmentRendererSegmentsItemReflect": {
+                    "name": "SegmentRendererSegmentsItemReflect",
+                    "properties": {
+                      "prompt": {
+                        "name": "prompt",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "reflect"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "SegmentRendererSegmentsItemVisualization": {
+                    "name": "SegmentRendererSegmentsItemVisualization",
+                    "properties": {
+                      "description": {
+                        "name": "description",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "visualization"
+                        ]
+                      },
+                      "visualizationType": {
+                        "name": "visualizationType",
+                        "required": true,
+                        "type": "string",
+                        "values": [
+                          "algorithms",
+                          "math",
+                          "physics",
+                          "biology",
+                          "chemistry",
+                          "probability"
+                        ]
+                      }
+                    },
+                    "type": "object"
                   }
                 },
-                "type": "object"
+                "type": "union",
+                "values": [
+                  "SegmentRendererSegmentsItemMarkdown",
+                  "SegmentRendererSegmentsItemCode",
+                  "SegmentRendererSegmentsItemQuiz",
+                  "SegmentRendererSegmentsItemActivate",
+                  "SegmentRendererSegmentsItemConnect",
+                  "SegmentRendererSegmentsItemReflect",
+                  "SegmentRendererSegmentsItemBloom",
+                  "SegmentRendererSegmentsItemVisualization"
+                ]
               },
               "label": "Segments",
               "tier": "presentation",
@@ -407,6 +731,107 @@
               "resource": "main"
             }
           ],
+          "emits": [
+            {
+              "definerKnob": "activationSaveEvent",
+              "description": "Event emitted when the activation prompt is saved or skipped (as `UI:<activationSaveEvent>`)",
+              "event": "@config.activationSaveEvent",
+              "eventId": "evt_01M458N6P0YNK7FQ12KMC9T30R",
+              "payloadSchema": [
+                {
+                  "name": "response",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "reflectionSaveEvent",
+              "description": "Event emitted when a reflection note is saved (as `UI:<reflectionSaveEvent>`)",
+              "event": "@config.reflectionSaveEvent",
+              "eventId": "evt_01M458N6P0H1AZT11P3E8H577T",
+              "payloadSchema": [
+                {
+                  "name": "index",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "note",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "bloomAnswerEvent",
+              "description": "Event emitted on the first reveal of a Bloom question (as `UI:<bloomAnswerEvent>`)",
+              "event": "@config.bloomAnswerEvent",
+              "eventId": "evt_01M458N6P0CVA84D14F7QQ70FH",
+              "payloadSchema": [
+                {
+                  "name": "index",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "level",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "askEvent",
+              "description": "Event emitted when the reader picks Ask on selected text (as `UI:<askEvent>`)",
+              "event": "@config.askEvent",
+              "eventId": "evt_01M458N6P062ZD3DSTR9K0AY43",
+              "payloadSchema": [
+                {
+                  "name": "selectedText",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "noteEvent",
+              "description": "Event emitted when the reader picks Note on selected text (as `UI:<noteEvent>`)",
+              "event": "@config.noteEvent",
+              "eventId": "evt_01M458N6P0A77V2AD2ED983CT3",
+              "payloadSchema": [
+                {
+                  "name": "selectedText",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "annotationEvent",
+              "description": "Event emitted when a highlighted passage is clicked (as `UI:<annotationEvent>`)",
+              "event": "@config.annotationEvent",
+              "eventId": "evt_01M458N6P0P9RX6ER58JN0KZ1T",
+              "payloadSchema": [
+                {
+                  "name": "annotationId",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
           "entityContract": {
             "provides": [],
             "requires": []
@@ -426,6 +851,99 @@
                 "id": "evt_01KXG04SYN6H60ZZK6J2K8AF63",
                 "key": "INIT",
                 "name": "Initialize"
+              },
+              {
+                "description": "Event emitted when the activation prompt is saved or skipped (as `UI:<activationSaveEvent>`)",
+                "id": "evt_01M458N6P0YNK7FQ12KMC9T30R",
+                "key": "@config.activationSaveEvent",
+                "name": "@config.activation save event",
+                "payloadSchema": [
+                  {
+                    "name": "response",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Event emitted when a reflection note is saved (as `UI:<reflectionSaveEvent>`)",
+                "id": "evt_01M458N6P0H1AZT11P3E8H577T",
+                "key": "@config.reflectionSaveEvent",
+                "name": "@config.reflection save event",
+                "payloadSchema": [
+                  {
+                    "name": "index",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "note",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Event emitted on the first reveal of a Bloom question (as `UI:<bloomAnswerEvent>`)",
+                "id": "evt_01M458N6P0CVA84D14F7QQ70FH",
+                "key": "@config.bloomAnswerEvent",
+                "name": "@config.bloom answer event",
+                "payloadSchema": [
+                  {
+                    "name": "index",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "level",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Event emitted when the reader picks Ask on selected text (as `UI:<askEvent>`)",
+                "id": "evt_01M458N6P062ZD3DSTR9K0AY43",
+                "key": "@config.askEvent",
+                "name": "@config.ask event",
+                "payloadSchema": [
+                  {
+                    "name": "selectedText",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Event emitted when the reader picks Note on selected text (as `UI:<noteEvent>`)",
+                "id": "evt_01M458N6P0A77V2AD2ED983CT3",
+                "key": "@config.noteEvent",
+                "name": "@config.note event",
+                "payloadSchema": [
+                  {
+                    "name": "selectedText",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Event emitted when a highlighted passage is clicked (as `UI:<annotationEvent>`)",
+                "id": "evt_01M458N6P0P9RX6ER58JN0KZ1T",
+                "key": "@config.annotationEvent",
+                "name": "@config.annotation event",
+                "payloadSchema": [
+                  {
+                    "name": "annotationId",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -441,6 +959,9 @@
                     "render-ui",
                     "main",
                     {
+                      "activationSaveEvent": "@config.activationSaveEvent",
+                      "annotationEvent": "@config.annotationEvent",
+                      "annotations": "@config.annotations",
                       "aria-busy": "@config.ariaBusy",
                       "aria-current": "@config.ariaCurrent",
                       "aria-describedby": "@config.ariaDescribedby",
@@ -451,12 +972,19 @@
                       "aria-live": "@config.ariaLive",
                       "aria-pressed": "@config.ariaPressed",
                       "aria-selected": "@config.ariaSelected",
+                      "askEvent": "@config.askEvent",
+                      "askLabel": "@config.askLabel",
+                      "bloomAnswerEvent": "@config.bloomAnswerEvent",
                       "className": "@config.className",
                       "containerClassName": "@config.containerClassName",
                       "dir": "@config.dir",
                       "enter": "@config.enter",
                       "enterDelay": "@config.enterDelay",
                       "lang": "@config.lang",
+                      "lesson": "@config.lesson",
+                      "noteEvent": "@config.noteEvent",
+                      "noteLabel": "@config.noteLabel",
+                      "reflectionSaveEvent": "@config.reflectionSaveEvent",
                       "role": "@config.role",
                       "segments": "@config.segments",
                       "skeleton": "@config.skeleton",
@@ -476,7 +1004,103 @@
         }
       ],
       "types": {
-        "SegmentRendererSegmentsItem": [
+        "SegmentRendererAnnotationsItem": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "text",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "kind",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "SegmentRendererSegmentsItemActivate": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "question",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "SegmentRendererSegmentsItemBloom": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "level",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "question",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "answer",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "SegmentRendererSegmentsItemCode": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "language",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "content",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "runnable",
+            "type": "boolean"
+          }
+        ],
+        "SegmentRendererSegmentsItemConnect": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "content",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "SegmentRendererSegmentsItemMarkdown": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "content",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "SegmentRendererSegmentsItemQuiz": [
           {
             "name": "type",
             "required": true,
@@ -493,6 +1117,35 @@
             "type": "string"
           }
         ],
+        "SegmentRendererSegmentsItemReflect": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "prompt",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "SegmentRendererSegmentsItemVisualization": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "visualizationType",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "description",
+            "required": true,
+            "type": "string"
+          }
+        ],
         "SegmentRendererUserProgress": [
           {
             "name": "activationResponse",