@almadar/std 16.252.0 → 16.254.0

package/behaviors/registry/ui/game/atoms/std-tutorial-overlay.orb

@@ -1 +1 @@
-{"name":"std-tutorial-overlay","version":"1.0.0","description":"Tutorial modal with live-demo steps for game boards and learning shells: a paged overlay — title, a live previewTrait frame playing the mechanic via std-tutorial-autodemo (a bare game canvas, no shell chrome), one line of body copy, a step counter, and Back / Next / Skip — composed entirely from registered render types (stack + text + button + trait frame) into the overlay slot, so no new UI component is needed. autoShow opens it on INIT for first-time players; a board's help button re-opens it any time via SHOW (which rewinds to step one). DISMISS (or finishing the last step) marks the run done, clears the overlay, and emits TUTORIAL_DONE so the board can unpause or log. Steps are pure config — a board teaches a new mechanic by adding one { id, title, body, demoId } row plus a previewTrait binding. Corresponds to the design-sheet field(s): feedback, agency.","orbitals":[{"name":"TutorialOverlayOrbital","id":"orb_085MM211YGGZ85MSQP4W89Y5GJ","entity":{"name":"TutorialState","id":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"step","type":"number","default":0},{"name":"done","type":"boolean","default":false}],"shared":true},"traits":[{"name":"TutorialEmptyPreview","id":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1","effectRow":[{"kind":"render-ui","resource":"overlay"}],"category":"interaction","linkedEntity":"TutorialState","linkedEntityId":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777","entityRefIds":{"TutorialState":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777"},"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_731AWVE8JZ49FXG6HR4TA84TYC","name":"Initialize"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_731AWVE8JZ49FXG6HR4TA84TYC","effects":[["render-ui","overlay",null]]}]},"scope":"instance"},{"name":"TutorialOverlay","id":"trt_20MF6XNRMCWA6DA4388Z4T08RD","entityRebindable":true,"entityContract":{"requires":[],"provides":["done","step"]},"effectRow":[{"kind":"emit","resource":"TUTORIAL_DEMO_START"},{"kind":"emit","resource":"TUTORIAL_DEMO_STOP"},{"kind":"emit","resource":"TUTORIAL_DONE"},{"kind":"emit","resource":"TUT_AUTO"},{"kind":"render-ui","resource":"overlay"},{"kind":"set","resource":"@entity.done"},{"kind":"set","resource":"@entity.step"}],"category":"interaction","linkedEntity":"TutorialState","linkedEntityId":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777","entityRefIds":{"TutorialState":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777"},"traitEmbedIds":{"TutorialEmptyPreview":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1"},"emits":[{"event":"TUT_AUTO","eventId":"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ","description":"Self-emitted on INIT when autoShow is on — opens step one. (A config-valued INIT guard would be constant-folded at compose time and misfire; the self-event keeps the decision in an effect.)","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"TUT_NEXT","eventId":"evt_TE7R4RNCXJPES62AZE67CT414J","description":"Advance one step; on the last step it finishes the tutorial (marks done, clears the overlay, emits TUTORIAL_DONE).","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"TUT_BACK","eventId":"evt_9T896GBWF7Y7KJDX8D0AVMDMT3","description":"Return one step (inert on the first).","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"TUT_DISMISS","eventId":"evt_HY867DXMHWT8Y4FF2PRWKT53T3","description":"Skip/close the tutorial; marks done and clears the overlay.","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"SHOW","eventId":"evt_1XBH8PA48J24956KS2VQZ16Q33","description":"Re-open the tutorial from step one — wire a board's help button here.","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"TUTORIAL_DONE","eventId":"evt_A15T659SSMWWT9JY1RM0NKST6H","description":"The tutorial was finished or skipped; boards unpause or log completion.","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true}]},{"event":"TUTORIAL_DEMO_START","eventId":"evt_KJ898NHRF4W7J29JM86XJXD889","description":"Emitted when a tutorial step carrying a demoId is shown; the composed std-tutorial-autodemo atom plays that scripted demo.","tier":"domain","scope":"external","payloadSchema":[{"name":"demoId","type":"string","required":true}]},{"event":"TUTORIAL_DEMO_STOP","eventId":"evt_4DMT9YE5QK2VSVM2QCZMXCDNGH","description":"Emitted when the tutorial leaves a demo step (next/back) or is dismissed/finished; the autodemo atom stops and releases control.","tier":"domain","scope":"external"}],"stateMachine":{"states":[{"name":"hidden","isInitial":true},{"name":"showing"}],"events":[{"key":"INIT","id":"evt_4QX6A3R5WW2YED1FFE0392DTN0","name":"Initialize"},{"key":"TUT_AUTO","id":"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ","name":"Tut Auto","description":"Self-emitted on INIT when autoShow is on — opens step one. (A config-valued INIT guard would be constant-folded at compose time and misfire; the self-event keeps the decision in an effect.)","tier":"essential","payloadSchema":[{"name":"id","type":"string"}]},{"key":"SHOW","id":"evt_1XBH8PA48J24956KS2VQZ16Q33","name":"Show","description":"Re-open the tutorial from step one — wire a board's help button here.","tier":"essential","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"TUT_NEXT","id":"evt_TE7R4RNCXJPES62AZE67CT414J","name":"Tut Next","description":"Advance one step; on the last step it finishes the tutorial (marks done, clears the overlay, emits TUTORIAL_DONE).","tier":"essential","payloadSchema":[{"name":"id","type":"string"}]},{"key":"TUT_BACK","id":"evt_9T896GBWF7Y7KJDX8D0AVMDMT3","name":"Tut Back","description":"Return one step (inert on the first).","tier":"essential","payloadSchema":[{"name":"id","type":"string"}]},{"key":"TUT_DISMISS","id":"evt_HY867DXMHWT8Y4FF2PRWKT53T3","name":"Tut Dismiss","description":"Skip/close the tutorial; marks done and clears the overlay.","tier":"essential","payloadSchema":[{"name":"id","type":"string"}]},{"key":"CLOSE","id":"evt_MK5VA67F9ZQMZK2KM8HDHNJNHF","name":"Close"},{"key":"TUTORIAL_DONE","id":"evt_A15T659SSMWWT9JY1RM0NKST6H","name":"Tutorial Done","description":"The tutorial was finished or skipped; boards unpause or log completion.","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true}]},{"key":"TUTORIAL_DEMO_START","id":"evt_KJ898NHRF4W7J29JM86XJXD889","name":"Tutorial Demo Start","description":"Emitted when a tutorial step carrying a demoId is shown; the composed std-tutorial-autodemo atom plays that scripted demo.","tier":"domain","payloadSchema":[{"name":"demoId","type":"string","required":true}]},{"key":"TUTORIAL_DEMO_STOP","id":"evt_4DMT9YE5QK2VSVM2QCZMXCDNGH","name":"Tutorial Demo Stop","description":"Emitted when the tutorial leaves a demo step (next/back) or is dismissed/finished; the autodemo atom stops and releases control.","tier":"domain"}],"transitions":[{"from":"hidden","to":"hidden","event":"INIT","eventId":"evt_4QX6A3R5WW2YED1FFE0392DTN0","effects":[["if","@config.autoShow",["emit","TUT_AUTO",{"id":"auto"}],["render-ui","overlay",null]]]},{"from":"hidden","to":"showing","event":"TUT_AUTO","eventId":"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ","guard":"@config.autoShow","effects":[["set","@entity.step",0],["render-ui","overlay",{"type":"stack","direction":"vertical","className":"bg-card text-card-foreground border border-border rounded-lg shadow-lg p-6 max-w-md mx-auto mt-16","children":[{"type":"typography","content":["object/get",["array/nth","@config.steps",0],"title"],"variant":"h4","weight":"bold"},"@config.previewTrait",{"type":"typography","content":["object/get",["array/nth","@config.steps",0],"body"],"variant":"body"},{"type":"typography","content":["str/concat","1 / ",["array/len","@config.steps"]],"variant":"caption","align":"center"},{"type":"stack","direction":"horizontal","justify":"center","className":"pt-2","children":[{"type":"button","label":["if",[">",["array/len","@config.steps"],1],"Next ▶","Got it"],"action":"TUT_NEXT","variant":"primary"},{"type":"button","label":"Skip","action":"TUT_DISMISS","variant":"secondary"}]}]}],["when",["!=",["object/get",["array/nth","@config.steps",0],"demoId",""],""],["do",["emit","TUTORIAL_DEMO_START",{"demoId":["object/get",["array/nth","@config.steps",0],"demoId",""]}]]]]},{"from":"hidden","to":"showing","event":"SHOW","eventId":"evt_1XBH8PA48J24956KS2VQZ16Q33","effects":[["set","@entity.step",0],["render-ui","overlay",{"type":"stack","direction":"vertical","className":"bg-card text-card-foreground border border-border rounded-lg shadow-lg p-6 max-w-md mx-auto mt-16","children":[{"type":"typography","content":["object/get",["array/nth","@config.steps",0],"title"],"variant":"h4","weight":"bold"},"@config.previewTrait",{"type":"typography","content":["object/get",["array/nth","@config.steps",0],"body"],"variant":"body"},{"type":"typography","content":["str/concat","1 / ",["array/len","@config.steps"]],"variant":"caption","align":"center"},{"type":"stack","direction":"horizontal","justify":"center","className":"pt-2","children":[{"type":"button","label":["if",[">",["array/len","@config.steps"],1],"Next ▶","Got it"],"action":"TUT_NEXT","variant":"primary"},{"type":"button","label":"Skip","action":"TUT_DISMISS","variant":"secondary"}]}]}],["when",["!=",["object/get",["array/nth","@config.steps",0],"demoId",""],""],["do",["emit","TUTORIAL_DEMO_START",{"demoId":["object/get",["array/nth","@config.steps",0],"demoId",""]}]]]]},{"from":"showing","to":"hidden","event":"INIT","eventId":"evt_4QX6A3R5WW2YED1FFE0392DTN0","effects":[["render-ui","overlay",null],["if","@config.autoShow",["emit","TUT_AUTO",{"id":"auto"}],["render-ui","overlay",null]]]},{"from":"showing","to":"showing","event":"TUT_NEXT","eventId":"evt_TE7R4RNCXJPES62AZE67CT414J","guard":["<",["+","@entity.step",1],["array/len","@config.steps"]],"effects":[["set","@entity.step",["+","@entity.step",1]],["render-ui","overlay",{"type":"stack","direction":"vertical","className":"bg-card text-card-foreground border border-border rounded-lg shadow-lg p-6 max-w-md mx-auto mt-16","children":[{"type":"typography","content":["object/get",["array/nth","@config.steps","@entity.step"],"title"],"variant":"h4","weight":"bold"},"@config.previewTrait",{"type":"typography","content":["object/get",["array/nth","@config.steps","@entity.step"],"body"],"variant":"body"},{"type":"typography","content":["str/concat",["+","@entity.step",1]," / ",["array/len","@config.steps"]],"variant":"caption","align":"center"},{"type":"stack","direction":"horizontal","justify":"center","className":"pt-2","children":[{"type":"button","label":"◀ Back","action":"TUT_BACK","variant":"secondary"},{"type":"button","label":["if",["<",["+","@entity.step",1],["array/len","@config.steps"]],"Next ▶","Got it"],"action":"TUT_NEXT","variant":"primary"},{"type":"button","label":"Skip","action":"TUT_DISMISS","variant":"secondary"}]}]}],["emit","TUTORIAL_DEMO_STOP",{}],["when",["!=",["object/get",["array/nth","@config.steps","@entity.step"],"demoId",""],""],["do",["emit","TUTORIAL_DEMO_START",{"demoId":["object/get",["array/nth","@config.steps","@entity.step"],"demoId",""]}]]]]},{"from":"showing","to":"hidden","event":"TUT_NEXT","eventId":"evt_TE7R4RNCXJPES62AZE67CT414J","guard":[">=",["+","@entity.step",1],["array/len","@config.steps"]],"effects":[["set","@entity.done",true],["render-ui","overlay",null],["emit","TUTORIAL_DEMO_STOP",{}],["emit","TUTORIAL_DONE",{"id":"tutorial"}]]},{"from":"showing","to":"showing","event":"TUT_BACK","eventId":"evt_9T896GBWF7Y7KJDX8D0AVMDMT3","guard":[">","@entity.step",0],"effects":[["set","@entity.step",["-","@entity.step",1]],["render-ui","overlay",{"type":"stack","direction":"vertical","className":"bg-card text-card-foreground border border-border rounded-lg shadow-lg p-6 max-w-md mx-auto mt-16","children":[{"type":"typography","content":["object/get",["array/nth","@config.steps","@entity.step"],"title"],"variant":"h4","weight":"bold"},"@config.previewTrait",{"type":"typography","content":["object/get",["array/nth","@config.steps","@entity.step"],"body"],"variant":"body"},{"type":"typography","content":["str/concat",["+","@entity.step",1]," / ",["array/len","@config.steps"]],"variant":"caption","align":"center"},{"type":"stack","direction":"horizontal","justify":"center","className":"pt-2","children":[{"type":"button","label":"◀ Back","action":"TUT_BACK","variant":"secondary"},{"type":"button","label":["if",["<",["+","@entity.step",1],["array/len","@config.steps"]],"Next ▶","Got it"],"action":"TUT_NEXT","variant":"primary"},{"type":"button","label":"Skip","action":"TUT_DISMISS","variant":"secondary"}]}]}],["emit","TUTORIAL_DEMO_STOP",{}],["when",["!=",["object/get",["array/nth","@config.steps","@entity.step"],"demoId",""],""],["do",["emit","TUTORIAL_DEMO_START",{"demoId":["object/get",["array/nth","@config.steps","@entity.step"],"demoId",""]}]]]]},{"from":"showing","to":"hidden","event":"TUT_DISMISS","eventId":"evt_HY867DXMHWT8Y4FF2PRWKT53T3","effects":[["set","@entity.done",true],["render-ui","overlay",null],["emit","TUTORIAL_DEMO_STOP",{}],["emit","TUTORIAL_DONE",{"id":"tutorial"}]]},{"from":"showing","to":"hidden","event":"CLOSE","eventId":"evt_MK5VA67F9ZQMZK2KM8HDHNJNHF","effects":[["set","@entity.done",true],["render-ui","overlay",null],["emit","TUTORIAL_DEMO_STOP",{}],["emit","TUTORIAL_DONE",{"id":"tutorial"}]]}]},"config":{"autoShow":{"type":"boolean","default":true,"label":"Auto Show","description":"When true the tutorial opens on INIT for this run; when false it stays hidden until SHOW.","tier":"domain"},"steps":{"type":"[TutorialStep]","default":[],"label":"Steps","description":"One row per tutorial page: title, one line of body copy, and an optional demoId that plays a scripted live demo (std-tutorial-autodemo) for the mechanic being taught.","tier":"presentation","items":{"type":"object","properties":{"demoId":{"name":"demoId","type":"string","required":false},"title":{"name":"title","type":"string","required":true},"id":{"name":"id","type":"string","required":true},"body":{"name":"body","type":"string","required":false}}}},"previewTrait":{"type":"trait","default":"@trait.TutorialEmptyPreview","label":"Preview trait","description":"Trait rendered in the media position of the modal — the live, demo-driven preview of the mechanic (a bare game canvas, no shell chrome). '@trait.TutorialEmptyPreview' leaves the slot blank. Override with '@trait.<TraitName>' to show a board's live frame.","tier":"presentation","refId":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1"}},"scope":"instance"}],"pages":[{"name":"TutorialOverlayPage","id":"pag_YF62W6VNSWTWY9WJQQK5MFC0V8","path":"/tutorial-overlay","traits":[{"ref":"TutorialOverlay","refId":"trt_20MF6XNRMCWA6DA4388Z4T08RD"}]}],"types":{"TutorialStep":[{"name":"id","type":"string","required":true},{"name":"title","type":"string","required":true},{"name":"body","type":"string"},{"name":"demoId","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_RC0QKPBQ4NVJAPR5XCY7PAN777":{"id":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777","kind":"entity","bakedName":"TutorialState","curName":"TutorialState","renames":[],"owner":"workspace"},"evt_1XBH8PA48J24956KS2VQZ16Q33":{"id":"evt_1XBH8PA48J24956KS2VQZ16Q33","kind":"event","bakedName":"SHOW","curName":"SHOW","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_4DMT9YE5QK2VSVM2QCZMXCDNGH":{"id":"evt_4DMT9YE5QK2VSVM2QCZMXCDNGH","kind":"event","bakedName":"TUTORIAL_DEMO_STOP","curName":"TUTORIAL_DEMO_STOP","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_4QX6A3R5WW2YED1FFE0392DTN0":{"id":"evt_4QX6A3R5WW2YED1FFE0392DTN0","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_731AWVE8JZ49FXG6HR4TA84TYC":{"id":"evt_731AWVE8JZ49FXG6HR4TA84TYC","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1"},"evt_9T896GBWF7Y7KJDX8D0AVMDMT3":{"id":"evt_9T896GBWF7Y7KJDX8D0AVMDMT3","kind":"event","bakedName":"TUT_BACK","curName":"TUT_BACK","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_A15T659SSMWWT9JY1RM0NKST6H":{"id":"evt_A15T659SSMWWT9JY1RM0NKST6H","kind":"event","bakedName":"TUTORIAL_DONE","curName":"TUTORIAL_DONE","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ":{"id":"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ","kind":"event","bakedName":"TUT_AUTO","curName":"TUT_AUTO","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_HY867DXMHWT8Y4FF2PRWKT53T3":{"id":"evt_HY867DXMHWT8Y4FF2PRWKT53T3","kind":"event","bakedName":"TUT_DISMISS","curName":"TUT_DISMISS","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_KJ898NHRF4W7J29JM86XJXD889":{"id":"evt_KJ898NHRF4W7J29JM86XJXD889","kind":"event","bakedName":"TUTORIAL_DEMO_START","curName":"TUTORIAL_DEMO_START","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_MK5VA67F9ZQMZK2KM8HDHNJNHF":{"id":"evt_MK5VA67F9ZQMZK2KM8HDHNJNHF","kind":"event","bakedName":"CLOSE","curName":"CLOSE","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_TE7R4RNCXJPES62AZE67CT414J":{"id":"evt_TE7R4RNCXJPES62AZE67CT414J","kind":"event","bakedName":"TUT_NEXT","curName":"TUT_NEXT","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"orb_085MM211YGGZ85MSQP4W89Y5GJ":{"id":"orb_085MM211YGGZ85MSQP4W89Y5GJ","kind":"orbital","bakedName":"TutorialOverlayOrbital","curName":"TutorialOverlayOrbital","renames":[],"owner":"workspace"},"pag_YF62W6VNSWTWY9WJQQK5MFC0V8":{"id":"pag_YF62W6VNSWTWY9WJQQK5MFC0V8","kind":"page","bakedName":"TutorialOverlayPage","curName":"TutorialOverlayPage","renames":[],"owner":"workspace"},"trt_20MF6XNRMCWA6DA4388Z4T08RD":{"id":"trt_20MF6XNRMCWA6DA4388Z4T08RD","kind":"trait","bakedName":"TutorialOverlay","curName":"TutorialOverlay","renames":[],"owner":"workspace"},"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1":{"id":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1","kind":"trait","bakedName":"TutorialEmptyPreview","curName":"TutorialEmptyPreview","renames":[],"owner":"workspace"}}}}
+{"name":"std-tutorial-overlay","version":"1.0.0","description":"Tutorial modal with live-demo steps for game boards and learning shells: a paged overlay — title, a live previewTrait frame playing the mechanic via std-tutorial-autodemo (a bare game canvas, no shell chrome), one line of body copy, a step counter, and Back / Next / Skip — composed entirely from registered render types (stack + text + button + trait frame) into the overlay slot, so no new UI component is needed. autoShow opens it on INIT for first-time players; a board's help button re-opens it any time via SHOW (which rewinds to step one). DISMISS (or finishing the last step) marks the run done, clears the overlay, and emits TUTORIAL_DONE so the board can unpause or log. Steps are pure config — a board teaches a new mechanic by adding one { id, title, body, demoId } row plus a previewTrait binding. Corresponds to the design-sheet field(s): feedback, agency.","orbitals":[{"name":"TutorialOverlayOrbital","id":"orb_085MM211YGGZ85MSQP4W89Y5GJ","entity":{"name":"TutorialState","id":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"step","type":"number","default":0},{"name":"done","type":"boolean","default":false}],"shared":true},"traits":[{"name":"TutorialEmptyPreview","id":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1","effectRow":[{"kind":"render-ui","resource":"overlay"}],"category":"interaction","linkedEntity":"TutorialState","linkedEntityId":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777","entityRefIds":{"TutorialState":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777"},"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_731AWVE8JZ49FXG6HR4TA84TYC","name":"Initialize"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_731AWVE8JZ49FXG6HR4TA84TYC","effects":[["render-ui","overlay",null]]}]},"scope":"instance"},{"name":"TutorialOverlay","id":"trt_20MF6XNRMCWA6DA4388Z4T08RD","entityRebindable":true,"entityContract":{"requires":[],"provides":["done","step"]},"effectRow":[{"kind":"emit","resource":"TUTORIAL_DEMO_START"},{"kind":"emit","resource":"TUTORIAL_DEMO_STOP"},{"kind":"emit","resource":"TUTORIAL_DONE"},{"kind":"emit","resource":"TUT_AUTO"},{"kind":"render-ui","resource":"overlay"},{"kind":"set","resource":"@entity.done"},{"kind":"set","resource":"@entity.step"}],"category":"interaction","linkedEntity":"TutorialState","linkedEntityId":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777","entityRefIds":{"TutorialState":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777"},"traitEmbedIds":{"TutorialEmptyPreview":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1"},"emits":[{"event":"TUT_AUTO","eventId":"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ","description":"Self-emitted on INIT when autoShow is on — opens step one. (A config-valued INIT guard would be constant-folded at compose time and misfire; the self-event keeps the decision in an effect.)","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"TUT_NEXT","eventId":"evt_TE7R4RNCXJPES62AZE67CT414J","description":"Advance one step; on the last step it finishes the tutorial (marks done, clears the overlay, emits TUTORIAL_DONE).","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"TUT_BACK","eventId":"evt_9T896GBWF7Y7KJDX8D0AVMDMT3","description":"Return one step (inert on the first).","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"TUT_DISMISS","eventId":"evt_HY867DXMHWT8Y4FF2PRWKT53T3","description":"Skip/close the tutorial; marks done and clears the overlay.","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"SHOW","eventId":"evt_1XBH8PA48J24956KS2VQZ16Q33","description":"Re-open the tutorial from step one — wire a board's help button here.","tier":"essential","scope":"external","payloadSchema":[{"name":"id","type":"string"}]},{"event":"TUTORIAL_DONE","eventId":"evt_A15T659SSMWWT9JY1RM0NKST6H","description":"The tutorial was finished or skipped; boards unpause or log completion.","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true}]},{"event":"TUTORIAL_DEMO_START","eventId":"evt_KJ898NHRF4W7J29JM86XJXD889","description":"Emitted when a tutorial step carrying a demoId is shown; the composed std-tutorial-autodemo atom plays that scripted demo.","tier":"domain","scope":"external","payloadSchema":[{"name":"demoId","type":"string","required":true}]},{"event":"TUTORIAL_DEMO_STOP","eventId":"evt_4DMT9YE5QK2VSVM2QCZMXCDNGH","description":"Emitted when the tutorial leaves a demo step (next/back) or is dismissed/finished; the autodemo atom stops and releases control.","tier":"domain","scope":"external"}],"stateMachine":{"states":[{"name":"hidden","isInitial":true},{"name":"showing"}],"events":[{"key":"INIT","id":"evt_4QX6A3R5WW2YED1FFE0392DTN0","name":"Initialize"},{"key":"TUT_AUTO","id":"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ","name":"Tut Auto","description":"Self-emitted on INIT when autoShow is on — opens step one. (A config-valued INIT guard would be constant-folded at compose time and misfire; the self-event keeps the decision in an effect.)","tier":"essential","payloadSchema":[{"name":"id","type":"string"}]},{"key":"SHOW","id":"evt_1XBH8PA48J24956KS2VQZ16Q33","name":"Show","description":"Re-open the tutorial from step one — wire a board's help button here.","tier":"essential","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"TUT_NEXT","id":"evt_TE7R4RNCXJPES62AZE67CT414J","name":"Tut Next","description":"Advance one step; on the last step it finishes the tutorial (marks done, clears the overlay, emits TUTORIAL_DONE).","tier":"essential","payloadSchema":[{"name":"id","type":"string"}]},{"key":"TUT_BACK","id":"evt_9T896GBWF7Y7KJDX8D0AVMDMT3","name":"Tut Back","description":"Return one step (inert on the first).","tier":"essential","payloadSchema":[{"name":"id","type":"string"}]},{"key":"TUT_DISMISS","id":"evt_HY867DXMHWT8Y4FF2PRWKT53T3","name":"Tut Dismiss","description":"Skip/close the tutorial; marks done and clears the overlay.","tier":"essential","payloadSchema":[{"name":"id","type":"string"}]},{"key":"CLOSE","id":"evt_MK5VA67F9ZQMZK2KM8HDHNJNHF","name":"Close"},{"key":"TUTORIAL_DONE","id":"evt_A15T659SSMWWT9JY1RM0NKST6H","name":"Tutorial Done","description":"The tutorial was finished or skipped; boards unpause or log completion.","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true}]},{"key":"TUTORIAL_DEMO_START","id":"evt_KJ898NHRF4W7J29JM86XJXD889","name":"Tutorial Demo Start","description":"Emitted when a tutorial step carrying a demoId is shown; the composed std-tutorial-autodemo atom plays that scripted demo.","tier":"domain","payloadSchema":[{"name":"demoId","type":"string","required":true}]},{"key":"TUTORIAL_DEMO_STOP","id":"evt_4DMT9YE5QK2VSVM2QCZMXCDNGH","name":"Tutorial Demo Stop","description":"Emitted when the tutorial leaves a demo step (next/back) or is dismissed/finished; the autodemo atom stops and releases control.","tier":"domain"}],"transitions":[{"from":"hidden","to":"hidden","event":"INIT","eventId":"evt_4QX6A3R5WW2YED1FFE0392DTN0","effects":[["if","@config.autoShow",["emit","TUT_AUTO",{"id":"auto"}],["render-ui","overlay",null]]]},{"from":"hidden","to":"showing","event":"TUT_AUTO","eventId":"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ","guard":"@config.autoShow","effects":[["set","@entity.step",0],["render-ui","overlay",{"type":"stack","direction":"vertical","className":"bg-card text-card-foreground border border-border rounded-lg shadow-lg p-6 max-w-md mx-auto mt-16","children":[{"type":"typography","content":["object/get",["array/nth","@config.steps",0],"title"],"variant":"h4","weight":"bold"},"@config.previewTrait",{"type":"typography","content":["object/get",["array/nth","@config.steps",0],"body"],"variant":"body"},{"type":"typography","content":["str/concat","1 / ",["array/len","@config.steps"]],"variant":"caption","align":"center"},{"type":"stack","direction":"horizontal","justify":"center","className":"pt-2","children":[{"type":"button","label":["if",[">",["array/len","@config.steps"],1],"Next ▶","Got it"],"action":"TUT_NEXT","variant":"primary"},{"type":"button","label":"Skip","action":"TUT_DISMISS","variant":"secondary"}]}]}],["when",["!=",["object/get",["array/nth","@config.steps",0],"demoId",""],""],["do",["emit","TUTORIAL_DEMO_START",{"demoId":["object/get",["array/nth","@config.steps",0],"demoId",""]}]]]]},{"from":"hidden","to":"showing","event":"SHOW","eventId":"evt_1XBH8PA48J24956KS2VQZ16Q33","effects":[["set","@entity.step",0],["render-ui","overlay",{"type":"stack","direction":"vertical","className":"bg-card text-card-foreground border border-border rounded-lg shadow-lg p-6 max-w-md mx-auto mt-16","children":[{"type":"typography","content":["object/get",["array/nth","@config.steps",0],"title"],"variant":"h4","weight":"bold"},"@config.previewTrait",{"type":"typography","content":["object/get",["array/nth","@config.steps",0],"body"],"variant":"body"},{"type":"typography","content":["str/concat","1 / ",["array/len","@config.steps"]],"variant":"caption","align":"center"},{"type":"stack","direction":"horizontal","justify":"center","className":"pt-2","children":[{"type":"button","label":["if",[">",["array/len","@config.steps"],1],"Next ▶","Got it"],"action":"TUT_NEXT","variant":"primary"},{"type":"button","label":"Skip","action":"TUT_DISMISS","variant":"secondary"}]}]}],["when",["!=",["object/get",["array/nth","@config.steps",0],"demoId",""],""],["do",["emit","TUTORIAL_DEMO_START",{"demoId":["object/get",["array/nth","@config.steps",0],"demoId",""]}]]]]},{"from":"showing","to":"hidden","event":"INIT","eventId":"evt_4QX6A3R5WW2YED1FFE0392DTN0","effects":[["render-ui","overlay",null],["if","@config.autoShow",["emit","TUT_AUTO",{"id":"auto"}],["render-ui","overlay",null]]]},{"from":"showing","to":"showing","event":"TUT_NEXT","eventId":"evt_TE7R4RNCXJPES62AZE67CT414J","guard":["<",["+","@entity.step",1],["array/len","@config.steps"]],"effects":[["set","@entity.step",["+","@entity.step",1]],["render-ui","overlay",{"type":"stack","direction":"vertical","className":"bg-card text-card-foreground border border-border rounded-lg shadow-lg p-6 max-w-md mx-auto mt-16","children":[{"type":"typography","content":["object/get",["array/nth","@config.steps","@entity.step"],"title"],"variant":"h4","weight":"bold"},"@config.previewTrait",{"type":"typography","content":["object/get",["array/nth","@config.steps","@entity.step"],"body"],"variant":"body"},{"type":"typography","content":["str/concat",["+","@entity.step",1]," / ",["array/len","@config.steps"]],"variant":"caption","align":"center"},{"type":"stack","direction":"horizontal","justify":"center","className":"pt-2","children":[{"type":"button","label":"◀ Back","action":"TUT_BACK","variant":"secondary"},{"type":"button","label":["if",["<",["+","@entity.step",1],["array/len","@config.steps"]],"Next ▶","Got it"],"action":"TUT_NEXT","variant":"primary"},{"type":"button","label":"Skip","action":"TUT_DISMISS","variant":"secondary"}]}]}],["emit","TUTORIAL_DEMO_STOP",{}],["when",["!=",["object/get",["array/nth","@config.steps","@entity.step"],"demoId",""],""],["do",["emit","TUTORIAL_DEMO_START",{"demoId":["object/get",["array/nth","@config.steps","@entity.step"],"demoId",""]}]]]]},{"from":"showing","to":"hidden","event":"TUT_NEXT","eventId":"evt_TE7R4RNCXJPES62AZE67CT414J","guard":[">=",["+","@entity.step",1],["array/len","@config.steps"]],"effects":[["set","@entity.done",true],["render-ui","overlay",null],["emit","TUTORIAL_DEMO_STOP",{}],["emit","TUTORIAL_DONE",{"id":"tutorial"}]]},{"from":"showing","to":"showing","event":"TUT_BACK","eventId":"evt_9T896GBWF7Y7KJDX8D0AVMDMT3","guard":[">","@entity.step",0],"effects":[["set","@entity.step",["-","@entity.step",1]],["render-ui","overlay",{"type":"stack","direction":"vertical","className":"bg-card text-card-foreground border border-border rounded-lg shadow-lg p-6 max-w-md mx-auto mt-16","children":[{"type":"typography","content":["object/get",["array/nth","@config.steps","@entity.step"],"title"],"variant":"h4","weight":"bold"},"@config.previewTrait",{"type":"typography","content":["object/get",["array/nth","@config.steps","@entity.step"],"body"],"variant":"body"},{"type":"typography","content":["str/concat",["+","@entity.step",1]," / ",["array/len","@config.steps"]],"variant":"caption","align":"center"},{"type":"stack","direction":"horizontal","justify":"center","className":"pt-2","children":[{"type":"button","label":"◀ Back","action":"TUT_BACK","variant":"secondary"},{"type":"button","label":["if",["<",["+","@entity.step",1],["array/len","@config.steps"]],"Next ▶","Got it"],"action":"TUT_NEXT","variant":"primary"},{"type":"button","label":"Skip","action":"TUT_DISMISS","variant":"secondary"}]}]}],["emit","TUTORIAL_DEMO_STOP",{}],["when",["!=",["object/get",["array/nth","@config.steps","@entity.step"],"demoId",""],""],["do",["emit","TUTORIAL_DEMO_START",{"demoId":["object/get",["array/nth","@config.steps","@entity.step"],"demoId",""]}]]]]},{"from":"showing","to":"hidden","event":"TUT_DISMISS","eventId":"evt_HY867DXMHWT8Y4FF2PRWKT53T3","effects":[["set","@entity.done",true],["render-ui","overlay",null],["emit","TUTORIAL_DEMO_STOP",{}],["emit","TUTORIAL_DONE",{"id":"tutorial"}]]},{"from":"showing","to":"hidden","event":"CLOSE","eventId":"evt_MK5VA67F9ZQMZK2KM8HDHNJNHF","effects":[["set","@entity.done",true],["render-ui","overlay",null],["emit","TUTORIAL_DEMO_STOP",{}],["emit","TUTORIAL_DONE",{"id":"tutorial"}]]}]},"config":{"autoShow":{"type":"boolean","default":true,"label":"Auto Show","description":"When true the tutorial opens on INIT for this run; when false it stays hidden until SHOW.","tier":"domain"},"steps":{"type":"[TutorialStep]","default":[],"label":"Steps","description":"One row per tutorial page: title, one line of body copy, and an optional demoId that plays a scripted live demo (std-tutorial-autodemo) for the mechanic being taught.","tier":"presentation","items":{"type":"object","properties":{"demoId":{"name":"demoId","type":"string","required":false},"id":{"name":"id","type":"string","required":true},"body":{"name":"body","type":"string","required":false},"title":{"name":"title","type":"string","required":true}}}},"previewTrait":{"type":"trait","default":"@trait.TutorialEmptyPreview","label":"Preview trait","description":"Trait rendered in the media position of the modal — the live, demo-driven preview of the mechanic (a bare game canvas, no shell chrome). '@trait.TutorialEmptyPreview' leaves the slot blank. Override with '@trait.<TraitName>' to show a board's live frame.","tier":"presentation","refId":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1"}},"scope":"instance"}],"pages":[{"name":"TutorialOverlayPage","id":"pag_YF62W6VNSWTWY9WJQQK5MFC0V8","path":"/tutorial-overlay","traits":[{"ref":"TutorialOverlay","refId":"trt_20MF6XNRMCWA6DA4388Z4T08RD"}]}],"types":{"TutorialStep":[{"name":"id","type":"string","required":true},{"name":"title","type":"string","required":true},{"name":"body","type":"string"},{"name":"demoId","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_RC0QKPBQ4NVJAPR5XCY7PAN777":{"id":"ent_RC0QKPBQ4NVJAPR5XCY7PAN777","kind":"entity","bakedName":"TutorialState","curName":"TutorialState","renames":[],"owner":"workspace"},"evt_1XBH8PA48J24956KS2VQZ16Q33":{"id":"evt_1XBH8PA48J24956KS2VQZ16Q33","kind":"event","bakedName":"SHOW","curName":"SHOW","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_4DMT9YE5QK2VSVM2QCZMXCDNGH":{"id":"evt_4DMT9YE5QK2VSVM2QCZMXCDNGH","kind":"event","bakedName":"TUTORIAL_DEMO_STOP","curName":"TUTORIAL_DEMO_STOP","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_4QX6A3R5WW2YED1FFE0392DTN0":{"id":"evt_4QX6A3R5WW2YED1FFE0392DTN0","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_731AWVE8JZ49FXG6HR4TA84TYC":{"id":"evt_731AWVE8JZ49FXG6HR4TA84TYC","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1"},"evt_9T896GBWF7Y7KJDX8D0AVMDMT3":{"id":"evt_9T896GBWF7Y7KJDX8D0AVMDMT3","kind":"event","bakedName":"TUT_BACK","curName":"TUT_BACK","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_A15T659SSMWWT9JY1RM0NKST6H":{"id":"evt_A15T659SSMWWT9JY1RM0NKST6H","kind":"event","bakedName":"TUTORIAL_DONE","curName":"TUTORIAL_DONE","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ":{"id":"evt_GDDAPJBQYYVZF9AN4C2HPSKSAZ","kind":"event","bakedName":"TUT_AUTO","curName":"TUT_AUTO","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_HY867DXMHWT8Y4FF2PRWKT53T3":{"id":"evt_HY867DXMHWT8Y4FF2PRWKT53T3","kind":"event","bakedName":"TUT_DISMISS","curName":"TUT_DISMISS","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_KJ898NHRF4W7J29JM86XJXD889":{"id":"evt_KJ898NHRF4W7J29JM86XJXD889","kind":"event","bakedName":"TUTORIAL_DEMO_START","curName":"TUTORIAL_DEMO_START","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_MK5VA67F9ZQMZK2KM8HDHNJNHF":{"id":"evt_MK5VA67F9ZQMZK2KM8HDHNJNHF","kind":"event","bakedName":"CLOSE","curName":"CLOSE","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"evt_TE7R4RNCXJPES62AZE67CT414J":{"id":"evt_TE7R4RNCXJPES62AZE67CT414J","kind":"event","bakedName":"TUT_NEXT","curName":"TUT_NEXT","renames":[],"owner":"workspace","parent":"trt_20MF6XNRMCWA6DA4388Z4T08RD"},"orb_085MM211YGGZ85MSQP4W89Y5GJ":{"id":"orb_085MM211YGGZ85MSQP4W89Y5GJ","kind":"orbital","bakedName":"TutorialOverlayOrbital","curName":"TutorialOverlayOrbital","renames":[],"owner":"workspace"},"pag_YF62W6VNSWTWY9WJQQK5MFC0V8":{"id":"pag_YF62W6VNSWTWY9WJQQK5MFC0V8","kind":"page","bakedName":"TutorialOverlayPage","curName":"TutorialOverlayPage","renames":[],"owner":"workspace"},"trt_20MF6XNRMCWA6DA4388Z4T08RD":{"id":"trt_20MF6XNRMCWA6DA4388Z4T08RD","kind":"trait","bakedName":"TutorialOverlay","curName":"TutorialOverlay","renames":[],"owner":"workspace"},"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1":{"id":"trt_7ZRNNP8S6BCK5H7SWMT5WVK7F1","kind":"trait","bakedName":"TutorialEmptyPreview","curName":"TutorialEmptyPreview","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/ui/game/atoms/std-velocity-gate.orb

@@ -1 +1 @@
-{"name":"std-velocity-gate","version":"1.0.0","description":"Headless velocity-gate mechanic: gates that open only when the player crosses them inside a speed band, optionally in a required direction, optionally sustained for a dwell. Listens BODY_MOVED and, per closed gate, tests the player's rect (padded by reachMargin), their speed against [minSpeed, maxSpeed], and their horizontal direction against dir (0 = either). Instant gates (dwellMs 0) open on the first passing cross; dwell gates (dwellMs > 0) accumulate ~33ms per passing move and open once held reaches dwellMs — a failing move resets the hold. The first newly opened gate emits VELOCITY_GATE_OPENED (the shared entity carries the rest). Entering a closed INSTANT gate while NOT passing emits VELOCITY_GATE_DENIED once per approach — re-arming only after the player steps out — so the board can answer with a PLACE back and a hint fx; dwell gates never deny (a hot entry is fine — coming to rest inside is the point), a failed hold simply resets. RESTART re-closes every live gate (re-arming the live entity set, so SET_VGATES-injected gates survive respawns). SET_VGATES replaces the gate set at runtime for boards that import their gates. Renders nothing; boards draw the gate band/chest and read open/held from the shared entity (the render authority). Corresponds to the design-sheet field(s): challenge, mechanics.","orbitals":[{"name":"VelocityGateOrbital","id":"orb_A9XD83X8HXM8YJ10B41B6ZBQ6W","entity":{"name":"VelocityGateData","id":"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"gates","type":"array","default":[],"items":{"type":"object","properties":{"held":{"name":"held","type":"number","required":false},"height":{"name":"height","type":"number","required":true},"reported":{"name":"reported","type":"boolean","required":false},"hint":{"name":"hint","type":"string","required":false},"dir":{"name":"dir","type":"number","required":true},"open":{"name":"open","type":"boolean","required":false},"denied":{"name":"denied","type":"boolean","required":false},"width":{"name":"width","type":"number","required":true},"touching":{"name":"touching","type":"boolean","required":false},"maxSpeed":{"name":"maxSpeed","type":"number","required":true},"id":{"name":"id","type":"string","required":true},"y":{"name":"y","type":"number","required":true},"minSpeed":{"name":"minSpeed","type":"number","required":true},"x":{"name":"x","type":"number","required":true},"dwellMs":{"name":"dwellMs","type":"number","required":true}}}}],"shared":true},"traits":[{"name":"VelocityGate","id":"trt_WTJPF9AS23CH1M1M57GXTY30F9","entityRebindable":true,"entityContract":{"requires":[],"provides":["gates"]},"effectRow":[{"kind":"emit","resource":"VELOCITY_GATE_DENIED"},{"kind":"emit","resource":"VELOCITY_GATE_OPENED"},{"kind":"set","resource":"@entity.gates"}],"category":"lifecycle","linkedEntity":"VelocityGateData","linkedEntityId":"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9","entityRefIds":{"VelocityGateData":"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9"},"emits":[{"event":"VELOCITY_GATE_OPENED","eventId":"evt_RF817QV9HRMRW7CH192PGZW7RK","description":"A gate's speed band was satisfied (instantly, or held for its dwell) and it flipped open; boards layer treasure fx and rewards. When several gates open on one move, the first reports and the shared entity carries the rest.","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true}]},{"event":"VELOCITY_GATE_DENIED","eventId":"evt_DZWN69D22RH1CE3QBMYVXDZ691","description":"The player entered a closed gate outside its speed band or against its direction; fires once per approach and re-arms after they step out. Boards answer with a PLACE back plus a hint fx.","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"speed","type":"number","required":true}]}],"stateMachine":{"states":[{"name":"active","isInitial":true}],"events":[{"key":"INIT","id":"evt_0J8B29RTT7DD3SCGB2F4Y16D19","name":"Initialize"},{"key":"BODY_MOVED","id":"evt_E9DKKZ24VC2DPFHA1K9HV3BG8S","name":"Body Moved","payloadSchema":[{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"vx","type":"number","required":true},{"name":"vy","type":"number","required":true},{"name":"grounded","type":"boolean","required":true},{"name":"skating","type":"boolean","required":true},{"name":"speed","type":"number","required":true}],"listened":true},{"key":"SET_VGATES","id":"evt_5P651ZJFX87YMDMG8K1XN2AVN5","name":"Set Vgates","payloadSchema":[{"name":"gates","type":"[object]","required":true,"properties":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"width","type":"number","required":true},{"name":"height","type":"number","required":true},{"name":"minSpeed","type":"number","required":true},{"name":"maxSpeed","type":"number","required":true},{"name":"dwellMs","type":"number","required":true},{"name":"dir","type":"number","required":true},{"name":"hint","type":"string"},{"name":"open","type":"boolean"},{"name":"touching","type":"boolean"},{"name":"denied","type":"boolean"},{"name":"held","type":"number"},{"name":"reported","type":"boolean"}]}],"listened":true},{"key":"RESTART","id":"evt_CM68XWRHDM8PT976J4B33K9DZD","name":"Restart","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"VELOCITY_GATE_OPENED","id":"evt_RF817QV9HRMRW7CH192PGZW7RK","name":"Velocity Gate Opened","description":"A gate's speed band was satisfied (instantly, or held for its dwell) and it flipped open; boards layer treasure fx and rewards. When several gates open on one move, the first reports and the shared entity carries the rest.","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true}]},{"key":"VELOCITY_GATE_DENIED","id":"evt_DZWN69D22RH1CE3QBMYVXDZ691","name":"Velocity Gate Denied","description":"The player entered a closed gate outside its speed band or against its direction; fires once per approach and re-arms after they step out. Boards answer with a PLACE back plus a hint fx.","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"speed","type":"number","required":true}]}],"transitions":[{"from":"active","to":"active","event":"INIT","eventId":"evt_0J8B29RTT7DD3SCGB2F4Y16D19","effects":[["set","@entity.gates",["array/map","@config.gates",["fn","g",["object/merge","@g",{"open":false,"touching":false,"denied":false,"held":0,"reported":false}]]]]]},{"from":"active","to":"active","event":"BODY_MOVED","eventId":"evt_E9DKKZ24VC2DPFHA1K9HV3BG8S","guard":"@config.running","effects":[["set","@entity.gates",["array/map","@entity.gates",["fn","g",["let",[["inside",["and",["==",["object/get","@g","open"],false],["and",[">=","@payload.x",["-",["object/get","@g","x"],"@config.reachMargin"]],["and",["<=","@payload.x",["+",["object/get","@g","x"],["object/get","@g","width"],"@config.reachMargin"]],["and",[">=","@payload.y",["-",["object/get","@g","y"],"@config.reachMargin"]],["<=","@payload.y",["+",["object/get","@g","y"],["object/get","@g","height"],"@config.reachMargin"]]]]]]]],["let",[["dirOk",["or",["==",["object/get","@g","dir"],0],["==",["math/sign","@payload.vx"],["object/get","@g","dir"]]]]],["let",[["pass",["and","@inside",["and",[">=","@payload.speed",["object/get","@g","minSpeed"]],["and",["<=","@payload.speed",["object/get","@g","maxSpeed"]],"@dirOk"]]]]],["let",[["held",["if","@pass",["+",["object/get","@g","held"],33],0]]],["let",[["openNow",["or",["object/get","@g","open"],["if",[">",["object/get","@g","dwellMs"],0],[">=","@held",["object/get","@g","dwellMs"]],"@pass"]]]],["object/merge","@g",{"touching":"@inside","held":"@held","open":"@openNow","denied":["and",["==",["object/get","@g","dwellMs"],0],["and","@inside",["and",["==","@pass",false],["==",["object/get","@g","touching"],false]]]]}]]]]]]]]],["let",[["newly",["array/filter","@entity.gates",["fn","g",["and",["==",["object/get","@g","open"],true],["==",["object/get","@g","reported"],false]]]]]],["if",[">",["array/len","@newly"],0],["do",["set","@entity.gates",["array/map","@entity.gates",["fn","g",["if",["==",["object/get","@g","id"],["object/get",["array/first","@newly"],"id"]],["object/merge","@g",{"reported":true}],"@g"]]]],["emit","VELOCITY_GATE_OPENED",{"id":["object/get",["array/first","@newly"],"id"],"x":["object/get",["array/first","@newly"],"x"],"y":["object/get",["array/first","@newly"],"y"]}]],null]],["let",[["denied",["array/filter","@entity.gates",["fn","g",["==",["object/get","@g","denied"],true]]]]],["if",[">",["array/len","@denied"],0],["emit","VELOCITY_GATE_DENIED",{"id":["object/get",["array/first","@denied"],"id"],"x":["object/get",["array/first","@denied"],"x"],"y":["object/get",["array/first","@denied"],"y"],"speed":"@payload.speed"}],null]]]},{"from":"active","to":"active","event":"SET_VGATES","eventId":"evt_5P651ZJFX87YMDMG8K1XN2AVN5","effects":[["set","@entity.gates",["array/map","@payload.gates",["fn","g",["object/merge","@g",{"open":false,"touching":false,"denied":false,"held":0,"reported":false}]]]]]},{"from":"active","to":"active","event":"RESTART","eventId":"evt_CM68XWRHDM8PT976J4B33K9DZD","effects":[["set","@entity.gates",["array/map","@entity.gates",["fn","g",["object/merge","@g",{"open":false,"touching":false,"denied":false,"held":0,"reported":false}]]]]]}]},"config":{"running":{"type":"boolean","default":true,"label":"Running","description":"When true, BODY_MOVED tests every gate's band and opens/denies; toggle to freeze every gate as-is.","tier":"domain"},"gates":{"type":"[VelocityGate]","default":[],"label":"Gates","description":"One row per velocity gate: id, min-corner rect (x, y, width, height in world units), the speed band [minSpeed, maxSpeed] that opens it, the hold required (dwellMs 0 = instant), the horizontal direction required (dir -1/0/+1), and an optional hint shown when denied. open/touching/denied/held/reported are stamped at runtime. Seeded onto the entity on INIT; the live set is entity.gates — SET_VGATES replaces it at runtime (boards that import gates), and RESTART re-arms the live set rather than re-reading config, so injected gates survive respawns.","tier":"domain","items":{"type":"object","properties":{"minSpeed":{"name":"minSpeed","type":"number","required":true},"held":{"name":"held","type":"number","required":false},"height":{"name":"height","type":"number","required":true},"open":{"name":"open","type":"boolean","required":false},"reported":{"name":"reported","type":"boolean","required":false},"id":{"name":"id","type":"string","required":true},"dir":{"name":"dir","type":"number","required":true},"x":{"name":"x","type":"number","required":true},"touching":{"name":"touching","type":"boolean","required":false},"hint":{"name":"hint","type":"string","required":false},"dwellMs":{"name":"dwellMs","type":"number","required":true},"denied":{"name":"denied","type":"boolean","required":false},"maxSpeed":{"name":"maxSpeed","type":"number","required":true},"y":{"name":"y","type":"number","required":true},"width":{"name":"width","type":"number","required":true}}}},"reachMargin":{"type":"number","default":0.6,"label":"Reach Margin","description":"Extra world units padded around a closed gate's rect when testing player contact (approximates the body's size).","tier":"domain"}},"scope":"instance"}],"pages":[{"name":"VelocityGatePage","id":"pag_45AWVXGYE8F7465GAWSWXN4R54","path":"/velocity-gate","traits":[{"ref":"VelocityGate","refId":"trt_WTJPF9AS23CH1M1M57GXTY30F9"}]}],"types":{"VelocityGate":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"width","type":"number","required":true},{"name":"height","type":"number","required":true},{"name":"minSpeed","type":"number","required":true},{"name":"maxSpeed","type":"number","required":true},{"name":"dwellMs","type":"number","required":true},{"name":"dir","type":"number","required":true},{"name":"hint","type":"string"},{"name":"open","type":"boolean"},{"name":"touching","type":"boolean"},{"name":"denied","type":"boolean"},{"name":"held","type":"number"},{"name":"reported","type":"boolean"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9":{"id":"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9","kind":"entity","bakedName":"VelocityGateData","curName":"VelocityGateData","renames":[],"owner":"workspace"},"evt_0J8B29RTT7DD3SCGB2F4Y16D19":{"id":"evt_0J8B29RTT7DD3SCGB2F4Y16D19","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_5P651ZJFX87YMDMG8K1XN2AVN5":{"id":"evt_5P651ZJFX87YMDMG8K1XN2AVN5","kind":"event","bakedName":"SET_VGATES","curName":"SET_VGATES","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_CM68XWRHDM8PT976J4B33K9DZD":{"id":"evt_CM68XWRHDM8PT976J4B33K9DZD","kind":"event","bakedName":"RESTART","curName":"RESTART","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_DZWN69D22RH1CE3QBMYVXDZ691":{"id":"evt_DZWN69D22RH1CE3QBMYVXDZ691","kind":"event","bakedName":"VELOCITY_GATE_DENIED","curName":"VELOCITY_GATE_DENIED","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_E9DKKZ24VC2DPFHA1K9HV3BG8S":{"id":"evt_E9DKKZ24VC2DPFHA1K9HV3BG8S","kind":"event","bakedName":"BODY_MOVED","curName":"BODY_MOVED","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_RF817QV9HRMRW7CH192PGZW7RK":{"id":"evt_RF817QV9HRMRW7CH192PGZW7RK","kind":"event","bakedName":"VELOCITY_GATE_OPENED","curName":"VELOCITY_GATE_OPENED","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"orb_A9XD83X8HXM8YJ10B41B6ZBQ6W":{"id":"orb_A9XD83X8HXM8YJ10B41B6ZBQ6W","kind":"orbital","bakedName":"VelocityGateOrbital","curName":"VelocityGateOrbital","renames":[],"owner":"workspace"},"pag_45AWVXGYE8F7465GAWSWXN4R54":{"id":"pag_45AWVXGYE8F7465GAWSWXN4R54","kind":"page","bakedName":"VelocityGatePage","curName":"VelocityGatePage","renames":[],"owner":"workspace"},"trt_WTJPF9AS23CH1M1M57GXTY30F9":{"id":"trt_WTJPF9AS23CH1M1M57GXTY30F9","kind":"trait","bakedName":"VelocityGate","curName":"VelocityGate","renames":[],"owner":"workspace"}}}}
+{"name":"std-velocity-gate","version":"1.0.0","description":"Headless velocity-gate mechanic: gates that open only when the player crosses them inside a speed band, optionally in a required direction, optionally sustained for a dwell. Listens BODY_MOVED and, per closed gate, tests the player's rect (padded by reachMargin), their speed against [minSpeed, maxSpeed], and their horizontal direction against dir (0 = either). Instant gates (dwellMs 0) open on the first passing cross; dwell gates (dwellMs > 0) accumulate ~33ms per passing move and open once held reaches dwellMs — a failing move resets the hold. The first newly opened gate emits VELOCITY_GATE_OPENED (the shared entity carries the rest). Entering a closed INSTANT gate while NOT passing emits VELOCITY_GATE_DENIED once per approach — re-arming only after the player steps out — so the board can answer with a PLACE back and a hint fx; dwell gates never deny (a hot entry is fine — coming to rest inside is the point), a failed hold simply resets. RESTART re-closes every live gate (re-arming the live entity set, so SET_VGATES-injected gates survive respawns). SET_VGATES replaces the gate set at runtime for boards that import their gates. Renders nothing; boards draw the gate band/chest and read open/held from the shared entity (the render authority). Corresponds to the design-sheet field(s): challenge, mechanics.","orbitals":[{"name":"VelocityGateOrbital","id":"orb_A9XD83X8HXM8YJ10B41B6ZBQ6W","entity":{"name":"VelocityGateData","id":"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"gates","type":"array","default":[],"items":{"type":"object","properties":{"denied":{"name":"denied","type":"boolean","required":false},"maxSpeed":{"name":"maxSpeed","type":"number","required":true},"minSpeed":{"name":"minSpeed","type":"number","required":true},"touching":{"name":"touching","type":"boolean","required":false},"hint":{"name":"hint","type":"string","required":false},"x":{"name":"x","type":"number","required":true},"open":{"name":"open","type":"boolean","required":false},"held":{"name":"held","type":"number","required":false},"width":{"name":"width","type":"number","required":true},"y":{"name":"y","type":"number","required":true},"dwellMs":{"name":"dwellMs","type":"number","required":true},"reported":{"name":"reported","type":"boolean","required":false},"dir":{"name":"dir","type":"number","required":true},"id":{"name":"id","type":"string","required":true},"height":{"name":"height","type":"number","required":true}}}}],"shared":true},"traits":[{"name":"VelocityGate","id":"trt_WTJPF9AS23CH1M1M57GXTY30F9","entityRebindable":true,"entityContract":{"requires":[],"provides":["gates"]},"effectRow":[{"kind":"emit","resource":"VELOCITY_GATE_DENIED"},{"kind":"emit","resource":"VELOCITY_GATE_OPENED"},{"kind":"set","resource":"@entity.gates"}],"category":"lifecycle","linkedEntity":"VelocityGateData","linkedEntityId":"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9","entityRefIds":{"VelocityGateData":"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9"},"emits":[{"event":"VELOCITY_GATE_OPENED","eventId":"evt_RF817QV9HRMRW7CH192PGZW7RK","description":"A gate's speed band was satisfied (instantly, or held for its dwell) and it flipped open; boards layer treasure fx and rewards. When several gates open on one move, the first reports and the shared entity carries the rest.","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true}]},{"event":"VELOCITY_GATE_DENIED","eventId":"evt_DZWN69D22RH1CE3QBMYVXDZ691","description":"The player entered a closed gate outside its speed band or against its direction; fires once per approach and re-arms after they step out. Boards answer with a PLACE back plus a hint fx.","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"speed","type":"number","required":true}]}],"stateMachine":{"states":[{"name":"active","isInitial":true}],"events":[{"key":"INIT","id":"evt_0J8B29RTT7DD3SCGB2F4Y16D19","name":"Initialize"},{"key":"BODY_MOVED","id":"evt_E9DKKZ24VC2DPFHA1K9HV3BG8S","name":"Body Moved","payloadSchema":[{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"vx","type":"number","required":true},{"name":"vy","type":"number","required":true},{"name":"grounded","type":"boolean","required":true},{"name":"skating","type":"boolean","required":true},{"name":"speed","type":"number","required":true}],"listened":true},{"key":"SET_VGATES","id":"evt_5P651ZJFX87YMDMG8K1XN2AVN5","name":"Set Vgates","payloadSchema":[{"name":"gates","type":"[object]","required":true,"properties":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"width","type":"number","required":true},{"name":"height","type":"number","required":true},{"name":"minSpeed","type":"number","required":true},{"name":"maxSpeed","type":"number","required":true},{"name":"dwellMs","type":"number","required":true},{"name":"dir","type":"number","required":true},{"name":"hint","type":"string"},{"name":"open","type":"boolean"},{"name":"touching","type":"boolean"},{"name":"denied","type":"boolean"},{"name":"held","type":"number"},{"name":"reported","type":"boolean"}]}],"listened":true},{"key":"RESTART","id":"evt_CM68XWRHDM8PT976J4B33K9DZD","name":"Restart","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"VELOCITY_GATE_OPENED","id":"evt_RF817QV9HRMRW7CH192PGZW7RK","name":"Velocity Gate Opened","description":"A gate's speed band was satisfied (instantly, or held for its dwell) and it flipped open; boards layer treasure fx and rewards. When several gates open on one move, the first reports and the shared entity carries the rest.","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true}]},{"key":"VELOCITY_GATE_DENIED","id":"evt_DZWN69D22RH1CE3QBMYVXDZ691","name":"Velocity Gate Denied","description":"The player entered a closed gate outside its speed band or against its direction; fires once per approach and re-arms after they step out. Boards answer with a PLACE back plus a hint fx.","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"speed","type":"number","required":true}]}],"transitions":[{"from":"active","to":"active","event":"INIT","eventId":"evt_0J8B29RTT7DD3SCGB2F4Y16D19","effects":[["set","@entity.gates",["array/map","@config.gates",["fn","g",["object/merge","@g",{"open":false,"touching":false,"denied":false,"held":0,"reported":false}]]]]]},{"from":"active","to":"active","event":"BODY_MOVED","eventId":"evt_E9DKKZ24VC2DPFHA1K9HV3BG8S","guard":"@config.running","effects":[["set","@entity.gates",["array/map","@entity.gates",["fn","g",["let",[["inside",["and",["==",["object/get","@g","open"],false],["and",[">=","@payload.x",["-",["object/get","@g","x"],"@config.reachMargin"]],["and",["<=","@payload.x",["+",["object/get","@g","x"],["object/get","@g","width"],"@config.reachMargin"]],["and",[">=","@payload.y",["-",["object/get","@g","y"],"@config.reachMargin"]],["<=","@payload.y",["+",["object/get","@g","y"],["object/get","@g","height"],"@config.reachMargin"]]]]]]]],["let",[["dirOk",["or",["==",["object/get","@g","dir"],0],["==",["math/sign","@payload.vx"],["object/get","@g","dir"]]]]],["let",[["pass",["and","@inside",["and",[">=","@payload.speed",["object/get","@g","minSpeed"]],["and",["<=","@payload.speed",["object/get","@g","maxSpeed"]],"@dirOk"]]]]],["let",[["held",["if","@pass",["+",["object/get","@g","held"],33],0]]],["let",[["openNow",["or",["object/get","@g","open"],["if",[">",["object/get","@g","dwellMs"],0],[">=","@held",["object/get","@g","dwellMs"]],"@pass"]]]],["object/merge","@g",{"touching":"@inside","held":"@held","open":"@openNow","denied":["and",["==",["object/get","@g","dwellMs"],0],["and","@inside",["and",["==","@pass",false],["==",["object/get","@g","touching"],false]]]]}]]]]]]]]],["let",[["newly",["array/filter","@entity.gates",["fn","g",["and",["==",["object/get","@g","open"],true],["==",["object/get","@g","reported"],false]]]]]],["if",[">",["array/len","@newly"],0],["do",["set","@entity.gates",["array/map","@entity.gates",["fn","g",["if",["==",["object/get","@g","id"],["object/get",["array/first","@newly"],"id"]],["object/merge","@g",{"reported":true}],"@g"]]]],["emit","VELOCITY_GATE_OPENED",{"id":["object/get",["array/first","@newly"],"id"],"x":["object/get",["array/first","@newly"],"x"],"y":["object/get",["array/first","@newly"],"y"]}]],null]],["let",[["denied",["array/filter","@entity.gates",["fn","g",["==",["object/get","@g","denied"],true]]]]],["if",[">",["array/len","@denied"],0],["emit","VELOCITY_GATE_DENIED",{"id":["object/get",["array/first","@denied"],"id"],"x":["object/get",["array/first","@denied"],"x"],"y":["object/get",["array/first","@denied"],"y"],"speed":"@payload.speed"}],null]]]},{"from":"active","to":"active","event":"SET_VGATES","eventId":"evt_5P651ZJFX87YMDMG8K1XN2AVN5","effects":[["set","@entity.gates",["array/map","@payload.gates",["fn","g",["object/merge","@g",{"open":false,"touching":false,"denied":false,"held":0,"reported":false}]]]]]},{"from":"active","to":"active","event":"RESTART","eventId":"evt_CM68XWRHDM8PT976J4B33K9DZD","effects":[["set","@entity.gates",["array/map","@entity.gates",["fn","g",["object/merge","@g",{"open":false,"touching":false,"denied":false,"held":0,"reported":false}]]]]]}]},"config":{"gates":{"type":"[VelocityGate]","default":[],"label":"Gates","description":"One row per velocity gate: id, min-corner rect (x, y, width, height in world units), the speed band [minSpeed, maxSpeed] that opens it, the hold required (dwellMs 0 = instant), the horizontal direction required (dir -1/0/+1), and an optional hint shown when denied. open/touching/denied/held/reported are stamped at runtime. Seeded onto the entity on INIT; the live set is entity.gates — SET_VGATES replaces it at runtime (boards that import gates), and RESTART re-arms the live set rather than re-reading config, so injected gates survive respawns.","tier":"domain","items":{"type":"object","properties":{"width":{"name":"width","type":"number","required":true},"minSpeed":{"name":"minSpeed","type":"number","required":true},"dir":{"name":"dir","type":"number","required":true},"dwellMs":{"name":"dwellMs","type":"number","required":true},"height":{"name":"height","type":"number","required":true},"reported":{"name":"reported","type":"boolean","required":false},"denied":{"name":"denied","type":"boolean","required":false},"y":{"name":"y","type":"number","required":true},"hint":{"name":"hint","type":"string","required":false},"id":{"name":"id","type":"string","required":true},"x":{"name":"x","type":"number","required":true},"touching":{"name":"touching","type":"boolean","required":false},"maxSpeed":{"name":"maxSpeed","type":"number","required":true},"held":{"name":"held","type":"number","required":false},"open":{"name":"open","type":"boolean","required":false}}}},"reachMargin":{"type":"number","default":0.6,"label":"Reach Margin","description":"Extra world units padded around a closed gate's rect when testing player contact (approximates the body's size).","tier":"domain"},"running":{"type":"boolean","default":true,"label":"Running","description":"When true, BODY_MOVED tests every gate's band and opens/denies; toggle to freeze every gate as-is.","tier":"domain"}},"scope":"instance"}],"pages":[{"name":"VelocityGatePage","id":"pag_45AWVXGYE8F7465GAWSWXN4R54","path":"/velocity-gate","traits":[{"ref":"VelocityGate","refId":"trt_WTJPF9AS23CH1M1M57GXTY30F9"}]}],"types":{"VelocityGate":[{"name":"id","type":"string","required":true},{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"width","type":"number","required":true},{"name":"height","type":"number","required":true},{"name":"minSpeed","type":"number","required":true},{"name":"maxSpeed","type":"number","required":true},{"name":"dwellMs","type":"number","required":true},{"name":"dir","type":"number","required":true},{"name":"hint","type":"string"},{"name":"open","type":"boolean"},{"name":"touching","type":"boolean"},{"name":"denied","type":"boolean"},{"name":"held","type":"number"},{"name":"reported","type":"boolean"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9":{"id":"ent_11F5ZSKXZ4YZJA56TRHE7JB2T9","kind":"entity","bakedName":"VelocityGateData","curName":"VelocityGateData","renames":[],"owner":"workspace"},"evt_0J8B29RTT7DD3SCGB2F4Y16D19":{"id":"evt_0J8B29RTT7DD3SCGB2F4Y16D19","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_5P651ZJFX87YMDMG8K1XN2AVN5":{"id":"evt_5P651ZJFX87YMDMG8K1XN2AVN5","kind":"event","bakedName":"SET_VGATES","curName":"SET_VGATES","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_CM68XWRHDM8PT976J4B33K9DZD":{"id":"evt_CM68XWRHDM8PT976J4B33K9DZD","kind":"event","bakedName":"RESTART","curName":"RESTART","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_DZWN69D22RH1CE3QBMYVXDZ691":{"id":"evt_DZWN69D22RH1CE3QBMYVXDZ691","kind":"event","bakedName":"VELOCITY_GATE_DENIED","curName":"VELOCITY_GATE_DENIED","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_E9DKKZ24VC2DPFHA1K9HV3BG8S":{"id":"evt_E9DKKZ24VC2DPFHA1K9HV3BG8S","kind":"event","bakedName":"BODY_MOVED","curName":"BODY_MOVED","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"evt_RF817QV9HRMRW7CH192PGZW7RK":{"id":"evt_RF817QV9HRMRW7CH192PGZW7RK","kind":"event","bakedName":"VELOCITY_GATE_OPENED","curName":"VELOCITY_GATE_OPENED","renames":[],"owner":"workspace","parent":"trt_WTJPF9AS23CH1M1M57GXTY30F9"},"orb_A9XD83X8HXM8YJ10B41B6ZBQ6W":{"id":"orb_A9XD83X8HXM8YJ10B41B6ZBQ6W","kind":"orbital","bakedName":"VelocityGateOrbital","curName":"VelocityGateOrbital","renames":[],"owner":"workspace"},"pag_45AWVXGYE8F7465GAWSWXN4R54":{"id":"pag_45AWVXGYE8F7465GAWSWXN4R54","kind":"page","bakedName":"VelocityGatePage","curName":"VelocityGatePage","renames":[],"owner":"workspace"},"trt_WTJPF9AS23CH1M1M57GXTY30F9":{"id":"trt_WTJPF9AS23CH1M1M57GXTY30F9","kind":"trait","bakedName":"VelocityGate","curName":"VelocityGate","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/ui/game/atoms/std-xp.orb

@@ -1 +1 @@
-{"name":"std-xp","version":"1.0.0","description":"Headless XP/progression mechanic: grants xp when the enemy survivor count drops (UNITS_CHANGED), and on reaching xpToNext levels up — raising the threshold and emitting a HEAL reward the grid-tactics authority applies. Owns only xp/xpToNext/level (+ kill baseline); never writes units.","orbitals":[{"name":"XpOrbital","id":"orb_RDPW5W3P2SV1CVP806E8VJRD4Y","entity":{"name":"XpState","id":"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"xp","type":"number","default":0},{"name":"xpToNext","type":"number","default":100},{"name":"level","type":"number","default":1},{"name":"xpBaseline","type":"number","default":0}],"shared":true},"traits":[{"name":"XpProgression","id":"trt_69XKX902FA17NFXTXAJS07ANY2","entityRebindable":true,"entityContract":{"requires":[],"provides":["level","xp","xpBaseline","xpToNext"]},"effectRow":[{"kind":"emit","resource":"HEAL"},{"kind":"set","resource":"@entity.level"},{"kind":"set","resource":"@entity.xp"},{"kind":"set","resource":"@entity.xpBaseline"},{"kind":"set","resource":"@entity.xpToNext"}],"category":"lifecycle","linkedEntity":"XpState","linkedEntityId":"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G","entityRefIds":{"XpState":"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G"},"emits":[{"event":"HEAL","eventId":"evt_7XKP4XV9EVMQDXH2HHPQPVS0WM","description":"Level-up heal reward applied by the grid-tactics authority (the sole units writer)","tier":"domain","scope":"external","payloadSchema":[{"name":"team","type":"string","required":true},{"name":"amount","type":"number","required":true}]}],"stateMachine":{"states":[{"name":"active","isInitial":true}],"events":[{"key":"INIT","id":"evt_WH94PXZNX8TYMC7BH51TYK93G3","name":"Initialize"},{"key":"UNITS_CHANGED","id":"evt_51HVQC46DS36WXG9YFM9BDDF2B","name":"Units Changed","payloadSchema":[{"name":"playersAlive","type":"number"},{"name":"enemiesAlive","type":"number"}],"listened":true},{"key":"HEAL","id":"evt_7XKP4XV9EVMQDXH2HHPQPVS0WM","name":"Heal","description":"Level-up heal reward applied by the grid-tactics authority (the sole units writer)","tier":"domain","payloadSchema":[{"name":"team","type":"string","required":true},{"name":"amount","type":"number","required":true}]}],"transitions":[{"from":"active","to":"active","event":"INIT","eventId":"evt_WH94PXZNX8TYMC7BH51TYK93G3","effects":[["set","@entity.xp","@config.startXp"],["set","@entity.xpToNext","@config.baseXpToNext"],["set","@entity.level",1],["set","@entity.xpBaseline","@config.initialEnemies"]]},{"from":"active","to":"active","event":"UNITS_CHANGED","eventId":"evt_51HVQC46DS36WXG9YFM9BDDF2B","guard":"@config.running","effects":[["set","@entity.xp",["if",["<","@payload.enemiesAlive","@entity.xpBaseline"],["+","@entity.xp",["*",["-","@entity.xpBaseline","@payload.enemiesAlive"],"@config.xpPerKill"]],"@entity.xp"]],["set","@entity.xpBaseline","@payload.enemiesAlive"],["if",[">=","@entity.xp","@entity.xpToNext"],["emit","HEAL",{"team":"@config.healTeam","amount":"@config.levelUpHeal"}],null],["set","@entity.level",["if",[">=","@entity.xp","@entity.xpToNext"],["+","@entity.level",1],"@entity.level"]],["set","@entity.xpToNext",["if",[">=","@entity.xp","@entity.xpToNext"],["+","@entity.xpToNext","@config.xpToNextIncrement"],"@entity.xpToNext"]]]}]},"config":{"startXp":{"type":"number","default":0,"label":"Start XP","description":"XP set on INIT.","tier":"domain"},"baseXpToNext":{"type":"number","default":100,"label":"Base XP To Next","description":"XP threshold for the first level-up.","tier":"domain"},"healTeam":{"type":"string","default":"player","label":"Heal Team","description":"Team whose units are healed on level-up.","tier":"domain"},"xpToNextIncrement":{"type":"number","default":50,"label":"XP To Next Increment","description":"Amount the threshold rises by on each level-up.","tier":"domain"},"initialEnemies":{"type":"number","default":0,"label":"Initial Enemies","description":"Enemy count at start; the kill baseline so the first kill grants xp correctly.","tier":"domain"},"running":{"type":"boolean","default":true,"label":"Running","description":"When true, enemy-count drops grant xp and trigger level-ups; toggle to freeze.","tier":"domain"},"xpPerKill":{"type":"number","default":25,"label":"XP Per Kill","description":"XP awarded for each enemy removed since the last signal.","tier":"domain"},"levelUpHeal":{"type":"number","default":2,"label":"Level-Up Heal","description":"Health restored to the healTeam's units on each level-up.","tier":"domain"}},"scope":"instance"}],"pages":[{"name":"XpPage","id":"pag_X0ERXD5841M20ZQGHC3NFZZHKY","path":"/xp","traits":[{"ref":"XpProgression","refId":"trt_69XKX902FA17NFXTXAJS07ANY2"}]}]}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G":{"id":"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G","kind":"entity","bakedName":"XpState","curName":"XpState","renames":[],"owner":"workspace"},"evt_51HVQC46DS36WXG9YFM9BDDF2B":{"id":"evt_51HVQC46DS36WXG9YFM9BDDF2B","kind":"event","bakedName":"UNITS_CHANGED","curName":"UNITS_CHANGED","renames":[],"owner":"workspace","parent":"trt_69XKX902FA17NFXTXAJS07ANY2"},"evt_7XKP4XV9EVMQDXH2HHPQPVS0WM":{"id":"evt_7XKP4XV9EVMQDXH2HHPQPVS0WM","kind":"event","bakedName":"HEAL","curName":"HEAL","renames":[],"owner":"workspace","parent":"trt_69XKX902FA17NFXTXAJS07ANY2"},"evt_WH94PXZNX8TYMC7BH51TYK93G3":{"id":"evt_WH94PXZNX8TYMC7BH51TYK93G3","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_69XKX902FA17NFXTXAJS07ANY2"},"orb_RDPW5W3P2SV1CVP806E8VJRD4Y":{"id":"orb_RDPW5W3P2SV1CVP806E8VJRD4Y","kind":"orbital","bakedName":"XpOrbital","curName":"XpOrbital","renames":[],"owner":"workspace"},"pag_X0ERXD5841M20ZQGHC3NFZZHKY":{"id":"pag_X0ERXD5841M20ZQGHC3NFZZHKY","kind":"page","bakedName":"XpPage","curName":"XpPage","renames":[],"owner":"workspace"},"trt_69XKX902FA17NFXTXAJS07ANY2":{"id":"trt_69XKX902FA17NFXTXAJS07ANY2","kind":"trait","bakedName":"XpProgression","curName":"XpProgression","renames":[],"owner":"workspace"}}}}
+{"name":"std-xp","version":"1.0.0","description":"Headless XP/progression mechanic: grants xp when the enemy survivor count drops (UNITS_CHANGED), and on reaching xpToNext levels up — raising the threshold and emitting a HEAL reward the grid-tactics authority applies. Owns only xp/xpToNext/level (+ kill baseline); never writes units.","orbitals":[{"name":"XpOrbital","id":"orb_RDPW5W3P2SV1CVP806E8VJRD4Y","entity":{"name":"XpState","id":"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"xp","type":"number","default":0},{"name":"xpToNext","type":"number","default":100},{"name":"level","type":"number","default":1},{"name":"xpBaseline","type":"number","default":0}],"shared":true},"traits":[{"name":"XpProgression","id":"trt_69XKX902FA17NFXTXAJS07ANY2","entityRebindable":true,"entityContract":{"requires":[],"provides":["level","xp","xpBaseline","xpToNext"]},"effectRow":[{"kind":"emit","resource":"HEAL"},{"kind":"set","resource":"@entity.level"},{"kind":"set","resource":"@entity.xp"},{"kind":"set","resource":"@entity.xpBaseline"},{"kind":"set","resource":"@entity.xpToNext"}],"category":"lifecycle","linkedEntity":"XpState","linkedEntityId":"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G","entityRefIds":{"XpState":"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G"},"emits":[{"event":"HEAL","eventId":"evt_7XKP4XV9EVMQDXH2HHPQPVS0WM","description":"Level-up heal reward applied by the grid-tactics authority (the sole units writer)","tier":"domain","scope":"external","payloadSchema":[{"name":"team","type":"string","required":true},{"name":"amount","type":"number","required":true}]}],"stateMachine":{"states":[{"name":"active","isInitial":true}],"events":[{"key":"INIT","id":"evt_WH94PXZNX8TYMC7BH51TYK93G3","name":"Initialize"},{"key":"UNITS_CHANGED","id":"evt_51HVQC46DS36WXG9YFM9BDDF2B","name":"Units Changed","payloadSchema":[{"name":"playersAlive","type":"number"},{"name":"enemiesAlive","type":"number"}],"listened":true},{"key":"HEAL","id":"evt_7XKP4XV9EVMQDXH2HHPQPVS0WM","name":"Heal","description":"Level-up heal reward applied by the grid-tactics authority (the sole units writer)","tier":"domain","payloadSchema":[{"name":"team","type":"string","required":true},{"name":"amount","type":"number","required":true}]}],"transitions":[{"from":"active","to":"active","event":"INIT","eventId":"evt_WH94PXZNX8TYMC7BH51TYK93G3","effects":[["set","@entity.xp","@config.startXp"],["set","@entity.xpToNext","@config.baseXpToNext"],["set","@entity.level",1],["set","@entity.xpBaseline","@config.initialEnemies"]]},{"from":"active","to":"active","event":"UNITS_CHANGED","eventId":"evt_51HVQC46DS36WXG9YFM9BDDF2B","guard":"@config.running","effects":[["set","@entity.xp",["if",["<","@payload.enemiesAlive","@entity.xpBaseline"],["+","@entity.xp",["*",["-","@entity.xpBaseline","@payload.enemiesAlive"],"@config.xpPerKill"]],"@entity.xp"]],["set","@entity.xpBaseline","@payload.enemiesAlive"],["if",[">=","@entity.xp","@entity.xpToNext"],["emit","HEAL",{"team":"@config.healTeam","amount":"@config.levelUpHeal"}],null],["set","@entity.level",["if",[">=","@entity.xp","@entity.xpToNext"],["+","@entity.level",1],"@entity.level"]],["set","@entity.xpToNext",["if",[">=","@entity.xp","@entity.xpToNext"],["+","@entity.xpToNext","@config.xpToNextIncrement"],"@entity.xpToNext"]]]}]},"config":{"xpPerKill":{"type":"number","default":25,"label":"XP Per Kill","description":"XP awarded for each enemy removed since the last signal.","tier":"domain"},"initialEnemies":{"type":"number","default":0,"label":"Initial Enemies","description":"Enemy count at start; the kill baseline so the first kill grants xp correctly.","tier":"domain"},"running":{"type":"boolean","default":true,"label":"Running","description":"When true, enemy-count drops grant xp and trigger level-ups; toggle to freeze.","tier":"domain"},"baseXpToNext":{"type":"number","default":100,"label":"Base XP To Next","description":"XP threshold for the first level-up.","tier":"domain"},"healTeam":{"type":"string","default":"player","label":"Heal Team","description":"Team whose units are healed on level-up.","tier":"domain"},"levelUpHeal":{"type":"number","default":2,"label":"Level-Up Heal","description":"Health restored to the healTeam's units on each level-up.","tier":"domain"},"startXp":{"type":"number","default":0,"label":"Start XP","description":"XP set on INIT.","tier":"domain"},"xpToNextIncrement":{"type":"number","default":50,"label":"XP To Next Increment","description":"Amount the threshold rises by on each level-up.","tier":"domain"}},"scope":"instance"}],"pages":[{"name":"XpPage","id":"pag_X0ERXD5841M20ZQGHC3NFZZHKY","path":"/xp","traits":[{"ref":"XpProgression","refId":"trt_69XKX902FA17NFXTXAJS07ANY2"}]}]}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G":{"id":"ent_9RNYSYRBNQ5TVHP5498YPE8Z2G","kind":"entity","bakedName":"XpState","curName":"XpState","renames":[],"owner":"workspace"},"evt_51HVQC46DS36WXG9YFM9BDDF2B":{"id":"evt_51HVQC46DS36WXG9YFM9BDDF2B","kind":"event","bakedName":"UNITS_CHANGED","curName":"UNITS_CHANGED","renames":[],"owner":"workspace","parent":"trt_69XKX902FA17NFXTXAJS07ANY2"},"evt_7XKP4XV9EVMQDXH2HHPQPVS0WM":{"id":"evt_7XKP4XV9EVMQDXH2HHPQPVS0WM","kind":"event","bakedName":"HEAL","curName":"HEAL","renames":[],"owner":"workspace","parent":"trt_69XKX902FA17NFXTXAJS07ANY2"},"evt_WH94PXZNX8TYMC7BH51TYK93G3":{"id":"evt_WH94PXZNX8TYMC7BH51TYK93G3","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_69XKX902FA17NFXTXAJS07ANY2"},"orb_RDPW5W3P2SV1CVP806E8VJRD4Y":{"id":"orb_RDPW5W3P2SV1CVP806E8VJRD4Y","kind":"orbital","bakedName":"XpOrbital","curName":"XpOrbital","renames":[],"owner":"workspace"},"pag_X0ERXD5841M20ZQGHC3NFZZHKY":{"id":"pag_X0ERXD5841M20ZQGHC3NFZZHKY","kind":"page","bakedName":"XpPage","curName":"XpPage","renames":[],"owner":"workspace"},"trt_69XKX902FA17NFXTXAJS07ANY2":{"id":"trt_69XKX902FA17NFXTXAJS07ANY2","kind":"trait","bakedName":"XpProgression","curName":"XpProgression","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/ui/game/atoms/std-zone-card.orb

@@ -1 +1 @@
-{"name":"std-zone-card","version":"1.0.0","description":"Headless zone-guidance mechanic for side-view boards: tracks which band of the world the player is in and holds up that zone's card — name, concept, objective — for a while after every crossing. Listens BODY_MOVED and, when the player's x crosses into a different config zone, stamps the shared entity (zoneId, card, enteredAt) and emits ZONE_CHANGED carrying the card fields; the card self-clears ttlTicks BODY_MOVED ticks later (a per-move tick counter on the entity, so pauses at speed zero still age it out) and boards clear it early via CARD_DISMISS (renamed to a board-scoped progress event) on any mechanic completion. RESTART clears the card and the clock. Renders nothing; boards draw the card from the shared entity (the render authority).","orbitals":[{"name":"ZoneCardOrbital","id":"orb_1YBGF4NVAMXNA5NZNAEBVF2QRR","entity":{"name":"ZoneCardData","id":"ent_VPWXWCR2KG19REHHFSW0Y4ZB97","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"zoneId","type":"string","default":""},{"name":"card","type":"object","properties":{"objective":{"name":"objective","type":"string","required":false},"name":{"name":"name","type":"string","required":true},"concept":{"name":"concept","type":"string","required":false}}},{"name":"enteredAt","type":"number","default":0},{"name":"ticks","type":"number","default":0}],"shared":true},"traits":[{"name":"ZoneCard","id":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6","entityRebindable":true,"entityContract":{"requires":[],"provides":["card","enteredAt","ticks","zoneId"]},"effectRow":[{"kind":"emit","resource":"ZONE_CHANGED"},{"kind":"set","resource":"@entity.card"},{"kind":"set","resource":"@entity.enteredAt"},{"kind":"set","resource":"@entity.ticks"},{"kind":"set","resource":"@entity.zoneId"}],"category":"lifecycle","linkedEntity":"ZoneCardData","linkedEntityId":"ent_VPWXWCR2KG19REHHFSW0Y4ZB97","entityRefIds":{"ZoneCardData":"ent_VPWXWCR2KG19REHHFSW0Y4ZB97"},"emits":[{"event":"ZONE_CHANGED","eventId":"evt_QZQ236W0W70E3RAEW3878YHK75","description":"The player crossed into a different zone; carries the zone's card fields (name, concept, objective) so boards can swap banners/guides and hold the card up. Fires once per crossing.","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"name","type":"string","required":true},{"name":"concept","type":"string"},{"name":"objective","type":"string"}]}],"stateMachine":{"states":[{"name":"active","isInitial":true}],"events":[{"key":"INIT","id":"evt_F3V26CA1940MJ1K4F5X72T9N83","name":"Initialize"},{"key":"BODY_MOVED","id":"evt_25G04EXXXQYYVPZA12BTZK00HQ","name":"Body Moved","payloadSchema":[{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"vx","type":"number","required":true},{"name":"vy","type":"number","required":true},{"name":"grounded","type":"boolean","required":true},{"name":"skating","type":"boolean","required":true},{"name":"speed","type":"number","required":true}],"listened":true},{"key":"CARD_DISMISS","id":"evt_F5FZ9S2EE5772X2YTA5NNN1BZA","name":"Card Dismiss","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"RESTART","id":"evt_YJJDY04EGP78B9V9PDTK4Q51YJ","name":"Restart","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"ZONE_CHANGED","id":"evt_QZQ236W0W70E3RAEW3878YHK75","name":"Zone Changed","description":"The player crossed into a different zone; carries the zone's card fields (name, concept, objective) so boards can swap banners/guides and hold the card up. Fires once per crossing.","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"name","type":"string","required":true},{"name":"concept","type":"string"},{"name":"objective","type":"string"}]}],"transitions":[{"from":"active","to":"active","event":"INIT","eventId":"evt_F3V26CA1940MJ1K4F5X72T9N83","effects":[["set","@entity.zoneId",""],["set","@entity.card",null],["set","@entity.enteredAt",0],["set","@entity.ticks",0]]},{"from":"active","to":"active","event":"BODY_MOVED","eventId":"evt_25G04EXXXQYYVPZA12BTZK00HQ","guard":"@config.running","effects":[["set","@entity.ticks",["+","@entity.ticks",1]],["let",[["zmatch",["array/filter","@config.zones",["fn","z",["and",[">=","@payload.x",["object/get","@z","x0"]],["<","@payload.x",["object/get","@z","x1"]]]]]]],["do",["if",["and",[">",["array/len","@zmatch"],0],["!=","@entity.zoneId",["object/get",["array/first","@zmatch"],"id"]]],["do",["set","@entity.zoneId",["object/get",["array/first","@zmatch"],"id"]],["set","@entity.card",{"name":["object/get",["array/first","@zmatch"],"name"],"concept":["object/get",["array/first","@zmatch"],"concept"],"objective":["object/get",["array/first","@zmatch"],"objective"]}],["set","@entity.enteredAt","@entity.ticks"],["emit","ZONE_CHANGED",{"id":["object/get",["array/first","@zmatch"],"id"],"name":["object/get",["array/first","@zmatch"],"name"],"concept":["object/get",["array/first","@zmatch"],"concept"],"objective":["object/get",["array/first","@zmatch"],"objective"]}]],null],["if",["and",["!=","@entity.card",null],[">",["-","@entity.ticks","@entity.enteredAt"],"@config.ttlTicks"]],["set","@entity.card",null],null]]]]},{"from":"active","to":"active","event":"CARD_DISMISS","eventId":"evt_F5FZ9S2EE5772X2YTA5NNN1BZA","effects":[["set","@entity.card",null]]},{"from":"active","to":"active","event":"RESTART","eventId":"evt_YJJDY04EGP78B9V9PDTK4Q51YJ","effects":[["set","@entity.zoneId",""],["set","@entity.card",null],["set","@entity.enteredAt",0],["set","@entity.ticks",0]]}]},"config":{"running":{"type":"boolean","default":true,"label":"Running","description":"When true, BODY_MOVED tracks the current zone and ages the card; toggle to freeze the card as-is.","tier":"domain"},"ttlTicks":{"type":"number","default":120,"label":"TTL Ticks","description":"BODY_MOVED ticks the card stays up after a zone crossing (≈ 4s at 30 moves/s) before it clears itself.","tier":"domain"},"zones":{"type":"[ZoneCardZone]","default":[],"label":"Zones","description":"One row per world band: id, display name, the one-line concept, the zone's objective text, and the x-range (x0..x1) the band covers.","tier":"domain","items":{"type":"object","properties":{"x1":{"name":"x1","type":"number","required":true},"concept":{"name":"concept","type":"string","required":false},"x0":{"name":"x0","type":"number","required":true},"id":{"name":"id","type":"string","required":true},"objective":{"name":"objective","type":"string","required":false},"name":{"name":"name","type":"string","required":true}}}}},"scope":"instance"}],"pages":[{"name":"ZoneCardPage","id":"pag_2GD5EPJ9KJ4SS4C1Y6N4F5R2VQ","path":"/zone-card","traits":[{"ref":"ZoneCard","refId":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"}]}],"types":{"ZoneCard":[{"name":"name","type":"string","required":true},{"name":"concept","type":"string"},{"name":"objective","type":"string"}],"ZoneCardZone":[{"name":"id","type":"string","required":true},{"name":"name","type":"string","required":true},{"name":"concept","type":"string"},{"name":"objective","type":"string"},{"name":"x0","type":"number","required":true},{"name":"x1","type":"number","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_VPWXWCR2KG19REHHFSW0Y4ZB97":{"id":"ent_VPWXWCR2KG19REHHFSW0Y4ZB97","kind":"entity","bakedName":"ZoneCardData","curName":"ZoneCardData","renames":[],"owner":"workspace"},"evt_25G04EXXXQYYVPZA12BTZK00HQ":{"id":"evt_25G04EXXXQYYVPZA12BTZK00HQ","kind":"event","bakedName":"BODY_MOVED","curName":"BODY_MOVED","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"evt_F3V26CA1940MJ1K4F5X72T9N83":{"id":"evt_F3V26CA1940MJ1K4F5X72T9N83","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"evt_F5FZ9S2EE5772X2YTA5NNN1BZA":{"id":"evt_F5FZ9S2EE5772X2YTA5NNN1BZA","kind":"event","bakedName":"CARD_DISMISS","curName":"CARD_DISMISS","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"evt_QZQ236W0W70E3RAEW3878YHK75":{"id":"evt_QZQ236W0W70E3RAEW3878YHK75","kind":"event","bakedName":"ZONE_CHANGED","curName":"ZONE_CHANGED","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"evt_YJJDY04EGP78B9V9PDTK4Q51YJ":{"id":"evt_YJJDY04EGP78B9V9PDTK4Q51YJ","kind":"event","bakedName":"RESTART","curName":"RESTART","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"orb_1YBGF4NVAMXNA5NZNAEBVF2QRR":{"id":"orb_1YBGF4NVAMXNA5NZNAEBVF2QRR","kind":"orbital","bakedName":"ZoneCardOrbital","curName":"ZoneCardOrbital","renames":[],"owner":"workspace"},"pag_2GD5EPJ9KJ4SS4C1Y6N4F5R2VQ":{"id":"pag_2GD5EPJ9KJ4SS4C1Y6N4F5R2VQ","kind":"page","bakedName":"ZoneCardPage","curName":"ZoneCardPage","renames":[],"owner":"workspace"},"trt_DX4CD19EKNQ9TNJV1X89FPM2W6":{"id":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6","kind":"trait","bakedName":"ZoneCard","curName":"ZoneCard","renames":[],"owner":"workspace"}}}}
+{"name":"std-zone-card","version":"1.0.0","description":"Headless zone-guidance mechanic for side-view boards: tracks which band of the world the player is in and holds up that zone's card — name, concept, objective — for a while after every crossing. Listens BODY_MOVED and, when the player's x crosses into a different config zone, stamps the shared entity (zoneId, card, enteredAt) and emits ZONE_CHANGED carrying the card fields; the card self-clears ttlTicks BODY_MOVED ticks later (a per-move tick counter on the entity, so pauses at speed zero still age it out) and boards clear it early via CARD_DISMISS (renamed to a board-scoped progress event) on any mechanic completion. RESTART clears the card and the clock. Renders nothing; boards draw the card from the shared entity (the render authority).","orbitals":[{"name":"ZoneCardOrbital","id":"orb_1YBGF4NVAMXNA5NZNAEBVF2QRR","entity":{"name":"ZoneCardData","id":"ent_VPWXWCR2KG19REHHFSW0Y4ZB97","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"zoneId","type":"string","default":""},{"name":"card","type":"object","properties":{"name":{"name":"name","type":"string","required":true},"concept":{"name":"concept","type":"string","required":false},"objective":{"name":"objective","type":"string","required":false}}},{"name":"enteredAt","type":"number","default":0},{"name":"ticks","type":"number","default":0}],"shared":true},"traits":[{"name":"ZoneCard","id":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6","entityRebindable":true,"entityContract":{"requires":[],"provides":["card","enteredAt","ticks","zoneId"]},"effectRow":[{"kind":"emit","resource":"ZONE_CHANGED"},{"kind":"set","resource":"@entity.card"},{"kind":"set","resource":"@entity.enteredAt"},{"kind":"set","resource":"@entity.ticks"},{"kind":"set","resource":"@entity.zoneId"}],"category":"lifecycle","linkedEntity":"ZoneCardData","linkedEntityId":"ent_VPWXWCR2KG19REHHFSW0Y4ZB97","entityRefIds":{"ZoneCardData":"ent_VPWXWCR2KG19REHHFSW0Y4ZB97"},"emits":[{"event":"ZONE_CHANGED","eventId":"evt_QZQ236W0W70E3RAEW3878YHK75","description":"The player crossed into a different zone; carries the zone's card fields (name, concept, objective) so boards can swap banners/guides and hold the card up. Fires once per crossing.","tier":"domain","scope":"external","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"name","type":"string","required":true},{"name":"concept","type":"string"},{"name":"objective","type":"string"}]}],"stateMachine":{"states":[{"name":"active","isInitial":true}],"events":[{"key":"INIT","id":"evt_F3V26CA1940MJ1K4F5X72T9N83","name":"Initialize"},{"key":"BODY_MOVED","id":"evt_25G04EXXXQYYVPZA12BTZK00HQ","name":"Body Moved","payloadSchema":[{"name":"x","type":"number","required":true},{"name":"y","type":"number","required":true},{"name":"vx","type":"number","required":true},{"name":"vy","type":"number","required":true},{"name":"grounded","type":"boolean","required":true},{"name":"skating","type":"boolean","required":true},{"name":"speed","type":"number","required":true}],"listened":true},{"key":"CARD_DISMISS","id":"evt_F5FZ9S2EE5772X2YTA5NNN1BZA","name":"Card Dismiss","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"RESTART","id":"evt_YJJDY04EGP78B9V9PDTK4Q51YJ","name":"Restart","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"ZONE_CHANGED","id":"evt_QZQ236W0W70E3RAEW3878YHK75","name":"Zone Changed","description":"The player crossed into a different zone; carries the zone's card fields (name, concept, objective) so boards can swap banners/guides and hold the card up. Fires once per crossing.","tier":"domain","payloadSchema":[{"name":"id","type":"string","required":true},{"name":"name","type":"string","required":true},{"name":"concept","type":"string"},{"name":"objective","type":"string"}]}],"transitions":[{"from":"active","to":"active","event":"INIT","eventId":"evt_F3V26CA1940MJ1K4F5X72T9N83","effects":[["set","@entity.zoneId",""],["set","@entity.card",null],["set","@entity.enteredAt",0],["set","@entity.ticks",0]]},{"from":"active","to":"active","event":"BODY_MOVED","eventId":"evt_25G04EXXXQYYVPZA12BTZK00HQ","guard":"@config.running","effects":[["set","@entity.ticks",["+","@entity.ticks",1]],["let",[["zmatch",["array/filter","@config.zones",["fn","z",["and",[">=","@payload.x",["object/get","@z","x0"]],["<","@payload.x",["object/get","@z","x1"]]]]]]],["do",["if",["and",[">",["array/len","@zmatch"],0],["!=","@entity.zoneId",["object/get",["array/first","@zmatch"],"id"]]],["do",["set","@entity.zoneId",["object/get",["array/first","@zmatch"],"id"]],["set","@entity.card",{"name":["object/get",["array/first","@zmatch"],"name"],"concept":["object/get",["array/first","@zmatch"],"concept"],"objective":["object/get",["array/first","@zmatch"],"objective"]}],["set","@entity.enteredAt","@entity.ticks"],["emit","ZONE_CHANGED",{"id":["object/get",["array/first","@zmatch"],"id"],"name":["object/get",["array/first","@zmatch"],"name"],"concept":["object/get",["array/first","@zmatch"],"concept"],"objective":["object/get",["array/first","@zmatch"],"objective"]}]],null],["if",["and",["!=","@entity.card",null],[">",["-","@entity.ticks","@entity.enteredAt"],"@config.ttlTicks"]],["set","@entity.card",null],null]]]]},{"from":"active","to":"active","event":"CARD_DISMISS","eventId":"evt_F5FZ9S2EE5772X2YTA5NNN1BZA","effects":[["set","@entity.card",null]]},{"from":"active","to":"active","event":"RESTART","eventId":"evt_YJJDY04EGP78B9V9PDTK4Q51YJ","effects":[["set","@entity.zoneId",""],["set","@entity.card",null],["set","@entity.enteredAt",0],["set","@entity.ticks",0]]}]},"config":{"running":{"type":"boolean","default":true,"label":"Running","description":"When true, BODY_MOVED tracks the current zone and ages the card; toggle to freeze the card as-is.","tier":"domain"},"ttlTicks":{"type":"number","default":120,"label":"TTL Ticks","description":"BODY_MOVED ticks the card stays up after a zone crossing (≈ 4s at 30 moves/s) before it clears itself.","tier":"domain"},"zones":{"type":"[ZoneCardZone]","default":[],"label":"Zones","description":"One row per world band: id, display name, the one-line concept, the zone's objective text, and the x-range (x0..x1) the band covers.","tier":"domain","items":{"type":"object","properties":{"x1":{"name":"x1","type":"number","required":true},"id":{"name":"id","type":"string","required":true},"name":{"name":"name","type":"string","required":true},"objective":{"name":"objective","type":"string","required":false},"x0":{"name":"x0","type":"number","required":true},"concept":{"name":"concept","type":"string","required":false}}}}},"scope":"instance"}],"pages":[{"name":"ZoneCardPage","id":"pag_2GD5EPJ9KJ4SS4C1Y6N4F5R2VQ","path":"/zone-card","traits":[{"ref":"ZoneCard","refId":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"}]}],"types":{"ZoneCard":[{"name":"name","type":"string","required":true},{"name":"concept","type":"string"},{"name":"objective","type":"string"}],"ZoneCardZone":[{"name":"id","type":"string","required":true},{"name":"name","type":"string","required":true},{"name":"concept","type":"string"},{"name":"objective","type":"string"},{"name":"x0","type":"number","required":true},{"name":"x1","type":"number","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_VPWXWCR2KG19REHHFSW0Y4ZB97":{"id":"ent_VPWXWCR2KG19REHHFSW0Y4ZB97","kind":"entity","bakedName":"ZoneCardData","curName":"ZoneCardData","renames":[],"owner":"workspace"},"evt_25G04EXXXQYYVPZA12BTZK00HQ":{"id":"evt_25G04EXXXQYYVPZA12BTZK00HQ","kind":"event","bakedName":"BODY_MOVED","curName":"BODY_MOVED","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"evt_F3V26CA1940MJ1K4F5X72T9N83":{"id":"evt_F3V26CA1940MJ1K4F5X72T9N83","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"evt_F5FZ9S2EE5772X2YTA5NNN1BZA":{"id":"evt_F5FZ9S2EE5772X2YTA5NNN1BZA","kind":"event","bakedName":"CARD_DISMISS","curName":"CARD_DISMISS","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"evt_QZQ236W0W70E3RAEW3878YHK75":{"id":"evt_QZQ236W0W70E3RAEW3878YHK75","kind":"event","bakedName":"ZONE_CHANGED","curName":"ZONE_CHANGED","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"evt_YJJDY04EGP78B9V9PDTK4Q51YJ":{"id":"evt_YJJDY04EGP78B9V9PDTK4Q51YJ","kind":"event","bakedName":"RESTART","curName":"RESTART","renames":[],"owner":"workspace","parent":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6"},"orb_1YBGF4NVAMXNA5NZNAEBVF2QRR":{"id":"orb_1YBGF4NVAMXNA5NZNAEBVF2QRR","kind":"orbital","bakedName":"ZoneCardOrbital","curName":"ZoneCardOrbital","renames":[],"owner":"workspace"},"pag_2GD5EPJ9KJ4SS4C1Y6N4F5R2VQ":{"id":"pag_2GD5EPJ9KJ4SS4C1Y6N4F5R2VQ","kind":"page","bakedName":"ZoneCardPage","curName":"ZoneCardPage","renames":[],"owner":"workspace"},"trt_DX4CD19EKNQ9TNJV1X89FPM2W6":{"id":"trt_DX4CD19EKNQ9TNJV1X89FPM2W6","kind":"trait","bakedName":"ZoneCard","curName":"ZoneCard","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/ui/game/atoms/ui-action-palette.orb

@@ -1 +1 @@
-{"name":"ui-action-palette","version":"1.0.0","description":"ActionPalette — UI factory (1:1 with the @almadar/ui action-palette pattern).","orbitals":[{"name":"ActionPaletteOrbital","id":"orb_GBSCY7ZGHNR8TQQBWEBJ9XMKKT","entity":{"name":"ActionPaletteItem","id":"ent_ZEZPXAZBNMNTTDK57J5X77ABVM","persistence":"runtime","fields":[{"name":"id","type":"string","required":true}]},"traits":[{"name":"ActionPaletteRender","id":"trt_BDFJRHJYNVFAXK1H6G6A5VAP01","entityRebindable":true,"entityContract":{"requires":[],"provides":[]},"effectRow":[{"kind":"render-ui","resource":"main"}],"category":"interaction","linkedEntity":"ActionPaletteItem","linkedEntityId":"ent_ZEZPXAZBNMNTTDK57J5X77ABVM","entityRefIds":{"ActionPaletteItem":"ent_ZEZPXAZBNMNTTDK57J5X77ABVM"},"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_76WZC19YF0Z7G9XSHJRJB3FFKS","name":"Initialize"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_76WZC19YF0Z7G9XSHJRJB3FFKS","effects":[["render-ui","main",{"actions":"@config.actions","usedActionIds":"@config.usedActionIds","allowDuplicates":"@config.allowDuplicates","categoryColors":"@config.categoryColors","size":"@config.size","label":"@config.label","className":"@config.className","enter":"@config.enter","enterDelay":"@config.enterDelay","skeleton":"@config.skeleton","aria-label":"@config.ariaLabel","aria-labelledby":"@config.ariaLabelledby","aria-describedby":"@config.ariaDescribedby","aria-live":"@config.ariaLive","aria-current":"@config.ariaCurrent","aria-pressed":"@config.ariaPressed","aria-expanded":"@config.ariaExpanded","aria-selected":"@config.ariaSelected","aria-hidden":"@config.ariaHidden","aria-busy":"@config.ariaBusy","role":"@config.role","lang":"@config.lang","dir":"@config.dir","tabIndex":"@config.tabIndex","type":"action-palette"}]]}]},"config":{"ariaLabelledby":{"type":"string","label":"Aria-labelledby","description":"Id of the element whose text names this one.","synonyms":"aria-labelledby","tier":"presentation"},"label":{"type":"string","label":"Label","description":"Label above the palette","tier":"presentation"},"size":{"type":"string","default":"md","label":"Size","description":"Size variant","tier":"presentation","values":["sm","md","lg"]},"ariaLabel":{"type":"string","label":"Aria-label","description":"Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control).","synonyms":"aria-label","tier":"presentation"},"role":{"type":"string","label":"Role","description":"WAI-ARIA role when the element's native semantics don't describe it.","tier":"presentation","values":["alert","alertdialog","application","article","banner","blockquote","button","caption","cell","checkbox","code","columnheader","combobox","complementary","contentinfo","definition","deletion","dialog","document","emphasis","feed","figure","form","generic","grid","gridcell","group","heading","img","insertion","link","list","listbox","listitem","log","main","marquee","math","menu","menubar","menuitem","menuitemcheckbox","menuitemradio","meter","navigation","none","note","option","paragraph","presentation","progressbar","radio","radiogroup","region","row","rowgroup","rowheader","scrollbar","search","searchbox","separator","slider","spinbutton","status","strong","subscript","superscript","switch","tab","table","tablist","tabpanel","term","textbox","time","timer","toolbar","tooltip","tree","treegrid","treeitem"]},"enter":{"type":"string","label":"Enter","description":"How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out.","tier":"presentation","values":["none","fade","rise","scale","slide"]},"allowDuplicates":{"type":"boolean","default":true,"label":"Allow Duplicates","description":"Whether each action can be used multiple times","tier":"presentation"},"lang":{"type":"string","label":"Lang","description":"Language of this element's content (BCP 47, e.g. ar, sl, en).","tier":"presentation"},"className":{"type":"string","label":"Class Name","description":"Additional CSS classes","tier":"presentation"},"ariaExpanded":{"type":"boolean","label":"Aria-expanded","description":"Whether the element it controls is expanded.","synonyms":"aria-expanded","tier":"presentation"},"ariaPressed":{"type":"string","label":"Aria-pressed","description":"Toggle-button state.","synonyms":"aria-pressed","tier":"presentation","values":["true","false","mixed"]},"categoryColors":{"type":"Map<string,ActionPaletteCategoryColorsValue>","default":{},"label":"Category Colors","description":"Category → color mapping","tier":"presentation","items":{"type":"object","properties":{"border":{"name":"border","type":"string","required":true},"bg":{"name":"bg","type":"string","required":true}}}},"ariaSelected":{"type":"boolean","label":"Aria-selected","description":"Whether this item is selected (tabs, options, grid cells).","synonyms":"aria-selected","tier":"presentation"},"ariaBusy":{"type":"boolean","label":"Aria-busy","description":"This region is updating; assistive technology waits before announcing it.","synonyms":"aria-busy","tier":"presentation"},"ariaCurrent":{"type":"string","label":"Aria-current","description":"Marks the current item in a set: the current page, step, location, date or time.","synonyms":"aria-current","tier":"presentation","values":["page","step","location","date","time","true","false"]},"actions":{"type":"[ActionPaletteActionsItem]","default":[{"id":"Id","name":"Name","category":"Category","description":"Description","iconEmoji":"Icon Emoji","iconUrl":{"url":"https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png","role":"ui","category":"iconUrl","animations":["static"],"style":"pixel","dimension":"2d","aspect":"1:1","name":"iconUrl","thumbnailUrl":""},"stateMachine":{"name":"Name","states":["Item","Item 2"],"currentState":"Current State","transitions":[{"from":"From","to":"To","event":"Event","guardHint":"Guard Hint"},{"from":"From 2","to":"To 2","event":"Event 2","guardHint":"Guard Hint 2"}],"description":"Description"}},{"id":"Id 2","name":"Name 2","category":"Category 2","description":"Description 2","iconEmoji":"Icon Emoji 2","iconUrl":{"url":"https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png","role":"ui","category":"iconUrl","animations":["static"],"style":"pixel","dimension":"2d","aspect":"1:1","name":"iconUrl","thumbnailUrl":""},"stateMachine":{"name":"Name 2","states":["Item","Item 2"],"currentState":"Current State 2","transitions":[{"from":"From","to":"To","event":"Event","guardHint":"Guard Hint"},{"from":"From 2","to":"To 2","event":"Event 2","guardHint":"Guard Hint 2"}],"description":"Description 2"}}],"label":"Actions","description":"Available actions","tier":"presentation","items":{"type":"object","properties":{"stateMachine":{"name":"stateMachine","type":"object","required":false,"properties":{"currentState":{"name":"currentState","type":"string","required":true},"transitions":{"name":"transitions","type":"array","required":true,"items":{"type":"object","properties":{"to":{"name":"to","type":"string","required":true},"guardHint":{"name":"guardHint","type":"string","required":false},"event":{"name":"event","type":"string","required":true},"from":{"name":"from","type":"string","required":true}}}},"name":{"name":"name","type":"string","required":true},"description":{"name":"description","type":"string","required":false},"states":{"name":"states","type":"array","required":true,"items":{"type":"string"}}}},"id":{"name":"id","type":"string","required":true},"iconEmoji":{"name":"iconEmoji","type":"string","required":false},"iconUrl":{"name":"iconUrl","type":"object","required":false,"properties":{"dimension":{"name":"dimension","type":"string","required":false,"values":["2d","3d"]},"sprite":{"name":"sprite","type":"string","required":false},"role":{"name":"role","type":"string","required":true},"category":{"name":"category","type":"string","required":true},"name":{"name":"name","type":"string","required":false},"aspect":{"name":"aspect","type":"string","required":false,"values":["1:1","16:9","5:7","8:1","4:1","5:3","1:2"]},"variant":{"name":"variant","type":"string","required":false},"atlas":{"name":"atlas","type":"string","required":false},"style":{"name":"style","type":"string","required":false,"values":["pixel","vector","hd","1-bit","isometric"]},"url":{"name":"url","type":"string","required":true},"animations":{"name":"animations","type":"array","required":false,"items":{"type":"string"}},"thumbnailUrl":{"name":"thumbnailUrl","type":"string","required":false}}},"category":{"name":"category","type":"string","required":true},"name":{"name":"name","type":"string","required":true},"description":{"name":"description","type":"string","required":false}}}},"usedActionIds":{"type":"[string]","default":[],"label":"Used Action Ids","description":"IDs of actions that are already used (shown as disabled)","tier":"presentation","items":{"type":"string"}},"tabIndex":{"type":"number","label":"Tab Index","description":"0 puts the element in the Tab order; -1 makes it focusable only programmatically.","tier":"presentation"},"ariaDescribedby":{"type":"string","label":"Aria-describedby","description":"Id of the element whose text describes this one (help text, error).","synonyms":"aria-describedby","tier":"presentation"},"dir":{"type":"string","label":"Dir","description":"Text direction of this element's content.","tier":"presentation","values":["ltr","rtl","auto"]},"ariaHidden":{"type":"boolean","label":"Aria-hidden","description":"Hide from assistive technology (decorative content only).","synonyms":"aria-hidden","tier":"presentation"},"ariaLive":{"type":"string","label":"Aria-live","description":"Announce changes to this region: polite waits for a pause, assertive interrupts.","synonyms":"aria-live","tier":"presentation","values":["off","polite","assertive"]},"enterDelay":{"type":"number","label":"Enter Delay","description":"Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating.","tier":"presentation"},"skeleton":{"type":"string","label":"Skeleton","description":"Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.","tier":"presentation","values":["header","table","list","grid","detail","stats","form","card","text","none"]}},"scope":"instance"}],"pages":[{"name":"ActionPalettePage","id":"pag_5YVSR1T7NN3TTM3Y8VPB0HPT58","path":"/action-palette","traits":[{"ref":"ActionPaletteRender","refId":"trt_BDFJRHJYNVFAXK1H6G6A5VAP01"}]}],"types":{"ActionPaletteActionsItem":[{"name":"id","type":"string","required":true},{"name":"name","type":"string","required":true},{"name":"category","type":"string","required":true},{"name":"description","type":"string"},{"name":"iconEmoji","type":"string"},{"name":"iconUrl","type":"object","properties":[{"name":"url","type":"asset","required":true},{"name":"role","type":"string","required":true},{"name":"category","type":"string","required":true},{"name":"animations","type":"[string]"},{"name":"style","type":"string","values":["pixel","vector","hd","1-bit","isometric"]},{"name":"variant","type":"string"},{"name":"dimension","type":"string","values":["2d","3d"]},{"name":"aspect","type":"string","values":["1:1","16:9","5:7","8:1","4:1","5:3","1:2"]},{"name":"atlas","type":"asset"},{"name":"sprite","type":"string"},{"name":"name","type":"string"},{"name":"thumbnailUrl","type":"string"}]},{"name":"stateMachine","type":"object","properties":[{"name":"name","type":"string","required":true},{"name":"states","type":"[string]","required":true},{"name":"currentState","type":"string","required":true},{"name":"transitions","type":"[object]","required":true,"properties":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"event","type":"string","required":true},{"name":"guardHint","type":"string"}]},{"name":"description","type":"string"}]}],"ActionPaletteActionsItemIconUrl":[{"name":"url","type":"asset","required":true},{"name":"role","type":"string","required":true},{"name":"category","type":"string","required":true},{"name":"animations","type":"[string]"},{"name":"style","type":"string","values":["pixel","vector","hd","1-bit","isometric"]},{"name":"variant","type":"string"},{"name":"dimension","type":"string","values":["2d","3d"]},{"name":"aspect","type":"string","values":["1:1","16:9","5:7","8:1","4:1","5:3","1:2"]},{"name":"atlas","type":"asset"},{"name":"sprite","type":"string"},{"name":"name","type":"string"},{"name":"thumbnailUrl","type":"string"}],"ActionPaletteActionsItemStateMachine":[{"name":"name","type":"string","required":true},{"name":"states","type":"[string]","required":true},{"name":"currentState","type":"string","required":true},{"name":"transitions","type":"[object]","required":true,"properties":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"event","type":"string","required":true},{"name":"guardHint","type":"string"}]},{"name":"description","type":"string"}],"ActionPaletteActionsItemStateMachineTransitionsItem":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"event","type":"string","required":true},{"name":"guardHint","type":"string"}],"ActionPaletteCategoryColorsValue":[{"name":"bg","type":"string","required":true},{"name":"border","type":"string","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_ZEZPXAZBNMNTTDK57J5X77ABVM":{"id":"ent_ZEZPXAZBNMNTTDK57J5X77ABVM","kind":"entity","bakedName":"ActionPaletteItem","curName":"ActionPaletteItem","renames":[],"owner":"workspace"},"evt_76WZC19YF0Z7G9XSHJRJB3FFKS":{"id":"evt_76WZC19YF0Z7G9XSHJRJB3FFKS","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_BDFJRHJYNVFAXK1H6G6A5VAP01"},"orb_GBSCY7ZGHNR8TQQBWEBJ9XMKKT":{"id":"orb_GBSCY7ZGHNR8TQQBWEBJ9XMKKT","kind":"orbital","bakedName":"ActionPaletteOrbital","curName":"ActionPaletteOrbital","renames":[],"owner":"workspace"},"pag_5YVSR1T7NN3TTM3Y8VPB0HPT58":{"id":"pag_5YVSR1T7NN3TTM3Y8VPB0HPT58","kind":"page","bakedName":"ActionPalettePage","curName":"ActionPalettePage","renames":[],"owner":"workspace"},"trt_BDFJRHJYNVFAXK1H6G6A5VAP01":{"id":"trt_BDFJRHJYNVFAXK1H6G6A5VAP01","kind":"trait","bakedName":"ActionPaletteRender","curName":"ActionPaletteRender","renames":[],"owner":"workspace"}}}}
+{"name":"ui-action-palette","version":"1.0.0","description":"ActionPalette — UI factory (1:1 with the @almadar/ui action-palette pattern).","orbitals":[{"name":"ActionPaletteOrbital","id":"orb_GBSCY7ZGHNR8TQQBWEBJ9XMKKT","entity":{"name":"ActionPaletteItem","id":"ent_ZEZPXAZBNMNTTDK57J5X77ABVM","persistence":"runtime","fields":[{"name":"id","type":"string","required":true}]},"traits":[{"name":"ActionPaletteRender","id":"trt_BDFJRHJYNVFAXK1H6G6A5VAP01","entityRebindable":true,"entityContract":{"requires":[],"provides":[]},"effectRow":[{"kind":"render-ui","resource":"main"}],"category":"interaction","linkedEntity":"ActionPaletteItem","linkedEntityId":"ent_ZEZPXAZBNMNTTDK57J5X77ABVM","entityRefIds":{"ActionPaletteItem":"ent_ZEZPXAZBNMNTTDK57J5X77ABVM"},"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_76WZC19YF0Z7G9XSHJRJB3FFKS","name":"Initialize"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_76WZC19YF0Z7G9XSHJRJB3FFKS","effects":[["render-ui","main",{"actions":"@config.actions","usedActionIds":"@config.usedActionIds","allowDuplicates":"@config.allowDuplicates","categoryColors":"@config.categoryColors","size":"@config.size","label":"@config.label","className":"@config.className","enter":"@config.enter","enterDelay":"@config.enterDelay","skeleton":"@config.skeleton","aria-label":"@config.ariaLabel","aria-labelledby":"@config.ariaLabelledby","aria-describedby":"@config.ariaDescribedby","aria-live":"@config.ariaLive","aria-current":"@config.ariaCurrent","aria-pressed":"@config.ariaPressed","aria-expanded":"@config.ariaExpanded","aria-selected":"@config.ariaSelected","aria-hidden":"@config.ariaHidden","aria-busy":"@config.ariaBusy","role":"@config.role","lang":"@config.lang","dir":"@config.dir","tabIndex":"@config.tabIndex","type":"action-palette"}]]}]},"config":{"ariaLabel":{"type":"string","label":"Aria-label","description":"Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control).","synonyms":"aria-label","tier":"presentation"},"ariaExpanded":{"type":"boolean","label":"Aria-expanded","description":"Whether the element it controls is expanded.","synonyms":"aria-expanded","tier":"presentation"},"allowDuplicates":{"type":"boolean","default":true,"label":"Allow Duplicates","description":"Whether each action can be used multiple times","tier":"presentation"},"actions":{"type":"[ActionPaletteActionsItem]","default":[{"id":"Id","name":"Name","category":"Category","description":"Description","iconEmoji":"Icon Emoji","iconUrl":{"url":"https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png","role":"ui","category":"iconUrl","animations":["static"],"style":"pixel","dimension":"2d","aspect":"1:1","name":"iconUrl","thumbnailUrl":""},"stateMachine":{"name":"Name","states":["Item","Item 2"],"currentState":"Current State","transitions":[{"from":"From","to":"To","event":"Event","guardHint":"Guard Hint"},{"from":"From 2","to":"To 2","event":"Event 2","guardHint":"Guard Hint 2"}],"description":"Description"}},{"id":"Id 2","name":"Name 2","category":"Category 2","description":"Description 2","iconEmoji":"Icon Emoji 2","iconUrl":{"url":"https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png","role":"ui","category":"iconUrl","animations":["static"],"style":"pixel","dimension":"2d","aspect":"1:1","name":"iconUrl","thumbnailUrl":""},"stateMachine":{"name":"Name 2","states":["Item","Item 2"],"currentState":"Current State 2","transitions":[{"from":"From","to":"To","event":"Event","guardHint":"Guard Hint"},{"from":"From 2","to":"To 2","event":"Event 2","guardHint":"Guard Hint 2"}],"description":"Description 2"}}],"label":"Actions","description":"Available actions","tier":"presentation","items":{"type":"object","properties":{"description":{"name":"description","type":"string","required":false},"iconUrl":{"name":"iconUrl","type":"object","required":false,"properties":{"atlas":{"name":"atlas","type":"string","required":false},"sprite":{"name":"sprite","type":"string","required":false},"style":{"name":"style","type":"string","required":false,"values":["pixel","vector","hd","1-bit","isometric"]},"name":{"name":"name","type":"string","required":false},"animations":{"name":"animations","type":"array","required":false,"items":{"type":"string"}},"variant":{"name":"variant","type":"string","required":false},"category":{"name":"category","type":"string","required":true},"dimension":{"name":"dimension","type":"string","required":false,"values":["2d","3d"]},"thumbnailUrl":{"name":"thumbnailUrl","type":"string","required":false},"role":{"name":"role","type":"string","required":true},"aspect":{"name":"aspect","type":"string","required":false,"values":["1:1","16:9","5:7","8:1","4:1","5:3","1:2"]},"url":{"name":"url","type":"string","required":true}}},"category":{"name":"category","type":"string","required":true},"stateMachine":{"name":"stateMachine","type":"object","required":false,"properties":{"description":{"name":"description","type":"string","required":false},"currentState":{"name":"currentState","type":"string","required":true},"transitions":{"name":"transitions","type":"array","required":true,"items":{"type":"object","properties":{"from":{"name":"from","type":"string","required":true},"guardHint":{"name":"guardHint","type":"string","required":false},"to":{"name":"to","type":"string","required":true},"event":{"name":"event","type":"string","required":true}}}},"states":{"name":"states","type":"array","required":true,"items":{"type":"string"}},"name":{"name":"name","type":"string","required":true}}},"id":{"name":"id","type":"string","required":true},"iconEmoji":{"name":"iconEmoji","type":"string","required":false},"name":{"name":"name","type":"string","required":true}}}},"label":{"type":"string","label":"Label","description":"Label above the palette","tier":"presentation"},"ariaDescribedby":{"type":"string","label":"Aria-describedby","description":"Id of the element whose text describes this one (help text, error).","synonyms":"aria-describedby","tier":"presentation"},"ariaLive":{"type":"string","label":"Aria-live","description":"Announce changes to this region: polite waits for a pause, assertive interrupts.","synonyms":"aria-live","tier":"presentation","values":["off","polite","assertive"]},"tabIndex":{"type":"number","label":"Tab Index","description":"0 puts the element in the Tab order; -1 makes it focusable only programmatically.","tier":"presentation"},"dir":{"type":"string","label":"Dir","description":"Text direction of this element's content.","tier":"presentation","values":["ltr","rtl","auto"]},"categoryColors":{"type":"Map<string,ActionPaletteCategoryColorsValue>","default":{},"label":"Category Colors","description":"Category → color mapping","tier":"presentation","items":{"type":"object","properties":{"bg":{"name":"bg","type":"string","required":true},"border":{"name":"border","type":"string","required":true}}}},"ariaBusy":{"type":"boolean","label":"Aria-busy","description":"This region is updating; assistive technology waits before announcing it.","synonyms":"aria-busy","tier":"presentation"},"usedActionIds":{"type":"[string]","default":[],"label":"Used Action Ids","description":"IDs of actions that are already used (shown as disabled)","tier":"presentation","items":{"type":"string"}},"size":{"type":"string","default":"md","label":"Size","description":"Size variant","tier":"presentation","values":["sm","md","lg"]},"ariaHidden":{"type":"boolean","label":"Aria-hidden","description":"Hide from assistive technology (decorative content only).","synonyms":"aria-hidden","tier":"presentation"},"enterDelay":{"type":"number","label":"Enter Delay","description":"Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating.","tier":"presentation"},"ariaCurrent":{"type":"string","label":"Aria-current","description":"Marks the current item in a set: the current page, step, location, date or time.","synonyms":"aria-current","tier":"presentation","values":["page","step","location","date","time","true","false"]},"ariaSelected":{"type":"boolean","label":"Aria-selected","description":"Whether this item is selected (tabs, options, grid cells).","synonyms":"aria-selected","tier":"presentation"},"ariaLabelledby":{"type":"string","label":"Aria-labelledby","description":"Id of the element whose text names this one.","synonyms":"aria-labelledby","tier":"presentation"},"className":{"type":"string","label":"Class Name","description":"Additional CSS classes","tier":"presentation"},"role":{"type":"string","label":"Role","description":"WAI-ARIA role when the element's native semantics don't describe it.","tier":"presentation","values":["alert","alertdialog","application","article","banner","blockquote","button","caption","cell","checkbox","code","columnheader","combobox","complementary","contentinfo","definition","deletion","dialog","document","emphasis","feed","figure","form","generic","grid","gridcell","group","heading","img","insertion","link","list","listbox","listitem","log","main","marquee","math","menu","menubar","menuitem","menuitemcheckbox","menuitemradio","meter","navigation","none","note","option","paragraph","presentation","progressbar","radio","radiogroup","region","row","rowgroup","rowheader","scrollbar","search","searchbox","separator","slider","spinbutton","status","strong","subscript","superscript","switch","tab","table","tablist","tabpanel","term","textbox","time","timer","toolbar","tooltip","tree","treegrid","treeitem"]},"lang":{"type":"string","label":"Lang","description":"Language of this element's content (BCP 47, e.g. ar, sl, en).","tier":"presentation"},"ariaPressed":{"type":"string","label":"Aria-pressed","description":"Toggle-button state.","synonyms":"aria-pressed","tier":"presentation","values":["true","false","mixed"]},"skeleton":{"type":"string","label":"Skeleton","description":"Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.","tier":"presentation","values":["header","table","list","grid","detail","stats","form","card","text","none"]},"enter":{"type":"string","label":"Enter","description":"How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out.","tier":"presentation","values":["none","fade","rise","scale","slide"]}},"scope":"instance"}],"pages":[{"name":"ActionPalettePage","id":"pag_5YVSR1T7NN3TTM3Y8VPB0HPT58","path":"/action-palette","traits":[{"ref":"ActionPaletteRender","refId":"trt_BDFJRHJYNVFAXK1H6G6A5VAP01"}]}],"types":{"ActionPaletteActionsItem":[{"name":"id","type":"string","required":true},{"name":"name","type":"string","required":true},{"name":"category","type":"string","required":true},{"name":"description","type":"string"},{"name":"iconEmoji","type":"string"},{"name":"iconUrl","type":"object","properties":[{"name":"url","type":"asset","required":true},{"name":"role","type":"string","required":true},{"name":"category","type":"string","required":true},{"name":"animations","type":"[string]"},{"name":"style","type":"string","values":["pixel","vector","hd","1-bit","isometric"]},{"name":"variant","type":"string"},{"name":"dimension","type":"string","values":["2d","3d"]},{"name":"aspect","type":"string","values":["1:1","16:9","5:7","8:1","4:1","5:3","1:2"]},{"name":"atlas","type":"asset"},{"name":"sprite","type":"string"},{"name":"name","type":"string"},{"name":"thumbnailUrl","type":"string"}]},{"name":"stateMachine","type":"object","properties":[{"name":"name","type":"string","required":true},{"name":"states","type":"[string]","required":true},{"name":"currentState","type":"string","required":true},{"name":"transitions","type":"[object]","required":true,"properties":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"event","type":"string","required":true},{"name":"guardHint","type":"string"}]},{"name":"description","type":"string"}]}],"ActionPaletteActionsItemIconUrl":[{"name":"url","type":"asset","required":true},{"name":"role","type":"string","required":true},{"name":"category","type":"string","required":true},{"name":"animations","type":"[string]"},{"name":"style","type":"string","values":["pixel","vector","hd","1-bit","isometric"]},{"name":"variant","type":"string"},{"name":"dimension","type":"string","values":["2d","3d"]},{"name":"aspect","type":"string","values":["1:1","16:9","5:7","8:1","4:1","5:3","1:2"]},{"name":"atlas","type":"asset"},{"name":"sprite","type":"string"},{"name":"name","type":"string"},{"name":"thumbnailUrl","type":"string"}],"ActionPaletteActionsItemStateMachine":[{"name":"name","type":"string","required":true},{"name":"states","type":"[string]","required":true},{"name":"currentState","type":"string","required":true},{"name":"transitions","type":"[object]","required":true,"properties":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"event","type":"string","required":true},{"name":"guardHint","type":"string"}]},{"name":"description","type":"string"}],"ActionPaletteActionsItemStateMachineTransitionsItem":[{"name":"from","type":"string","required":true},{"name":"to","type":"string","required":true},{"name":"event","type":"string","required":true},{"name":"guardHint","type":"string"}],"ActionPaletteCategoryColorsValue":[{"name":"bg","type":"string","required":true},{"name":"border","type":"string","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_ZEZPXAZBNMNTTDK57J5X77ABVM":{"id":"ent_ZEZPXAZBNMNTTDK57J5X77ABVM","kind":"entity","bakedName":"ActionPaletteItem","curName":"ActionPaletteItem","renames":[],"owner":"workspace"},"evt_76WZC19YF0Z7G9XSHJRJB3FFKS":{"id":"evt_76WZC19YF0Z7G9XSHJRJB3FFKS","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_BDFJRHJYNVFAXK1H6G6A5VAP01"},"orb_GBSCY7ZGHNR8TQQBWEBJ9XMKKT":{"id":"orb_GBSCY7ZGHNR8TQQBWEBJ9XMKKT","kind":"orbital","bakedName":"ActionPaletteOrbital","curName":"ActionPaletteOrbital","renames":[],"owner":"workspace"},"pag_5YVSR1T7NN3TTM3Y8VPB0HPT58":{"id":"pag_5YVSR1T7NN3TTM3Y8VPB0HPT58","kind":"page","bakedName":"ActionPalettePage","curName":"ActionPalettePage","renames":[],"owner":"workspace"},"trt_BDFJRHJYNVFAXK1H6G6A5VAP01":{"id":"trt_BDFJRHJYNVFAXK1H6G6A5VAP01","kind":"trait","bakedName":"ActionPaletteRender","curName":"ActionPaletteRender","renames":[],"owner":"workspace"}}}}