@almadar/std 16.252.0 → 16.254.0

package/behaviors/registry/ui/learning/atoms/std-learn-diagram.orb

@@ -1 +1 @@
-{"name":"std-learn-diagram","version":"1.0.0","description":"Generic annotated-diagram instrument. Contract: a config-declared roster of labeled parts (id, label, description, x, y, radius, color) plus optional connector links (from, to, color, label); the whole diagram renders as circles connected by lines with always-visible part labels on a biology-canvas; the learner selects a part via its choice-button and the selected part is visually emphasized with a highlight ring and enlarged radius while its description renders in a caption card alongside a \"part k of n selected\" readout; a Clear button returns to the no-selection overview state where the caption card shows a config-declared overview text. Standalone by default; behind a lab router set matchMode and it renders only when MODE_SELECTED matches.","orbitals":[{"name":"LearnDiagramOrbital","id":"orb_673HJD8BPQ5VBS9SXDWYQM3WW3","entity":{"name":"LearnDiagramScene","id":"ent_NEWW2QMCGV68DSG22T92GR4GE2","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"active","type":"boolean","default":false},{"name":"title","type":"string"},{"name":"parts","type":"array","items":{"type":"object","properties":{"radius":{"name":"radius","type":"number","required":false},"id":{"name":"id","type":"string","required":true},"description":{"name":"description","type":"string","required":false},"x":{"name":"x","type":"number","required":true},"color":{"name":"color","type":"string","required":false},"label":{"name":"label","type":"string","required":true},"y":{"name":"y","type":"number","required":true}}}},{"name":"links","type":"array","items":{"type":"object","properties":{"from":{"name":"from","type":"string","required":true},"color":{"name":"color","type":"string","required":false},"label":{"name":"label","type":"string","required":false},"to":{"name":"to","type":"string","required":true}}}},{"name":"selectedId","type":"string","default":""},{"name":"selectedIndex","type":"number","default":-1},{"name":"captionText","type":"string"},{"name":"readoutText","type":"string"},{"name":"captionChildren","type":"array","items":{"type":"node"}},{"name":"partButtons","type":"array","items":{"type":"node"}}]},"traits":[{"name":"LearnDiagramSim","id":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC","entityRebindable":true,"entityContract":{"requires":[],"provides":["active","captionChildren","captionText","links","partButtons","parts","readoutText","selectedId","selectedIndex","title"]},"effectRow":[{"kind":"emit","resource":"PART_SELECTED"},{"kind":"emit","resource":"SELECTION_CLEARED"},{"kind":"render-ui","resource":"main"},{"kind":"set","resource":"@entity.active"},{"kind":"set","resource":"@entity.captionChildren"},{"kind":"set","resource":"@entity.captionText"},{"kind":"set","resource":"@entity.links"},{"kind":"set","resource":"@entity.partButtons"},{"kind":"set","resource":"@entity.parts"},{"kind":"set","resource":"@entity.readoutText"},{"kind":"set","resource":"@entity.selectedId"},{"kind":"set","resource":"@entity.selectedIndex"},{"kind":"set","resource":"@entity.title"}],"category":"interaction","linkedEntity":"LearnDiagramScene","linkedEntityId":"ent_NEWW2QMCGV68DSG22T92GR4GE2","entityRefIds":{"LearnDiagramScene":"ent_NEWW2QMCGV68DSG22T92GR4GE2"},"emits":[{"event":"PART_SELECTED","eventId":"evt_3GH7ZB71SDGWPQP99M0BHW83VP","description":"Fires when the learner selects a part, carrying the selected part's id — a composed listener (readout, quiz) can subscribe; a harmless no-op when the atom runs standalone.","synonyms":"select, choose, part, highlight, diagram, label","tier":"domain","scope":"external","payloadSchema":[{"name":"partId","type":"string"}]},{"event":"SELECTION_CLEARED","eventId":"evt_6SZE26N5DZJPZZPSSBSG9MB5TX","description":"Fires when the learner clears the current selection and the diagram returns to its overview state; a harmless no-op when the atom runs standalone.","synonyms":"clear, deselect, reset, overview","tier":"domain","scope":"external"}],"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_005XRSCM02A01EZGRRJ2SEJKHP","name":"Initialize"},{"key":"MODE_SELECTED","id":"evt_S4GSZM9N6STKCMF7AEBBKHQMJT","name":"Mode Selected","description":"Lab router broadcast naming the active mode; this instrument renders when the mode equals matchMode, otherwise renders null.","tier":"domain","payloadSchema":[{"name":"mode","type":"string"}],"listened":true},{"key":"ROSTER_LOADED","id":"evt_C69K1RGWJKE99WRWJT26A5HJ68","name":"Roster Loaded","description":"Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone), parts is the labeled-part roster and links the connector list; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides.","tier":"domain","payloadSchema":[{"name":"mode","type":"string","required":true},{"name":"parts","type":"[object]","required":true,"properties":[{"name":"id","type":"string","required":true},{"name":"label","type":"string","required":true},{"name":"description","type":"string"},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"radius","type":"number"},{"name":"color","type":"string"}]},{"name":"links","type":"[object]","required":true,"properties":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"color","type":"string"},{"name":"label","type":"string"}]}],"listened":true},{"key":"SELECT_PART","id":"evt_MGFC1J8M41A20HGS29GD8BTT08","name":"Select Part","description":"Learner picked a part's choice-button; the matching part is highlighted on the diagram and its description surfaces in the caption card.","tier":"domain","payloadSchema":[{"name":"partId","type":"string"}],"listened":true},{"key":"CLEAR_PART","id":"evt_5RY5KVMAPA5B53VKX96A205H9F","name":"Clear Part","description":"Learner cleared the current selection, returning the diagram to its no-selection overview state.","tier":"domain","listened":true},{"key":"PART_SELECTED","id":"evt_3GH7ZB71SDGWPQP99M0BHW83VP","name":"Part Selected","description":"Fires when the learner selects a part, carrying the selected part's id — a composed listener (readout, quiz) can subscribe; a harmless no-op when the atom runs standalone.","synonyms":"select, choose, part, highlight, diagram, label","tier":"domain","payloadSchema":[{"name":"partId","type":"string"}]},{"key":"SELECTION_CLEARED","id":"evt_6SZE26N5DZJPZZPSSBSG9MB5TX","name":"Selection Cleared","description":"Fires when the learner clears the current selection and the diagram returns to its overview state; a harmless no-op when the atom runs standalone.","synonyms":"clear, deselect, reset, overview","tier":"domain"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_005XRSCM02A01EZGRRJ2SEJKHP","guard":["and",["==","@config.matchMode",""],["==","@config.rosterSource","config"]],"effects":[["set","@entity.active",true],["set","@entity.title","@config.title"],["set","@entity.parts","@config.parts"],["set","@entity.links","@config.links"],["set","@entity.selectedId",""],["set","@entity.selectedIndex",-1],["set","@entity.captionText","@config.overviewText"],["set","@entity.readoutText",""],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}]]},{"from":"idle","to":"idle","event":"MODE_SELECTED","eventId":"evt_S4GSZM9N6STKCMF7AEBBKHQMJT","guard":["and",["not",["==","@config.matchMode",""]],["not",["==","@payload.mode","@config.matchMode"]]],"effects":[["set","@entity.active",false],["render-ui","main",null]]},{"from":"idle","to":"idle","event":"MODE_SELECTED","eventId":"evt_S4GSZM9N6STKCMF7AEBBKHQMJT","guard":["and",["==","@payload.mode","@config.matchMode"],["==","@config.rosterSource","config"]],"effects":[["set","@entity.active",true],["set","@entity.title","@config.title"],["set","@entity.parts","@config.parts"],["set","@entity.links","@config.links"],["set","@entity.selectedId",""],["set","@entity.selectedIndex",-1],["set","@entity.captionText","@config.overviewText"],["set","@entity.readoutText",""],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}]]},{"from":"idle","to":"idle","event":"ROSTER_LOADED","eventId":"evt_C69K1RGWJKE99WRWJT26A5HJ68","guard":["and",["==","@config.rosterSource","event"],["and",["==","@payload.mode","@config.matchMode"],[">",["array/len","@payload.parts"],0]]],"effects":[["set","@entity.active",true],["set","@entity.title","@config.title"],["set","@entity.parts","@payload.parts"],["set","@entity.links","@payload.links"],["set","@entity.selectedId",""],["set","@entity.selectedIndex",-1],["set","@entity.captionText","@config.overviewText"],["set","@entity.readoutText",""],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}]]},{"from":"idle","to":"idle","event":"ROSTER_LOADED","eventId":"evt_C69K1RGWJKE99WRWJT26A5HJ68","guard":["and",["==","@config.rosterSource","event"],["not",["==","@payload.mode","@config.matchMode"]]],"effects":[["set","@entity.active",false],["render-ui","main",null]]},{"from":"idle","to":"idle","event":"SELECT_PART","eventId":"evt_MGFC1J8M41A20HGS29GD8BTT08","guard":["==","@entity.active",true],"effects":[["let",[["idx",["array/first",["array/filter",["array/range",["array/len","@entity.parts"]],["fn","i",["==",["object/get",["array/nth","@entity.parts","@i"],"id"],"@payload.partId"]]]]],["part",["array/nth","@entity.parts","@idx"]]],["do",["set","@entity.selectedId","@payload.partId"],["set","@entity.selectedIndex","@idx"],["set","@entity.captionText",["object/get","@part","description"]],["set","@entity.readoutText",["str/concat","Part ",["str/concat","",["+","@idx",1]]," of ",["str/concat","",["array/len","@entity.parts"]]," selected: ",["object/get","@part","label"]]]]],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}],["emit","PART_SELECTED",{"partId":"@entity.selectedId"}]]},{"from":"idle","to":"idle","event":"CLEAR_PART","eventId":"evt_5RY5KVMAPA5B53VKX96A205H9F","guard":["==","@entity.active",true],"effects":[["set","@entity.selectedId",""],["set","@entity.selectedIndex",-1],["set","@entity.captionText","@config.overviewText"],["set","@entity.readoutText",""],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}],["emit","SELECTION_CLEARED",{}]]}]},"config":{"matchMode":{"type":"string","default":"","label":"Match Mode","description":"When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT.","tier":"presentation"},"backgroundColor":{"type":"string","default":"","label":"Background Color","description":"Canvas ground. Empty uses the theme drawing ground.","tier":"presentation"},"summary":{"type":"string","default":"","label":"Concept","description":"One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line.","tier":"presentation"},"height":{"type":"number","default":400,"label":"Height","description":"Canvas height in pixels.","tier":"presentation"},"highlightColor":{"type":"string","default":"highlight","label":"Highlight Color","description":"Ring color drawn around the selected part.","tier":"presentation"},"width":{"type":"number","default":600,"label":"Width","description":"Canvas width in pixels.","tier":"presentation"},"links":{"type":"[LearnDiagramLink]","default":[{"from":"input","to":"processor","color":"guide","label":""},{"from":"processor","to":"storage","color":"guide","label":""},{"from":"processor","to":"output","color":"guide","label":""},{"from":"controller","to":"processor","color":"guide","label":""}],"label":"Links","description":"Connector lines drawn between parts, by id.","synonyms":"link, edge, connector, arrow","tier":"domain","items":{"type":"object","properties":{"from":{"name":"from","type":"string","required":true},"to":{"name":"to","type":"string","required":true},"color":{"name":"color","type":"string","required":false},"label":{"name":"label","type":"string","required":false}}}},"clearLabel":{"type":"string","default":"Clear","label":"Clear Button Label","description":"Label text for the button that clears the current selection.","tier":"presentation"},"overviewText":{"type":"string","default":"Select a part below to learn what it does.","label":"Overview Text","description":"Caption card text shown when no part is selected.","tier":"presentation"},"parts":{"type":"[LearnDiagramPart]","default":[{"id":"input","label":"Input","description":"Receives raw data or requests from the outside world and hands them to the processor.","x":120,"y":200,"radius":34,"color":"series-1"},{"id":"processor","label":"Processor","description":"The central component that transforms incoming data according to the system's rules.","x":300,"y":200,"radius":46,"color":"series-2"},{"id":"storage","label":"Storage","description":"Persists data so it can be retrieved later, even after the system restarts.","x":300,"y":320,"radius":34,"color":"series-3"},{"id":"output","label":"Output","description":"Delivers the processor's results back out to users or other systems.","x":480,"y":200,"radius":34,"color":"series-4"},{"id":"controller","label":"Controller","description":"Coordinates timing and configuration for the processor without touching the data itself.","x":300,"y":80,"radius":26,"color":"series-5"}],"label":"Parts","description":"Roster of labeled parts (id, label, description, x, y, radius, color) the diagram renders as circles; the learner selects one to see its description.","synonyms":"part, node, component, label, annotation","tier":"domain","items":{"type":"object","properties":{"x":{"name":"x","type":"number","required":true},"description":{"name":"description","type":"string","required":false},"y":{"name":"y","type":"number","required":true},"radius":{"name":"radius","type":"number","required":false},"id":{"name":"id","type":"string","required":true},"color":{"name":"color","type":"string","required":false},"label":{"name":"label","type":"string","required":true}}}},"rosterSource":{"type":"string","default":"config","label":"Roster Source","description":"Where the parts and links roster comes from: config reads the parts and links knobs at INIT; event waits for ROSTER_LOADED and takes the roster from its payload.","tier":"domain","values":["config","event"]},"title":{"type":"string","default":"System Diagram","label":"Title","description":"Title shown above the diagram.","tier":"presentation"}},"scope":"instance"}],"pages":[{"name":"LearnDiagramPage","id":"pag_562K8BCCFQ67VKTMTGECNRHSXM","path":"/learn-diagram","traits":[{"ref":"LearnDiagramSim","refId":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"}]}],"types":{"LearnDiagramLink":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"color","type":"string"},{"name":"label","type":"string"}],"LearnDiagramPart":[{"name":"id","type":"string","required":true},{"name":"label","type":"string","required":true},{"name":"description","type":"string"},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"radius","type":"number"},{"name":"color","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_NEWW2QMCGV68DSG22T92GR4GE2":{"id":"ent_NEWW2QMCGV68DSG22T92GR4GE2","kind":"entity","bakedName":"LearnDiagramScene","curName":"LearnDiagramScene","renames":[],"owner":"workspace"},"evt_005XRSCM02A01EZGRRJ2SEJKHP":{"id":"evt_005XRSCM02A01EZGRRJ2SEJKHP","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_3GH7ZB71SDGWPQP99M0BHW83VP":{"id":"evt_3GH7ZB71SDGWPQP99M0BHW83VP","kind":"event","bakedName":"PART_SELECTED","curName":"PART_SELECTED","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_5RY5KVMAPA5B53VKX96A205H9F":{"id":"evt_5RY5KVMAPA5B53VKX96A205H9F","kind":"event","bakedName":"CLEAR_PART","curName":"CLEAR_PART","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_6SZE26N5DZJPZZPSSBSG9MB5TX":{"id":"evt_6SZE26N5DZJPZZPSSBSG9MB5TX","kind":"event","bakedName":"SELECTION_CLEARED","curName":"SELECTION_CLEARED","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_C69K1RGWJKE99WRWJT26A5HJ68":{"id":"evt_C69K1RGWJKE99WRWJT26A5HJ68","kind":"event","bakedName":"ROSTER_LOADED","curName":"ROSTER_LOADED","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_MGFC1J8M41A20HGS29GD8BTT08":{"id":"evt_MGFC1J8M41A20HGS29GD8BTT08","kind":"event","bakedName":"SELECT_PART","curName":"SELECT_PART","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_S4GSZM9N6STKCMF7AEBBKHQMJT":{"id":"evt_S4GSZM9N6STKCMF7AEBBKHQMJT","kind":"event","bakedName":"MODE_SELECTED","curName":"MODE_SELECTED","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"orb_673HJD8BPQ5VBS9SXDWYQM3WW3":{"id":"orb_673HJD8BPQ5VBS9SXDWYQM3WW3","kind":"orbital","bakedName":"LearnDiagramOrbital","curName":"LearnDiagramOrbital","renames":[],"owner":"workspace"},"pag_562K8BCCFQ67VKTMTGECNRHSXM":{"id":"pag_562K8BCCFQ67VKTMTGECNRHSXM","kind":"page","bakedName":"LearnDiagramPage","curName":"LearnDiagramPage","renames":[],"owner":"workspace"},"trt_6AY5PFV55WJJY9ERA3N8J9NWBC":{"id":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC","kind":"trait","bakedName":"LearnDiagramSim","curName":"LearnDiagramSim","renames":[],"owner":"workspace"}}}}
+{"name":"std-learn-diagram","version":"1.0.0","description":"Generic annotated-diagram instrument. Contract: a config-declared roster of labeled parts (id, label, description, x, y, radius, color) plus optional connector links (from, to, color, label); the whole diagram renders as circles connected by lines with always-visible part labels on a biology-canvas; the learner selects a part via its choice-button and the selected part is visually emphasized with a highlight ring and enlarged radius while its description renders in a caption card alongside a \"part k of n selected\" readout; a Clear button returns to the no-selection overview state where the caption card shows a config-declared overview text. Standalone by default; behind a lab router set matchMode and it renders only when MODE_SELECTED matches.","orbitals":[{"name":"LearnDiagramOrbital","id":"orb_673HJD8BPQ5VBS9SXDWYQM3WW3","entity":{"name":"LearnDiagramScene","id":"ent_NEWW2QMCGV68DSG22T92GR4GE2","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"active","type":"boolean","default":false},{"name":"title","type":"string"},{"name":"parts","type":"array","items":{"type":"object","properties":{"label":{"name":"label","type":"string","required":true},"x":{"name":"x","type":"number","required":true},"color":{"name":"color","type":"string","required":false},"radius":{"name":"radius","type":"number","required":false},"id":{"name":"id","type":"string","required":true},"description":{"name":"description","type":"string","required":false},"y":{"name":"y","type":"number","required":true}}}},{"name":"links","type":"array","items":{"type":"object","properties":{"label":{"name":"label","type":"string","required":false},"from":{"name":"from","type":"string","required":true},"to":{"name":"to","type":"string","required":true},"color":{"name":"color","type":"string","required":false}}}},{"name":"selectedId","type":"string","default":""},{"name":"selectedIndex","type":"number","default":-1},{"name":"captionText","type":"string"},{"name":"readoutText","type":"string"},{"name":"captionChildren","type":"array","items":{"type":"node"}},{"name":"partButtons","type":"array","items":{"type":"node"}}]},"traits":[{"name":"LearnDiagramSim","id":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC","entityRebindable":true,"entityContract":{"requires":[],"provides":["active","captionChildren","captionText","links","partButtons","parts","readoutText","selectedId","selectedIndex","title"]},"effectRow":[{"kind":"emit","resource":"PART_SELECTED"},{"kind":"emit","resource":"SELECTION_CLEARED"},{"kind":"render-ui","resource":"main"},{"kind":"set","resource":"@entity.active"},{"kind":"set","resource":"@entity.captionChildren"},{"kind":"set","resource":"@entity.captionText"},{"kind":"set","resource":"@entity.links"},{"kind":"set","resource":"@entity.partButtons"},{"kind":"set","resource":"@entity.parts"},{"kind":"set","resource":"@entity.readoutText"},{"kind":"set","resource":"@entity.selectedId"},{"kind":"set","resource":"@entity.selectedIndex"},{"kind":"set","resource":"@entity.title"}],"category":"interaction","linkedEntity":"LearnDiagramScene","linkedEntityId":"ent_NEWW2QMCGV68DSG22T92GR4GE2","entityRefIds":{"LearnDiagramScene":"ent_NEWW2QMCGV68DSG22T92GR4GE2"},"emits":[{"event":"PART_SELECTED","eventId":"evt_3GH7ZB71SDGWPQP99M0BHW83VP","description":"Fires when the learner selects a part, carrying the selected part's id — a composed listener (readout, quiz) can subscribe; a harmless no-op when the atom runs standalone.","synonyms":"select, choose, part, highlight, diagram, label","tier":"domain","scope":"external","payloadSchema":[{"name":"partId","type":"string"}]},{"event":"SELECTION_CLEARED","eventId":"evt_6SZE26N5DZJPZZPSSBSG9MB5TX","description":"Fires when the learner clears the current selection and the diagram returns to its overview state; a harmless no-op when the atom runs standalone.","synonyms":"clear, deselect, reset, overview","tier":"domain","scope":"external"}],"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_005XRSCM02A01EZGRRJ2SEJKHP","name":"Initialize"},{"key":"MODE_SELECTED","id":"evt_S4GSZM9N6STKCMF7AEBBKHQMJT","name":"Mode Selected","description":"Lab router broadcast naming the active mode; this instrument renders when the mode equals matchMode, otherwise renders null.","tier":"domain","payloadSchema":[{"name":"mode","type":"string"}],"listened":true},{"key":"ROSTER_LOADED","id":"evt_C69K1RGWJKE99WRWJT26A5HJ68","name":"Roster Loaded","description":"Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone), parts is the labeled-part roster and links the connector list; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides.","tier":"domain","payloadSchema":[{"name":"mode","type":"string","required":true},{"name":"parts","type":"[object]","required":true,"properties":[{"name":"id","type":"string","required":true},{"name":"label","type":"string","required":true},{"name":"description","type":"string"},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"radius","type":"number"},{"name":"color","type":"string"}]},{"name":"links","type":"[object]","required":true,"properties":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"color","type":"string"},{"name":"label","type":"string"}]}],"listened":true},{"key":"SELECT_PART","id":"evt_MGFC1J8M41A20HGS29GD8BTT08","name":"Select Part","description":"Learner picked a part's choice-button; the matching part is highlighted on the diagram and its description surfaces in the caption card.","tier":"domain","payloadSchema":[{"name":"partId","type":"string"}],"listened":true},{"key":"CLEAR_PART","id":"evt_5RY5KVMAPA5B53VKX96A205H9F","name":"Clear Part","description":"Learner cleared the current selection, returning the diagram to its no-selection overview state.","tier":"domain","listened":true},{"key":"PART_SELECTED","id":"evt_3GH7ZB71SDGWPQP99M0BHW83VP","name":"Part Selected","description":"Fires when the learner selects a part, carrying the selected part's id — a composed listener (readout, quiz) can subscribe; a harmless no-op when the atom runs standalone.","synonyms":"select, choose, part, highlight, diagram, label","tier":"domain","payloadSchema":[{"name":"partId","type":"string"}]},{"key":"SELECTION_CLEARED","id":"evt_6SZE26N5DZJPZZPSSBSG9MB5TX","name":"Selection Cleared","description":"Fires when the learner clears the current selection and the diagram returns to its overview state; a harmless no-op when the atom runs standalone.","synonyms":"clear, deselect, reset, overview","tier":"domain"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_005XRSCM02A01EZGRRJ2SEJKHP","guard":["and",["==","@config.matchMode",""],["==","@config.rosterSource","config"]],"effects":[["set","@entity.active",true],["set","@entity.title","@config.title"],["set","@entity.parts","@config.parts"],["set","@entity.links","@config.links"],["set","@entity.selectedId",""],["set","@entity.selectedIndex",-1],["set","@entity.captionText","@config.overviewText"],["set","@entity.readoutText",""],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}]]},{"from":"idle","to":"idle","event":"MODE_SELECTED","eventId":"evt_S4GSZM9N6STKCMF7AEBBKHQMJT","guard":["and",["not",["==","@config.matchMode",""]],["not",["==","@payload.mode","@config.matchMode"]]],"effects":[["set","@entity.active",false],["render-ui","main",null]]},{"from":"idle","to":"idle","event":"MODE_SELECTED","eventId":"evt_S4GSZM9N6STKCMF7AEBBKHQMJT","guard":["and",["==","@payload.mode","@config.matchMode"],["==","@config.rosterSource","config"]],"effects":[["set","@entity.active",true],["set","@entity.title","@config.title"],["set","@entity.parts","@config.parts"],["set","@entity.links","@config.links"],["set","@entity.selectedId",""],["set","@entity.selectedIndex",-1],["set","@entity.captionText","@config.overviewText"],["set","@entity.readoutText",""],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}]]},{"from":"idle","to":"idle","event":"ROSTER_LOADED","eventId":"evt_C69K1RGWJKE99WRWJT26A5HJ68","guard":["and",["==","@config.rosterSource","event"],["and",["==","@payload.mode","@config.matchMode"],[">",["array/len","@payload.parts"],0]]],"effects":[["set","@entity.active",true],["set","@entity.title","@config.title"],["set","@entity.parts","@payload.parts"],["set","@entity.links","@payload.links"],["set","@entity.selectedId",""],["set","@entity.selectedIndex",-1],["set","@entity.captionText","@config.overviewText"],["set","@entity.readoutText",""],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}]]},{"from":"idle","to":"idle","event":"ROSTER_LOADED","eventId":"evt_C69K1RGWJKE99WRWJT26A5HJ68","guard":["and",["==","@config.rosterSource","event"],["not",["==","@payload.mode","@config.matchMode"]]],"effects":[["set","@entity.active",false],["render-ui","main",null]]},{"from":"idle","to":"idle","event":"SELECT_PART","eventId":"evt_MGFC1J8M41A20HGS29GD8BTT08","guard":["==","@entity.active",true],"effects":[["let",[["idx",["array/first",["array/filter",["array/range",["array/len","@entity.parts"]],["fn","i",["==",["object/get",["array/nth","@entity.parts","@i"],"id"],"@payload.partId"]]]]],["part",["array/nth","@entity.parts","@idx"]]],["do",["set","@entity.selectedId","@payload.partId"],["set","@entity.selectedIndex","@idx"],["set","@entity.captionText",["object/get","@part","description"]],["set","@entity.readoutText",["str/concat","Part ",["str/concat","",["+","@idx",1]]," of ",["str/concat","",["array/len","@entity.parts"]]," selected: ",["object/get","@part","label"]]]]],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}],["emit","PART_SELECTED",{"partId":"@entity.selectedId"}]]},{"from":"idle","to":"idle","event":"CLEAR_PART","eventId":"evt_5RY5KVMAPA5B53VKX96A205H9F","guard":["==","@entity.active",true],"effects":[["set","@entity.selectedId",""],["set","@entity.selectedIndex",-1],["set","@entity.captionText","@config.overviewText"],["set","@entity.readoutText",""],["let",[["buttons",["array/map","@entity.parts",["fn","p",{"type":"button","action":"SELECT_PART","actionPayload":{"partId":["object/get","@p","id"]},"label":["object/get","@p","label"],"variant":["if",["==","@entity.selectedId",["object/get","@p","id"]],"primary","secondary"],"size":"sm"}]]],["clearButton",{"type":"button","action":"CLEAR_PART","label":"@config.clearLabel","variant":"ghost","size":"sm"}]],["do",["set","@entity.partButtons",["array/append","@buttons","@clearButton"]],["set","@entity.captionChildren",["if",["!=","@entity.readoutText",""],[{"type":"typography","variant":"caption","color":"muted","content":"@entity.readoutText"},{"type":"typography","variant":"body","content":"@entity.captionText"}],[{"type":"typography","variant":"body","content":"@entity.captionText"}]]]]],["render-ui","main",{"type":"box","padding":"md","children":[{"type":"stack","direction":"vertical","gap":"md","children":[{"type":"stack","direction":"horizontal","justify":"between","align":"start","gap":"md","children":[{"type":"stack","direction":"vertical","gap":"xs","children":[{"type":"typography","variant":"h4","content":"@entity.title"},["if",["==","@config.summary",""],null,{"type":"typography","variant":"body2","color":"muted","content":"@config.summary"}]]},{"type":"badge","label":["if",["==","@entity.selectedId",""],"Overview",["str/concat","Part ",["str/concat","",["+","@entity.selectedIndex",1]]," of ",["str/concat","",["array/len","@entity.parts"]]]],"variant":["if",["==","@entity.selectedId",""],"neutral","primary"]}]},{"type":"stack","direction":"horizontal","align":"center","gap":"xs","wrap":true,"children":"@entity.partButtons"},{"type":"biology-canvas","width":"@config.width","height":"@config.height","backgroundColor":"@config.backgroundColor","nodes":["array/map","@entity.parts",["fn","p",{"id":["object/get","@p","id"],"x":["object/get","@p","x"],"y":["object/get","@p","y"],"radius":["if",["==",["object/get","@p","id"],"@entity.selectedId"],["*",["object/get","@p","radius"],1.4],["object/get","@p","radius"]],"color":["object/get","@p","color"],"label":["object/get","@p","label"]}]],"edges":"@entity.links","shapes":["if",["==","@entity.selectedId",""],[],[{"type":"circle","x":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"x"],"y":["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"y"],"radius":["+",["object/get",["array/nth","@entity.parts","@entity.selectedIndex"],"radius"],10],"color":"@config.highlightColor","stroke":"bold"}]]},{"type":"card","variant":"bordered","padding":"md","children":"@entity.captionChildren"}]}]}],["emit","SELECTION_CLEARED",{}]]}]},"config":{"rosterSource":{"type":"string","default":"config","label":"Roster Source","description":"Where the parts and links roster comes from: config reads the parts and links knobs at INIT; event waits for ROSTER_LOADED and takes the roster from its payload.","tier":"domain","values":["config","event"]},"title":{"type":"string","default":"System Diagram","label":"Title","description":"Title shown above the diagram.","tier":"presentation"},"highlightColor":{"type":"string","default":"highlight","label":"Highlight Color","description":"Ring color drawn around the selected part.","tier":"presentation"},"clearLabel":{"type":"string","default":"Clear","label":"Clear Button Label","description":"Label text for the button that clears the current selection.","tier":"presentation"},"overviewText":{"type":"string","default":"Select a part below to learn what it does.","label":"Overview Text","description":"Caption card text shown when no part is selected.","tier":"presentation"},"summary":{"type":"string","default":"","label":"Concept","description":"One line under the title saying what the learner is looking at (keep it under ~65 characters). Empty shows no line.","tier":"presentation"},"matchMode":{"type":"string","default":"","label":"Match Mode","description":"When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT.","tier":"presentation"},"height":{"type":"number","default":400,"label":"Height","description":"Canvas height in pixels.","tier":"presentation"},"links":{"type":"[LearnDiagramLink]","default":[{"from":"input","to":"processor","color":"guide","label":""},{"from":"processor","to":"storage","color":"guide","label":""},{"from":"processor","to":"output","color":"guide","label":""},{"from":"controller","to":"processor","color":"guide","label":""}],"label":"Links","description":"Connector lines drawn between parts, by id.","synonyms":"link, edge, connector, arrow","tier":"domain","items":{"type":"object","properties":{"color":{"name":"color","type":"string","required":false},"from":{"name":"from","type":"string","required":true},"to":{"name":"to","type":"string","required":true},"label":{"name":"label","type":"string","required":false}}}},"backgroundColor":{"type":"string","default":"","label":"Background Color","description":"Canvas ground. Empty uses the theme drawing ground.","tier":"presentation"},"parts":{"type":"[LearnDiagramPart]","default":[{"id":"input","label":"Input","description":"Receives raw data or requests from the outside world and hands them to the processor.","x":120,"y":200,"radius":34,"color":"series-1"},{"id":"processor","label":"Processor","description":"The central component that transforms incoming data according to the system's rules.","x":300,"y":200,"radius":46,"color":"series-2"},{"id":"storage","label":"Storage","description":"Persists data so it can be retrieved later, even after the system restarts.","x":300,"y":320,"radius":34,"color":"series-3"},{"id":"output","label":"Output","description":"Delivers the processor's results back out to users or other systems.","x":480,"y":200,"radius":34,"color":"series-4"},{"id":"controller","label":"Controller","description":"Coordinates timing and configuration for the processor without touching the data itself.","x":300,"y":80,"radius":26,"color":"series-5"}],"label":"Parts","description":"Roster of labeled parts (id, label, description, x, y, radius, color) the diagram renders as circles; the learner selects one to see its description.","synonyms":"part, node, component, label, annotation","tier":"domain","items":{"type":"object","properties":{"description":{"name":"description","type":"string","required":false},"radius":{"name":"radius","type":"number","required":false},"y":{"name":"y","type":"number","required":true},"label":{"name":"label","type":"string","required":true},"x":{"name":"x","type":"number","required":true},"color":{"name":"color","type":"string","required":false},"id":{"name":"id","type":"string","required":true}}}},"width":{"type":"number","default":600,"label":"Width","description":"Canvas width in pixels.","tier":"presentation"}},"scope":"instance"}],"pages":[{"name":"LearnDiagramPage","id":"pag_562K8BCCFQ67VKTMTGECNRHSXM","path":"/learn-diagram","traits":[{"ref":"LearnDiagramSim","refId":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"}]}],"types":{"LearnDiagramLink":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"color","type":"string"},{"name":"label","type":"string"}],"LearnDiagramPart":[{"name":"id","type":"string","required":true},{"name":"label","type":"string","required":true},{"name":"description","type":"string"},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"radius","type":"number"},{"name":"color","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_NEWW2QMCGV68DSG22T92GR4GE2":{"id":"ent_NEWW2QMCGV68DSG22T92GR4GE2","kind":"entity","bakedName":"LearnDiagramScene","curName":"LearnDiagramScene","renames":[],"owner":"workspace"},"evt_005XRSCM02A01EZGRRJ2SEJKHP":{"id":"evt_005XRSCM02A01EZGRRJ2SEJKHP","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_3GH7ZB71SDGWPQP99M0BHW83VP":{"id":"evt_3GH7ZB71SDGWPQP99M0BHW83VP","kind":"event","bakedName":"PART_SELECTED","curName":"PART_SELECTED","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_5RY5KVMAPA5B53VKX96A205H9F":{"id":"evt_5RY5KVMAPA5B53VKX96A205H9F","kind":"event","bakedName":"CLEAR_PART","curName":"CLEAR_PART","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_6SZE26N5DZJPZZPSSBSG9MB5TX":{"id":"evt_6SZE26N5DZJPZZPSSBSG9MB5TX","kind":"event","bakedName":"SELECTION_CLEARED","curName":"SELECTION_CLEARED","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_C69K1RGWJKE99WRWJT26A5HJ68":{"id":"evt_C69K1RGWJKE99WRWJT26A5HJ68","kind":"event","bakedName":"ROSTER_LOADED","curName":"ROSTER_LOADED","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_MGFC1J8M41A20HGS29GD8BTT08":{"id":"evt_MGFC1J8M41A20HGS29GD8BTT08","kind":"event","bakedName":"SELECT_PART","curName":"SELECT_PART","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"evt_S4GSZM9N6STKCMF7AEBBKHQMJT":{"id":"evt_S4GSZM9N6STKCMF7AEBBKHQMJT","kind":"event","bakedName":"MODE_SELECTED","curName":"MODE_SELECTED","renames":[],"owner":"workspace","parent":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC"},"orb_673HJD8BPQ5VBS9SXDWYQM3WW3":{"id":"orb_673HJD8BPQ5VBS9SXDWYQM3WW3","kind":"orbital","bakedName":"LearnDiagramOrbital","curName":"LearnDiagramOrbital","renames":[],"owner":"workspace"},"pag_562K8BCCFQ67VKTMTGECNRHSXM":{"id":"pag_562K8BCCFQ67VKTMTGECNRHSXM","kind":"page","bakedName":"LearnDiagramPage","curName":"LearnDiagramPage","renames":[],"owner":"workspace"},"trt_6AY5PFV55WJJY9ERA3N8J9NWBC":{"id":"trt_6AY5PFV55WJJY9ERA3N8J9NWBC","kind":"trait","bakedName":"LearnDiagramSim","curName":"LearnDiagramSim","renames":[],"owner":"workspace"}}}}