mosaic-headless 1.30.1 → 1.31.1

package/data/data-class-hierarchy.csv

@@ -64,6 +64,7 @@ NavigationElementMResourceData,ElementMResourceDataAbstract,no,Mosaic/NodeTypes/
 NodeMResourceDataAbstract,MResourceDataAbstract,yes,Mosaic/NodeTypes/NodeAbstract/NodeMResourceDataAbstract.php
 OpenStreetMapElementMResourceData,ElementMResourceDataAbstract,no,Mosaic/NodeTypes/OpenStreetMap/OpenStreetMapElementMResourceData.php
 OptionElementMResourceData,ElementMResourceDataAbstract,no,Mosaic/NodeTypes/Pro/Form/Form/MElements/Select/Option/OptionElementMResourceData.php
+PopoverElementMResourceData,ElementMResourceDataAbstract,no,Mosaic/NodeTypes/Popover/PopoverElementMResourceData.php
 RadioInputElementMResourceData,ElementMResourceDataAbstract,no,Mosaic/NodeTypes/Pro/Form/Form/MElements/Radio/RadioInput/RadioInputElementMResourceData.php
 RecaptchaElementMResourceData,ElementMResourceDataAbstract,no,Mosaic/NodeTypes/Pro/Form/Form/MElements/Recaptcha/RecaptchaElementMResourceData.php
 RootElementMResourceData,ElementMResourceDataAbstract,no,Mosaic/NodeTypes/Root/RootElementMResourceData.php

package/data/dialog-form-verification.csv

@@ -31,9 +31,9 @@ GATE/button-closes,PASS,the modalClose inside is the only exit
 DEPTH/shut-at-rest,PASS,
 DEPTH/opens-past-75,PASS,scrollDepth threshold 75%
 EXIT/opens,PASS,exitIntent is desktop-only and synthetic leave is approximate
-LATCH/record-abb,PASS,"{""counter"":1,""firstAt"":1791103196338,""lastAt"":1791103196338,""lastID"":""75cb0b1a-7"
+LATCH/record-abb,PASS,"{""counter"":1,""firstAt"":1791303948906,""lastAt"":1791303948906,""lastID"":""403cc438-0"
 LATCH/B-first-wins,PASS,"6/6 as predicted, 0 lost clicks  {'abb>abb,aba>none': 6}"
-LATCH/record-aba,PASS,"{""counter"":1,""firstAt"":1791103249401,""lastAt"":1791103249401,""lastID"":""fbc055d4-7"
+LATCH/record-aba,PASS,"{""counter"":1,""firstAt"":1791303994070,""lastAt"":1791303994070,""lastID"":""7ddba850-2"
 LATCH/A-first-wins,PASS,"6/6 as predicted, 0 lost clicks  {'aba>aba,abb>none': 6}"
 LATCH/order-decides,PASS,"the winner flips with click order, so it is the first EVALUATED, not the first authored"
 FIT390/centre,PASS,scrollW=349/349 childOverflow=0 pageScrollsSideways=False

package/data/dialog-verification.csv

@@ -3,7 +3,7 @@ HOST,PASS,renders <dialog>
 STRUCTURE,PASS,overlay and window children present
 ARIA,PASS,aria-modal=true aria-label='Feature probe dialog' role=dialog
 CLOSED_AT_REST,PASS,dialog.open=False display=none
-OPENS,PASS,dialog.open=True display=grid top-layer=False
+OPENS,PASS,dialog.open=True display=grid top-layer=True
 CLOSES,PASS,dialog.open=False
 CLOSEDBY_ESC,PASS,"closedby=everything, Esc closed it"
 KEYBOARD,PASS,the opening control takes focus

package/data/form-surface-verification.csv

@@ -6,6 +6,9 @@ FORM/required,PASS,required is set on 8 of them
 FORM/honeypot,PASS,"Mosaic adds its own spam trap: ['mosaic_hp_url', 'mosaic_hp_ts']"
 FORM/option_labels,PASS,"5 options, all labelled"
 FORM/required_blocks,PASS,"empty form reports invalid: ['name', 'email', 'kind', 'kind']"
+NAVBAR,SKIPPED,not on this page
+MEDIA,SKIPPED,not on this page
+WORDPRESS,SKIPPED,not on this page
 MULTISTEP/one_at_rest,PASS,visible steps: [0]
 MULTISTEP/next,PASS,NEXT -> [1]
 MULTISTEP/back,PASS,BACK -> [0]

package/data/interaction-types.csv

@@ -10,6 +10,7 @@ formSubmit,timed,Element events,Runs when the form reaches a submission outcome.
 hover,timed,Mouse,Animate when the cursor hovers the element.,Mosaic/Plugins/InteractionTypes/timed/hover/InteractionTypeHover.php
 modal,timed,Element events,Animates the modal as it opens and closes.,Mosaic/Plugins/InteractionTypes/timed/modal/InteractionTypeModal.php
 pageLoad,timed,Page & scroll,Activates when the page finishes loading.,Mosaic/Plugins/InteractionTypes/timed/pageload/InteractionTypePageLoad.php
+popover,timed,Element events,Animates the popover as it opens and closes.,Mosaic/Plugins/InteractionTypes/timed/popover/InteractionTypePopover.php
 scrollDepth,timed,Page & scroll,Activates when the visitor scrolls this far down the page.,Mosaic/Plugins/InteractionTypes/timed/scrolldepth/InteractionTypeScrollDepth.php
 scrollDirectionChange,timed,Page & scroll,Animate when the scroll direction changes.,Mosaic/Plugins/InteractionTypes/timed/scrolldirectionchange/InteractionTypeScrollDirectionChange.php
 slideChange,timed,Element events,Animate when the slide slides in or out.,Mosaic/Plugins/InteractionTypes/timed/slidechange/InteractionTypeSlideChange.php

package/data/intro-verification.csv

@@ -1,26 +1,26 @@
 check,result,detail
 PLAYS,PASS,43 of 43 intro elements changed state
 COUNTS,PASS,--mk-n reached 100
-ENDS,PASS,veil is out of hit-testing from 8900ms
+ENDS,PASS,veil is out of hit-testing from 3400ms
 NO_TRAP,PASS,"0 content elements still at opacity 0 in the viewport (1 below the fold and 0 on a scroll timeline awaiting it, 1 mid-blink)"
 CLEARS,PASS,a real click landed on 'mk-caret-row'
-AMBIENT,PASS,"7 elements still moving between 11000ms and 13000ms with no input: mk-board-city-s, mk-board-utc-s, mk-clock-s, mk-flap-0-s, mk-flap-1-s, mk-flap-2-s"
+AMBIENT,PASS,"8 elements still moving between 5000ms and 7000ms with no input: mk-board-city-s, mk-board-utc-s, mk-caret, mk-clock-s, mk-flap-0-s, mk-flap-1-s"
 DEGRADES,PASS,with reduced motion the veil is display:none throughout
 READABLE,PASS,0 elements invisible at 120ms with reduced motion
 
 t_ms,counter,veil_visibility,veil_clip,veil_covers_centre,hit_centre,invisible_content
 120,,,,False,html.no-js,0
-700,--mk-n=0;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,7
-1400,--mk-n=5;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,7
-2200,--mk-n=40;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
-3000,--mk-n=71;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
-3800,--mk-n=87;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
-4600,--mk-n=95;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
-5400,--mk-n=98;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
-6200,--mk-n=100;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
-7000,--mk-n=100;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
-7800,--mk-n=100;--mk-s=0;--mk-m=0,visible,none,True,p.m-text,2
-8300,--mk-n=100;--mk-s=0;--mk-m=0,visible,none,False,mk-caret-row,1
-8900,--mk-n=0;--mk-s=0;--mk-m=0,hidden,none,False,mk-caret-row,0
-11000,--mk-n=0;--mk-s=0;--mk-m=0,hidden,none,False,mk-caret-row,0
-13000,--mk-n=0;--mk-s=0;--mk-m=0,hidden,none,False,mk-caret-row,0
+400,--mk-n=0;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,7
+700,--mk-n=9;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,7
+1000,--mk-n=52;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
+1300,--mk-n=82;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
+1600,--mk-n=94;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
+1900,--mk-n=98;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
+2200,--mk-n=100;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
+2500,--mk-n=100;--mk-s=0;--mk-m=0,visible,none,True,mk-boot-num,3
+2800,--mk-n=100;--mk-s=0;--mk-m=0,visible,none,True,mk-boot,0
+3100,--mk-n=100;--mk-s=0;--mk-m=0,visible,none,False,mk-caret-row,0
+3400,--mk-n=0;--mk-s=0;--mk-m=0,hidden,none,False,mk-caret-row,0
+3800,--mk-n=0;--mk-s=0;--mk-m=0,hidden,none,False,mk-caret-row,0
+5000,--mk-n=0;--mk-s=0;--mk-m=0,hidden,none,False,mk-caret-row,0
+7000,--mk-n=0;--mk-s=0;--mk-m=0,hidden,none,False,mk-caret-row,0

package/data/mobile-audit.csv

@@ -1,9 +1,14 @@
 path,width,finding,element,detail
 components/,390,GRID_NOT_COLLAPSED,cp-tabs-menu,2 columns at 390px
 components/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
-forms/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
 content/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
+conversion/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
 dialogs/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
+dynamic/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
+forms/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
+popovers/,390,GRID_NOT_COLLAPSED,pp-cells,3 columns at 390px
+popovers/,390,GRID_NOT_COLLAPSED,pp-tour-row,3 columns at 390px
+popovers/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
 sliders/,390,SMALL_TARGET,sl-main-nav-dot,34x28: 
 sliders/,390,SMALL_TARGET,sl-main-nav-dot,34x28: 
 sliders/,390,SMALL_TARGET,sl-main-nav-dot,34x28: 
@@ -16,18 +21,30 @@ sliders/,390,SMALL_TARGET,sl-carousel-nav-dot,34x28:
 sliders/,390,SMALL_TARGET,sl-carousel-nav-dot,34x28: 
 sliders/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
 tokens/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
-dynamic/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
-conversion/,390,GRID_NOT_COLLAPSED,mk-f-links,2 columns at 390px
 components/,768,LONG_MEASURE,m-text,44 chars/line
 components/,768,LONG_MEASURE,m-text,56 chars/line
 components/,768,LONG_MEASURE,m-text,56 chars/line
-forms/,768,LONG_MEASURE,m-text,59 chars/line
-forms/,768,LONG_MEASURE,m-text,59 chars/line
 content/,768,LONG_MEASURE,m-text,43 chars/line
 content/,768,LONG_MEASURE,m-text,58 chars/line
+conversion/,768,LONG_MEASURE,m-text,46 chars/line
+conversion/,768,LONG_MEASURE,m-text,47 chars/line
+conversion/,768,LONG_MEASURE,m-text,45 chars/line
+conversion/,768,LONG_MEASURE,m-text,49 chars/line
+conversion/,768,LONG_MEASURE,m-text,55 chars/line
+conversion/,768,LONG_MEASURE,m-text,55 chars/line
+conversion/,768,LONG_MEASURE,m-text,55 chars/line
 dialogs/,768,LONG_MEASURE,m-text,46 chars/line
 dialogs/,768,LONG_MEASURE,m-text,45 chars/line
 dialogs/,768,LONG_MEASURE,m-text,45 chars/line
+dynamic/,768,LONG_MEASURE,m-text,43 chars/line
+dynamic/,768,LONG_MEASURE,m-text,57 chars/line
+dynamic/,768,LONG_MEASURE,m-text,49 chars/line
+dynamic/,768,LONG_MEASURE,m-text,55 chars/line
+dynamic/,768,LONG_MEASURE,m-text,55 chars/line
+dynamic/,768,LONG_MEASURE,m-text,55 chars/line
+dynamic/,768,LONG_MEASURE,m-text,55 chars/line
+forms/,768,LONG_MEASURE,m-text,59 chars/line
+forms/,768,LONG_MEASURE,m-text,59 chars/line
 sliders/,768,SMALL_TARGET,sl-main-nav-dot,34x28: 
 sliders/,768,SMALL_TARGET,sl-main-nav-dot,34x28: 
 sliders/,768,SMALL_TARGET,sl-main-nav-dot,34x28: 
@@ -50,17 +67,3 @@ tokens/,768,LONG_MEASURE,m-text,49 chars/line
 tokens/,768,LONG_MEASURE,m-text,55 chars/line
 tokens/,768,LONG_MEASURE,m-text,55 chars/line
 tokens/,768,LONG_MEASURE,m-text,55 chars/line
-dynamic/,768,LONG_MEASURE,m-text,43 chars/line
-dynamic/,768,LONG_MEASURE,m-text,57 chars/line
-dynamic/,768,LONG_MEASURE,m-text,49 chars/line
-dynamic/,768,LONG_MEASURE,m-text,55 chars/line
-dynamic/,768,LONG_MEASURE,m-text,55 chars/line
-dynamic/,768,LONG_MEASURE,m-text,55 chars/line
-dynamic/,768,LONG_MEASURE,m-text,55 chars/line
-conversion/,768,LONG_MEASURE,m-text,46 chars/line
-conversion/,768,LONG_MEASURE,m-text,47 chars/line
-conversion/,768,LONG_MEASURE,m-text,45 chars/line
-conversion/,768,LONG_MEASURE,m-text,49 chars/line
-conversion/,768,LONG_MEASURE,m-text,55 chars/line
-conversion/,768,LONG_MEASURE,m-text,55 chars/line
-conversion/,768,LONG_MEASURE,m-text,55 chars/line

package/data/navigation-verification.csv

@@ -1,18 +1,19 @@
 check,result,detail
-FRONT_PAGE,PASS,"HTTP 200, 240832 bytes"
+FRONT_PAGE,PASS,"HTTP 200, 241886 bytes"
 MENU_IS_LINKS,PASS,1 real <a href> in #mk-nav
-NAV 首頁,PASS,"/ -> HTTP 200, 240834 bytes"
-PAGE moksa,PASS,"HTTP 200, 240832 bytes"
-PAGE my-account,PASS,"HTTP 200, 101036 bytes"
-PAGE intro,PASS,"HTTP 200, 134746 bytes"
-PAGE content,PASS,"HTTP 200, 102378 bytes"
-PAGE forms,PASS,"HTTP 200, 126731 bytes"
-PAGE components,PASS,"HTTP 200, 135123 bytes"
-PAGE conversion,PASS,"HTTP 200, 103204 bytes"
-PAGE dynamic,PASS,"HTTP 200, 113003 bytes"
-PAGE tokens,PASS,"HTTP 200, 125413 bytes"
-PAGE sliders,PASS,"HTTP 200, 152191 bytes"
-PAGE dialogs,PASS,"HTTP 200, 207349 bytes"
+NAV 首頁,PASS,"/ -> HTTP 200, 241885 bytes"
+PAGE moksa,PASS,"HTTP 200, 241885 bytes"
+PAGE my-account,PASS,"HTTP 200, 102024 bytes"
+PAGE intro,PASS,"HTTP 200, 135353 bytes"
+PAGE content,PASS,"HTTP 200, 103366 bytes"
+PAGE forms,PASS,"HTTP 200, 127717 bytes"
+PAGE components,PASS,"HTTP 200, 136111 bytes"
+PAGE conversion,PASS,"HTTP 200, 104190 bytes"
+PAGE dynamic,PASS,"HTTP 200, 113610 bytes"
+PAGE tokens,PASS,"HTTP 200, 126780 bytes"
+PAGE sliders,PASS,"HTTP 200, 152797 bytes"
+PAGE popovers,PASS,"HTTP 200, 191166 bytes"
+PAGE dialogs,PASS,"HTTP 200, 208778 bytes"
 ANCHORS moksa,PASS,every in-page link resolves
 ANCHORS my-account,PASS,every in-page link resolves
 ANCHORS intro,PASS,every in-page link resolves
@@ -23,6 +24,7 @@ ANCHORS conversion,PASS,every in-page link resolves
 ANCHORS dynamic,PASS,every in-page link resolves
 ANCHORS tokens,PASS,every in-page link resolves
 ANCHORS sliders,PASS,every in-page link resolves
+ANCHORS popovers,PASS,every in-page link resolves
 ANCHORS dialogs,PASS,every in-page link resolves
 WIDTH moksa,PASS,"no sideways scroll at 390,768,1280"
 WIDTH my-account,PASS,"no sideways scroll at 390,768,1280"
@@ -34,4 +36,5 @@ WIDTH conversion,PASS,"no sideways scroll at 390,768,1280"
 WIDTH dynamic,PASS,"no sideways scroll at 390,768,1280"
 WIDTH tokens,PASS,"no sideways scroll at 390,768,1280"
 WIDTH sliders,PASS,"no sideways scroll at 390,768,1280"
+WIDTH popovers,PASS,"no sideways scroll at 390,768,1280"
 WIDTH dialogs,PASS,"no sideways scroll at 390,768,1280"

package/data/node-properties.csv

@@ -9,9 +9,9 @@ ButtonElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,in
 ButtonElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,url,ValidateAllowUndefined|ValidatorDynamicCodeObject|ValidatorSanitizeEmptyString|ValidatorURL|ValidatorURLObject|Validators,,true,,type|href|target|rel,Mosaic/NodeTypes/Button/ButtonElementMResourceData.php
 ButtonElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,target,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,_self|_blank|_parent|_top,true,,type|href|target|rel,Mosaic/NodeTypes/Button/ButtonElementMResourceData.php
 ButtonElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,rel,ValidateAllowUndefined|ValidatorArray|ValidatorString|Validators,,true,,type|href|target|rel,Mosaic/NodeTypes/Button/ButtonElementMResourceData.php
-ModalElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,role,ValidateAllowUndefined|ValidatorString|Validators,,true,,role|aria-label|aria-modal|tabindex|data-mosaic-modal-closedby,Mosaic/NodeTypes/Dialog/Modal/ModalElementMResourceData.php
-ModalElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,accessibleLabel,ValidateAllowUndefined|ValidatorString|Validators,,true,,role|aria-label|aria-modal|tabindex|data-mosaic-modal-closedby,Mosaic/NodeTypes/Dialog/Modal/ModalElementMResourceData.php
-ModalElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,closedby,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,everything|clickOutside|esc|nothing,true,,role|aria-label|aria-modal|tabindex|data-mosaic-modal-closedby,Mosaic/NodeTypes/Dialog/Modal/ModalElementMResourceData.php
+ModalElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,role,ValidateAllowUndefined|ValidatorString|Validators,,true,,role|aria-label|aria-modal|tabindex|popover|open|data-mosaic-modal-closedby|data-mosaic-modal-screenshot-open,Mosaic/NodeTypes/Dialog/Modal/ModalElementMResourceData.php
+ModalElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,accessibleLabel,ValidateAllowUndefined|ValidatorString|Validators,,true,,role|aria-label|aria-modal|tabindex|popover|open|data-mosaic-modal-closedby|data-mosaic-modal-screenshot-open,Mosaic/NodeTypes/Dialog/Modal/ModalElementMResourceData.php
+ModalElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,closedby,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,everything|clickOutside|esc|nothing,true,,role|aria-label|aria-modal|tabindex|popover|open|data-mosaic-modal-closedby|data-mosaic-modal-screenshot-open,Mosaic/NodeTypes/Dialog/Modal/ModalElementMResourceData.php
 DivElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,tagName,ValidateAllowUndefined|ValidatorTagName|Validators,,true,,,Mosaic/NodeTypes/Div/DivElementMResourceData.php
 DivElementMResourceData,ElementMResourceDataAbstract,free,createDataArray,dynamicSources,,,true,,,Mosaic/NodeTypes/Div/DivElementMResourceData.php
 ElementMResourceDataAbstract,NodeMResourceDataAbstract,free,createDataSimple,name,ValidateAllowUndefined|ValidatorName|ValidatorSanitizeEmptyString|Validators,,true,,,Mosaic/NodeTypes/ElementAbstract/ElementMResourceDataAbstract.php
@@ -67,6 +67,11 @@ OpenStreetMapElementMResourceData,ElementMResourceDataAbstract,free,createDataSi
 OpenStreetMapElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,zoom,ValidateAllowUndefined|ValidatorDynamicCodeObject|ValidatorInteger|ValidatorIntegerAsString|Validators,,true,,,Mosaic/NodeTypes/OpenStreetMap/OpenStreetMapElementMResourceData.php
 OpenStreetMapElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,layer,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,mapnik|cyclosm|cyclemap|transportmap|hot,true,,,Mosaic/NodeTypes/OpenStreetMap/OpenStreetMapElementMResourceData.php
 OpenStreetMapElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,lazyLoad,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,0|1,true,,,Mosaic/NodeTypes/OpenStreetMap/OpenStreetMapElementMResourceData.php
+PopoverElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,role,ValidateAllowUndefined|ValidatorString|Validators,,true,,role|aria-label|aria-live|aria-modal|tabindex|popover|open|data-mosaic-popover-anchor|data-mosaic-popover-placement|data-mosaic-popover-screen-position|data-mosaic-popover-keep-in-view|data-mosaic-popover-anchored|data-mosaic-popover-flip|data-mosaic-popover-screenshot-open|data-mosaic-popover-closedby,Mosaic/NodeTypes/Popover/PopoverElementMResourceData.php
+PopoverElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,ariaLive,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,off|polite|assertive,true,,role|aria-label|aria-live|aria-modal|tabindex|popover|open|data-mosaic-popover-anchor|data-mosaic-popover-placement|data-mosaic-popover-screen-position|data-mosaic-popover-keep-in-view|data-mosaic-popover-anchored|data-mosaic-popover-flip|data-mosaic-popover-screenshot-open|data-mosaic-popover-closedby,Mosaic/NodeTypes/Popover/PopoverElementMResourceData.php
+PopoverElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,accessibleLabel,ValidateAllowUndefined|ValidatorString|Validators,,true,,role|aria-label|aria-live|aria-modal|tabindex|popover|open|data-mosaic-popover-anchor|data-mosaic-popover-placement|data-mosaic-popover-screen-position|data-mosaic-popover-keep-in-view|data-mosaic-popover-anchored|data-mosaic-popover-flip|data-mosaic-popover-screenshot-open|data-mosaic-popover-closedby,Mosaic/NodeTypes/Popover/PopoverElementMResourceData.php
+PopoverElementMResourceData,ElementMResourceDataAbstract,free,createDataSimple,closedby,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,everything|clickOutside|esc|nothing,true,,role|aria-label|aria-live|aria-modal|tabindex|popover|open|data-mosaic-popover-anchor|data-mosaic-popover-placement|data-mosaic-popover-screen-position|data-mosaic-popover-keep-in-view|data-mosaic-popover-anchored|data-mosaic-popover-flip|data-mosaic-popover-screenshot-open|data-mosaic-popover-closedby,Mosaic/NodeTypes/Popover/PopoverElementMResourceData.php
+PopoverElementMResourceData,ElementMResourceDataAbstract,free,createDataGroup,positioning,,,true,,role|aria-label|aria-live|aria-modal|tabindex|popover|open|data-mosaic-popover-anchor|data-mosaic-popover-placement|data-mosaic-popover-screen-position|data-mosaic-popover-keep-in-view|data-mosaic-popover-anchored|data-mosaic-popover-flip|data-mosaic-popover-screenshot-open|data-mosaic-popover-closedby,Mosaic/NodeTypes/Popover/PopoverElementMResourceData.php
 CodeElementMResourceData,ElementMResourceDataAbstract,pro,createDataSimple,insertLocation,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,inPlace|head|bodyStart|bodyEnd,true,,,Mosaic/NodeTypes/Pro/Code/CodeElementMResourceData.php
 CodeElementMResourceData,ElementMResourceDataAbstract,pro,createDataSimple,content,ValidateAllowUndefined|ValidatorString|Validators,,true,,,Mosaic/NodeTypes/Pro/Code/CodeElementMResourceData.php
 CodeElementMResourceData,ElementMResourceDataAbstract,pro,createDataSimple,processShortcodes,ValidateAllowUndefined|ValidatorAcceptedValues|Validators,0|1,true,,,Mosaic/NodeTypes/Pro/Code/CodeElementMResourceData.php

package/data/node-types.csv

@@ -41,6 +41,7 @@ navbar,Navbar,NavbarElementTypeFactory,ElementTypeFactoryAbstract,no,free,,,,,Na
 navbar-toggle,Mobile menu toggle,NavbarToggleElementTypeFactory,ElementTypeFactoryAbstract,no,free,,true,true,,NavbarToggleElementMResourceData,ElementMResourceDataAbstract,Mosaic/NodeTypes/Navbar/NavbarToggle/NavbarToggleElementTypeFactory.php
 navigation,Navigation,NavigationElementTypeFactory,ElementTypeFactoryAbstract,no,free,,,true,,NavigationElementMResourceData,ElementMResourceDataAbstract,Mosaic/NodeTypes/Navbar/Navigation/NavigationElementTypeFactory.php
 openstreetmap,,OpenStreetMapElementTypeFactory,ElementTypeFactoryAbstract,no,free,,,,,OpenStreetMapElementMResourceData,ElementMResourceDataAbstract,Mosaic/NodeTypes/OpenStreetMap/OpenStreetMapElementTypeFactory.php
+popover,Popover,PopoverElementTypeFactory,ElementTypeFactoryAbstract,no,free,,,true,,PopoverElementMResourceData,ElementMResourceDataAbstract,Mosaic/NodeTypes/Popover/PopoverElementTypeFactory.php
 code,Code,CodeElementTypeFactory,ElementTypeFactoryAbstract,no,pro,,,,,CodeElementMResourceData,ElementMResourceDataAbstract,Mosaic/NodeTypes/Pro/Code/CodeElementTypeFactory.php
 form-wrapper,Form,FormWrapperElementTypeFactory,ElementTypeFactoryAbstract,no,pro,,,,,FormWrapperElementMResourceData,ElementMResourceDataAbstract,Mosaic/NodeTypes/Pro/Form/FormWrapperElementTypeFactory.php
 form,Form,FormElementTypeFactory,ElementTypeFactoryAbstract,no,pro,,,true,,FormElementMResourceData,ElementMResourceDataAbstract,Mosaic/NodeTypes/Pro/Form/Form/FormElementTypeFactory.php

package/data/node-verification.csv

@@ -125,3 +125,6 @@ wysiwyg-span,RENDERED,span,m-span,,27396,
 wysiwyg-text,COMMITTED,,,,27344,
 wysiwyg-variable,BROKE_PAGE,,,,54,NodeMResourceFilterFunctionInterface parent is missing
 youtube,RENDERED,mosaic-youtube,m-youtube,,27993,
+popover,RENDERED,div,m-popover M_Dialog M_IJ,,28043,
+fieldset-legend,RENDERED,div,m-fieldset-legend m-wysiwyg,,27401,
+fieldset-content,RENDERED,div,m-fieldset-content,,27357,

package/data/placement-rules.csv

@@ -67,6 +67,7 @@ navbar,none,,yes,yes,navbar,Mosaic/NodeTypes/Navbar/NavbarElementTypeFactory.php
 navbar-toggle,any,,yes,yes,navbar|navbar-toggle|navigation,Mosaic/NodeTypes/Navbar/NavbarToggle/NavbarToggleElementTypeFactory.php
 navigation,any,,yes,yes,navbar|navbar-toggle|navigation,Mosaic/NodeTypes/Navbar/Navigation/NavigationElementTypeFactory.php
 openstreetmap,none,,,,,Mosaic/NodeTypes/OpenStreetMap/OpenStreetMapElementTypeFactory.php
+popover,any,,,,,Mosaic/NodeTypes/Popover/PopoverElementTypeFactory.php
 radio-input,none,,yes,,choice,Mosaic/NodeTypes/Pro/Form/Form/MElements/Radio/RadioInput/RadioInputElementTypeFactory.php
 recaptcha,none,,yes,,choice-field|field|form,Mosaic/NodeTypes/Pro/Form/Form/MElements/Recaptcha/RecaptchaElementTypeFactory.php
 section,any,,yes,,section,Mosaic/NodeTypes/Section/SectionElementTypeFactory.php

package/data/pluggables.csv

@@ -34,8 +34,6 @@ EvaluatorEngine,starts-with,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosa
 EvaluatorEngine,regexp,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectPostTypes.php
 EvaluatorEngine,number,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectPostTypes.php
 EvaluatorEngine,date,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectPostTypes.php
-EvaluatorEngine,after,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectPostTypes.php
-EvaluatorEngine,before,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectPostTypes.php
 EvaluatorEngine,includes,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectTaxonomies.php
 EvaluatorEngine,excludes,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectTaxonomies.php
 EvaluatorEngine,text,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectTaxonomies.php
@@ -67,8 +65,6 @@ EvaluatorEngine,greater-than-or-equal,,Mosaic\Plugins\EvaluatorEngine\Filters\Su
 EvaluatorEngine,less-than,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectUsers.php
 EvaluatorEngine,less-than-or-equal,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectUsers.php
 EvaluatorEngine,date,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectUsers.php
-EvaluatorEngine,after,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectUsers.php
-EvaluatorEngine,before,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectUsers.php
 EvaluatorEngine,wpUsersUserMeta,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectUsers.php
 EvaluatorEngine,wpMenu,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectWPMenu.php
 EvaluatorEngine,includes,,Mosaic\Plugins\EvaluatorEngine\Filters\Subject,Mosaic/Plugins/EvaluatorEngine/Filters/Subject/FilterSubjectWPMenu.php
@@ -147,6 +143,15 @@ InteractionActions,playerPause,,Mosaic\Plugins\InteractionActions\Simple\Player\
 InteractionActions,elementAction,,Mosaic\Plugins\InteractionActions\Simple\Player\Play,Mosaic/Plugins/InteractionActions/Simple/Player/Play/InteractionSimpleActionPlayerPlay.php
 InteractionActions,player,,Mosaic\Plugins\InteractionActions\Simple\Player\Play,Mosaic/Plugins/InteractionActions/Simple/Player/Play/InteractionSimpleActionPlayerPlay.php
 InteractionActions,playerPlay,,Mosaic\Plugins\InteractionActions\Simple\Player\Play,Mosaic/Plugins/InteractionActions/Simple/Player/Play/InteractionSimpleActionPlayerPlay.php
+InteractionActions,elementAction,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverClose,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverClose/InteractionSimpleActionPopoverClose.php
+InteractionActions,popover,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverClose,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverClose/InteractionSimpleActionPopoverClose.php
+InteractionActions,popoverClose,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverClose,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverClose/InteractionSimpleActionPopoverClose.php
+InteractionActions,elementAction,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverOpen,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverOpen/InteractionSimpleActionPopoverOpen.php
+InteractionActions,popover,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverOpen,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverOpen/InteractionSimpleActionPopoverOpen.php
+InteractionActions,popoverOpen,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverOpen,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverOpen/InteractionSimpleActionPopoverOpen.php
+InteractionActions,elementAction,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverToggle,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverToggle/InteractionSimpleActionPopoverToggle.php
+InteractionActions,popover,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverToggle,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverToggle/InteractionSimpleActionPopoverToggle.php
+InteractionActions,popoverToggle,,Mosaic\Plugins\InteractionActions\Simple\Popover\PopoverToggle,Mosaic/Plugins/InteractionActions/Simple/Popover/PopoverToggle/InteractionSimpleActionPopoverToggle.php
 InteractionActions,script,,Mosaic\Plugins\InteractionActions\Simple\RunScript,Mosaic/Plugins/InteractionActions/Simple/RunScript/InteractionSimpleActionScript.php
 InteractionActions,setCookie,,Mosaic\Plugins\InteractionActions\Simple\SetCookie,Mosaic/Plugins/InteractionActions/Simple/SetCookie/InteractionSimpleActionSetCookie.php
 InteractionTypes,pointerMove,,Mosaic\Plugins\InteractionTypes\progress\pointermove,Mosaic/Plugins/InteractionTypes/progress/pointermove/InteractionTypePointerMove.php
@@ -195,11 +200,18 @@ InteractionTypes,pageLoad,,Mosaic\Plugins\InteractionTypes\timed\pageload,Mosaic
 InteractionTypes,pageScroll,,Mosaic\Plugins\InteractionTypes\timed\pageload,Mosaic/Plugins/InteractionTypes/timed/pageload/InteractionTypePageLoad.php
 InteractionTypes,s,,Mosaic\Plugins\InteractionTypes\timed\pageload,Mosaic/Plugins/InteractionTypes/timed/pageload/InteractionTypePageLoad.php
 InteractionTypes,ms,,Mosaic\Plugins\InteractionTypes\timed\pageload,Mosaic/Plugins/InteractionTypes/timed/pageload/InteractionTypePageLoad.php
+InteractionTypes,popover,,Mosaic\Plugins\InteractionTypes\timed\popover,Mosaic/Plugins/InteractionTypes/timed/popover/InteractionTypePopover.php
+InteractionTypes,elementEvent,,Mosaic\Plugins\InteractionTypes\timed\popover,Mosaic/Plugins/InteractionTypes/timed/popover/InteractionTypePopover.php
+InteractionTypes,show,,Mosaic\Plugins\InteractionTypes\timed\popover,Mosaic/Plugins/InteractionTypes/timed/popover/InteractionTypePopover.php
+InteractionTypes,beforeClose,,Mosaic\Plugins\InteractionTypes\timed\popover,Mosaic/Plugins/InteractionTypes/timed/popover/InteractionTypePopover.php
+InteractionTypes,afterClose,,Mosaic\Plugins\InteractionTypes\timed\popover,Mosaic/Plugins/InteractionTypes/timed/popover/InteractionTypePopover.php
 InteractionTypes,scrollDepth,,Mosaic\Plugins\InteractionTypes\timed\scrolldepth,Mosaic/Plugins/InteractionTypes/timed/scrolldepth/InteractionTypeScrollDepth.php
 InteractionTypes,pageScroll,,Mosaic\Plugins\InteractionTypes\timed\scrolldepth,Mosaic/Plugins/InteractionTypes/timed/scrolldepth/InteractionTypeScrollDepth.php
 InteractionTypes,%,,Mosaic\Plugins\InteractionTypes\timed\scrolldepth,Mosaic/Plugins/InteractionTypes/timed/scrolldepth/InteractionTypeScrollDepth.php
 InteractionTypes,px,,Mosaic\Plugins\InteractionTypes\timed\scrolldepth,Mosaic/Plugins/InteractionTypes/timed/scrolldepth/InteractionTypeScrollDepth.php
 InteractionTypes,vh,,Mosaic\Plugins\InteractionTypes\timed\scrolldepth,Mosaic/Plugins/InteractionTypes/timed/scrolldepth/InteractionTypeScrollDepth.php
+InteractionTypes,reached,,Mosaic\Plugins\InteractionTypes\timed\scrolldepth,Mosaic/Plugins/InteractionTypes/timed/scrolldepth/InteractionTypeScrollDepth.php
+InteractionTypes,returned,,Mosaic\Plugins\InteractionTypes\timed\scrolldepth,Mosaic/Plugins/InteractionTypes/timed/scrolldepth/InteractionTypeScrollDepth.php
 InteractionTypes,scrollDirectionChange,,Mosaic\Plugins\InteractionTypes\timed\scrolldirectionchange,Mosaic/Plugins/InteractionTypes/timed/scrolldirectionchange/InteractionTypeScrollDirectionChange.php
 InteractionTypes,pageScroll,,Mosaic\Plugins\InteractionTypes\timed\scrolldirectionchange,Mosaic/Plugins/InteractionTypes/timed/scrolldirectionchange/InteractionTypeScrollDirectionChange.php
 InteractionTypes,down,,Mosaic\Plugins\InteractionTypes\timed\scrolldirectionchange,Mosaic/Plugins/InteractionTypes/timed/scrolldirectionchange/InteractionTypeScrollDirectionChange.php

package/data/popover-verification.csv

@@ -0,0 +1,38 @@
+check,result,detail
+FOUND,PASS,19 popovers on the page
+HOST,PASS,"every one is <div popover=manual>, none carries `open`"
+NOTICE/pageLoad,PASS,open after load
+NOTICE/aria,PASS,role=status aria-live=polite aria-modal=None
+NOTICE/non_blocking,PASS,centre hit-tests to the page; wheel scrolled 0 -> 600
+NOTICE/page_usable,PASS,"open while the notice shows: ['pp-menu', 'pp-notice']"
+NOTICE/closedby_nothing,PASS,Esc left it open
+NOTICE/close_button,PASS,popoverClose closed it
+CLOSED_IS_HIDDEN,PASS,every closed popover measures 0x0
+MENU/placement,PASS,"flipped above: menu 224..627 high, trigger 627..671, left edges 685 / 685"
+MENU/toggle,PASS,the same button closed it
+MENU/esc,PASS,closedby=everything: Esc closed it
+INFO/placement,PASS,"inline-end: card 949..1209, trigger 905..949; centres 449 / 449"
+INFO/esc_ignored,PASS,closedby=clickOutside: Esc left it open
+INFO/click_outside,PASS,a click outside closed it
+POINTER/anchor,PASS,popover bottom 300 vs card top 300; centres 950 / 949
+GRID/top-left,PASS,"box 12,12 240x112 in 1280x900"
+GRID/top-center,PASS,"box 520,12 240x112 in 1280x900"
+GRID/top-right,PASS,"box 1028,12 240x112 in 1280x900"
+GRID/center-left,PASS,"box 12,393 240x112 in 1280x900"
+GRID/center-center,PASS,"box 520,393 240x112 in 1280x900"
+GRID/center-right,PASS,"box 1028,393 240x112 in 1280x900"
+GRID/bottom-left,PASS,"box 12,775 240x112 in 1280x900"
+GRID/bottom-center,PASS,"box 520,775 240x112 in 1280x900"
+GRID/bottom-right,PASS,"box 1028,775 240x112 in 1280x900"
+TOUR/steps,PASS,pp-tour-brief > pp-tour-quote > pp-tour-launch > pp-tour-done
+TOUR/anchored,PASS,3 of 3 steps sit beside the box they explain
+TOUR/esc_ignored,PASS,open after Esc on step 2: pp-tour-quote
+TOUR/quit_ends,PASS,open after 結束導覽 on step 2: none
+TOUR/restart_resumes,PASS,"restarted, two steps on: pp-tour-launch"
+SNAP/flips,PASS,flipped=True; popover right 1069 vs trigger left 1069
+SNAP/flipped_state,PASS,"background while flipped: rgb(22, 24, 28)"
+SNAP/off_shifted,PASS,"keepInView=0, not flipped: popover 1020..1280 inside a 1280 viewport, over its trigger 1069..1231"
+FLEXMODAL/closed,PASS,"authored display:flex, closed it computes display:none 0x0"
+FLEXMODAL/open,PASS,"display:flex top-layer=True window centre 633,450 in 1280x900"
+NO_JS_ERRORS,PASS,none
+PHONE/menu_fits,PASS,menu 43..318 in a 390 viewport

package/data/style-states.csv

@@ -37,6 +37,7 @@ ___navbar--dropdown-mode,"&:where(.m-navbar.dropdown-mode,.m-navbar.dropdown-mod
 ___navbar--opened,.dropdown-mode:where(.m-navbar.dropdown--opened) &,600,node-type,Mosaic/NodeTypes/Navbar/NavbarElementTypeFactory.php
 ___navbar--opening,.dropdown-mode:where(.m-navbar.dropdown--opening) &,600,node-type,Mosaic/NodeTypes/Navbar/NavbarElementTypeFactory.php
 ___nested_dropdown_mode,"&:where(.dropdown-mode .m-navbar-navigation .m-dropdown &, .m-dropdown .m-dropdown &):not(x)",600,node-type,Mosaic/NodeTypes/Menu/Dropdown/DropdownElementTypeFactoryAbstract.php
+___popover--flipped,"&:where(.m-popover[data-mosaic-popover-flipped],.m-popover[data-mosaic-popover-flipped] &)",600,node-type,Mosaic/NodeTypes/Popover/PopoverElementTypeFactory.php
 ___radio-input--checked,&:checked,500,node-type,Mosaic/NodeTypes/Pro/Form/Form/MElements/Radio/RadioInput/RadioInputElementTypeFactory.php
 ___radio-input--checkmark,&:checked::before,500,node-type,Mosaic/NodeTypes/Pro/Form/Form/MElements/Radio/RadioInput/RadioInputElementTypeFactory.php
 ___select-input-option,"&.m-select:where(:has(option:not(:disabled):checked)), &.m-select :where(option)",500,node-type,Mosaic/NodeTypes/Pro/Form/Form/MElements/Select/SelectElementTypeFactory.php

package/data/token-verification.csv

@@ -9,8 +9,8 @@ USED/--mk-accent,PASS,"5 element(s), e.g. mk-progress-track, mk-progress, mk-clo
 USED/--mk-accent-ink,PASS,"2 element(s), e.g. mk-header-cta, tk-chip-mk-accent-ink"
 USED/--mk-ai,PASS,"1 element(s), e.g. tk-chip-mk-ai"
 USED/--mk-faint,PASS,"1 element(s), e.g. tk-chip-mk-faint"
-USED/--mk-ink,PASS,"76 element(s), e.g. mk-clock-m, mk-clock-m, mk-clock-s"
+USED/--mk-ink,PASS,"66 element(s), e.g. mk-clock-m, mk-clock-m, mk-clock-s"
 USED/--mk-muted,PASS,"1 element(s), e.g. tk-chip-mk-muted"
 USED/--mk-panel,PASS,"3 element(s), e.g. tk-sw, tk-chip-mk-panel, tk-props"
-USED/--mk-paper,PASS,"7 element(s), e.g. tk-head, tk-chip-mk-paper, tk-pipe"
+USED/--mk-paper,PASS,"9 element(s), e.g. mk-cap-g0-menu, mk-cap-g1-menu, tk-head"
 USED/--mk-rule,PASS,"1 element(s), e.g. tk-chip-mk-rule"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mosaic-headless",
-  "version": "1.30.1",
+  "version": "1.31.1",
   "description": "AI-agent skill: build Mosaic Pro (Nextend) WordPress sites by writing the underlying data model directly - 23 custom tables, no visual editor, no DOM. Every node type, style property and node property swept against a live install and asserted on the delivered HTML and compiled CSS. Installs into Claude Code, Cursor, Codex CLI, Gemini CLI, Copilot, Continue, Windsurf and Claude.ai.",
   "keywords": [
     "wordpress",
@@ -42,6 +42,7 @@
     "sites/_dialogs.py",
     "sites/_dynamic.py",
     "sites/_forms.py",
+    "sites/_popovers.py",
     "sites/_sliders.py",
     "sites/_tokens.py",
     "tools/*.py",

package/references/custom-fields.md

@@ -81,13 +81,36 @@ the source on the loop node:
 ```json
 {"type": "loop",
  "data": {"loopType": "localContext",
-          "localContextOptions": {"loopSource": {"v": "@LOOP('post/loopacf_rel')"}}},
+          "localContextOptions": {"loopSource": {"v": "@VAR('post/loopacf_rel')"}}},
  "children": [{"type": "loop-items", "children": [{"type": "loop-item", "children": [
    {"type": "text", "data": {"tagName": "p"},
     "children": [{"type": "wysiwyg-variable", "data": {"dynamicCode": "@VAR('item/value__label')"}}]}
  ]}]}]}
 ```
 
+**The `loopSource` is `@VAR('<namespace>/<loop>')`, never `@LOOP(…)`.** This page
+used to show `@LOOP('post/loopacf_rel')` here, and that form breaks the editor while
+the front end renders it fine - the worst kind of split, because the page looks done:
+
+- the front end (`LoopEvaluator.php`) takes the first string argument of whatever
+  function call it is given and ignores the function's name, so `@LOOP('post/x')`
+  and `@VAR('post/x')` resolve to the same loop;
+- the editor (`evaluateLoop` in `AppMosaicEditor-bundle.js`, 1.0.10) builds its
+  expression evaluator with the loop lookup as the VARIABLE evaluator and `null` as
+  the loop evaluator, so `@VAR` resolves the loop and `@LOOP` calls `null`:
+  `TypeError: this._loopEvaluatorFunction is not a function`, the canvas renders
+  for a long time and never finishes. Mosaic's own callers write
+  `evaluateLoop("@VAR('<menu>/loop')")`.
+
+Reported from a client build (a Meta Box `image_advanced` gallery as the source):
+changing the source to `@VAR('post/loopwork_gallery')` cleared the editor error and
+the front end still rendered all 35 images. `@LOOP(…)` *inside text* goes through a
+different evaluator that is given both functions, and is fine in the editor too -
+measured on the same build: a loop item's image `alt` of
+`@concat(@VAR('post/title'), '｜', @LOOP('post/work_category', 1, 'term_name'), '作品照片 ', @VAR('item/index'))`
+opens with zero console errors and delivers `墨竹｜住宅設計作品照片 1`. The table
+above stays valid there.
+
 `loopType:"localContext"` is the built-in source that evaluates an expression in the
 page's context; the sweep's `loop` COMMIT_500 is what happens without it. The loop
 rendered exactly the rows the field holds for every family above (2, 2, 1, 1, 2, 2,