@almadar/std 16.252.0 → 16.254.0

package/behaviors/registry/ui/core/atoms/std-slide-deck.orb

@@ -1 +1 @@
-{"name":"std-slide-deck","version":"1.0.0","description":"std-slide-deck — generic presentation atom. An ordered list of slide nodes (`config.slides`, any render tree or @trait) shown one at a time, with a previous/next arrow on either side, a dot strip and a k / n counter underneath, and keyboard stepping through the host's KEY router (`config.nextKeys` / `config.prevKeys`, captured per `config.keymap`). The cursor clamps at either end unless `loop` is on. Each visit mounts the slide fresh, so its own entry animations replay. Carries no content or visual style: a realization supplies the slides and restyles via `bodyContent`. The default body picks the slide inside a mapped-children lambda, which expands static slides only; a deck whose slides hold stateful traits (forms, live lists) overrides `bodyContent` with one `presence` per slide gated on `@entity.slideIndex`. Every move emits SLIDE_CHANGED for speaker notes, timers or analytics.","orbitals":[{"name":"SlideDeckOrbital","id":"orb_JDJ0BYEMWTAEDFWGWF41DGWZ2W","entity":{"name":"SlideDeck","id":"ent_YGR5P7BCDBP6NHMC4QNEAD86NE","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"slideIndex","type":"number","default":0,"description":"Zero-based index of the slide currently shown.","synonyms":"current slide, cursor, position"}]},"traits":[{"name":"SlideDeckPresenter","id":"trt_D1X5CSEN36AHK6HZG8VTPVA84W","entityRebindable":true,"entityContract":{"requires":[],"provides":["slideIndex"]},"effectRow":[{"kind":"emit","resource":"SLIDE_CHANGED"},{"kind":"render-ui","resource":"main"},{"kind":"set","resource":"@entity.slideIndex"}],"category":"interaction","linkedEntity":"SlideDeck","linkedEntityId":"ent_YGR5P7BCDBP6NHMC4QNEAD86NE","entityRefIds":{"SlideDeck":"ent_YGR5P7BCDBP6NHMC4QNEAD86NE"},"emits":[{"event":"SLIDE_CHANGED","eventId":"evt_53FTFWG2PK1B9KRW2Z2BDEQGAN","description":"The deck moved to a new slide (zero-based index).","synonyms":"slide shown, advanced, went back","tier":"domain","scope":"external","payloadSchema":[{"name":"index","type":"number","required":true}]}],"stateMachine":{"states":[{"name":"presenting","isInitial":true}],"events":[{"key":"INIT","id":"evt_4JYQ63JCC3661ND0W7FXX6RTB4","name":"Initialize"},{"key":"GO_TO","id":"evt_X54FYR1C7AP3N3NBJES7QBKPAP","name":"Go To","description":"Show a zero-based slide index. The arrows and dots send the already-bounded target; a remote or table of contents can send any index.","synonyms":"jump, seek, next slide, previous slide, select slide","tier":"domain","payloadSchema":[{"name":"index","type":"number","required":true}],"listened":true},{"key":"SLIDE_CHANGED","id":"evt_53FTFWG2PK1B9KRW2Z2BDEQGAN","name":"Slide Changed","description":"The deck moved to a new slide (zero-based index).","synonyms":"slide shown, advanced, went back","tier":"domain","payloadSchema":[{"name":"index","type":"number","required":true}]}],"transitions":[{"from":"presenting","to":"presenting","event":"INIT","eventId":"evt_4JYQ63JCC3661ND0W7FXX6RTB4","effects":[["set","@entity.slideIndex","@config.startIndex"],["render-ui","main","@config.bodyContent"]]},{"from":"presenting","to":"presenting","event":"GO_TO","eventId":"evt_X54FYR1C7AP3N3NBJES7QBKPAP","effects":[["set","@entity.slideIndex","@payload.index"],["emit","SLIDE_CHANGED",{"index":"@entity.slideIndex"}],["render-ui","main","@config.bodyContent"]]}]},"config":{"stageMinHeight":{"type":"string","default":"70vh","label":"Stage height","description":"Minimum height of the slide stage (any CSS length, e.g. 70vh or 640px); the slide is centred vertically inside it so short and tall slides share one frame.","tier":"presentation"},"bodyContent":{"type":"render-ui","default":{"type":"stack","direction":"vertical","gap":"md","className":"w-full","children":[{"type":"stack","direction":"horizontal","gap":"md","align":"center","children":[["array/map",[["array/len","@config.slides"]],["fn","n",["if","@config.showArrows",{"type":"button","variant":"ghost","size":"lg","icon":"@config.prevIcon","aria-label":"Previous slide","action":"GO_TO","actionPayload":{"index":["if","@config.loop",["math/wrap",["-","@entity.slideIndex",1],0,"@n"],["math/max",0,["-","@entity.slideIndex",1]]]},"disabled":["and",["==","@config.loop",false],["<=","@entity.slideIndex",0]]},null]]],{"type":"center","className":"flex-1 min-w-0","minHeight":"@config.stageMinHeight","children":["array/map",["@entity.slideIndex"],["fn","i",{"type":"box","className":"w-full","children":[["array/nth","@config.slides","@i"]]}]]},["array/map",[["array/len","@config.slides"]],["fn","n",["if","@config.showArrows",{"type":"button","variant":"ghost","size":"lg","icon":"@config.nextIcon","aria-label":"Next slide","action":"GO_TO","actionPayload":{"index":["if","@config.loop",["math/wrap",["+","@entity.slideIndex",1],0,"@n"],["math/min",["-","@n",1],["+","@entity.slideIndex",1]]]},"disabled":["and",["==","@config.loop",false],[">=","@entity.slideIndex",["-","@n",1]]]},null]]]]},["if","@config.showProgress",{"type":"stack","direction":"horizontal","gap":"md","align":"center","justify":"center","children":["array/map",[["array/len","@config.slides"]],["fn","n",{"type":"stack","direction":"horizontal","gap":"md","align":"center","children":[{"type":"progress-dots","count":"@n","currentIndex":"@entity.slideIndex","onDotClick":"GO_TO","size":"sm"},{"type":"typography","variant":"caption","color":"muted","content":["str/concat","",["+","@entity.slideIndex",1]," / ","@n"]}]}]]},null]]},"label":"Body content tree","description":"Render-ui tree for the deck. Default: slide centred between previous/next arrows, dot strip and counter below. A realization overrides this to restyle (full-bleed, bottom bar, no chrome) while keeping the same cursor, keys and emits.","tier":"internal"},"nextIcon":{"type":"icon","default":"chevron-right","label":"Next icon","tier":"presentation"},"slides":{"type":"[trait]","default":[],"label":"Slides","description":"Ordered slide nodes; each entry is a render tree or a @trait reference and is shown one at a time.","tier":"domain","items":{"type":"trait"}},"prevIcon":{"type":"icon","default":"chevron-left","label":"Previous icon","tier":"presentation"},"startIndex":{"type":"number","default":0,"label":"Start slide","description":"Zero-based slide shown on first render; clamped to the deck.","tier":"presentation"},"showArrows":{"type":"boolean","default":true,"label":"Show arrows","description":"Previous/next buttons on the left and right of the slide.","tier":"presentation"},"showProgress":{"type":"boolean","default":true,"label":"Show progress","description":"Dot strip and k / n counter under the slide; dots jump to their slide.","tier":"presentation"},"loop":{"type":"boolean","default":false,"label":"Loop","description":"Wrap from the last slide to the first (and back) instead of stopping at either end.","tier":"presentation"}},"scope":"instance"}],"pages":[{"name":"SlideDeckPage","id":"pag_HF2BH1KXC3YP1V1D2WC7KS98HK","path":"/slide-deck","traits":[{"ref":"SlideDeckPresenter","refId":"trt_D1X5CSEN36AHK6HZG8VTPVA84W"}]}]}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_YGR5P7BCDBP6NHMC4QNEAD86NE":{"id":"ent_YGR5P7BCDBP6NHMC4QNEAD86NE","kind":"entity","bakedName":"SlideDeck","curName":"SlideDeck","renames":[],"owner":"workspace"},"evt_4JYQ63JCC3661ND0W7FXX6RTB4":{"id":"evt_4JYQ63JCC3661ND0W7FXX6RTB4","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_D1X5CSEN36AHK6HZG8VTPVA84W"},"evt_53FTFWG2PK1B9KRW2Z2BDEQGAN":{"id":"evt_53FTFWG2PK1B9KRW2Z2BDEQGAN","kind":"event","bakedName":"SLIDE_CHANGED","curName":"SLIDE_CHANGED","renames":[],"owner":"workspace","parent":"trt_D1X5CSEN36AHK6HZG8VTPVA84W"},"evt_X54FYR1C7AP3N3NBJES7QBKPAP":{"id":"evt_X54FYR1C7AP3N3NBJES7QBKPAP","kind":"event","bakedName":"GO_TO","curName":"GO_TO","renames":[],"owner":"workspace","parent":"trt_D1X5CSEN36AHK6HZG8VTPVA84W"},"orb_JDJ0BYEMWTAEDFWGWF41DGWZ2W":{"id":"orb_JDJ0BYEMWTAEDFWGWF41DGWZ2W","kind":"orbital","bakedName":"SlideDeckOrbital","curName":"SlideDeckOrbital","renames":[],"owner":"workspace"},"pag_HF2BH1KXC3YP1V1D2WC7KS98HK":{"id":"pag_HF2BH1KXC3YP1V1D2WC7KS98HK","kind":"page","bakedName":"SlideDeckPage","curName":"SlideDeckPage","renames":[],"owner":"workspace"},"trt_D1X5CSEN36AHK6HZG8VTPVA84W":{"id":"trt_D1X5CSEN36AHK6HZG8VTPVA84W","kind":"trait","bakedName":"SlideDeckPresenter","curName":"SlideDeckPresenter","renames":[],"owner":"workspace"}}}}
+{"name":"std-slide-deck","version":"1.0.0","description":"std-slide-deck — generic presentation atom. An ordered list of slide nodes (`config.slides`, any render tree or @trait) shown one at a time, with a previous/next arrow on either side, a dot strip and a k / n counter underneath, and keyboard stepping through the host's KEY router (`config.nextKeys` / `config.prevKeys`, captured per `config.keymap`). The cursor clamps at either end unless `loop` is on. Each visit mounts the slide fresh, so its own entry animations replay. Carries no content or visual style: a realization supplies the slides and restyles via `bodyContent`. The default body picks the slide inside a mapped-children lambda, which expands static slides only; a deck whose slides hold stateful traits (forms, live lists) overrides `bodyContent` with one `presence` per slide gated on `@entity.slideIndex`. Every move emits SLIDE_CHANGED for speaker notes, timers or analytics.","orbitals":[{"name":"SlideDeckOrbital","id":"orb_JDJ0BYEMWTAEDFWGWF41DGWZ2W","entity":{"name":"SlideDeck","id":"ent_YGR5P7BCDBP6NHMC4QNEAD86NE","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"slideIndex","type":"number","default":0,"description":"Zero-based index of the slide currently shown.","synonyms":"current slide, cursor, position"}]},"traits":[{"name":"SlideDeckPresenter","id":"trt_D1X5CSEN36AHK6HZG8VTPVA84W","entityRebindable":true,"entityContract":{"requires":[],"provides":["slideIndex"]},"effectRow":[{"kind":"emit","resource":"SLIDE_CHANGED"},{"kind":"render-ui","resource":"main"},{"kind":"set","resource":"@entity.slideIndex"}],"category":"interaction","linkedEntity":"SlideDeck","linkedEntityId":"ent_YGR5P7BCDBP6NHMC4QNEAD86NE","entityRefIds":{"SlideDeck":"ent_YGR5P7BCDBP6NHMC4QNEAD86NE"},"emits":[{"event":"SLIDE_CHANGED","eventId":"evt_53FTFWG2PK1B9KRW2Z2BDEQGAN","description":"The deck moved to a new slide (zero-based index).","synonyms":"slide shown, advanced, went back","tier":"domain","scope":"external","payloadSchema":[{"name":"index","type":"number","required":true}]}],"stateMachine":{"states":[{"name":"presenting","isInitial":true}],"events":[{"key":"INIT","id":"evt_4JYQ63JCC3661ND0W7FXX6RTB4","name":"Initialize"},{"key":"GO_TO","id":"evt_X54FYR1C7AP3N3NBJES7QBKPAP","name":"Go To","description":"Show a zero-based slide index. The arrows and dots send the already-bounded target; a remote or table of contents can send any index.","synonyms":"jump, seek, next slide, previous slide, select slide","tier":"domain","payloadSchema":[{"name":"index","type":"number","required":true}],"listened":true},{"key":"SLIDE_CHANGED","id":"evt_53FTFWG2PK1B9KRW2Z2BDEQGAN","name":"Slide Changed","description":"The deck moved to a new slide (zero-based index).","synonyms":"slide shown, advanced, went back","tier":"domain","payloadSchema":[{"name":"index","type":"number","required":true}]}],"transitions":[{"from":"presenting","to":"presenting","event":"INIT","eventId":"evt_4JYQ63JCC3661ND0W7FXX6RTB4","effects":[["set","@entity.slideIndex","@config.startIndex"],["render-ui","main","@config.bodyContent"]]},{"from":"presenting","to":"presenting","event":"GO_TO","eventId":"evt_X54FYR1C7AP3N3NBJES7QBKPAP","effects":[["set","@entity.slideIndex","@payload.index"],["emit","SLIDE_CHANGED",{"index":"@entity.slideIndex"}],["render-ui","main","@config.bodyContent"]]}]},"config":{"stageMinHeight":{"type":"string","default":"70vh","label":"Stage height","description":"Minimum height of the slide stage (any CSS length, e.g. 70vh or 640px); the slide is centred vertically inside it so short and tall slides share one frame.","tier":"presentation"},"prevIcon":{"type":"icon","default":"chevron-left","label":"Previous icon","tier":"presentation"},"loop":{"type":"boolean","default":false,"label":"Loop","description":"Wrap from the last slide to the first (and back) instead of stopping at either end.","tier":"presentation"},"bodyContent":{"type":"render-ui","default":{"type":"stack","direction":"vertical","gap":"md","className":"w-full","children":[{"type":"stack","direction":"horizontal","gap":"md","align":"center","children":[["array/map",[["array/len","@config.slides"]],["fn","n",["if","@config.showArrows",{"type":"button","variant":"ghost","size":"lg","icon":"@config.prevIcon","aria-label":"Previous slide","action":"GO_TO","actionPayload":{"index":["if","@config.loop",["math/wrap",["-","@entity.slideIndex",1],0,"@n"],["math/max",0,["-","@entity.slideIndex",1]]]},"disabled":["and",["==","@config.loop",false],["<=","@entity.slideIndex",0]]},null]]],{"type":"center","className":"flex-1 min-w-0","minHeight":"@config.stageMinHeight","children":["array/map",["@entity.slideIndex"],["fn","i",{"type":"box","className":"w-full","children":[["array/nth","@config.slides","@i"]]}]]},["array/map",[["array/len","@config.slides"]],["fn","n",["if","@config.showArrows",{"type":"button","variant":"ghost","size":"lg","icon":"@config.nextIcon","aria-label":"Next slide","action":"GO_TO","actionPayload":{"index":["if","@config.loop",["math/wrap",["+","@entity.slideIndex",1],0,"@n"],["math/min",["-","@n",1],["+","@entity.slideIndex",1]]]},"disabled":["and",["==","@config.loop",false],[">=","@entity.slideIndex",["-","@n",1]]]},null]]]]},["if","@config.showProgress",{"type":"stack","direction":"horizontal","gap":"md","align":"center","justify":"center","children":["array/map",[["array/len","@config.slides"]],["fn","n",{"type":"stack","direction":"horizontal","gap":"md","align":"center","children":[{"type":"progress-dots","count":"@n","currentIndex":"@entity.slideIndex","onDotClick":"GO_TO","size":"sm"},{"type":"typography","variant":"caption","color":"muted","content":["str/concat","",["+","@entity.slideIndex",1]," / ","@n"]}]}]]},null]]},"label":"Body content tree","description":"Render-ui tree for the deck. Default: slide centred between previous/next arrows, dot strip and counter below. A realization overrides this to restyle (full-bleed, bottom bar, no chrome) while keeping the same cursor, keys and emits.","tier":"internal"},"nextIcon":{"type":"icon","default":"chevron-right","label":"Next icon","tier":"presentation"},"showProgress":{"type":"boolean","default":true,"label":"Show progress","description":"Dot strip and k / n counter under the slide; dots jump to their slide.","tier":"presentation"},"showArrows":{"type":"boolean","default":true,"label":"Show arrows","description":"Previous/next buttons on the left and right of the slide.","tier":"presentation"},"slides":{"type":"[trait]","default":[],"label":"Slides","description":"Ordered slide nodes; each entry is a render tree or a @trait reference and is shown one at a time.","tier":"domain","items":{"type":"trait"}},"startIndex":{"type":"number","default":0,"label":"Start slide","description":"Zero-based slide shown on first render; clamped to the deck.","tier":"presentation"}},"scope":"instance"}],"pages":[{"name":"SlideDeckPage","id":"pag_HF2BH1KXC3YP1V1D2WC7KS98HK","path":"/slide-deck","traits":[{"ref":"SlideDeckPresenter","refId":"trt_D1X5CSEN36AHK6HZG8VTPVA84W"}]}]}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_YGR5P7BCDBP6NHMC4QNEAD86NE":{"id":"ent_YGR5P7BCDBP6NHMC4QNEAD86NE","kind":"entity","bakedName":"SlideDeck","curName":"SlideDeck","renames":[],"owner":"workspace"},"evt_4JYQ63JCC3661ND0W7FXX6RTB4":{"id":"evt_4JYQ63JCC3661ND0W7FXX6RTB4","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_D1X5CSEN36AHK6HZG8VTPVA84W"},"evt_53FTFWG2PK1B9KRW2Z2BDEQGAN":{"id":"evt_53FTFWG2PK1B9KRW2Z2BDEQGAN","kind":"event","bakedName":"SLIDE_CHANGED","curName":"SLIDE_CHANGED","renames":[],"owner":"workspace","parent":"trt_D1X5CSEN36AHK6HZG8VTPVA84W"},"evt_X54FYR1C7AP3N3NBJES7QBKPAP":{"id":"evt_X54FYR1C7AP3N3NBJES7QBKPAP","kind":"event","bakedName":"GO_TO","curName":"GO_TO","renames":[],"owner":"workspace","parent":"trt_D1X5CSEN36AHK6HZG8VTPVA84W"},"orb_JDJ0BYEMWTAEDFWGWF41DGWZ2W":{"id":"orb_JDJ0BYEMWTAEDFWGWF41DGWZ2W","kind":"orbital","bakedName":"SlideDeckOrbital","curName":"SlideDeckOrbital","renames":[],"owner":"workspace"},"pag_HF2BH1KXC3YP1V1D2WC7KS98HK":{"id":"pag_HF2BH1KXC3YP1V1D2WC7KS98HK","kind":"page","bakedName":"SlideDeckPage","curName":"SlideDeckPage","renames":[],"owner":"workspace"},"trt_D1X5CSEN36AHK6HZG8VTPVA84W":{"id":"trt_D1X5CSEN36AHK6HZG8VTPVA84W","kind":"trait","bakedName":"SlideDeckPresenter","curName":"SlideDeckPresenter","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/ui/core/atoms/std-stat-band.orb

@@ -1 +1 @@
-{"name":"std-stat-band","version":"1.0.0","description":"std-stat-band — a band of headline figures from a config list: each item a big value (a number or short text such as '99.9%', '3x' or 'Open source') over a short label, centered in a row that wraps on small screens, under an optional heading. Display only — for figures computed from data use std-stats. Pick for 'by the numbers' strips on landing, about and product pages.","orbitals":[{"name":"StatBandOrbital","id":"orb_ZWZPFXMKDD9PPMPNPZ9Y60Q7G7","entity":{"name":"StatBandView","id":"ent_KGSNB1KJ21S10YMD82WYZEGVRR","persistence":"runtime","fields":[{"name":"id","type":"string","required":true}]},"traits":[{"name":"StatBandRender","id":"trt_AD60K85XXGYYRERRZY2CHD9GZ1","entityRebindable":true,"entityContract":{"requires":[],"provides":[]},"effectRow":[{"kind":"render-ui","resource":"main"}],"category":"interaction","linkedEntity":"StatBandView","linkedEntityId":"ent_KGSNB1KJ21S10YMD82WYZEGVRR","entityRefIds":{"StatBandView":"ent_KGSNB1KJ21S10YMD82WYZEGVRR"},"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_H393QQRY0BF05Q04SFG0GSRZTD","name":"Initialize"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_H393QQRY0BF05Q04SFG0GSRZTD","effects":[["render-ui","main",{"type":"box","paddingY":"xl","bg":["if",["==","@config.surface","muted"],"muted",["if",["==","@config.surface","accent"],"gradient",["if",["==","@config.surface","inverse"],"inverse","transparent"]]],"edgeTop":"@config.edgeTop","edgeBottom":"@config.edgeBottom","edgeColor":"@config.edgeColor","texture":"@config.texture","fullWidth":true,"children":[{"type":"container","size":"xl","maxWidth":"xl","padding":"lg","children":[{"type":"stack","direction":"vertical","gap":"lg","children":[{"type":"typography","content":"@config.heading","variant":"h3","weight":"bold","align":"center","className":["if",["==","@config.heading",""],"hidden","tracking-tight"]},{"type":"simple-grid","cols":["math/min",["math/max",["array/len","@config.items"],1],4],"gap":"lg","children":["array/map","@config.items",["fn","item",{"type":"stack","direction":"vertical","gap":"xs","align":"center","children":[{"type":"typography","content":["object/get","@item","value",""],"variant":"h2","weight":"bold","align":"center","className":"tracking-tight text-primary"},{"type":"typography","content":["object/get","@item","label",""],"variant":"body","color":"muted","align":"center"}]}]]}]}]}]}]]}]},"config":{"edgeBottom":{"type":"string","default":"none","label":"Bottom edge","description":"Shape cut into the bottom of the section; curve uses the theme's shape","tier":"presentation","values":["none","curve","wave","arc","tilt","step","scallop"]},"edgeColor":{"type":"string","default":"background","label":"Edge fill","description":"The surface of the neighbouring section, which fills the cut","tier":"presentation","values":["background","muted","surface","gradient","inverse"]},"surface":{"type":"string","default":"plain","label":"Surface","tier":"presentation","values":["plain","muted","accent","inverse"]},"heading":{"type":"string","default":"","label":"Heading","description":"Heading above the figures; empty hides it","tier":"presentation"},"items":{"type":"[StatBandItem]","default":[{"value":"120+","label":"Building blocks"},{"value":"3","label":"Languages"},{"value":"99.9%","label":"Uptime"}],"label":"Figures","description":"One entry per figure: value (number or short text) and label","synonyms":"stats, numbers, metrics, kpis, by the numbers","tier":"presentation","items":{"type":"object","properties":{"value":{"name":"value","type":"string","required":true},"label":{"name":"label","type":"string","required":true}}}},"edgeTop":{"type":"string","default":"none","label":"Top edge","description":"Shape cut into the top of the section; curve uses the theme's shape","tier":"presentation","values":["none","curve","wave","arc","tilt","step","scallop"]},"texture":{"type":"boolean","default":false,"label":"Texture","description":"Lay the theme's texture over the section","tier":"presentation"}},"scope":"instance"}],"pages":[{"name":"StatBandPage","id":"pag_84QRKWNWGGY888JJJN5P3NMY29","path":"/stat-band","traits":[{"ref":"StatBandRender","refId":"trt_AD60K85XXGYYRERRZY2CHD9GZ1"}]}],"types":{"StatBandItem":[{"name":"value","type":"string","required":true},{"name":"label","type":"string","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_KGSNB1KJ21S10YMD82WYZEGVRR":{"id":"ent_KGSNB1KJ21S10YMD82WYZEGVRR","kind":"entity","bakedName":"StatBandView","curName":"StatBandView","renames":[],"owner":"workspace"},"evt_H393QQRY0BF05Q04SFG0GSRZTD":{"id":"evt_H393QQRY0BF05Q04SFG0GSRZTD","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_AD60K85XXGYYRERRZY2CHD9GZ1"},"orb_ZWZPFXMKDD9PPMPNPZ9Y60Q7G7":{"id":"orb_ZWZPFXMKDD9PPMPNPZ9Y60Q7G7","kind":"orbital","bakedName":"StatBandOrbital","curName":"StatBandOrbital","renames":[],"owner":"workspace"},"pag_84QRKWNWGGY888JJJN5P3NMY29":{"id":"pag_84QRKWNWGGY888JJJN5P3NMY29","kind":"page","bakedName":"StatBandPage","curName":"StatBandPage","renames":[],"owner":"workspace"},"trt_AD60K85XXGYYRERRZY2CHD9GZ1":{"id":"trt_AD60K85XXGYYRERRZY2CHD9GZ1","kind":"trait","bakedName":"StatBandRender","curName":"StatBandRender","renames":[],"owner":"workspace"}}}}
+{"name":"std-stat-band","version":"1.0.0","description":"std-stat-band — a band of headline figures from a config list: each item a big value (a number or short text such as '99.9%', '3x' or 'Open source') over a short label, centered in a row that wraps on small screens, under an optional heading. Display only — for figures computed from data use std-stats. Pick for 'by the numbers' strips on landing, about and product pages.","orbitals":[{"name":"StatBandOrbital","id":"orb_ZWZPFXMKDD9PPMPNPZ9Y60Q7G7","entity":{"name":"StatBandView","id":"ent_KGSNB1KJ21S10YMD82WYZEGVRR","persistence":"runtime","fields":[{"name":"id","type":"string","required":true}]},"traits":[{"name":"StatBandRender","id":"trt_AD60K85XXGYYRERRZY2CHD9GZ1","entityRebindable":true,"entityContract":{"requires":[],"provides":[]},"effectRow":[{"kind":"render-ui","resource":"main"}],"category":"interaction","linkedEntity":"StatBandView","linkedEntityId":"ent_KGSNB1KJ21S10YMD82WYZEGVRR","entityRefIds":{"StatBandView":"ent_KGSNB1KJ21S10YMD82WYZEGVRR"},"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_H393QQRY0BF05Q04SFG0GSRZTD","name":"Initialize"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_H393QQRY0BF05Q04SFG0GSRZTD","effects":[["render-ui","main",{"type":"box","paddingY":"xl","bg":["if",["==","@config.surface","muted"],"muted",["if",["==","@config.surface","accent"],"gradient",["if",["==","@config.surface","inverse"],"inverse","transparent"]]],"edgeTop":"@config.edgeTop","edgeBottom":"@config.edgeBottom","edgeColor":"@config.edgeColor","texture":"@config.texture","fullWidth":true,"children":[{"type":"container","size":"xl","maxWidth":"xl","padding":"lg","children":[{"type":"stack","direction":"vertical","gap":"lg","children":[{"type":"typography","content":"@config.heading","variant":"h3","weight":"bold","align":"center","className":["if",["==","@config.heading",""],"hidden","tracking-tight"]},{"type":"simple-grid","cols":["math/min",["math/max",["array/len","@config.items"],1],4],"gap":"lg","children":["array/map","@config.items",["fn","item",{"type":"stack","direction":"vertical","gap":"xs","align":"center","children":[{"type":"typography","content":["object/get","@item","value",""],"variant":"h2","weight":"bold","align":"center","className":"tracking-tight text-primary"},{"type":"typography","content":["object/get","@item","label",""],"variant":"body","color":"muted","align":"center"}]}]]}]}]}]}]]}]},"config":{"edgeBottom":{"type":"string","default":"none","label":"Bottom edge","description":"Shape cut into the bottom of the section; curve uses the theme's shape","tier":"presentation","values":["none","curve","wave","arc","tilt","step","scallop"]},"edgeTop":{"type":"string","default":"none","label":"Top edge","description":"Shape cut into the top of the section; curve uses the theme's shape","tier":"presentation","values":["none","curve","wave","arc","tilt","step","scallop"]},"edgeColor":{"type":"string","default":"background","label":"Edge fill","description":"The surface of the neighbouring section, which fills the cut","tier":"presentation","values":["background","muted","surface","gradient","inverse"]},"texture":{"type":"boolean","default":false,"label":"Texture","description":"Lay the theme's texture over the section","tier":"presentation"},"surface":{"type":"string","default":"plain","label":"Surface","tier":"presentation","values":["plain","muted","accent","inverse"]},"items":{"type":"[StatBandItem]","default":[{"value":"120+","label":"Building blocks"},{"value":"3","label":"Languages"},{"value":"99.9%","label":"Uptime"}],"label":"Figures","description":"One entry per figure: value (number or short text) and label","synonyms":"stats, numbers, metrics, kpis, by the numbers","tier":"presentation","items":{"type":"object","properties":{"value":{"name":"value","type":"string","required":true},"label":{"name":"label","type":"string","required":true}}}},"heading":{"type":"string","default":"","label":"Heading","description":"Heading above the figures; empty hides it","tier":"presentation"}},"scope":"instance"}],"pages":[{"name":"StatBandPage","id":"pag_84QRKWNWGGY888JJJN5P3NMY29","path":"/stat-band","traits":[{"ref":"StatBandRender","refId":"trt_AD60K85XXGYYRERRZY2CHD9GZ1"}]}],"types":{"StatBandItem":[{"name":"value","type":"string","required":true},{"name":"label","type":"string","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_KGSNB1KJ21S10YMD82WYZEGVRR":{"id":"ent_KGSNB1KJ21S10YMD82WYZEGVRR","kind":"entity","bakedName":"StatBandView","curName":"StatBandView","renames":[],"owner":"workspace"},"evt_H393QQRY0BF05Q04SFG0GSRZTD":{"id":"evt_H393QQRY0BF05Q04SFG0GSRZTD","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_AD60K85XXGYYRERRZY2CHD9GZ1"},"orb_ZWZPFXMKDD9PPMPNPZ9Y60Q7G7":{"id":"orb_ZWZPFXMKDD9PPMPNPZ9Y60Q7G7","kind":"orbital","bakedName":"StatBandOrbital","curName":"StatBandOrbital","renames":[],"owner":"workspace"},"pag_84QRKWNWGGY888JJJN5P3NMY29":{"id":"pag_84QRKWNWGGY888JJJN5P3NMY29","kind":"page","bakedName":"StatBandPage","curName":"StatBandPage","renames":[],"owner":"workspace"},"trt_AD60K85XXGYYRERRZY2CHD9GZ1":{"id":"trt_AD60K85XXGYYRERRZY2CHD9GZ1","kind":"trait","bakedName":"StatBandRender","curName":"StatBandRender","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/ui/core/atoms/std-stats.orb

@@ -1 +1 @@
-{"name":"std-stats","version":"3.2.0","description":"std-stats — embeddable analytics-card atom. ITEMS_LOADED aggregates @payload.data per @config.metrics (count|sum|avg|min|max|variance with optional filter, baselineFilter, format, icon, max, target, trend, trendPolarity, sparkline) and renders one stat-display per entry. Variance metrics compute actual - baseline using `filter` + `baselineFilter` lambdas and report the signed delta as trend. clickEvent emits UI:{clickEvent} { metricLabel } when a card is clicked. Drop into a dashboard alongside std-browse / std-search / std-filter. `config.statsLook` switches the whole body between the default per-metric card grid ('cards'), a Stripe-dashboard KPI tile row ('kpi-tiles'), a single hero metric card ('hero-metric'), and a chart-first sparkline tile grid ('sparkline-row').","orbitals":[{"name":"StatsItemOrbital","id":"orb_YV3K2F2QV0BXG6MJN689F3FD3T","entity":{"name":"StatsItem","id":"ent_ENMEZRC4RB2C5HNQAZG29WPC31","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"cards","type":"array","default":[],"items":{"type":"object","properties":{"value":{"name":"value","type":"number","required":false},"suffix":{"name":"suffix","type":"string","required":false},"variant":{"name":"variant","type":"string","required":false,"values":["default","primary","success","warning","error","info"]},"trendFormat":{"name":"trendFormat","type":"string","required":false,"values":["absolute","percent"]},"format":{"name":"format","type":"string","required":false,"values":["number","currency","percent"]},"max":{"name":"max","type":"number","required":false},"trendPolarity":{"name":"trendPolarity","type":"string","required":false,"values":["higher-is-better","lower-is-better"]},"target":{"name":"target","type":"number","required":false},"prefix":{"name":"prefix","type":"string","required":false},"sparklineData":{"name":"sparklineData","type":"array","required":false,"items":{"type":"number"}},"icon":{"name":"icon","type":"string","required":false},"trend":{"name":"trend","type":"number","required":false},"clickEvent":{"name":"clickEvent","type":"string","required":false},"label":{"name":"label","type":"string","required":true},"position":{"name":"position","type":"number","required":false}}},"intrinsic":true,"description":"A collection of statistical cards to display.","synonyms":"statistics, items, displays"}]},"traits":[{"name":"StatsItemStats","id":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ","entityRebindable":true,"entityContract":{"requires":[],"provides":["cards"]},"effectRow":[{"kind":"render-ui","resource":"main"},{"kind":"set","resource":"@entity.cards"}],"category":"interaction","linkedEntity":"StatsItem","linkedEntityId":"ent_ENMEZRC4RB2C5HNQAZG29WPC31","entityRefIds":{"StatsItem":"ent_ENMEZRC4RB2C5HNQAZG29WPC31"},"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_AK5C411DJKPS9G1WH0EMJ78Q7V","name":"Initialize"},{"key":"ITEMS_LOADED","id":"evt_E0DJXKK6Z8KFM763KX1BBVM1X6","name":"Items Loaded","description":"Data has been loaded and is ready for processing.","synonyms":"data ready, update, refresh, loaded","tier":"domain","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}]},{"name":"totalCount","type":"number"}],"listened":true}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_AK5C411DJKPS9G1WH0EMJ78Q7V","effects":[["set","@entity.cards",["array/map","@config.metrics",["fn","metric",{"clickEvent":["object/get","@metric","clickEvent",""],"format":["object/get","@metric","format","number"],"icon":["object/get","@metric","icon",""],"label":["object/get","@metric","label"],"position":"@index","max":["object/get","@metric","max",0],"prefix":["object/get","@metric","prefix",""],"sparklineData":["object/get","@metric","sparklineData",[]],"suffix":["object/get","@metric","suffix",""],"target":["object/get","@metric","target",0],"trend":["object/get","@metric","trend"],"trendFormat":["object/get","@metric","trendFormat","absolute"],"trendPolarity":["object/get","@metric","trendPolarity","higher-is-better"],"value":["object/get","@metric","value",0],"variant":["object/get","@metric","variant","default"]}]]],["if",["=","@config.statsLook","kpi-tiles"],["render-ui","main","@config.kpiTilesBodyContent"],["if",["=","@config.statsLook","hero-metric"],["render-ui","main","@config.heroMetricBodyContent"],["if",["=","@config.statsLook","sparkline-row"],["render-ui","main","@config.sparklineRowBodyContent"],["render-ui","main","@config.bodyContent"]]]]]},{"from":"idle","to":"idle","event":"ITEMS_LOADED","eventId":"evt_E0DJXKK6Z8KFM763KX1BBVM1X6","effects":[["set","@entity.cards",["array/map","@config.metrics",["fn","metric",{"clickEvent":["object/get","@metric","clickEvent",""],"format":["object/get","@metric","format","number"],"icon":["object/get","@metric","icon",""],"label":["object/get","@metric","label"],"position":"@index","max":["object/get","@metric","max",0],"prefix":["object/get","@metric","prefix",""],"sparklineData":["object/get","@metric","sparklineData",[]],"suffix":["object/get","@metric","suffix",""],"target":["object/get","@metric","target",0],"trend":["if",["=",["object/get","@metric","aggregation","count"],"variance"],["-",["array/sum",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["array/sum",["array/filter","@payload.data",["object/get","@metric","baselineFilter",true]],["object/get","@metric","field",""]]],["object/get","@metric","trend"]],"trendFormat":["object/get","@metric","trendFormat","absolute"],"trendPolarity":["object/get","@metric","trendPolarity","higher-is-better"],"value":["if",["=",["object/get","@metric","aggregation","count"],"sum"],["array/sum",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["if",["=",["object/get","@metric","aggregation","count"],"avg"],["array/avg",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["if",["=",["object/get","@metric","aggregation","count"],"min"],["array/min",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["if",["=",["object/get","@metric","aggregation","count"],"max"],["array/max",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["if",["=",["object/get","@metric","aggregation","count"],"variance"],["array/sum",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["array/len",["array/filter","@payload.data",["object/get","@metric","filter",true]]]]]]]],"variant":["object/get","@metric","variant","default"]}]]],["if",["=","@config.statsLook","kpi-tiles"],["render-ui","main","@config.kpiTilesBodyContent"],["if",["=","@config.statsLook","hero-metric"],["render-ui","main","@config.heroMetricBodyContent"],["if",["=","@config.statsLook","sparkline-row"],["render-ui","main","@config.sparklineRowBodyContent"],["render-ui","main","@config.bodyContent"]]]]]}]},"config":{"statsLook":{"type":"string","default":"cards","label":"Stats look","description":"Layer 3 body layout: default per-metric stat-card grid ('cards'), Stripe-dashboard KPI tile row ('kpi-tiles'), single oversize hero number ('hero-metric'), or chart-first sparkline tile grid ('sparkline-row').","tier":"presentation","values":["cards","kpi-tiles","hero-metric","sparkline-row"]},"viewPattern":{"type":"pattern","default":"data-grid","label":"Render pattern","description":"UI pattern used to arrange the stat cards","synonyms":"internal pattern selector. user prompts rarely target this directly","tier":"internal"},"metricLabels":{"type":"[string]","default":[],"label":"Metric labels","description":"In metric order: the label shown on each card, in place of its `metrics` label (render-only, so it may be translated)","tier":"presentation","items":{"type":"string"}},"metrics":{"type":"[MetricSpec]","default":[{"aggregation":"count","format":"number","icon":"list","label":"Total Items","sparklineData":[2,4,3,6,5,8,7],"variant":"primary"},{"aggregation":"count","format":"number","icon":"check-circle","label":"Active","sparklineData":[1,3,2,4,6,5,7],"variant":"success"},{"aggregation":"avg","field":"value","format":"number","icon":"trending-up","label":"Avg Value","sparklineData":[5,4,6,3,5,7,6],"variant":"info"}],"label":"Metrics","description":"One stat card per entry; declares aggregation, format, and styling","synonyms":"list of KPI cards / stat tiles / metric cards. each entry has label / value / format / icon / variant / aggregation. user phrases: 'replace metrics with X, Y, Z' -> rewrite array; 'add Revenue tile' -> append entry; 'change KPIs to X' -> rewrite array","tier":"presentation","items":{"type":"object","properties":{"target":{"name":"target","type":"number","required":false},"label":{"name":"label","type":"string","required":true},"max":{"name":"max","type":"number","required":false},"clickEvent":{"name":"clickEvent","type":"string","required":false},"icon":{"name":"icon","type":"string","required":false},"variant":{"name":"variant","type":"string","required":false,"values":["default","primary","success","warning","error","info"]},"suffix":{"name":"suffix","type":"string","required":false},"sparklineData":{"name":"sparklineData","type":"array","required":false,"items":{"type":"number"}},"trendPolarity":{"name":"trendPolarity","type":"string","required":false,"values":["higher-is-better","lower-is-better"]},"format":{"name":"format","type":"string","required":false,"values":["number","currency","percent"]},"prefix":{"name":"prefix","type":"string","required":false},"trend":{"name":"trend","type":"number","required":false},"aggregation":{"name":"aggregation","type":"string","required":false,"values":["count","sum","avg","min","max","variance"]},"trendFormat":{"name":"trendFormat","type":"string","required":false,"values":["absolute","percent"]},"field":{"name":"field","type":"string","required":false},"value":{"name":"value","type":"number","required":false}}}},"heroMetricBodyContent":{"type":"render-ui","default":{"data-theme":"@config.theme","type":"box","children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"entity":"@entity.cards","fields":[],"gap":"none","renderItem":["fn","card",{"children":[{"children":[{"align":"center","children":[{"align":"center","children":[{"color":"muted","name":"@card.icon","size":"md","type":"icon"},{"className":"uppercase tracking-widest","color":"muted","content":["if",["=",["array/len","@config.metricLabels"],0],"@card.label",["array/nth","@config.metricLabels","@card.position"]],"type":"typography","variant":"overline","weight":"bold"}],"direction":"horizontal","gap":"sm","justify":"center","type":"stack"},{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"h2","weight":"normal"},{"className":"text-7xl md:text-8xl font-bold tracking-tighter tabular-nums text-[var(--color-foreground)]","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"h2","weight":"normal"}],"className":"py-section","direction":"horizontal","gap":"xs","justify":"center","type":"stack"},{"showValue":true,"size":"md","type":"trend-indicator","value":"@card.trend"}],"className":"relative z-10 w-full max-w-2xl mx-auto text-center","direction":"vertical","gap":"md","type":"stack"},{"className":"absolute inset-x-0 bottom-0 w-full opacity-10 pointer-events-none","color":"auto","data":"@card.sparklineData","fill":true,"height":96,"strokeWidth":1,"type":"sparkline"}],"look":"elevated","padding":"lg","type":"card"}],"className":"relative w-full rounded-xl shadow-lg overflow-hidden","direction":"vertical","gap":"none","type":"stack"}],"type":"data-list"}]},"label":"Hero metric body content tree","description":"Render-ui SExpr for statsLook='hero-metric' — one elevated card, one oversize number, background sparkline.","tier":"internal"},"title":{"type":"string","default":"","label":"Section title","description":"Heading shown above the stat-card grid","synonyms":"the section header text. user phrases: 'rename section to X' / 'title the KPIs X' / 'change section title to X' -> X","tier":"presentation"},"kpiTilesBodyContent":{"type":"render-ui","default":{"data-theme":"@config.theme","type":"box","children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","entity":"@entity.cards","fields":[],"gap":"lg","minCardWidth":220,"renderItem":["fn","card",{"children":[{"align":"center","children":[{"className":"uppercase tracking-wide","color":"muted","content":["if",["=",["array/len","@config.metricLabels"],0],"@card.label",["array/nth","@config.metricLabels","@card.position"]],"type":"typography","variant":"caption","weight":"medium"},{"color":"muted","name":"@card.icon","size":"sm","type":"icon"}],"direction":"horizontal","gap":"xs","justify":"between","type":"stack"},{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"caption"},{"className":"text-4xl font-bold tracking-tight","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"caption"}],"direction":"horizontal","gap":"xs","type":"stack"},{"align":"center","children":[{"showValue":true,"size":"sm","type":"trend-indicator","value":"@card.trend"},{"className":"flex-1","color":"auto","data":"@card.sparklineData","fill":true,"height":24,"type":"sparkline"}],"direction":"horizontal","gap":"sm","type":"stack"}],"className":"rounded-lg border border-[var(--color-border)] bg-[var(--color-surface)] p-card-lg shadow-elevation-sm hover:shadow-elevation-md transition-shadow","direction":"vertical","gap":"sm","type":"stack"}],"type":"data-grid"}]},"label":"KPI tiles body content tree","description":"Render-ui SExpr for statsLook='kpi-tiles' — Stripe-dashboard style tile grid: huge typography number, label, trend indicator, sparkline hint.","tier":"internal"},"theme":{"type":"string","default":"","label":"Theme","description":"Data-theme skin applied to the stat body root — for chrome-less pages composed without an AppShell.","tier":"presentation"},"bodyContent":{"type":"render-ui","default":{"data-theme":"@config.theme","type":"box","children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"entity":"@entity.cards","fields":[],"renderItem":["fn","card",{"clickEvent":"@card.clickEvent","format":"@card.format","icon":"@card.icon","label":["if",["=",["array/len","@config.metricLabels"],0],"@card.label",["array/nth","@config.metricLabels","@card.position"]],"look":"@config.statLook","max":"@card.max","prefix":"@card.prefix","sparklineData":"@card.sparklineData","suffix":"@card.suffix","target":"@card.target","trend":"@card.trend","trendFormat":"@card.trendFormat","trendPolarity":"@card.trendPolarity","type":"stat-display","value":"@card.value","variant":"@card.variant"}],"type":"@config.viewPattern"}]},"label":"Body content tree","description":"Render-ui SExpr rendered after metrics aggregate for statsLook='cards' — the canonical data-grid call mapping @entity.cards through stat-display. Other statsLook values render kpiTilesBodyContent / heroMetricBodyContent / sparklineRowBodyContent instead; all four share this trait's state machine, aggregation pipeline, and listens.","tier":"internal"},"statLook":{"type":"string","default":"elevated","label":"Stat display look","description":"Layer 2 visual treatment for stat / KPI cards.","tier":"presentation","values":["elevated","flat","progress-backed","gauge","sparkline"]},"sparklineRowBodyContent":{"type":"render-ui","default":{"data-theme":"@config.theme","type":"box","children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","entity":"@entity.cards","fields":[],"gap":"md","minCardWidth":260,"renderItem":["fn","card",{"children":[{"align":"center","children":[{"color":"muted","name":"@card.icon","size":"xs","type":"icon"},{"className":"uppercase tracking-wide truncate","color":"muted","content":["if",["=",["array/len","@config.metricLabels"],0],"@card.label",["array/nth","@config.metricLabels","@card.position"]],"type":"typography","variant":"overline","weight":"semibold"}],"direction":"horizontal","gap":"xs","type":"stack"},{"className":"w-full","color":"auto","data":"@card.sparklineData","fill":true,"height":64,"strokeWidth":2,"type":"sparkline"},{"align":"baseline","children":[{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"caption"},{"className":"text-2xl font-semibold tabular-nums","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"caption"}],"direction":"horizontal","gap":"xs","type":"stack"},{"showValue":true,"size":"sm","type":"trend-indicator","value":"@card.trend"}],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"}],"className":"surface-content p-card-md hover:shadow-elevation-dialog transition-shadow min-h-[180px]","direction":"vertical","gap":"sm","type":"stack"}],"type":"data-grid"}]},"label":"Sparkline row body content tree","description":"Render-ui SExpr for statsLook='sparkline-row' — chart-first tiles where the mini trend line is the visual centerpiece, label above, value+delta footer.","tier":"internal"}},"scope":"instance"}],"pages":[{"name":"StatsItemStatsPage","id":"pag_D8NVY00X1WEGY4N9W1Z73SZBSK","path":"/statsitems","traits":[{"ref":"StatsItemStats","refId":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ"}]}],"types":{"MetricSpec":[{"name":"label","type":"string","required":true},{"name":"value","type":"number"},{"name":"icon","type":"string"},{"name":"format","type":"string","values":["number","currency","percent"]},{"name":"variant","type":"string","values":["default","primary","success","warning","error","info"]},{"name":"prefix","type":"string"},{"name":"suffix","type":"string"},{"name":"max","type":"number"},{"name":"target","type":"number"},{"name":"trend","type":"number"},{"name":"trendPolarity","type":"string","values":["higher-is-better","lower-is-better"]},{"name":"trendFormat","type":"string","values":["absolute","percent"]},{"name":"sparklineData","type":"[number]"},{"name":"clickEvent","type":"string"},{"name":"aggregation","type":"string","values":["count","sum","avg","min","max","variance"]},{"name":"field","type":"string"}],"ObjectSpec":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}],"StatCard":[{"name":"label","type":"string","required":true},{"name":"position","type":"number"},{"name":"value","type":"number"},{"name":"icon","type":"string"},{"name":"format","type":"string","values":["number","currency","percent"]},{"name":"variant","type":"string","values":["default","primary","success","warning","error","info"]},{"name":"prefix","type":"string"},{"name":"suffix","type":"string"},{"name":"max","type":"number"},{"name":"target","type":"number"},{"name":"trend","type":"number"},{"name":"trendPolarity","type":"string","values":["higher-is-better","lower-is-better"]},{"name":"trendFormat","type":"string","values":["absolute","percent"]},{"name":"sparklineData","type":"[number]"},{"name":"clickEvent","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_ENMEZRC4RB2C5HNQAZG29WPC31":{"id":"ent_ENMEZRC4RB2C5HNQAZG29WPC31","kind":"entity","bakedName":"StatsItem","curName":"StatsItem","renames":[],"owner":"workspace"},"evt_AK5C411DJKPS9G1WH0EMJ78Q7V":{"id":"evt_AK5C411DJKPS9G1WH0EMJ78Q7V","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ"},"evt_E0DJXKK6Z8KFM763KX1BBVM1X6":{"id":"evt_E0DJXKK6Z8KFM763KX1BBVM1X6","kind":"event","bakedName":"ITEMS_LOADED","curName":"ITEMS_LOADED","renames":[],"owner":"workspace","parent":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ"},"orb_YV3K2F2QV0BXG6MJN689F3FD3T":{"id":"orb_YV3K2F2QV0BXG6MJN689F3FD3T","kind":"orbital","bakedName":"StatsItemOrbital","curName":"StatsItemOrbital","renames":[],"owner":"workspace"},"pag_D8NVY00X1WEGY4N9W1Z73SZBSK":{"id":"pag_D8NVY00X1WEGY4N9W1Z73SZBSK","kind":"page","bakedName":"StatsItemStatsPage","curName":"StatsItemStatsPage","renames":[],"owner":"workspace"},"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ":{"id":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ","kind":"trait","bakedName":"StatsItemStats","curName":"StatsItemStats","renames":[],"owner":"workspace"}}}}
+{"name":"std-stats","version":"3.2.0","description":"std-stats — embeddable analytics-card atom. ITEMS_LOADED aggregates @payload.data per @config.metrics (count|sum|avg|min|max|variance with optional filter, baselineFilter, format, icon, max, target, trend, trendPolarity, sparkline) and renders one stat-display per entry. Variance metrics compute actual - baseline using `filter` + `baselineFilter` lambdas and report the signed delta as trend. clickEvent emits UI:{clickEvent} { metricLabel } when a card is clicked. Drop into a dashboard alongside std-browse / std-search / std-filter. `config.statsLook` switches the whole body between the default per-metric card grid ('cards'), a Stripe-dashboard KPI tile row ('kpi-tiles'), a single hero metric card ('hero-metric'), and a chart-first sparkline tile grid ('sparkline-row').","orbitals":[{"name":"StatsItemOrbital","id":"orb_YV3K2F2QV0BXG6MJN689F3FD3T","entity":{"name":"StatsItem","id":"ent_ENMEZRC4RB2C5HNQAZG29WPC31","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"cards","type":"array","default":[],"items":{"type":"object","properties":{"clickEvent":{"name":"clickEvent","type":"string","required":false},"suffix":{"name":"suffix","type":"string","required":false},"value":{"name":"value","type":"number","required":false},"position":{"name":"position","type":"number","required":false},"prefix":{"name":"prefix","type":"string","required":false},"trend":{"name":"trend","type":"number","required":false},"sparklineData":{"name":"sparklineData","type":"array","required":false,"items":{"type":"number"}},"variant":{"name":"variant","type":"string","required":false,"values":["default","primary","success","warning","error","info"]},"max":{"name":"max","type":"number","required":false},"icon":{"name":"icon","type":"string","required":false},"trendPolarity":{"name":"trendPolarity","type":"string","required":false,"values":["higher-is-better","lower-is-better"]},"format":{"name":"format","type":"string","required":false,"values":["number","currency","percent"]},"label":{"name":"label","type":"string","required":true},"trendFormat":{"name":"trendFormat","type":"string","required":false,"values":["absolute","percent"]},"target":{"name":"target","type":"number","required":false}}},"intrinsic":true,"description":"A collection of statistical cards to display.","synonyms":"statistics, items, displays"}]},"traits":[{"name":"StatsItemStats","id":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ","entityRebindable":true,"entityContract":{"requires":[],"provides":["cards"]},"effectRow":[{"kind":"render-ui","resource":"main"},{"kind":"set","resource":"@entity.cards"}],"category":"interaction","linkedEntity":"StatsItem","linkedEntityId":"ent_ENMEZRC4RB2C5HNQAZG29WPC31","entityRefIds":{"StatsItem":"ent_ENMEZRC4RB2C5HNQAZG29WPC31"},"stateMachine":{"states":[{"name":"idle","isInitial":true}],"events":[{"key":"INIT","id":"evt_AK5C411DJKPS9G1WH0EMJ78Q7V","name":"Initialize"},{"key":"ITEMS_LOADED","id":"evt_E0DJXKK6Z8KFM763KX1BBVM1X6","name":"Items Loaded","description":"Data has been loaded and is ready for processing.","synonyms":"data ready, update, refresh, loaded","tier":"domain","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}]},{"name":"totalCount","type":"number"}],"listened":true}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_AK5C411DJKPS9G1WH0EMJ78Q7V","effects":[["set","@entity.cards",["array/map","@config.metrics",["fn","metric",{"clickEvent":["object/get","@metric","clickEvent",""],"format":["object/get","@metric","format","number"],"icon":["object/get","@metric","icon",""],"label":["object/get","@metric","label"],"position":"@index","max":["object/get","@metric","max",0],"prefix":["object/get","@metric","prefix",""],"sparklineData":["object/get","@metric","sparklineData",[]],"suffix":["object/get","@metric","suffix",""],"target":["object/get","@metric","target",0],"trend":["object/get","@metric","trend"],"trendFormat":["object/get","@metric","trendFormat","absolute"],"trendPolarity":["object/get","@metric","trendPolarity","higher-is-better"],"value":["object/get","@metric","value",0],"variant":["object/get","@metric","variant","default"]}]]],["if",["=","@config.statsLook","kpi-tiles"],["render-ui","main","@config.kpiTilesBodyContent"],["if",["=","@config.statsLook","hero-metric"],["render-ui","main","@config.heroMetricBodyContent"],["if",["=","@config.statsLook","sparkline-row"],["render-ui","main","@config.sparklineRowBodyContent"],["render-ui","main","@config.bodyContent"]]]]]},{"from":"idle","to":"idle","event":"ITEMS_LOADED","eventId":"evt_E0DJXKK6Z8KFM763KX1BBVM1X6","effects":[["set","@entity.cards",["array/map","@config.metrics",["fn","metric",{"clickEvent":["object/get","@metric","clickEvent",""],"format":["object/get","@metric","format","number"],"icon":["object/get","@metric","icon",""],"label":["object/get","@metric","label"],"position":"@index","max":["object/get","@metric","max",0],"prefix":["object/get","@metric","prefix",""],"sparklineData":["object/get","@metric","sparklineData",[]],"suffix":["object/get","@metric","suffix",""],"target":["object/get","@metric","target",0],"trend":["if",["=",["object/get","@metric","aggregation","count"],"variance"],["-",["array/sum",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["array/sum",["array/filter","@payload.data",["object/get","@metric","baselineFilter",true]],["object/get","@metric","field",""]]],["object/get","@metric","trend"]],"trendFormat":["object/get","@metric","trendFormat","absolute"],"trendPolarity":["object/get","@metric","trendPolarity","higher-is-better"],"value":["if",["=",["object/get","@metric","aggregation","count"],"sum"],["array/sum",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["if",["=",["object/get","@metric","aggregation","count"],"avg"],["array/avg",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["if",["=",["object/get","@metric","aggregation","count"],"min"],["array/min",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["if",["=",["object/get","@metric","aggregation","count"],"max"],["array/max",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["if",["=",["object/get","@metric","aggregation","count"],"variance"],["array/sum",["array/filter","@payload.data",["object/get","@metric","filter",true]],["object/get","@metric","field",""]],["array/len",["array/filter","@payload.data",["object/get","@metric","filter",true]]]]]]]],"variant":["object/get","@metric","variant","default"]}]]],["if",["=","@config.statsLook","kpi-tiles"],["render-ui","main","@config.kpiTilesBodyContent"],["if",["=","@config.statsLook","hero-metric"],["render-ui","main","@config.heroMetricBodyContent"],["if",["=","@config.statsLook","sparkline-row"],["render-ui","main","@config.sparklineRowBodyContent"],["render-ui","main","@config.bodyContent"]]]]]}]},"config":{"kpiTilesBodyContent":{"type":"render-ui","default":{"data-theme":"@config.theme","type":"box","children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","entity":"@entity.cards","fields":[],"gap":"lg","minCardWidth":220,"renderItem":["fn","card",{"children":[{"align":"center","children":[{"className":"uppercase tracking-wide","color":"muted","content":["if",["=",["array/len","@config.metricLabels"],0],"@card.label",["array/nth","@config.metricLabels","@card.position"]],"type":"typography","variant":"caption","weight":"medium"},{"color":"muted","name":"@card.icon","size":"sm","type":"icon"}],"direction":"horizontal","gap":"xs","justify":"between","type":"stack"},{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"caption"},{"className":"text-4xl font-bold tracking-tight","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"caption"}],"direction":"horizontal","gap":"xs","type":"stack"},{"align":"center","children":[{"showValue":true,"size":"sm","type":"trend-indicator","value":"@card.trend"},{"className":"flex-1","color":"auto","data":"@card.sparklineData","fill":true,"height":24,"type":"sparkline"}],"direction":"horizontal","gap":"sm","type":"stack"}],"className":"rounded-lg border border-[var(--color-border)] bg-[var(--color-surface)] p-card-lg shadow-elevation-sm hover:shadow-elevation-md transition-shadow","direction":"vertical","gap":"sm","type":"stack"}],"type":"data-grid"}]},"label":"KPI tiles body content tree","description":"Render-ui SExpr for statsLook='kpi-tiles' — Stripe-dashboard style tile grid: huge typography number, label, trend indicator, sparkline hint.","tier":"internal"},"theme":{"type":"string","default":"","label":"Theme","description":"Data-theme skin applied to the stat body root — for chrome-less pages composed without an AppShell.","tier":"presentation"},"heroMetricBodyContent":{"type":"render-ui","default":{"data-theme":"@config.theme","type":"box","children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"entity":"@entity.cards","fields":[],"gap":"none","renderItem":["fn","card",{"children":[{"children":[{"align":"center","children":[{"align":"center","children":[{"color":"muted","name":"@card.icon","size":"md","type":"icon"},{"className":"uppercase tracking-widest","color":"muted","content":["if",["=",["array/len","@config.metricLabels"],0],"@card.label",["array/nth","@config.metricLabels","@card.position"]],"type":"typography","variant":"overline","weight":"bold"}],"direction":"horizontal","gap":"sm","justify":"center","type":"stack"},{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"h2","weight":"normal"},{"className":"text-7xl md:text-8xl font-bold tracking-tighter tabular-nums text-[var(--color-foreground)]","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"h2","weight":"normal"}],"className":"py-section","direction":"horizontal","gap":"xs","justify":"center","type":"stack"},{"showValue":true,"size":"md","type":"trend-indicator","value":"@card.trend"}],"className":"relative z-10 w-full max-w-2xl mx-auto text-center","direction":"vertical","gap":"md","type":"stack"},{"className":"absolute inset-x-0 bottom-0 w-full opacity-10 pointer-events-none","color":"auto","data":"@card.sparklineData","fill":true,"height":96,"strokeWidth":1,"type":"sparkline"}],"look":"elevated","padding":"lg","type":"card"}],"className":"relative w-full rounded-xl shadow-lg overflow-hidden","direction":"vertical","gap":"none","type":"stack"}],"type":"data-list"}]},"label":"Hero metric body content tree","description":"Render-ui SExpr for statsLook='hero-metric' — one elevated card, one oversize number, background sparkline.","tier":"internal"},"title":{"type":"string","default":"","label":"Section title","description":"Heading shown above the stat-card grid","synonyms":"the section header text. user phrases: 'rename section to X' / 'title the KPIs X' / 'change section title to X' -> X","tier":"presentation"},"bodyContent":{"type":"render-ui","default":{"data-theme":"@config.theme","type":"box","children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"entity":"@entity.cards","fields":[],"renderItem":["fn","card",{"clickEvent":"@card.clickEvent","format":"@card.format","icon":"@card.icon","label":["if",["=",["array/len","@config.metricLabels"],0],"@card.label",["array/nth","@config.metricLabels","@card.position"]],"look":"@config.statLook","max":"@card.max","prefix":"@card.prefix","sparklineData":"@card.sparklineData","suffix":"@card.suffix","target":"@card.target","trend":"@card.trend","trendFormat":"@card.trendFormat","trendPolarity":"@card.trendPolarity","type":"stat-display","value":"@card.value","variant":"@card.variant"}],"type":"@config.viewPattern"}]},"label":"Body content tree","description":"Render-ui SExpr rendered after metrics aggregate for statsLook='cards' — the canonical data-grid call mapping @entity.cards through stat-display. Other statsLook values render kpiTilesBodyContent / heroMetricBodyContent / sparklineRowBodyContent instead; all four share this trait's state machine, aggregation pipeline, and listens.","tier":"internal"},"metrics":{"type":"[MetricSpec]","default":[{"aggregation":"count","format":"number","icon":"list","label":"Total Items","sparklineData":[2,4,3,6,5,8,7],"variant":"primary"},{"aggregation":"count","format":"number","icon":"check-circle","label":"Active","sparklineData":[1,3,2,4,6,5,7],"variant":"success"},{"aggregation":"avg","field":"value","format":"number","icon":"trending-up","label":"Avg Value","sparklineData":[5,4,6,3,5,7,6],"variant":"info"}],"label":"Metrics","description":"One stat card per entry; declares aggregation, format, and styling","synonyms":"list of KPI cards / stat tiles / metric cards. each entry has label / value / format / icon / variant / aggregation. user phrases: 'replace metrics with X, Y, Z' -> rewrite array; 'add Revenue tile' -> append entry; 'change KPIs to X' -> rewrite array","tier":"presentation","items":{"type":"object","properties":{"icon":{"name":"icon","type":"string","required":false},"label":{"name":"label","type":"string","required":true},"clickEvent":{"name":"clickEvent","type":"string","required":false},"target":{"name":"target","type":"number","required":false},"variant":{"name":"variant","type":"string","required":false,"values":["default","primary","success","warning","error","info"]},"aggregation":{"name":"aggregation","type":"string","required":false,"values":["count","sum","avg","min","max","variance"]},"suffix":{"name":"suffix","type":"string","required":false},"trend":{"name":"trend","type":"number","required":false},"max":{"name":"max","type":"number","required":false},"trendFormat":{"name":"trendFormat","type":"string","required":false,"values":["absolute","percent"]},"sparklineData":{"name":"sparklineData","type":"array","required":false,"items":{"type":"number"}},"trendPolarity":{"name":"trendPolarity","type":"string","required":false,"values":["higher-is-better","lower-is-better"]},"value":{"name":"value","type":"number","required":false},"field":{"name":"field","type":"string","required":false},"prefix":{"name":"prefix","type":"string","required":false},"format":{"name":"format","type":"string","required":false,"values":["number","currency","percent"]}}}},"metricLabels":{"type":"[string]","default":[],"label":"Metric labels","description":"In metric order: the label shown on each card, in place of its `metrics` label (render-only, so it may be translated)","tier":"presentation","items":{"type":"string"}},"statLook":{"type":"string","default":"elevated","label":"Stat display look","description":"Layer 2 visual treatment for stat / KPI cards.","tier":"presentation","values":["elevated","flat","progress-backed","gauge","sparkline"]},"sparklineRowBodyContent":{"type":"render-ui","default":{"data-theme":"@config.theme","type":"box","children":[["if",["!=","@config.title",""],{"content":"@config.title","type":"typography","variant":"h3"},{"children":[],"gap":"none","type":"stack"}],{"className":"w-full","entity":"@entity.cards","fields":[],"gap":"md","minCardWidth":260,"renderItem":["fn","card",{"children":[{"align":"center","children":[{"color":"muted","name":"@card.icon","size":"xs","type":"icon"},{"className":"uppercase tracking-wide truncate","color":"muted","content":["if",["=",["array/len","@config.metricLabels"],0],"@card.label",["array/nth","@config.metricLabels","@card.position"]],"type":"typography","variant":"overline","weight":"semibold"}],"direction":"horizontal","gap":"xs","type":"stack"},{"className":"w-full","color":"auto","data":"@card.sparklineData","fill":true,"height":64,"strokeWidth":2,"type":"sparkline"},{"align":"baseline","children":[{"align":"baseline","children":[{"color":"muted","content":"@card.prefix","type":"typography","variant":"caption"},{"className":"text-2xl font-semibold tabular-nums","format":"@card.format","type":"animated-counter","value":"@card.value"},{"color":"muted","content":"@card.suffix","type":"typography","variant":"caption"}],"direction":"horizontal","gap":"xs","type":"stack"},{"showValue":true,"size":"sm","type":"trend-indicator","value":"@card.trend"}],"direction":"horizontal","gap":"sm","justify":"between","type":"stack"}],"className":"surface-content p-card-md hover:shadow-elevation-dialog transition-shadow min-h-[180px]","direction":"vertical","gap":"sm","type":"stack"}],"type":"data-grid"}]},"label":"Sparkline row body content tree","description":"Render-ui SExpr for statsLook='sparkline-row' — chart-first tiles where the mini trend line is the visual centerpiece, label above, value+delta footer.","tier":"internal"},"viewPattern":{"type":"pattern","default":"data-grid","label":"Render pattern","description":"UI pattern used to arrange the stat cards","synonyms":"internal pattern selector. user prompts rarely target this directly","tier":"internal"},"statsLook":{"type":"string","default":"cards","label":"Stats look","description":"Layer 3 body layout: default per-metric stat-card grid ('cards'), Stripe-dashboard KPI tile row ('kpi-tiles'), single oversize hero number ('hero-metric'), or chart-first sparkline tile grid ('sparkline-row').","tier":"presentation","values":["cards","kpi-tiles","hero-metric","sparkline-row"]}},"scope":"instance"}],"pages":[{"name":"StatsItemStatsPage","id":"pag_D8NVY00X1WEGY4N9W1Z73SZBSK","path":"/statsitems","traits":[{"ref":"StatsItemStats","refId":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ"}]}],"types":{"MetricSpec":[{"name":"label","type":"string","required":true},{"name":"value","type":"number"},{"name":"icon","type":"string"},{"name":"format","type":"string","values":["number","currency","percent"]},{"name":"variant","type":"string","values":["default","primary","success","warning","error","info"]},{"name":"prefix","type":"string"},{"name":"suffix","type":"string"},{"name":"max","type":"number"},{"name":"target","type":"number"},{"name":"trend","type":"number"},{"name":"trendPolarity","type":"string","values":["higher-is-better","lower-is-better"]},{"name":"trendFormat","type":"string","values":["absolute","percent"]},{"name":"sparklineData","type":"[number]"},{"name":"clickEvent","type":"string"},{"name":"aggregation","type":"string","values":["count","sum","avg","min","max","variance"]},{"name":"field","type":"string"}],"ObjectSpec":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}],"StatCard":[{"name":"label","type":"string","required":true},{"name":"position","type":"number"},{"name":"value","type":"number"},{"name":"icon","type":"string"},{"name":"format","type":"string","values":["number","currency","percent"]},{"name":"variant","type":"string","values":["default","primary","success","warning","error","info"]},{"name":"prefix","type":"string"},{"name":"suffix","type":"string"},{"name":"max","type":"number"},{"name":"target","type":"number"},{"name":"trend","type":"number"},{"name":"trendPolarity","type":"string","values":["higher-is-better","lower-is-better"]},{"name":"trendFormat","type":"string","values":["absolute","percent"]},{"name":"sparklineData","type":"[number]"},{"name":"clickEvent","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_ENMEZRC4RB2C5HNQAZG29WPC31":{"id":"ent_ENMEZRC4RB2C5HNQAZG29WPC31","kind":"entity","bakedName":"StatsItem","curName":"StatsItem","renames":[],"owner":"workspace"},"evt_AK5C411DJKPS9G1WH0EMJ78Q7V":{"id":"evt_AK5C411DJKPS9G1WH0EMJ78Q7V","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ"},"evt_E0DJXKK6Z8KFM763KX1BBVM1X6":{"id":"evt_E0DJXKK6Z8KFM763KX1BBVM1X6","kind":"event","bakedName":"ITEMS_LOADED","curName":"ITEMS_LOADED","renames":[],"owner":"workspace","parent":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ"},"orb_YV3K2F2QV0BXG6MJN689F3FD3T":{"id":"orb_YV3K2F2QV0BXG6MJN689F3FD3T","kind":"orbital","bakedName":"StatsItemOrbital","curName":"StatsItemOrbital","renames":[],"owner":"workspace"},"pag_D8NVY00X1WEGY4N9W1Z73SZBSK":{"id":"pag_D8NVY00X1WEGY4N9W1Z73SZBSK","kind":"page","bakedName":"StatsItemStatsPage","curName":"StatsItemStatsPage","renames":[],"owner":"workspace"},"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ":{"id":"trt_ZJ5A8RZ3WPHYBF8FCQ3Q46EDWJ","kind":"trait","bakedName":"StatsItemStats","curName":"StatsItemStats","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/ui/core/atoms/std-step-flow.orb

@@ -1 +1 @@
-{"name":"std-step-flow","version":"3.4.0","description":"std-step-flow — generic N-step sequential decision chain (Stripe Connect / TurboTax / Vercel deploy style). `config.steps` is an array of step definitions `{ key, label, description, icon, allowedRoles?: [string] }`; the trait projects the current step into a prominent body card and a `wizard-progress` stepper bar at the top. When a step declares `allowedRoles`, only users whose `@user.role` is in that list can advance through it. One primary button ADVANCEs along the chain; at the last step the same button finalizes (label/icon/variant swap via entity binding, state routed via guard). REJECT/ESCALATE terminate. Topology = loading / running / approved / rejected / escalated / error.","orbitals":[{"name":"StepFlowOrbital","id":"orb_PA6W1HQCZNPFTW5K99ANSJXKTP","entity":{"name":"StepFlowView","id":"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"wizardSteps","type":"array","default":[],"items":{"type":"object","properties":{"id":{"name":"id","type":"string","required":true},"isPending":{"name":"isPending","type":"boolean","required":false},"description":{"name":"description","type":"string","required":false},"icon":{"name":"icon","type":"string","required":false},"label":{"name":"label","type":"string","required":false},"badgeVariant":{"name":"badgeVariant","type":"string","required":false},"title":{"name":"title","type":"string","required":true},"indexLabel":{"name":"indexLabel","type":"string","required":false},"labelColor":{"name":"labelColor","type":"string","required":false},"key":{"name":"key","type":"string","required":false}}},"intrinsic":true},{"name":"currentStepIndex","type":"number","default":0},{"name":"totalSteps","type":"number","default":0,"intrinsic":true},{"name":"currentStepLabel","type":"string","default":"","intrinsic":true},{"name":"currentStepDescription","type":"string","default":"","intrinsic":true},{"name":"currentStepIcon","type":"string","default":"user","intrinsic":true},{"name":"isFirstStep","type":"boolean","default":true,"intrinsic":true},{"name":"isLastStep","type":"boolean","default":false,"intrinsic":true},{"name":"primaryActionLabel","type":"string","default":"Approve & Continue","intrinsic":true},{"name":"primaryActionVariant","type":"string","default":"primary","values":["primary","success"],"intrinsic":true},{"name":"primaryActionIcon","type":"string","default":"chevron-right","intrinsic":true},{"name":"finalStatus","type":"string","default":"","values":["approved","rejected","escalated",""]},{"name":"rejectionReason","type":"string","default":""},{"name":"errorMessage","type":"string","default":"","intrinsic":true}]},"traits":[{"name":"StepFlowReview","id":"trt_K578R9F0ABG55Y52TSNQR8R55T","entityRebindable":true,"entityContract":{"requires":[],"provides":["currentStepDescription","currentStepIcon","currentStepIndex","currentStepLabel","errorMessage","finalStatus","isFirstStep","isLastStep","primaryActionIcon","primaryActionLabel","primaryActionVariant","rejectionReason","totalSteps","wizardSteps"]},"effectRow":[{"kind":"fetch","resource":"StepFlowView"},{"kind":"render-ui","resource":"main"},{"kind":"set","resource":"@entity.currentStepDescription"},{"kind":"set","resource":"@entity.currentStepIcon"},{"kind":"set","resource":"@entity.currentStepIndex"},{"kind":"set","resource":"@entity.currentStepLabel"},{"kind":"set","resource":"@entity.errorMessage"},{"kind":"set","resource":"@entity.finalStatus"},{"kind":"set","resource":"@entity.id"},{"kind":"set","resource":"@entity.isFirstStep"},{"kind":"set","resource":"@entity.isLastStep"},{"kind":"set","resource":"@entity.primaryActionIcon"},{"kind":"set","resource":"@entity.primaryActionLabel"},{"kind":"set","resource":"@entity.primaryActionVariant"},{"kind":"set","resource":"@entity.rejectionReason"},{"kind":"set","resource":"@entity.totalSteps"},{"kind":"set","resource":"@entity.wizardSteps"}],"category":"interaction","linkedEntity":"StepFlowView","linkedEntityId":"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC","entityRefIds":{"StepFlowView":"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC"},"emits":[{"event":"ADVANCE","eventId":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","description":"Signals progression to the next step in the sequence.","synonyms":"next, proceed, continue, move forward","tier":"domain","payloadSchema":[{"name":"id","type":"string"},{"name":"stepKey","type":"string"}]},{"event":"BACK","eventId":"evt_0FVFMF82DX16YPBT3PX16PD80E","description":"Indicates a request to navigate to the previous step.","synonyms":"previous, undo, return","tier":"domain","payloadSchema":[{"name":"id","type":"string"}]},{"event":"REJECT","eventId":"evt_5KS3V9VZ36ZHKB38K7983MJ34W","description":"Indicates the user or system rejected the current step.","synonyms":"cancel, decline, dismiss","tier":"domain","payloadSchema":[{"name":"id","type":"string"},{"name":"reason","type":"string"}]},{"event":"ESCALATE","eventId":"evt_STHBFKHJ22S112YPFMN0T79JCX","description":"Signals a request to elevate the process to a higher authority.","synonyms":"defer, transfer, handoff","tier":"presentation","payloadSchema":[{"name":"id","type":"string"},{"name":"reason","type":"string"}]},{"event":"RESTART","eventId":"evt_CH2R67A5692K4V0D11B50D5FFT","description":"Initiates a reset of the current workflow process.","synonyms":"reset, refresh, restart, reinitialize","tier":"internal","payloadSchema":[{"name":"id","type":"string"}]},{"event":"StepItemsLoaded","eventId":"evt_VJB19V2TNBDANP87ZYYBEJNQ6M","description":"Signals that the step items have been successfully loaded.","synonyms":"loaded, fetched, retrieved, populated","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}],"entity":"ObjectSpec"}]},{"event":"StepItemsLoadFailed","eventId":"evt_N367DBM0ZG0FREKCQ313PZ9D2H","description":"Indicates failure to load step configuration items.","synonyms":"load error, failed fetch, data problem","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]}],"stateMachine":{"states":[{"name":"loading","isInitial":true},{"name":"running"},{"name":"approved"},{"name":"rejected"},{"name":"escalated"},{"name":"error"}],"events":[{"key":"INIT","id":"evt_WPAMMGA10H0G8XKRH4P65D42N8","name":"Initialize"},{"key":"StepItemsLoaded","id":"evt_VJB19V2TNBDANP87ZYYBEJNQ6M","name":"Step items loaded","description":"Signals that the step items have been successfully loaded.","synonyms":"loaded, fetched, retrieved, populated","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}]}],"listened":true},{"key":"StepItemsLoadFailed","id":"evt_N367DBM0ZG0FREKCQ313PZ9D2H","name":"Step items load failed","description":"Indicates failure to load step configuration items.","synonyms":"load error, failed fetch, data problem","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}],"listened":true},{"key":"StepItemsSaved","id":"evt_K5TEF7KBZRNZW38DMW8EM1QQ6D","name":"Step items saved","description":"Data for the current step has been successfully saved.","synonyms":"update, persist, store, commit","tier":"presentation","payloadSchema":[{"name":"row","type":"@entity"}],"listened":true},{"key":"StepItemsSaveFailed","id":"evt_RCPD80QKETSQD2CF0R8NNJWK2N","name":"Step items save failed","description":"Indicates a failure to save step item data.","synonyms":"save error, data failed, persistence error","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}],"listened":true},{"key":"ADVANCE","id":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","name":"Advance","description":"Signals progression to the next step in the sequence.","synonyms":"next, proceed, continue, move forward","tier":"domain","payloadSchema":[{"name":"id","type":"string"},{"name":"stepKey","type":"string"}],"listened":true},{"key":"BACK","id":"evt_0FVFMF82DX16YPBT3PX16PD80E","name":"Back","description":"Indicates a request to navigate to the previous step.","synonyms":"previous, undo, return","tier":"domain","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"REJECT","id":"evt_5KS3V9VZ36ZHKB38K7983MJ34W","name":"Reject","description":"Indicates the user or system rejected the current step.","synonyms":"cancel, decline, dismiss","tier":"domain","payloadSchema":[{"name":"id","type":"string"},{"name":"reason","type":"string"}],"listened":true},{"key":"ESCALATE","id":"evt_STHBFKHJ22S112YPFMN0T79JCX","name":"Escalate","description":"Signals a request to elevate the process to a higher authority.","synonyms":"defer, transfer, handoff","tier":"presentation","payloadSchema":[{"name":"id","type":"string"},{"name":"reason","type":"string"}],"listened":true},{"key":"RESTART","id":"evt_CH2R67A5692K4V0D11B50D5FFT","name":"Restart","description":"Initiates a reset of the current workflow process.","synonyms":"reset, refresh, restart, reinitialize","tier":"internal","payloadSchema":[{"name":"id","type":"string"}],"listened":true}],"transitions":[{"from":"loading","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"loading","to":"running","event":"StepItemsLoaded","eventId":"evt_VJB19V2TNBDANP87ZYYBEJNQ6M","effects":[["set","@entity.id",["object/get",["array/nth","@payload.data",0],"id"]],["set","@entity.currentStepIndex",0],["set","@entity.totalSteps",["array/len","@config.steps"]],["set","@entity.wizardSteps",["array/map","@config.steps",["fn","step",{"badgeVariant":["if",["<","@index","@entity.currentStepIndex"],"success",["if",["=","@index","@entity.currentStepIndex"],"primary","neutral"]],"description":["object/get","@step","description",""],"icon":["object/get","@step","icon","circle"],"id":["object/get","@step","key"],"indexLabel":["str/concat","",["+","@index",1]],"isPending":[">","@index","@entity.currentStepIndex"],"key":["object/get","@step","key"],"label":["object/get","@step","label"],"labelColor":["if",["=","@index","@entity.currentStepIndex"],"default","muted"],"title":["object/get","@step","label"]}]]],["set","@entity.currentStepLabel",["object/get",["array/nth","@config.steps",0],"label"]],["set","@entity.currentStepDescription",["object/get",["array/nth","@config.steps",0],"description",""]],["set","@entity.currentStepIcon",["object/get",["array/nth","@config.steps",0],"icon","user"]],["set","@entity.isFirstStep",true],["set","@entity.isLastStep",["=",["array/len","@config.steps"],1]],["set","@entity.primaryActionLabel",["if",["=",["array/len","@config.steps"],1],"Finalize Approval","Approve & Continue"]],["set","@entity.primaryActionVariant",["if",["=",["array/len","@config.steps"],1],"success","primary"]],["set","@entity.primaryActionIcon",["if",["=",["array/len","@config.steps"],1],"check-circle","chevron-right"]],["render-ui","main","@config.bodyContent"]]},{"from":"loading","to":"error","event":"StepItemsLoadFailed","eventId":"evt_N367DBM0ZG0FREKCQ313PZ9D2H","effects":[["set","@entity.errorMessage","@payload.error"],["render-ui","main",{"message":"@entity.errorMessage","title":"Failed to load","type":"error-state"}]]},{"from":"loading","to":"running","event":"StepItemsSaved","eventId":"evt_K5TEF7KBZRNZW38DMW8EM1QQ6D","effects":[["render-ui","main","@config.bodyContent"]]},{"from":"loading","to":"error","event":"StepItemsSaveFailed","eventId":"evt_RCPD80QKETSQD2CF0R8NNJWK2N","effects":[["set","@entity.errorMessage","@payload.error"],["render-ui","main",{"message":"@entity.errorMessage","title":"Save failed","type":"error-state"}]]},{"from":"running","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}]]},{"from":"running","to":"running","event":"ADVANCE","eventId":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","guard":["and",["not","@entity.isLastStep"],["or",["not",["object/has",["array/nth","@config.steps","@entity.currentStepIndex"],"allowedRoles"]],["array/includes",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"allowedRoles",[]],"@user.role"]]],"effects":[["set","@entity.currentStepIndex",["+","@entity.currentStepIndex",1]],["set","@entity.currentStepLabel",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"label"]],["set","@entity.currentStepDescription",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"description",""]],["set","@entity.currentStepIcon",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"icon","user"]],["set","@entity.isFirstStep",["=","@entity.currentStepIndex",0]],["set","@entity.isLastStep",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]]],["set","@entity.primaryActionLabel",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"Finalize Approval","Approve & Continue"]],["set","@entity.primaryActionVariant",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"success","primary"]],["set","@entity.primaryActionIcon",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"check-circle","chevron-right"]],["set","@entity.wizardSteps",["array/map","@config.steps",["fn","step",{"badgeVariant":["if",["<","@index","@entity.currentStepIndex"],"success",["if",["=","@index","@entity.currentStepIndex"],"primary","neutral"]],"description":["object/get","@step","description",""],"icon":["object/get","@step","icon","circle"],"id":["object/get","@step","key"],"indexLabel":["str/concat","",["+","@index",1]],"isPending":[">","@index","@entity.currentStepIndex"],"key":["object/get","@step","key"],"label":["object/get","@step","label"],"labelColor":["if",["=","@index","@entity.currentStepIndex"],"default","muted"],"title":["object/get","@step","label"]}]]],["render-ui","main","@config.bodyContent"]]},{"from":"running","to":"approved","event":"ADVANCE","eventId":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","guard":["and","@entity.isLastStep",["or",["not",["object/has",["array/nth","@config.steps","@entity.currentStepIndex"],"allowedRoles"]],["array/includes",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"allowedRoles",[]],"@user.role"]]],"effects":[["set","@entity.finalStatus","approved"],["render-ui","main",{"align":"center","children":[{"name":"check-circle","size":"xl","type":"icon"},{"align":"center","content":"Approved","type":"typography","variant":"h2"},{"align":"center","color":"muted","content":"@config.completedText","type":"typography","variant":"body"},{"allowNavigation":false,"currentStep":"@entity.totalSteps","steps":["if",["=",["array/len","@config.stepLabels"],0],"@entity.wizardSteps",["array/map","@entity.wizardSteps",["fn","step",{"id":["object/get","@step","id",""],"title":["array/nth","@config.stepLabels","@index"],"description":["if",["=",["array/len","@config.stepDescriptions"],0],["object/get","@step","description",""],["array/nth","@config.stepDescriptions","@index"]]}]]],"type":"wizard-progress"},{"action":"RESTART","actionPayload":{"id":"@entity.id"},"icon":"rotate-ccw","label":"@config.restartLabel","type":"button","variant":"secondary"}],"direction":"vertical","gap":"lg","type":"stack"}]]},{"from":"running","to":"running","event":"BACK","eventId":"evt_0FVFMF82DX16YPBT3PX16PD80E","effects":[["set","@entity.currentStepIndex",["-","@entity.currentStepIndex",1]],["set","@entity.currentStepLabel",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"label"]],["set","@entity.currentStepDescription",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"description",""]],["set","@entity.currentStepIcon",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"icon","user"]],["set","@entity.isFirstStep",["=","@entity.currentStepIndex",0]],["set","@entity.isLastStep",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]]],["set","@entity.primaryActionLabel",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"Finalize Approval","Approve & Continue"]],["set","@entity.primaryActionVariant",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"success","primary"]],["set","@entity.primaryActionIcon",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"check-circle","chevron-right"]],["set","@entity.wizardSteps",["array/map","@config.steps",["fn","step",{"badgeVariant":["if",["<","@index","@entity.currentStepIndex"],"success",["if",["=","@index","@entity.currentStepIndex"],"primary","neutral"]],"description":["object/get","@step","description",""],"icon":["object/get","@step","icon","circle"],"id":["object/get","@step","key"],"indexLabel":["str/concat","",["+","@index",1]],"isPending":[">","@index","@entity.currentStepIndex"],"key":["object/get","@step","key"],"label":["object/get","@step","label"],"labelColor":["if",["=","@index","@entity.currentStepIndex"],"default","muted"],"title":["object/get","@step","label"]}]]],["render-ui","main","@config.bodyContent"]]},{"from":"running","to":"rejected","event":"REJECT","eventId":"evt_5KS3V9VZ36ZHKB38K7983MJ34W","effects":[["set","@entity.finalStatus","rejected"],["set","@entity.rejectionReason","@payload.reason"],["render-ui","main",{"align":"center","children":[{"name":"x-circle","size":"xl","type":"icon"},{"align":"center","content":"Rejected","type":"typography","variant":"h2"},{"children":[{"children":[{"color":"muted","content":"Reason","type":"typography","variant":"caption"},{"content":"@entity.rejectionReason","type":"typography","variant":"body"}],"direction":"vertical","gap":"sm","type":"stack"}],"look":"@config.cardLook","type":"card"},{"action":"RESTART","actionPayload":{"id":"@entity.id"},"icon":"rotate-ccw","label":"@config.restartLabel","type":"button","variant":"secondary"}],"direction":"vertical","gap":"lg","type":"stack"}]]},{"from":"running","to":"escalated","event":"ESCALATE","eventId":"evt_STHBFKHJ22S112YPFMN0T79JCX","effects":[["set","@entity.finalStatus","escalated"],["render-ui","main",{"align":"center","children":[{"name":"alert-triangle","size":"xl","type":"icon"},{"align":"center","content":"Escalated","type":"typography","variant":"h2"},{"align":"center","color":"muted","content":"@config.escalatedText","type":"typography","variant":"body"},{"action":"RESTART","actionPayload":{"id":"@entity.id"},"icon":"rotate-ccw","label":"@config.restartLabel","type":"button","variant":"secondary"}],"direction":"vertical","gap":"lg","type":"stack"}]]},{"from":"approved","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"approved","to":"loading","event":"RESTART","eventId":"evt_CH2R67A5692K4V0D11B50D5FFT","effects":[["set","@entity.finalStatus",""],["set","@entity.currentStepIndex",0],["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"rejected","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"rejected","to":"loading","event":"RESTART","eventId":"evt_CH2R67A5692K4V0D11B50D5FFT","effects":[["set","@entity.finalStatus",""],["set","@entity.currentStepIndex",0],["set","@entity.rejectionReason",""],["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"escalated","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"escalated","to":"loading","event":"RESTART","eventId":"evt_CH2R67A5692K4V0D11B50D5FFT","effects":[["set","@entity.finalStatus",""],["set","@entity.currentStepIndex",0],["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"error","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["render-ui","main",{"title":"Retrying…","type":"loading-state"}]]}]},"config":{"title":{"type":"string","default":"Review","label":"Flow title","description":"Heading shown above the step progress bar","tier":"presentation"},"backLabel":{"type":"string","default":"Back","label":"Back label","tier":"presentation"},"continueLabel":{"type":"string","default":"Approve & Continue","label":"Continue label","tier":"presentation"},"finishLabel":{"type":"string","default":"Finalize Approval","label":"Finish label","description":"The primary button on the last step","tier":"presentation"},"cardLook":{"type":"string","default":"elevated","label":"Card look","description":"Layer 2 visual treatment for cards rendered by this atom.","tier":"presentation","values":["elevated","flat-bordered","borderless-divider","ticket","invoice","chip","tile-image-first"]},"restartLabel":{"type":"string","default":"Start a new review","label":"Restart label","tier":"presentation"},"bodyContent":{"type":"render-ui","default":{"children":[{"align":"center","children":[{"name":"shield-check","size":"lg","type":"icon"},{"content":"@config.title","type":"typography","variant":"h3"}],"direction":"horizontal","gap":"sm","type":"stack"},{"allowNavigation":false,"currentStep":"@entity.currentStepIndex","steps":["if",["=",["array/len","@config.stepLabels"],0],"@entity.wizardSteps",["array/map","@entity.wizardSteps",["fn","step",{"id":["object/get","@step","id",""],"title":["array/nth","@config.stepLabels","@index"],"description":["if",["=",["array/len","@config.stepDescriptions"],0],["object/get","@step","description",""],["array/nth","@config.stepDescriptions","@index"]]}]]],"type":"wizard-progress"},{"children":[{"children":[{"align":"center","children":[{"name":"@entity.currentStepIcon","size":"xl","type":"icon"},{"children":[{"content":["if",["=",["array/len","@config.stepLabels"],0],"@entity.currentStepLabel",["array/nth","@config.stepLabels","@entity.currentStepIndex"]],"type":"typography","variant":"h2"},{"color":"muted","content":["if",["=",["array/len","@config.stepDescriptions"],0],"@entity.currentStepDescription",["array/nth","@config.stepDescriptions","@entity.currentStepIndex"]],"type":"typography","variant":"body"}],"direction":"vertical","gap":"xs","type":"stack"}],"direction":"horizontal","gap":"sm","type":"stack"}],"direction":"vertical","gap":"md","type":"stack"}],"look":"@config.cardLook","type":"card"},{"align":"center","children":[{"action":"BACK","actionPayload":{"id":"@entity.id"},"disabled":"@entity.isFirstStep","icon":"chevron-left","label":"@config.backLabel","type":"button","variant":"ghost"},{"action":"REJECT","actionPayload":{"id":"@entity.id"},"icon":"x","label":"@config.rejectLabel","type":"button","variant":"ghost"},{"action":"ESCALATE","actionPayload":{"id":"@entity.id"},"icon":"alert-triangle","label":"@config.escalateLabel","type":"button","variant":"ghost"},{"action":"ADVANCE","actionPayload":{"id":"@entity.id"},"icon":"@entity.primaryActionIcon","label":["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"@config.finishLabel","@config.continueLabel"],"type":"button","variant":"primary"}],"direction":"horizontal","wrap":true,"gap":"sm","type":"stack"}],"direction":"vertical","gap":"lg","type":"stack"},"label":"Body content tree","description":"Render-ui SExpr rendered while the step chain is active (loading-success, running, BACK). Default is the canonical wizard-progress + step-card + action-row tree. Layer 3 variants override this with their own tree (horizontal stepper, sidebar progress, card carousel, etc.) to deliver entirely different step UX while inheriting the same trait, state machine, emits, and listens.","tier":"internal"},"stepDescriptions":{"type":"[string]","default":[],"label":"Step descriptions","description":"In step order: the description shown for each step, in place of its `steps` description (render-only, so it may be translated)","tier":"presentation","items":{"type":"string"}},"steps":{"type":"[StepSpec]","default":[{"description":"Initial review by direct manager","icon":"user","key":"manager","label":"Manager Review"},{"description":"Department director sign-off","icon":"users","key":"director","label":"Director Approval"},{"description":"Final executive approval","icon":"shield","key":"executive","label":"Executive Sign-off"}],"label":"Steps","description":"Ordered decision steps with label, icon, and optional role gates","tier":"domain","items":{"type":"object","properties":{"label":{"name":"label","type":"string","required":true},"icon":{"name":"icon","type":"string","required":false},"description":{"name":"description","type":"string","required":false},"key":{"name":"key","type":"string","required":false},"allowedRoles":{"name":"allowedRoles","type":"array","required":false,"items":{"type":"string"}}}}},"rejectLabel":{"type":"string","default":"Reject","label":"Reject label","tier":"presentation"},"stepLabels":{"type":"[string]","default":[],"label":"Step labels","description":"In step order: the label shown for each step, in place of its `steps` label (render-only, so it may be translated)","tier":"presentation","items":{"type":"string"}},"completedText":{"type":"string","default":"All review steps completed successfully.","label":"Completed text","tier":"presentation"},"escalateLabel":{"type":"string","default":"Escalate","label":"Escalate label","tier":"presentation"},"escalatedText":{"type":"string","default":"This item has been escalated for further review.","label":"Escalated text","tier":"presentation"}},"scope":"instance"}],"pages":[{"name":"StepFlowPage","id":"pag_1104H9H6EHK78VFYC7XE7ZCGMB","path":"/step-flow","traits":[{"ref":"StepFlowReview","refId":"trt_K578R9F0ABG55Y52TSNQR8R55T"}]}],"types":{"ObjectSpec":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}],"StepSpec":[{"name":"label","type":"string","required":true},{"name":"key","type":"string"},{"name":"icon","type":"string"},{"name":"description","type":"string"},{"name":"allowedRoles","type":"[string]"}],"WizardStep":[{"name":"id","type":"string","required":true},{"name":"key","type":"string"},{"name":"title","type":"string","required":true},{"name":"label","type":"string"},{"name":"description","type":"string"},{"name":"icon","type":"string"},{"name":"indexLabel","type":"string"},{"name":"isPending","type":"boolean"},{"name":"badgeVariant","type":"string"},{"name":"labelColor","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC":{"id":"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC","kind":"entity","bakedName":"StepFlowView","curName":"StepFlowView","renames":[],"owner":"workspace"},"evt_0FVFMF82DX16YPBT3PX16PD80E":{"id":"evt_0FVFMF82DX16YPBT3PX16PD80E","kind":"event","bakedName":"BACK","curName":"BACK","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_5KS3V9VZ36ZHKB38K7983MJ34W":{"id":"evt_5KS3V9VZ36ZHKB38K7983MJ34W","kind":"event","bakedName":"REJECT","curName":"REJECT","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_CH2R67A5692K4V0D11B50D5FFT":{"id":"evt_CH2R67A5692K4V0D11B50D5FFT","kind":"event","bakedName":"RESTART","curName":"RESTART","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_FQTFWPQMZJTFS8WTNT91TCMMQF":{"id":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","kind":"event","bakedName":"ADVANCE","curName":"ADVANCE","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_K5TEF7KBZRNZW38DMW8EM1QQ6D":{"id":"evt_K5TEF7KBZRNZW38DMW8EM1QQ6D","kind":"event","bakedName":"StepItemsSaved","curName":"StepItemsSaved","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_N367DBM0ZG0FREKCQ313PZ9D2H":{"id":"evt_N367DBM0ZG0FREKCQ313PZ9D2H","kind":"event","bakedName":"StepItemsLoadFailed","curName":"StepItemsLoadFailed","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_RCPD80QKETSQD2CF0R8NNJWK2N":{"id":"evt_RCPD80QKETSQD2CF0R8NNJWK2N","kind":"event","bakedName":"StepItemsSaveFailed","curName":"StepItemsSaveFailed","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_STHBFKHJ22S112YPFMN0T79JCX":{"id":"evt_STHBFKHJ22S112YPFMN0T79JCX","kind":"event","bakedName":"ESCALATE","curName":"ESCALATE","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_VJB19V2TNBDANP87ZYYBEJNQ6M":{"id":"evt_VJB19V2TNBDANP87ZYYBEJNQ6M","kind":"event","bakedName":"StepItemsLoaded","curName":"StepItemsLoaded","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_WPAMMGA10H0G8XKRH4P65D42N8":{"id":"evt_WPAMMGA10H0G8XKRH4P65D42N8","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"orb_PA6W1HQCZNPFTW5K99ANSJXKTP":{"id":"orb_PA6W1HQCZNPFTW5K99ANSJXKTP","kind":"orbital","bakedName":"StepFlowOrbital","curName":"StepFlowOrbital","renames":[],"owner":"workspace"},"pag_1104H9H6EHK78VFYC7XE7ZCGMB":{"id":"pag_1104H9H6EHK78VFYC7XE7ZCGMB","kind":"page","bakedName":"StepFlowPage","curName":"StepFlowPage","renames":[],"owner":"workspace"},"trt_K578R9F0ABG55Y52TSNQR8R55T":{"id":"trt_K578R9F0ABG55Y52TSNQR8R55T","kind":"trait","bakedName":"StepFlowReview","curName":"StepFlowReview","renames":[],"owner":"workspace"}}}}
+{"name":"std-step-flow","version":"3.4.0","description":"std-step-flow — generic N-step sequential decision chain (Stripe Connect / TurboTax / Vercel deploy style). `config.steps` is an array of step definitions `{ key, label, description, icon, allowedRoles?: [string] }`; the trait projects the current step into a prominent body card and a `wizard-progress` stepper bar at the top. When a step declares `allowedRoles`, only users whose `@user.role` is in that list can advance through it. One primary button ADVANCEs along the chain; at the last step the same button finalizes (label/icon/variant swap via entity binding, state routed via guard). REJECT/ESCALATE terminate. Topology = loading / running / approved / rejected / escalated / error.","orbitals":[{"name":"StepFlowOrbital","id":"orb_PA6W1HQCZNPFTW5K99ANSJXKTP","entity":{"name":"StepFlowView","id":"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"wizardSteps","type":"array","default":[],"items":{"type":"object","properties":{"id":{"name":"id","type":"string","required":true},"title":{"name":"title","type":"string","required":true},"key":{"name":"key","type":"string","required":false},"labelColor":{"name":"labelColor","type":"string","required":false},"label":{"name":"label","type":"string","required":false},"isPending":{"name":"isPending","type":"boolean","required":false},"badgeVariant":{"name":"badgeVariant","type":"string","required":false},"description":{"name":"description","type":"string","required":false},"indexLabel":{"name":"indexLabel","type":"string","required":false},"icon":{"name":"icon","type":"string","required":false}}},"intrinsic":true},{"name":"currentStepIndex","type":"number","default":0},{"name":"totalSteps","type":"number","default":0,"intrinsic":true},{"name":"currentStepLabel","type":"string","default":"","intrinsic":true},{"name":"currentStepDescription","type":"string","default":"","intrinsic":true},{"name":"currentStepIcon","type":"string","default":"user","intrinsic":true},{"name":"isFirstStep","type":"boolean","default":true,"intrinsic":true},{"name":"isLastStep","type":"boolean","default":false,"intrinsic":true},{"name":"primaryActionLabel","type":"string","default":"Approve & Continue","intrinsic":true},{"name":"primaryActionVariant","type":"string","default":"primary","values":["primary","success"],"intrinsic":true},{"name":"primaryActionIcon","type":"string","default":"chevron-right","intrinsic":true},{"name":"finalStatus","type":"string","default":"","values":["approved","rejected","escalated",""]},{"name":"rejectionReason","type":"string","default":""},{"name":"errorMessage","type":"string","default":"","intrinsic":true}]},"traits":[{"name":"StepFlowReview","id":"trt_K578R9F0ABG55Y52TSNQR8R55T","entityRebindable":true,"entityContract":{"requires":[],"provides":["currentStepDescription","currentStepIcon","currentStepIndex","currentStepLabel","errorMessage","finalStatus","isFirstStep","isLastStep","primaryActionIcon","primaryActionLabel","primaryActionVariant","rejectionReason","totalSteps","wizardSteps"]},"effectRow":[{"kind":"fetch","resource":"StepFlowView"},{"kind":"render-ui","resource":"main"},{"kind":"set","resource":"@entity.currentStepDescription"},{"kind":"set","resource":"@entity.currentStepIcon"},{"kind":"set","resource":"@entity.currentStepIndex"},{"kind":"set","resource":"@entity.currentStepLabel"},{"kind":"set","resource":"@entity.errorMessage"},{"kind":"set","resource":"@entity.finalStatus"},{"kind":"set","resource":"@entity.id"},{"kind":"set","resource":"@entity.isFirstStep"},{"kind":"set","resource":"@entity.isLastStep"},{"kind":"set","resource":"@entity.primaryActionIcon"},{"kind":"set","resource":"@entity.primaryActionLabel"},{"kind":"set","resource":"@entity.primaryActionVariant"},{"kind":"set","resource":"@entity.rejectionReason"},{"kind":"set","resource":"@entity.totalSteps"},{"kind":"set","resource":"@entity.wizardSteps"}],"category":"interaction","linkedEntity":"StepFlowView","linkedEntityId":"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC","entityRefIds":{"StepFlowView":"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC"},"emits":[{"event":"ADVANCE","eventId":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","description":"Signals progression to the next step in the sequence.","synonyms":"next, proceed, continue, move forward","tier":"domain","payloadSchema":[{"name":"id","type":"string"},{"name":"stepKey","type":"string"}]},{"event":"BACK","eventId":"evt_0FVFMF82DX16YPBT3PX16PD80E","description":"Indicates a request to navigate to the previous step.","synonyms":"previous, undo, return","tier":"domain","payloadSchema":[{"name":"id","type":"string"}]},{"event":"REJECT","eventId":"evt_5KS3V9VZ36ZHKB38K7983MJ34W","description":"Indicates the user or system rejected the current step.","synonyms":"cancel, decline, dismiss","tier":"domain","payloadSchema":[{"name":"id","type":"string"},{"name":"reason","type":"string"}]},{"event":"ESCALATE","eventId":"evt_STHBFKHJ22S112YPFMN0T79JCX","description":"Signals a request to elevate the process to a higher authority.","synonyms":"defer, transfer, handoff","tier":"presentation","payloadSchema":[{"name":"id","type":"string"},{"name":"reason","type":"string"}]},{"event":"RESTART","eventId":"evt_CH2R67A5692K4V0D11B50D5FFT","description":"Initiates a reset of the current workflow process.","synonyms":"reset, refresh, restart, reinitialize","tier":"internal","payloadSchema":[{"name":"id","type":"string"}]},{"event":"StepItemsLoaded","eventId":"evt_VJB19V2TNBDANP87ZYYBEJNQ6M","description":"Signals that the step items have been successfully loaded.","synonyms":"loaded, fetched, retrieved, populated","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}],"entity":"ObjectSpec"}]},{"event":"StepItemsLoadFailed","eventId":"evt_N367DBM0ZG0FREKCQ313PZ9D2H","description":"Indicates failure to load step configuration items.","synonyms":"load error, failed fetch, data problem","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]}],"stateMachine":{"states":[{"name":"loading","isInitial":true},{"name":"running"},{"name":"approved"},{"name":"rejected"},{"name":"escalated"},{"name":"error"}],"events":[{"key":"INIT","id":"evt_WPAMMGA10H0G8XKRH4P65D42N8","name":"Initialize"},{"key":"StepItemsLoaded","id":"evt_VJB19V2TNBDANP87ZYYBEJNQ6M","name":"Step items loaded","description":"Signals that the step items have been successfully loaded.","synonyms":"loaded, fetched, retrieved, populated","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}]}],"listened":true},{"key":"StepItemsLoadFailed","id":"evt_N367DBM0ZG0FREKCQ313PZ9D2H","name":"Step items load failed","description":"Indicates failure to load step configuration items.","synonyms":"load error, failed fetch, data problem","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}],"listened":true},{"key":"StepItemsSaved","id":"evt_K5TEF7KBZRNZW38DMW8EM1QQ6D","name":"Step items saved","description":"Data for the current step has been successfully saved.","synonyms":"update, persist, store, commit","tier":"presentation","payloadSchema":[{"name":"row","type":"@entity"}],"listened":true},{"key":"StepItemsSaveFailed","id":"evt_RCPD80QKETSQD2CF0R8NNJWK2N","name":"Step items save failed","description":"Indicates a failure to save step item data.","synonyms":"save error, data failed, persistence error","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}],"listened":true},{"key":"ADVANCE","id":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","name":"Advance","description":"Signals progression to the next step in the sequence.","synonyms":"next, proceed, continue, move forward","tier":"domain","payloadSchema":[{"name":"id","type":"string"},{"name":"stepKey","type":"string"}],"listened":true},{"key":"BACK","id":"evt_0FVFMF82DX16YPBT3PX16PD80E","name":"Back","description":"Indicates a request to navigate to the previous step.","synonyms":"previous, undo, return","tier":"domain","payloadSchema":[{"name":"id","type":"string"}],"listened":true},{"key":"REJECT","id":"evt_5KS3V9VZ36ZHKB38K7983MJ34W","name":"Reject","description":"Indicates the user or system rejected the current step.","synonyms":"cancel, decline, dismiss","tier":"domain","payloadSchema":[{"name":"id","type":"string"},{"name":"reason","type":"string"}],"listened":true},{"key":"ESCALATE","id":"evt_STHBFKHJ22S112YPFMN0T79JCX","name":"Escalate","description":"Signals a request to elevate the process to a higher authority.","synonyms":"defer, transfer, handoff","tier":"presentation","payloadSchema":[{"name":"id","type":"string"},{"name":"reason","type":"string"}],"listened":true},{"key":"RESTART","id":"evt_CH2R67A5692K4V0D11B50D5FFT","name":"Restart","description":"Initiates a reset of the current workflow process.","synonyms":"reset, refresh, restart, reinitialize","tier":"internal","payloadSchema":[{"name":"id","type":"string"}],"listened":true}],"transitions":[{"from":"loading","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"loading","to":"running","event":"StepItemsLoaded","eventId":"evt_VJB19V2TNBDANP87ZYYBEJNQ6M","effects":[["set","@entity.id",["object/get",["array/nth","@payload.data",0],"id"]],["set","@entity.currentStepIndex",0],["set","@entity.totalSteps",["array/len","@config.steps"]],["set","@entity.wizardSteps",["array/map","@config.steps",["fn","step",{"badgeVariant":["if",["<","@index","@entity.currentStepIndex"],"success",["if",["=","@index","@entity.currentStepIndex"],"primary","neutral"]],"description":["object/get","@step","description",""],"icon":["object/get","@step","icon","circle"],"id":["object/get","@step","key"],"indexLabel":["str/concat","",["+","@index",1]],"isPending":[">","@index","@entity.currentStepIndex"],"key":["object/get","@step","key"],"label":["object/get","@step","label"],"labelColor":["if",["=","@index","@entity.currentStepIndex"],"default","muted"],"title":["object/get","@step","label"]}]]],["set","@entity.currentStepLabel",["object/get",["array/nth","@config.steps",0],"label"]],["set","@entity.currentStepDescription",["object/get",["array/nth","@config.steps",0],"description",""]],["set","@entity.currentStepIcon",["object/get",["array/nth","@config.steps",0],"icon","user"]],["set","@entity.isFirstStep",true],["set","@entity.isLastStep",["=",["array/len","@config.steps"],1]],["set","@entity.primaryActionLabel",["if",["=",["array/len","@config.steps"],1],"Finalize Approval","Approve & Continue"]],["set","@entity.primaryActionVariant",["if",["=",["array/len","@config.steps"],1],"success","primary"]],["set","@entity.primaryActionIcon",["if",["=",["array/len","@config.steps"],1],"check-circle","chevron-right"]],["render-ui","main","@config.bodyContent"]]},{"from":"loading","to":"error","event":"StepItemsLoadFailed","eventId":"evt_N367DBM0ZG0FREKCQ313PZ9D2H","effects":[["set","@entity.errorMessage","@payload.error"],["render-ui","main",{"message":"@entity.errorMessage","title":"Failed to load","type":"error-state"}]]},{"from":"loading","to":"running","event":"StepItemsSaved","eventId":"evt_K5TEF7KBZRNZW38DMW8EM1QQ6D","effects":[["render-ui","main","@config.bodyContent"]]},{"from":"loading","to":"error","event":"StepItemsSaveFailed","eventId":"evt_RCPD80QKETSQD2CF0R8NNJWK2N","effects":[["set","@entity.errorMessage","@payload.error"],["render-ui","main",{"message":"@entity.errorMessage","title":"Save failed","type":"error-state"}]]},{"from":"running","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}]]},{"from":"running","to":"running","event":"ADVANCE","eventId":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","guard":["and",["not","@entity.isLastStep"],["or",["not",["object/has",["array/nth","@config.steps","@entity.currentStepIndex"],"allowedRoles"]],["array/includes",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"allowedRoles",[]],"@user.role"]]],"effects":[["set","@entity.currentStepIndex",["+","@entity.currentStepIndex",1]],["set","@entity.currentStepLabel",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"label"]],["set","@entity.currentStepDescription",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"description",""]],["set","@entity.currentStepIcon",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"icon","user"]],["set","@entity.isFirstStep",["=","@entity.currentStepIndex",0]],["set","@entity.isLastStep",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]]],["set","@entity.primaryActionLabel",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"Finalize Approval","Approve & Continue"]],["set","@entity.primaryActionVariant",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"success","primary"]],["set","@entity.primaryActionIcon",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"check-circle","chevron-right"]],["set","@entity.wizardSteps",["array/map","@config.steps",["fn","step",{"badgeVariant":["if",["<","@index","@entity.currentStepIndex"],"success",["if",["=","@index","@entity.currentStepIndex"],"primary","neutral"]],"description":["object/get","@step","description",""],"icon":["object/get","@step","icon","circle"],"id":["object/get","@step","key"],"indexLabel":["str/concat","",["+","@index",1]],"isPending":[">","@index","@entity.currentStepIndex"],"key":["object/get","@step","key"],"label":["object/get","@step","label"],"labelColor":["if",["=","@index","@entity.currentStepIndex"],"default","muted"],"title":["object/get","@step","label"]}]]],["render-ui","main","@config.bodyContent"]]},{"from":"running","to":"approved","event":"ADVANCE","eventId":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","guard":["and","@entity.isLastStep",["or",["not",["object/has",["array/nth","@config.steps","@entity.currentStepIndex"],"allowedRoles"]],["array/includes",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"allowedRoles",[]],"@user.role"]]],"effects":[["set","@entity.finalStatus","approved"],["render-ui","main",{"align":"center","children":[{"name":"check-circle","size":"xl","type":"icon"},{"align":"center","content":"Approved","type":"typography","variant":"h2"},{"align":"center","color":"muted","content":"@config.completedText","type":"typography","variant":"body"},{"allowNavigation":false,"currentStep":"@entity.totalSteps","steps":["if",["=",["array/len","@config.stepLabels"],0],"@entity.wizardSteps",["array/map","@entity.wizardSteps",["fn","step",{"id":["object/get","@step","id",""],"title":["array/nth","@config.stepLabels","@index"],"description":["if",["=",["array/len","@config.stepDescriptions"],0],["object/get","@step","description",""],["array/nth","@config.stepDescriptions","@index"]]}]]],"type":"wizard-progress"},{"action":"RESTART","actionPayload":{"id":"@entity.id"},"icon":"rotate-ccw","label":"@config.restartLabel","type":"button","variant":"secondary"}],"direction":"vertical","gap":"lg","type":"stack"}]]},{"from":"running","to":"running","event":"BACK","eventId":"evt_0FVFMF82DX16YPBT3PX16PD80E","effects":[["set","@entity.currentStepIndex",["-","@entity.currentStepIndex",1]],["set","@entity.currentStepLabel",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"label"]],["set","@entity.currentStepDescription",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"description",""]],["set","@entity.currentStepIcon",["object/get",["array/nth","@config.steps","@entity.currentStepIndex"],"icon","user"]],["set","@entity.isFirstStep",["=","@entity.currentStepIndex",0]],["set","@entity.isLastStep",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]]],["set","@entity.primaryActionLabel",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"Finalize Approval","Approve & Continue"]],["set","@entity.primaryActionVariant",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"success","primary"]],["set","@entity.primaryActionIcon",["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"check-circle","chevron-right"]],["set","@entity.wizardSteps",["array/map","@config.steps",["fn","step",{"badgeVariant":["if",["<","@index","@entity.currentStepIndex"],"success",["if",["=","@index","@entity.currentStepIndex"],"primary","neutral"]],"description":["object/get","@step","description",""],"icon":["object/get","@step","icon","circle"],"id":["object/get","@step","key"],"indexLabel":["str/concat","",["+","@index",1]],"isPending":[">","@index","@entity.currentStepIndex"],"key":["object/get","@step","key"],"label":["object/get","@step","label"],"labelColor":["if",["=","@index","@entity.currentStepIndex"],"default","muted"],"title":["object/get","@step","label"]}]]],["render-ui","main","@config.bodyContent"]]},{"from":"running","to":"rejected","event":"REJECT","eventId":"evt_5KS3V9VZ36ZHKB38K7983MJ34W","effects":[["set","@entity.finalStatus","rejected"],["set","@entity.rejectionReason","@payload.reason"],["render-ui","main",{"align":"center","children":[{"name":"x-circle","size":"xl","type":"icon"},{"align":"center","content":"Rejected","type":"typography","variant":"h2"},{"children":[{"children":[{"color":"muted","content":"Reason","type":"typography","variant":"caption"},{"content":"@entity.rejectionReason","type":"typography","variant":"body"}],"direction":"vertical","gap":"sm","type":"stack"}],"look":"@config.cardLook","type":"card"},{"action":"RESTART","actionPayload":{"id":"@entity.id"},"icon":"rotate-ccw","label":"@config.restartLabel","type":"button","variant":"secondary"}],"direction":"vertical","gap":"lg","type":"stack"}]]},{"from":"running","to":"escalated","event":"ESCALATE","eventId":"evt_STHBFKHJ22S112YPFMN0T79JCX","effects":[["set","@entity.finalStatus","escalated"],["render-ui","main",{"align":"center","children":[{"name":"alert-triangle","size":"xl","type":"icon"},{"align":"center","content":"Escalated","type":"typography","variant":"h2"},{"align":"center","color":"muted","content":"@config.escalatedText","type":"typography","variant":"body"},{"action":"RESTART","actionPayload":{"id":"@entity.id"},"icon":"rotate-ccw","label":"@config.restartLabel","type":"button","variant":"secondary"}],"direction":"vertical","gap":"lg","type":"stack"}]]},{"from":"approved","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"approved","to":"loading","event":"RESTART","eventId":"evt_CH2R67A5692K4V0D11B50D5FFT","effects":[["set","@entity.finalStatus",""],["set","@entity.currentStepIndex",0],["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"rejected","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"rejected","to":"loading","event":"RESTART","eventId":"evt_CH2R67A5692K4V0D11B50D5FFT","effects":[["set","@entity.finalStatus",""],["set","@entity.currentStepIndex",0],["set","@entity.rejectionReason",""],["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"escalated","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"escalated","to":"loading","event":"RESTART","eventId":"evt_CH2R67A5692K4V0D11B50D5FFT","effects":[["set","@entity.finalStatus",""],["set","@entity.currentStepIndex",0],["fetch","StepFlowView",{"emit":{"failure":"StepItemsLoadFailed","success":"StepItemsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"card"}]]},{"from":"error","to":"loading","event":"INIT","eventId":"evt_WPAMMGA10H0G8XKRH4P65D42N8","effects":[["render-ui","main",{"title":"Retrying…","type":"loading-state"}]]}]},"config":{"cardLook":{"type":"string","default":"elevated","label":"Card look","description":"Layer 2 visual treatment for cards rendered by this atom.","tier":"presentation","values":["elevated","flat-bordered","borderless-divider","ticket","invoice","chip","tile-image-first"]},"completedText":{"type":"string","default":"All review steps completed successfully.","label":"Completed text","tier":"presentation"},"stepLabels":{"type":"[string]","default":[],"label":"Step labels","description":"In step order: the label shown for each step, in place of its `steps` label (render-only, so it may be translated)","tier":"presentation","items":{"type":"string"}},"backLabel":{"type":"string","default":"Back","label":"Back label","tier":"presentation"},"restartLabel":{"type":"string","default":"Start a new review","label":"Restart label","tier":"presentation"},"finishLabel":{"type":"string","default":"Finalize Approval","label":"Finish label","description":"The primary button on the last step","tier":"presentation"},"continueLabel":{"type":"string","default":"Approve & Continue","label":"Continue label","tier":"presentation"},"escalatedText":{"type":"string","default":"This item has been escalated for further review.","label":"Escalated text","tier":"presentation"},"title":{"type":"string","default":"Review","label":"Flow title","description":"Heading shown above the step progress bar","tier":"presentation"},"bodyContent":{"type":"render-ui","default":{"children":[{"align":"center","children":[{"name":"shield-check","size":"lg","type":"icon"},{"content":"@config.title","type":"typography","variant":"h3"}],"direction":"horizontal","gap":"sm","type":"stack"},{"allowNavigation":false,"currentStep":"@entity.currentStepIndex","steps":["if",["=",["array/len","@config.stepLabels"],0],"@entity.wizardSteps",["array/map","@entity.wizardSteps",["fn","step",{"id":["object/get","@step","id",""],"title":["array/nth","@config.stepLabels","@index"],"description":["if",["=",["array/len","@config.stepDescriptions"],0],["object/get","@step","description",""],["array/nth","@config.stepDescriptions","@index"]]}]]],"type":"wizard-progress"},{"children":[{"children":[{"align":"center","children":[{"name":"@entity.currentStepIcon","size":"xl","type":"icon"},{"children":[{"content":["if",["=",["array/len","@config.stepLabels"],0],"@entity.currentStepLabel",["array/nth","@config.stepLabels","@entity.currentStepIndex"]],"type":"typography","variant":"h2"},{"color":"muted","content":["if",["=",["array/len","@config.stepDescriptions"],0],"@entity.currentStepDescription",["array/nth","@config.stepDescriptions","@entity.currentStepIndex"]],"type":"typography","variant":"body"}],"direction":"vertical","gap":"xs","type":"stack"}],"direction":"horizontal","gap":"sm","type":"stack"}],"direction":"vertical","gap":"md","type":"stack"}],"look":"@config.cardLook","type":"card"},{"align":"center","children":[{"action":"BACK","actionPayload":{"id":"@entity.id"},"disabled":"@entity.isFirstStep","icon":"chevron-left","label":"@config.backLabel","type":"button","variant":"ghost"},{"action":"REJECT","actionPayload":{"id":"@entity.id"},"icon":"x","label":"@config.rejectLabel","type":"button","variant":"ghost"},{"action":"ESCALATE","actionPayload":{"id":"@entity.id"},"icon":"alert-triangle","label":"@config.escalateLabel","type":"button","variant":"ghost"},{"action":"ADVANCE","actionPayload":{"id":"@entity.id"},"icon":"@entity.primaryActionIcon","label":["if",["=","@entity.currentStepIndex",["-","@entity.totalSteps",1]],"@config.finishLabel","@config.continueLabel"],"type":"button","variant":"primary"}],"direction":"horizontal","wrap":true,"gap":"sm","type":"stack"}],"direction":"vertical","gap":"lg","type":"stack"},"label":"Body content tree","description":"Render-ui SExpr rendered while the step chain is active (loading-success, running, BACK). Default is the canonical wizard-progress + step-card + action-row tree. Layer 3 variants override this with their own tree (horizontal stepper, sidebar progress, card carousel, etc.) to deliver entirely different step UX while inheriting the same trait, state machine, emits, and listens.","tier":"internal"},"steps":{"type":"[StepSpec]","default":[{"description":"Initial review by direct manager","icon":"user","key":"manager","label":"Manager Review"},{"description":"Department director sign-off","icon":"users","key":"director","label":"Director Approval"},{"description":"Final executive approval","icon":"shield","key":"executive","label":"Executive Sign-off"}],"label":"Steps","description":"Ordered decision steps with label, icon, and optional role gates","tier":"domain","items":{"type":"object","properties":{"icon":{"name":"icon","type":"string","required":false},"label":{"name":"label","type":"string","required":true},"allowedRoles":{"name":"allowedRoles","type":"array","required":false,"items":{"type":"string"}},"description":{"name":"description","type":"string","required":false},"key":{"name":"key","type":"string","required":false}}}},"rejectLabel":{"type":"string","default":"Reject","label":"Reject label","tier":"presentation"},"stepDescriptions":{"type":"[string]","default":[],"label":"Step descriptions","description":"In step order: the description shown for each step, in place of its `steps` description (render-only, so it may be translated)","tier":"presentation","items":{"type":"string"}},"escalateLabel":{"type":"string","default":"Escalate","label":"Escalate label","tier":"presentation"}},"scope":"instance"}],"pages":[{"name":"StepFlowPage","id":"pag_1104H9H6EHK78VFYC7XE7ZCGMB","path":"/step-flow","traits":[{"ref":"StepFlowReview","refId":"trt_K578R9F0ABG55Y52TSNQR8R55T"}]}],"types":{"ObjectSpec":[{"name":"id","type":"string"},{"name":"label","type":"string"},{"name":"value","type":"string"}],"StepSpec":[{"name":"label","type":"string","required":true},{"name":"key","type":"string"},{"name":"icon","type":"string"},{"name":"description","type":"string"},{"name":"allowedRoles","type":"[string]"}],"WizardStep":[{"name":"id","type":"string","required":true},{"name":"key","type":"string"},{"name":"title","type":"string","required":true},{"name":"label","type":"string"},{"name":"description","type":"string"},{"name":"icon","type":"string"},{"name":"indexLabel","type":"string"},{"name":"isPending","type":"boolean"},{"name":"badgeVariant","type":"string"},{"name":"labelColor","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC":{"id":"ent_EC5VEQKW13Y0HTX3TXZAWTPKKC","kind":"entity","bakedName":"StepFlowView","curName":"StepFlowView","renames":[],"owner":"workspace"},"evt_0FVFMF82DX16YPBT3PX16PD80E":{"id":"evt_0FVFMF82DX16YPBT3PX16PD80E","kind":"event","bakedName":"BACK","curName":"BACK","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_5KS3V9VZ36ZHKB38K7983MJ34W":{"id":"evt_5KS3V9VZ36ZHKB38K7983MJ34W","kind":"event","bakedName":"REJECT","curName":"REJECT","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_CH2R67A5692K4V0D11B50D5FFT":{"id":"evt_CH2R67A5692K4V0D11B50D5FFT","kind":"event","bakedName":"RESTART","curName":"RESTART","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_FQTFWPQMZJTFS8WTNT91TCMMQF":{"id":"evt_FQTFWPQMZJTFS8WTNT91TCMMQF","kind":"event","bakedName":"ADVANCE","curName":"ADVANCE","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_K5TEF7KBZRNZW38DMW8EM1QQ6D":{"id":"evt_K5TEF7KBZRNZW38DMW8EM1QQ6D","kind":"event","bakedName":"StepItemsSaved","curName":"StepItemsSaved","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_N367DBM0ZG0FREKCQ313PZ9D2H":{"id":"evt_N367DBM0ZG0FREKCQ313PZ9D2H","kind":"event","bakedName":"StepItemsLoadFailed","curName":"StepItemsLoadFailed","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_RCPD80QKETSQD2CF0R8NNJWK2N":{"id":"evt_RCPD80QKETSQD2CF0R8NNJWK2N","kind":"event","bakedName":"StepItemsSaveFailed","curName":"StepItemsSaveFailed","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_STHBFKHJ22S112YPFMN0T79JCX":{"id":"evt_STHBFKHJ22S112YPFMN0T79JCX","kind":"event","bakedName":"ESCALATE","curName":"ESCALATE","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_VJB19V2TNBDANP87ZYYBEJNQ6M":{"id":"evt_VJB19V2TNBDANP87ZYYBEJNQ6M","kind":"event","bakedName":"StepItemsLoaded","curName":"StepItemsLoaded","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"evt_WPAMMGA10H0G8XKRH4P65D42N8":{"id":"evt_WPAMMGA10H0G8XKRH4P65D42N8","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_K578R9F0ABG55Y52TSNQR8R55T"},"orb_PA6W1HQCZNPFTW5K99ANSJXKTP":{"id":"orb_PA6W1HQCZNPFTW5K99ANSJXKTP","kind":"orbital","bakedName":"StepFlowOrbital","curName":"StepFlowOrbital","renames":[],"owner":"workspace"},"pag_1104H9H6EHK78VFYC7XE7ZCGMB":{"id":"pag_1104H9H6EHK78VFYC7XE7ZCGMB","kind":"page","bakedName":"StepFlowPage","curName":"StepFlowPage","renames":[],"owner":"workspace"},"trt_K578R9F0ABG55Y52TSNQR8R55T":{"id":"trt_K578R9F0ABG55Y52TSNQR8R55T","kind":"trait","bakedName":"StepFlowReview","curName":"StepFlowReview","renames":[],"owner":"workspace"}}}}