domma-cms 1.8.16 → 1.8.18

package/admin/js/views/page-editor.js

@@ -1,4 +1,4 @@
-import{api as g}from"../api.js";import{CardBuilder as gt}from"../lib/card-builder.js";import{TimelineBuilder as bt}from"../lib/timeline-builder.js";import{attachEditorKeybindings as ht,createToolbar as yt,insertAtCursor as wt}from"../lib/markdown-toolbar.js";import{EffectsBuilder as kt}from"../lib/effects-builder.js";import{attachContextMenu as Et}from"../lib/shortcode-context-menu.js";import{registerCustomInserters as Mt}from"../lib/shortcode-insert.js";import{populateThemeSelect as St}from"../lib/themes.js";import{createFoldingManager as Tt}from"../lib/editor-folding.js";import{openScribeComposer as Ct}from"../lib/scribe-composer.js";import{openCrudTutorial as xt}from"../lib/crud-tutorial.js";import{addBannerAction as j}from"../lib/plugin-chrome.js";import{helpPopovers as Ke}from"../lib/help-popover.js";import{onceClosed as ye,openMenuAt as Ue}from"../lib/tool-kit.js";import{pickMedia as Pt}from"../lib/media-picker.js";import{openPageClone as At}from"../lib/page-clone.js";import{openEditorReference as _e}from"../lib/page-editor-reference.js";import{cleanType as Z,DEFAULT_TYPE as Q,EDITOR_FONTS as Lt,fontHref as Ot,isDefaultType as Dt,LINE_HEIGHTS as Rt,SIZES as Nt,typeVars as Je}from"../lib/editor-type.js";import{getProjectFromHash as Ft}from"../lib/project-context.js";import{attachSmoothCaret as We,getCaretPreference as It,setCaretPreference as Bt}from"../lib/smooth-caret.js";import{SCREEN as $t,bannerSection as zt,draftIsStale as jt,draftKey as Vt,initialProject as qt,makeDraft as Ht,problems as we,readDraft as Kt,snapshot as V}from"../lib/page-editor-arrange.js";import{fmtDateTime as ee}from"../lib/dates.js";function te(o){const i=document.createElement("template");return i.innerHTML=o.trim(),i.content.firstElementChild}const Ut=ee,Ge=o=>ee(o.createdAt)+(o.label?` - ${o.label}`:""),_t=`
+import{api as v}from"../api.js";import{CardBuilder as xt}from"../lib/card-builder.js";import{TimelineBuilder as Pt}from"../lib/timeline-builder.js";import{attachEditorKeybindings as At,createToolbar as Lt,insertAtCursor as Dt}from"../lib/markdown-toolbar.js";import{EffectsBuilder as Ot}from"../lib/effects-builder.js";import{attachContextMenu as Rt}from"../lib/shortcode-context-menu.js";import{registerCustomInserters as Nt}from"../lib/shortcode-insert.js";import{populateThemeSelect as Bt}from"../lib/themes.js";import{createFoldingManager as It}from"../lib/editor-folding.js";import{openScribeComposer as Ft}from"../lib/scribe-composer.js";import{openCrudTutorial as zt}from"../lib/crud-tutorial.js";import{addBannerAction as V}from"../lib/plugin-chrome.js";import{helpPopovers as We}from"../lib/help-popover.js";import{onceClosed as Se,openMenuAt as Ye}from"../lib/tool-kit.js";import{pickMedia as $t}from"../lib/media-picker.js";import{openPageClone as jt}from"../lib/page-clone.js";import{openEditorReference as Ge}from"../lib/page-editor-reference.js";import{cleanType as Q,DEFAULT_TYPE as ee,EDITOR_FONTS as Vt,fontHref as qt,isDefaultType as Ht,LINE_HEIGHTS as Kt,SIZES as Ut,typeVars as Xe}from"../lib/editor-type.js";import{getProjectFromHash as _t}from"../lib/project-context.js";import{attachSmoothCaret as Ze,getCaretPreference as Jt,setCaretPreference as Wt}from"../lib/smooth-caret.js";import{SCREEN as Yt,bannerSection as Gt,draftIsStale as Qe,draftKey as Xt,initialProject as Zt,makeDraft as Qt,problems as Te,readDraft as ea,snapshot as j}from"../lib/page-editor-arrange.js";import{fmtDateTime as te}from"../lib/dates.js";import{heldBlockEdits as ta,hold as et,mountEditorHop as aa,noteRecent as sa,takeHeld as oa}from"../lib/editor-hop.js";import{isHop as na}from"../lib/editor-hop-arrange.js";import{blockTagDefs as ra,blocksInBody as ia}from"../lib/block-tags.js";function ae(o){const l=document.createElement("template");return l.innerHTML=o.trim(),l.content.firstElementChild}const la=te,tt=o=>te(o.createdAt)+(o.label?` - ${o.label}`:""),ca=`
 <div class="pe-share">
   <p class="form-hint" style="margin-top:0">Anyone with the link can view this page even while it is unpublished, without
     signing in. The link works for this page only, expires on its own, and can be revoked at any time.</p>
@@ -30,7 +30,7 @@ import{api as g}from"../api.js";import{CardBuilder as gt}from"../lib/card-builde
 .pe-share [hidden] { display: none !important; }
 .pe-share-row { display: flex; align-items: center; gap: .6rem; padding: .5rem 0; border-bottom: 1px solid var(--dm-border-light); }
 .pe-share-text { flex: 1 1 auto; min-width: 0; font-size: .82rem; }
-</style>`;function Ye(o){const i=Ot(o);if(!i||document.querySelector(`link[data-pe-font="${CSS.escape(o)}"]`))return;const l=Object.assign(document.createElement("link"),{rel:"stylesheet",href:i});l.dataset.peFont=o,document.head.appendChild(l)}const Jt=`
+</style>`;function at(o){const l=qt(o);if(!l||document.querySelector(`link[data-pe-font="${CSS.escape(o)}"]`))return;const c=Object.assign(document.createElement("link"),{rel:"stylesheet",href:l});c.dataset.peFont=o,document.head.appendChild(c)}const da=`
 <div class="pe-settings">
   <p class="pe-settings-note">How the editor looks to you - kept in this browser, for every page.</p>
   <label class="form-label" for="pe-set-font">Font <span data-help="The lettering in the editor (not on the site). Monospace keeps every character the same width, so shortcodes and Markdown line up."></span></label>
@@ -68,17 +68,17 @@ The quick brown fox - 0O 1lI {} [] () =&gt; ==
 .pe-settings-sample { white-space: pre-wrap; padding: .75rem 1rem; border-radius: var(--dm-radius-md); border: 1px solid var(--dm-border);
   background: var(--dm-background-alt); font-family: var(--pe-font); font-size: var(--pe-size); line-height: var(--pe-line); }
 .pe-settings-actions { display: flex; gap: .5rem; border-top: 1px solid var(--dm-border); padding-top: .75rem; }
-</style>`;function Wt(o){const i=E.slideover({title:"Editor settings",size:"sm",position:"right"}),l=te(`<div>${Jt}</div>`),s=Z(o.peek()),r={font:M.observable(s.font),size:M.observable(String(s.size)),line:M.observable(String(s.line)),wrap:M.observable(s.wrap),caret:M.observable(It())},v=M.computed(()=>Z({font:r.font.value,size:r.size.value,line:r.line.value,wrap:r.wrap.value}));r.isDefault=M.computed(()=>Dt(v.value)&&r.caret.value==="auto");const u=M.effect(()=>Bt(r.caret.value)),p=l.querySelector("#pe-set-font");for(const[b,L]of[["mono","Monospace"],["sans","Other"],["serif",null]]){const $=Lt.filter(P=>P.kind===b),m=L?Object.assign(document.createElement("optgroup"),{label:L}):p.querySelector("optgroup:last-of-type");m.append(...$.map(P=>new Option(P.label,P.id))),L&&p.appendChild(m)}l.querySelector("#pe-set-size").append(...Nt.map(b=>new Option(`${b}px`,String(b)))),l.querySelector("#pe-set-line").append(...Rt.map(b=>new Option({1.3:"Tight",1.45:"Snug",1.6:"Normal",1.8:"Relaxed",2:"Double"}[b]||String(b),String(b))));const c=l.querySelector(".pe-settings-sample"),C=M.effect(()=>{const b=v.value;Ye(b.font);for(const[L,$]of Object.entries(Je(b)))c.style.setProperty(L,$);c.style.whiteSpace=b.wrap?"pre-wrap":"pre",c.style.overflowX=b.wrap?"":"auto",JSON.stringify(b)!==JSON.stringify(Z(o.peek()))&&(o.value=b,ae("type",b))});r.reset=()=>{r.font.value=Q.font,r.size.value=String(Q.size),r.line.value=String(Q.line),r.wrap.value=Q.wrap,r.caret.value="auto"},r.done=()=>i.close(),i.element.appendChild(l);const d=M.applyBindings(r,l),h=Ke(l);return ye(i,()=>{d.dispose(),h(),C?.(),u?.()}),Domma.icons?.scan?.(l),i.open(),i}async function Gt(o){const i=E.slideover({title:"Share preview link",size:"md",position:"right"}),l=te(`<div>${_t}</div>`),s={expiry:M.observable("7d"),note:M.observable(""),creating:M.observable(!1),url:M.observable(""),links:M.observable([]),loaded:M.observable(!1),listError:M.observable("")},r=async()=>{try{const u=await g.pages.previewLinks.list(o);s.links.value=u.filter(p=>!p.revokedAt&&!p.expired).map(p=>({id:p.id,title:p.label||"Untitled link",meta:`Expires ${Ut(p.expiresAt)} - ${p.useCount===1?"1 view":`${p.useCount||0} views`}`})),s.listError.value=""}catch(u){s.listError.value="Could not load existing links: "+(u.message||"unknown error")}finally{s.loaded.value=!0}};s.create=async()=>{s.creating.value=!0;try{const u=await g.pages.previewLinks.create(o,s.expiry.peek(),s.note.peek().trim());s.url.value=u.url,s.note.value="",E.toast("Share link created.",{type:"success"}),await r(),l.querySelector(".pe-share-url")?.select()}catch(u){E.toast("Could not create link: "+(u.message||"unknown error"),{type:"error"})}finally{s.creating.value=!1}},s.copy=async()=>{try{await navigator.clipboard.writeText(s.url.peek()),E.toast("Link copied to clipboard.",{type:"success"})}catch{l.querySelector(".pe-share-url")?.select(),E.toast("Press Ctrl+C to copy the selected link.",{type:"info"})}},s.revoke=async u=>{if(await E.confirm("Revoke this link? Anyone holding it loses access immediately."))try{await g.pages.previewLinks.revoke(u),E.toast("Link revoked.",{type:"success"}),await r()}catch(p){E.toast("Could not revoke: "+(p.message||"unknown error"),{type:"error"})}};const v=M.applyBindings(s,l);ye(i,()=>v.dispose()),i.element.appendChild(l),i.open(),await r()}function Yt(o){return new Promise(i=>{const l=E.slideover({title:"Save Named Version",size:"sm",position:"right"}),s=te(`
+</style>`;function pa(o){const l=E.slideover({title:"Editor settings",size:"sm",position:"right"}),c=ae(`<div>${da}</div>`),s=Q(o.peek()),i={font:M.observable(s.font),size:M.observable(String(s.size)),line:M.observable(String(s.line)),wrap:M.observable(s.wrap),caret:M.observable(Jt())},m=M.computed(()=>Q({font:i.font.value,size:i.size.value,line:i.line.value,wrap:i.wrap.value}));i.isDefault=M.computed(()=>Ht(m.value)&&i.caret.value==="auto");const p=M.effect(()=>Wt(i.caret.value)),r=c.querySelector("#pe-set-font");for(const[g,L]of[["mono","Monospace"],["sans","Other"],["serif",null]]){const D=Vt.filter(O=>O.kind===g),f=L?Object.assign(document.createElement("optgroup"),{label:L}):r.querySelector("optgroup:last-of-type");f.append(...D.map(O=>new Option(O.label,O.id))),L&&r.appendChild(f)}c.querySelector("#pe-set-size").append(...Ut.map(g=>new Option(`${g}px`,String(g)))),c.querySelector("#pe-set-line").append(...Kt.map(g=>new Option({1.3:"Tight",1.45:"Snug",1.6:"Normal",1.8:"Relaxed",2:"Double"}[g]||String(g),String(g))));const d=c.querySelector(".pe-settings-sample"),C=M.effect(()=>{const g=m.value;at(g.font);for(const[L,D]of Object.entries(Xe(g)))d.style.setProperty(L,D);d.style.whiteSpace=g.wrap?"pre-wrap":"pre",d.style.overflowX=g.wrap?"":"auto",JSON.stringify(g)!==JSON.stringify(Q(o.peek()))&&(o.value=g,se("type",g))});i.reset=()=>{i.font.value=ee.font,i.size.value=String(ee.size),i.line.value=String(ee.line),i.wrap.value=ee.wrap,i.caret.value="auto"},i.done=()=>l.close(),l.element.appendChild(c);const b=M.applyBindings(i,c),h=We(c);return Se(l,()=>{b.dispose(),h(),C?.(),p?.()}),Domma.icons?.scan?.(c),l.open(),l}async function ua(o){const l=E.slideover({title:"Share preview link",size:"md",position:"right"}),c=ae(`<div>${ca}</div>`),s={expiry:M.observable("7d"),note:M.observable(""),creating:M.observable(!1),url:M.observable(""),links:M.observable([]),loaded:M.observable(!1),listError:M.observable("")},i=async()=>{try{const p=await v.pages.previewLinks.list(o);s.links.value=p.filter(r=>!r.revokedAt&&!r.expired).map(r=>({id:r.id,title:r.label||"Untitled link",meta:`Expires ${la(r.expiresAt)} - ${r.useCount===1?"1 view":`${r.useCount||0} views`}`})),s.listError.value=""}catch(p){s.listError.value="Could not load existing links: "+(p.message||"unknown error")}finally{s.loaded.value=!0}};s.create=async()=>{s.creating.value=!0;try{const p=await v.pages.previewLinks.create(o,s.expiry.peek(),s.note.peek().trim());s.url.value=p.url,s.note.value="",E.toast("Share link created.",{type:"success"}),await i(),c.querySelector(".pe-share-url")?.select()}catch(p){E.toast("Could not create link: "+(p.message||"unknown error"),{type:"error"})}finally{s.creating.value=!1}},s.copy=async()=>{try{await navigator.clipboard.writeText(s.url.peek()),E.toast("Link copied to clipboard.",{type:"success"})}catch{c.querySelector(".pe-share-url")?.select(),E.toast("Press Ctrl+C to copy the selected link.",{type:"info"})}},s.revoke=async p=>{if(await E.confirm("Revoke this link? Anyone holding it loses access immediately."))try{await v.pages.previewLinks.revoke(p),E.toast("Link revoked.",{type:"success"}),await i()}catch(r){E.toast("Could not revoke: "+(r.message||"unknown error"),{type:"error"})}};const m=M.applyBindings(s,c);Se(l,()=>m.dispose()),l.element.appendChild(c),l.open(),await i()}function ma(o){return new Promise(l=>{const c=E.slideover({title:"Save Named Version",size:"sm",position:"right"}),s=ae(`
             <div style="padding:1rem">
               <label class="form-label" for="pe-version-label">Version Label</label>
               <input id="pe-version-label" type="text" class="form-input" style="margin-bottom:.75rem"
                      placeholder="e.g. Initial design, Before restructure" data-model="label.value" data-on-keydown="key">
               <button type="button" class="btn btn-primary" data-on-click="save" data-bind-disabled="saving.value">Save Version</button>
-            </div>`);let r=!1;const v={label:M.observable(""),saving:M.observable(!1)};v.save=async()=>{v.saving.value=!0;try{await g.versions.create(o,v.label.peek().trim()||null),E.toast("Named version saved.",{type:"success"}),r=!0,l.close()}catch(p){E.toast("Failed to save version: "+p.message,{type:"error"})}finally{v.saving.value=!1}},v.key=p=>{p.key==="Enter"&&(p.preventDefault(),v.save())};const u=M.applyBindings(v,s);ye(l,()=>{u.dispose(),i(r)}),l.element.appendChild(s),l.open(),setTimeout(()=>s.querySelector("input")?.focus(),100)})}let T=null,Xe=!1;function Xt(){Xe||!window.R?.use||(Xe=!0,R.use((o,i,l)=>{const s=i?.path||"",r=o?.path||"",v=$t.test(s)&&r!==s;return v&&T?.path===s&&T.cloneTarget===r?(T.cloneTarget=null,T.keepDraft(),l()):!v||!T||T.path!==s||!T.dirty()?l():E.confirm("You have unsaved changes to this page. Leave anyway? They are kept as a draft for your next visit.").then(u=>{u?(T?.keepDraft(),l()):history.replaceState(null,"","#"+s)})}),M.subscribe("router:afterChange",({to:o}={})=>{if(T&&(o?.path||"")!==T.path){const i=T;T=null,i.dispose()}}))}function Zt(o){return o.split(`
-`).map(i=>i.trimEnd()).join(`
+            </div>`);let i=!1;const m={label:M.observable(""),saving:M.observable(!1)};m.save=async()=>{m.saving.value=!0;try{await v.versions.create(o,m.label.peek().trim()||null),E.toast("Named version saved.",{type:"success"}),i=!0,c.close()}catch(r){E.toast("Failed to save version: "+r.message,{type:"error"})}finally{m.saving.value=!1}},m.key=r=>{r.key==="Enter"&&(r.preventDefault(),m.save())};const p=M.applyBindings(m,s);Se(c,()=>{p.dispose(),l(i)}),c.element.appendChild(s),c.open(),setTimeout(()=>s.querySelector("input")?.focus(),100)})}let k=null,st=!1;function fa(){st||!window.R?.use||(st=!0,R.use((o,l,c)=>{const s=l?.path||"",i=o?.path||"",m=Yt.test(s)&&i!==s;return m&&k?.path===s&&k.cloneTarget===i?(k.cloneTarget=null,k.keepDraft(),et(k.item),c()):!m||!k||k.path!==s||!k.dirty()?c():na(s,i)?(k.keepDraft(),et(k.item),c()):E.confirm("You have unsaved changes to this page. Leave anyway? They are kept as a draft for your next visit.").then(p=>{p?(k?.keepDraft(),c()):history.replaceState(null,"","#"+s)})}),M.subscribe("router:afterChange",({to:o}={})=>{if(k&&(o?.path||"")!==k.path){const l=k;k=null,l.dispose()}}))}function va(o){return o.split(`
+`).map(l=>l.trimEnd()).join(`
 `).replace(/\n{3,}/g,`
 
-`)}const Ze="editor_prefs";function q(){return S.get(Ze)||{viewMode:"split",fullscreen:!1}}function ae(o,i){const l=q();l[o]=i,S.set(Ze,l)}const Qt=["edit","details","seo","dconfig","live","history"],Qe=["split","write","preview"],ea=o=>o.replace(/<\/head>/i,"<style>body.dm-cloaked{opacity:1 !important;transition:none !important}</style></head>");function et(o,i,l=()=>{}){let s=0;try{s=o.contentWindow.scrollY||0}catch{}o.addEventListener("load",()=>{try{o.contentWindow.scrollTo(0,s)}catch{}l()},{once:!0}),o.srcdoc=i}export const pageEditorView={templateUrl:"/admin/js/templates/page-editor.html",async onMount(o){if(Xt(),T){const e=T;T=null,e.dispose()}const i=window.location.hash.replace(/^#/,""),l=[],s=e=>(l.push(e),e);let r=()=>!1,v=()=>{};const u={path:i,dirty:()=>r(),keepDraft:()=>v(),dispose:()=>{l.splice(0).forEach(e=>{try{e()}catch{}})}};T=u;const p=o.get(0),c=()=>T===u&&p.isConnected,C=window.location.hash.match(/#\/pages\/edit(\/[^?]*)/),d=C?C[1]:null,h=!!d,b=E.loader(p,{type:"dots"}),[L,$,m,P,ke,tt,at]=await Promise.all([g.layouts.get().catch(()=>({})),g.settings.get().catch(()=>({})),h?g.pages.get(d).catch(()=>null):null,h?g.pages.list().catch(()=>[]):[],g.projects.list().catch(()=>[]),g.pages.tags().catch(()=>[]),g.listTags.list("pages").then(e=>e.map(t=>t.name)).catch(()=>[])]);if(!c()){b.destroy();return}if(b.destroy(),h&&!m){E.toast("Page not found.",{type:"error"}),R.navigate("/pages");return}const w=e=>p.querySelector(e);if(St(w("#field-theme"),{includeDefault:!0}),await na(w("#field-visibility"),m?.visibility),!c())return;const st=oa(w("#field-layout"),L,m?.layout||"default");for(const e of ke)w("#field-project").append(new Option(e.name||e.slug,e.slug));const Ee=[...Array.isArray(P)?P:[]].sort((e,t)=>(e.title||e.urlPath).localeCompare(t.title||t.urlPath));for(const e of Ee)w("#quick-switch").append(new Option(`${e.title||"Untitled"} (${e.urlPath})`,e.urlPath,!1,e.urlPath===d));const H=q(),a={urlPath:M.observable(d||""),title:M.observable(m?.title||""),description:M.observable(m?.description||""),layout:M.observable(st),status:M.observable(m?.status||"draft"),sortOrder:M.observable(String(m?.sortOrder??99)),showInNav:M.observable(!!m?.showInNav),sidebar:M.observable(!!m?.sidebar),breadcrumbs:M.observable(m?m.breadcrumbs!==!1:!0),bundled:M.observable(!!m?.bundled),tags:M.observable(Array.isArray(m?.tags)?m.tags:[]),adminTags:M.observable(Array.isArray(m?.adminTags)?m.adminTags:[]),category:M.observable(m?.category||""),visibility:M.observable(typeof m?.visibility=="string"&&m.visibility?m.visibility:"public"),project:M.observable(qt({isEdit:h,page:m,projects:ke,fromHash:Ft()||"",urlPath:d||""})),theme:M.observable(m?.theme||""),seoTitle:M.observable(m?.seo?.title||""),seoDesc:M.observable(m?.seo?.description||""),dconfig:M.observable(m?.dconfig?JSON.stringify(m.dconfig,null,2):""),css:M.observable(""),cssOpened:M.observable(!1)},n={bodyRev:M.observable(0),base:M.observable(""),saving:M.observable(!1),tab:M.observable("edit"),viewMode:M.observable(Qe.includes(H.viewMode)?H.viewMode:"split"),fullscreen:M.observable(!!H.fullscreen),cssMode:M.observable(!1),folded:M.observable(!1),liveStatus:M.observable("Showing unsaved changes"),liveWidth:M.observable("full"),versions:M.observable([]),histLoading:M.observable(!1),histError:M.observable(""),compare:M.observable(null)},k=w("#markdown-editor"),F=w("#css-editor");k.value=m?.content||"";const ot=We(k),nt=We(F);s(()=>ot.destroy()),s(()=>nt.destroy());const O=document.createElement("div");O.className="editor-line-numbers editor-line-numbers--foldable",k.parentElement.insertBefore(O,k);const x=Tt(k,O,{onFoldChange:()=>{}});let I=!1;x.setGuard(e=>{I=e});const z=()=>x.getUnfoldedContent(),Me=M.observable(Z(H.type));s(M.effect(()=>{const e=Me.value,t=w("#editor-body");if(t){Ye(e.font);for(const[f,y]of Object.entries(Je(e)))t.style.setProperty(f,y);t.classList.toggle("pe-nowrap",!e.wrap),k.wrap=e.wrap?"soft":"off",F.wrap=e.wrap?"soft":"off"}}));let Se=null;s(()=>{try{Se?.close()}catch{}});const D=()=>(n.bodyRev.value,{urlPath:a.urlPath.value.trim(),title:a.title.value,description:a.description.value,layout:a.layout.value,status:a.status.value,sortOrder:a.sortOrder.value,showInNav:a.showInNav.value,sidebar:a.sidebar.value,breadcrumbs:a.breadcrumbs.value,bundled:a.bundled.value,tags:a.tags.value,adminTags:a.adminTags.value,category:a.category.value,visibility:a.visibility.value,project:a.project.value,theme:a.theme.value,seoTitle:a.seoTitle.value,seoDesc:a.seoDesc.value,dconfig:a.dconfig.value,body:z(),css:a.cssOpened.value?a.css.value:null}),rt=M.computed(()=>V(D())!==n.base.value),it=M.computed(()=>we({urlPath:a.urlPath.value,dconfig:a.dconfig.value})[0]?.text||""),lt=M.computed(()=>n.versions.value.some(e=>e.checked.value)),ct=M.computed(()=>n.versions.value.length>0&&n.versions.value.every(e=>e.checked.value)),dt=M.computed(()=>{const e=n.versions.value.filter(t=>t.checked.value).length;return e>0&&e<n.versions.value.length});r=()=>V(D())!==n.base.peek();let Te=JSON.stringify(a.adminTags.peek());const K=e=>({title:a.title.peek().trim()||"Untitled",description:a.description.peek().trim(),layout:a.layout.peek(),status:a.status.peek(),sortOrder:parseInt(String(a.sortOrder.peek()),10)||99,showInNav:a.showInNav.peek(),sidebar:a.sidebar.peek(),...a.breadcrumbs.peek()?{}:{breadcrumbs:!1},...a.bundled.peek()?{bundled:!0}:{},tags:a.tags.peek(),...h&&JSON.stringify(a.adminTags.peek())===Te?{}:{adminTags:a.adminTags.peek()},category:a.category.peek().trim()||null,visibility:a.visibility.peek()||"public",project:a.project.peek()||"",seo:{title:a.seoTitle.peek().trim(),description:a.seoDesc.peek().trim()},dconfig:e,...a.theme.peek()?{theme:a.theme.peek()}:{}}),se=()=>{const e=a.dconfig.peek().trim();if(!e)return null;try{return JSON.parse(e)}catch{return null}},Ce=()=>a.urlPath.peek().trim()||d||"/",U=w("#markdown-preview");let xe="";g.settings.getCustomCss().then(({css:e})=>{xe=e||""}).catch(()=>{});const Pe=()=>{const e=U?.contentDocument;if(!e?.head)return;const t=a.cssOpened.peek()?a.css.peek():"";if(!t)return;let f=e.getElementById("preview-custom-css");f||(f=e.createElement("style"),f.id="preview-custom-css",e.head.appendChild(f)),f.textContent=t};let oe=null;const _=()=>{clearTimeout(oe),oe=setTimeout(async()=>{if(!(!U||n.viewMode.peek()==="write"))try{const{html:e}=await g.pages.previewFull(Ce(),K(se()),z());c()&&et(U,ea(e),Pe)}catch(e){U.srcdoc='<!doctype html><meta charset="utf-8"><body style="font:14px system-ui;padding:1rem;color:#b91c1c;">Preview failed: '+String(e?.message||"unknown error").replace(/[<&]/g,t=>t==="<"?"&lt;":"&amp;")+"</body>"}},500)},Ae=w("#live-preview-frame");let ne=!0,re=null,ie=!1;const le=async()=>{if(!(ie||!Ae)){ie=!0,n.liveStatus.value="Rendering\u2026";try{const{html:e}=await g.pages.previewFull(Ce(),K(se()),z());if(!c())return;et(Ae,e),ne=!1,n.liveStatus.value="Showing unsaved changes"}catch(e){n.liveStatus.value="Preview failed - "+(e?.message||"unknown error")}finally{ie=!1}}},Le=()=>{ne=!0,n.tab.peek()==="live"&&(clearTimeout(re),re=setTimeout(le,600))};s(()=>{clearTimeout(oe),clearTimeout(re)});const ce=yt(o.find("#markdown-editor"),o.find("#editor-toolbar"),{spacerDefault:$?.layoutOptions?.spacerSize??40});Et(k);const de=p.querySelector(".editor-toolbar-right");de.querySelectorAll(".editor-view-btn[data-mode]").forEach(e=>{const t=e.getAttribute("data-mode");e.classList.remove("active"),e.setAttribute("data-bind-class",`viewMode.value === '${t}' && 'active'`),e.setAttribute("data-on-click",`setMode('${t}')`)}),w("#fullscreen-btn")?.setAttribute("data-on-click","toggleFullscreen");const pt=te(`
+`)}const ot="editor_prefs";function q(){return S.get(ot)||{viewMode:"split",fullscreen:!1}}function se(o,l){const c=q();c[o]=l,S.set(ot,c)}const ba=["edit","details","seo","dconfig","live","history"],nt=["split","write","preview"],ga=o=>o.replace(/<\/head>/i,"<style>body.dm-cloaked{opacity:1 !important;transition:none !important}</style></head>");function rt(o,l,c=()=>{}){let s=0;try{s=o.contentWindow.scrollY||0}catch{}o.addEventListener("load",()=>{try{o.contentWindow.scrollTo(0,s)}catch{}c()},{once:!0}),o.srcdoc=l}export const pageEditorView={templateUrl:"/admin/js/templates/page-editor.html",async onMount(o){if(fa(),k){const e=k;k=null,e.dispose()}const l=window.location.hash.replace(/^#/,""),c=[],s=e=>(c.push(e),e);let i=()=>!1,m=()=>{};const p=window.location.hash.match(/#\/pages\/edit(\/[^?]*)/),r=p?p[1]:null,d=!!r,C={path:l,item:{kind:"page",id:r||""},dirty:()=>i(),keepDraft:()=>m(),dispose:()=>{c.splice(0).forEach(e=>{try{e()}catch{}})}};k=C;const b=o.get(0),h=()=>k===C&&b.isConnected,g=E.loader(b,{type:"dots"}),[L,D,f,O,Ce,it,lt,H]=await Promise.all([v.layouts.get().catch(()=>({})),v.settings.get().catch(()=>({})),d?v.pages.get(r).catch(()=>null):null,v.pages.list().catch(()=>[]),v.projects.list().catch(()=>[]),v.pages.tags().catch(()=>[]),v.listTags.list("pages").then(e=>e.map(t=>t.name)).catch(()=>[]),v.blocks.list().catch(()=>[])]);if(!h()){g.destroy();return}if(g.destroy(),d&&!f){E.toast("Page not found.",{type:"error"}),R.navigate("/pages");return}const w=e=>b.querySelector(e);if(Bt(w("#field-theme"),{includeDefault:!0}),await Ea(w("#field-visibility"),f?.visibility),!h())return;const ct=wa(w("#field-layout"),L,f?.layout||"default");for(const e of Ce)w("#field-project").append(new Option(e.name||e.slug,e.slug));const oe=ra(H),K=q(),a={urlPath:M.observable(r||""),title:M.observable(f?.title||""),description:M.observable(f?.description||""),layout:M.observable(ct),status:M.observable(f?.status||"draft"),sortOrder:M.observable(String(f?.sortOrder??99)),showInNav:M.observable(!!f?.showInNav),sidebar:M.observable(!!f?.sidebar),breadcrumbs:M.observable(f?f.breadcrumbs!==!1:!0),bundled:M.observable(!!f?.bundled),tags:M.observable(Array.isArray(f?.tags)?f.tags:[]),adminTags:M.observable(Array.isArray(f?.adminTags)?f.adminTags:[]),category:M.observable(f?.category||""),visibility:M.observable(typeof f?.visibility=="string"&&f.visibility?f.visibility:"public"),project:M.observable(Zt({isEdit:d,page:f,projects:Ce,fromHash:_t()||"",urlPath:r||""})),theme:M.observable(f?.theme||""),seoTitle:M.observable(f?.seo?.title||""),seoDesc:M.observable(f?.seo?.description||""),dconfig:M.observable(f?.dconfig?JSON.stringify(f.dconfig,null,2):""),css:M.observable(""),cssOpened:M.observable(!1)},n={bodyRev:M.observable(0),base:M.observable(""),saving:M.observable(!1),tab:M.observable("edit"),viewMode:M.observable(nt.includes(K.viewMode)?K.viewMode:"split"),fullscreen:M.observable(!!K.fullscreen),cssMode:M.observable(!1),folded:M.observable(!1),liveStatus:M.observable("Showing unsaved changes"),liveWidth:M.observable("full"),versions:M.observable([]),histLoading:M.observable(!1),histError:M.observable(""),compare:M.observable(null),heldNote:M.observable("")},T=w("#markdown-editor"),F=w("#css-editor");T.value=f?.content||"";const dt=Ze(T),pt=Ze(F);s(()=>dt.destroy()),s(()=>pt.destroy());const N=document.createElement("div");N.className="editor-line-numbers editor-line-numbers--foldable",T.parentElement.insertBefore(N,T);const x=It(T,N,{onFoldChange:()=>{}});let z=!1;x.setGuard(e=>{z=e});const $=()=>x.getUnfoldedContent(),xe=M.observable(Q(K.type));s(M.effect(()=>{const e=xe.value,t=w("#editor-body");if(t){at(e.font);for(const[u,y]of Object.entries(Xe(e)))t.style.setProperty(u,y);t.classList.toggle("pe-nowrap",!e.wrap),T.wrap=e.wrap?"soft":"off",F.wrap=e.wrap?"soft":"off"}}));let Pe=null;s(()=>{try{Pe?.close()}catch{}});const B=()=>(n.bodyRev.value,{urlPath:a.urlPath.value.trim(),title:a.title.value,description:a.description.value,layout:a.layout.value,status:a.status.value,sortOrder:a.sortOrder.value,showInNav:a.showInNav.value,sidebar:a.sidebar.value,breadcrumbs:a.breadcrumbs.value,bundled:a.bundled.value,tags:a.tags.value,adminTags:a.adminTags.value,category:a.category.value,visibility:a.visibility.value,project:a.project.value,theme:a.theme.value,seoTitle:a.seoTitle.value,seoDesc:a.seoDesc.value,dconfig:a.dconfig.value,body:$(),css:a.cssOpened.value?a.css.value:null}),ut=M.computed(()=>j(B())!==n.base.value),mt=M.computed(()=>Te({urlPath:a.urlPath.value,dconfig:a.dconfig.value})[0]?.text||""),ft=M.computed(()=>n.versions.value.some(e=>e.checked.value)),vt=M.computed(()=>n.versions.value.length>0&&n.versions.value.every(e=>e.checked.value)),bt=M.computed(()=>{const e=n.versions.value.filter(t=>t.checked.value).length;return e>0&&e<n.versions.value.length});i=()=>j(B())!==n.base.peek();let Ae=JSON.stringify(a.adminTags.peek());const U=e=>({title:a.title.peek().trim()||"Untitled",description:a.description.peek().trim(),layout:a.layout.peek(),status:a.status.peek(),sortOrder:parseInt(String(a.sortOrder.peek()),10)||99,showInNav:a.showInNav.peek(),sidebar:a.sidebar.peek(),...a.breadcrumbs.peek()?{}:{breadcrumbs:!1},...a.bundled.peek()?{bundled:!0}:{},tags:a.tags.peek(),...d&&JSON.stringify(a.adminTags.peek())===Ae?{}:{adminTags:a.adminTags.peek()},category:a.category.peek().trim()||null,visibility:a.visibility.peek()||"public",project:a.project.peek()||"",seo:{title:a.seoTitle.peek().trim(),description:a.seoDesc.peek().trim()},dconfig:e,...a.theme.peek()?{theme:a.theme.peek()}:{}}),ne=()=>{const e=a.dconfig.peek().trim();if(!e)return null;try{return JSON.parse(e)}catch{return null}},Le=()=>a.urlPath.peek().trim()||r||"/";let re=[];const gt=Array.isArray(D?.footer?.blocks)?D.footer.blocks.filter(e=>typeof e=="string"):[],ht=new Map((Array.isArray(H)?H:[]).map(e=>[e.name,e.updatedAt])),ie=()=>{const e=ta([...new Set([...re,...gt])],ht),t=Object.keys(e),u=t.length?`Preview shows unsaved changes to ${t.join(", ")}`:"";return u!==n.heldNote.peek()&&(n.heldNote.value=u),e},_=w("#markdown-preview");let De="";v.settings.getCustomCss().then(({css:e})=>{De=e||""}).catch(()=>{});const Oe=()=>{const e=_?.contentDocument;if(!e?.head)return;const t=a.cssOpened.peek()?a.css.peek():"";if(!t)return;let u=e.getElementById("preview-custom-css");u||(u=e.createElement("style"),u.id="preview-custom-css",e.head.appendChild(u)),u.textContent=t};let le=null;const J=()=>{clearTimeout(le),le=setTimeout(async()=>{if(!(!_||n.viewMode.peek()==="write"))try{const{html:e}=await v.pages.previewFull(Le(),U(ne()),$(),ie());h()&&rt(_,ga(e),Oe)}catch(e){_.srcdoc='<!doctype html><meta charset="utf-8"><body style="font:14px system-ui;padding:1rem;color:#b91c1c;">Preview failed: '+String(e?.message||"unknown error").replace(/[<&]/g,t=>t==="<"?"&lt;":"&amp;")+"</body>"}},500)},Re=w("#live-preview-frame");let ce=!0,de=null,pe=!1;const ue=async()=>{if(!(pe||!Re)){pe=!0,n.liveStatus.value="Rendering\u2026";try{const{html:e}=await v.pages.previewFull(Le(),U(ne()),$(),ie());if(!h())return;rt(Re,e),ce=!1,n.liveStatus.value="Showing unsaved changes"}catch(e){n.liveStatus.value="Preview failed - "+(e?.message||"unknown error")}finally{pe=!1}}},Ne=()=>{ce=!0,n.tab.peek()==="live"&&(clearTimeout(de),de=setTimeout(ue,600))};s(()=>{clearTimeout(le),clearTimeout(de)});const me=Lt(o.find("#markdown-editor"),o.find("#editor-toolbar"),{spacerDefault:D?.layoutOptions?.spacerSize??40});Rt(T,{blocks:()=>oe});const fe=b.querySelector(".editor-toolbar-right");fe.querySelectorAll(".editor-view-btn[data-mode]").forEach(e=>{const t=e.getAttribute("data-mode");e.classList.remove("active"),e.setAttribute("data-bind-class",`viewMode.value === '${t}' && 'active'`),e.setAttribute("data-on-click",`setMode('${t}')`)}),w("#fullscreen-btn")?.setAttribute("data-on-click","toggleFullscreen");const yt=ae(`
             <span class="pe-toolbar-extras" style="display:contents">
               <button type="button" class="editor-view-btn" data-tip="Edit Custom CSS" data-on-click="toggleCss"
                       data-bind-class="cssMode.value && 'active'"><span>CSS</span></button>
@@ -90,5 +90,5 @@ The quick brown fox - 0O 1lI {} [] () =&gt; ==
                 <span class="pe-fold-icon" hidden data-bind-hidden="!folded.value"><span data-icon="chevrons-right" data-icon-size="10"></span></span>
               </button>
               <span class="editor-toolbar-sep"></span>
-            </span>`);de.prepend(pt);const Oe=e=>(Array.isArray(e)?e:[]).map(t=>({value:t,label:t})),De=w("#field-tags");let J=null;J=De?E.pillbox(De,{data:Oe(tt),value:a.tags.peek(),creatable:!0,searchable:!0,placeholder:"Add tag\u2026",onChange:()=>{J&&(a.tags.value=[...J.getValue()])}}):null;const Re=w("#field-admin-tags");let W=null;W=Re?E.pillbox(Re,{data:Oe(at),value:a.adminTags.peek(),creatable:!0,searchable:!0,placeholder:"Add admin tag\u2026",onChange:()=>{W&&(a.adminTags.value=[...W.getValue()])}}):null;let pe=!1,ue=null;const G=async()=>{pe=!0,n.histLoading.value=!0,n.histError.value="";try{const e=(await g.versions.list(d)).versions||[];if(!c())return;n.versions.value=e.map(t=>({...t,when:ee(t.createdAt),author:t.author||"",label:t.label||"",checked:M.observable(!1)}))}catch(e){n.histError.value="Failed to load versions: "+e.message}finally{n.histLoading.value=!1}},ve=e=>n.versions.peek().find(t=>t.filename===e),fe=async e=>{try{const t=await g.versions.get(d,e.filename);ue=e.filename,n.compare.value={label:Ge(e),old:t.content,current:z()}}catch(t){E.toast("Failed to load version: "+t.message,{type:"error"})}},Ne=async e=>{if(!(!e||!await E.confirm("Restore this version? The current page content will be overwritten (a pre-restore snapshot will be saved automatically).")))try{await g.versions.restore(d,e),E.toast("Page restored. Reloading editor\u2026",{type:"success"}),R.navigate("/pages"),setTimeout(()=>R.navigate(`/pages/edit${d}`),300)}catch(t){E.toast("Restore failed: "+t.message,{type:"error"})}},ut=async e=>{if(await E.confirm("Delete this version? This cannot be undone."))try{await g.versions.delete(d,e.filename),E.toast("Version deleted.",{type:"success"}),await G()}catch(t){E.toast("Failed to delete: "+t.message,{type:"error"})}},Fe=()=>{n.bodyRev.value=n.bodyRev.peek()+1},Ie=()=>{a.cssOpened.peek()||(a.css.value=xe,a.cssOpened.value=!0,ht(F))},Be=e=>{for(const t of["urlPath","title","description","layout","status","sortOrder","category","visibility","project","theme","seoTitle","seoDesc","dconfig"])a[t].value=e[t]==null?"":String(e[t]);for(const t of["showInNav","sidebar","breadcrumbs","bundled"])a[t].value=!!e[t];a.tags.value=Array.isArray(e.tags)?e.tags:[],J?.setValue(a.tags.peek()),Array.isArray(e.adminTags)&&(a.adminTags.value=e.adminTags),W?.setValue(a.adminTags.peek()),x.unfoldAll(),I=!0,k.value=e.body==null?"":String(e.body),I=!1,x.refresh(),e.css!=null&&(Ie(),a.css.value=String(e.css)),Fe()};n.base.value=V(D());const Y=Vt(d||"");v=()=>{if(r())try{S.set(Y,Ht(D(),n.base.peek()))}catch{}};const me=()=>{try{S.remove?S.remove(Y):S.set(Y,null)}catch{}},$e=e=>{r()&&(v(),e.preventDefault(),e.returnValue="")};window.addEventListener("beforeunload",$e),s(()=>window.removeEventListener("beforeunload",$e));const ze=async()=>{if(n.saving.peek())return;const e=D(),t=we(e);if(t.length){E.toast(t[0].text,{type:"warning"}),p.querySelectorAll("#editor-meta-tabs .tab-item")[Qt.indexOf(t[0].field==="dconfig"?"dconfig":"details")]?.click();return}const f=(e.dconfig||"").trim(),y=K(f?JSON.parse(f):null),A=a.cssOpened.peek();n.saving.value=!0;try{if(h){const N={frontmatter:y,body:e.body};e.urlPath!==d&&(N.newUrlPath=e.urlPath),await g.pages.update(d,N)}else await g.pages.create({urlPath:e.urlPath,frontmatter:y,body:e.body});A&&await g.settings.saveCustomCss(a.css.peek()),E.toast(A?"Page and CSS saved.":"Page saved.",{type:"success"}),me(),Te=JSON.stringify(a.adminTags.peek()),n.base.value=V(D()),h?e.urlPath!==d&&R.navigate(`/pages/edit${e.urlPath}`):R.navigate("/pages")}catch(N){E.toast(`Save failed: ${N.message||"Unknown error"}`,{type:"error"})}finally{n.saving.value=!1}},je=p.querySelector(".dm-plugin-body")||p,vt={...a,...n,dirty:rt,problem:it,anySelected:lt,allSelected:ct,someSelected:dt,isEdit:h,savedPath:d||"",hasPages:Ee.length>0},ft={save:()=>ze(),discard:async()=>{!r()||!await E.confirm("Discard the changes you have not saved?")||(Be(JSON.parse(n.base.peek())),me())},switchPage:e=>{const t=e?.target?.value;t&&R.navigate("/pages/edit"+t)},showTab:e=>{n.tab.value=e,e==="live"&&ne&&le(),e==="history"&&h&&!pe&&G()},setMode:e=>{n.cssMode.peek()&&(n.cssMode.value=!1),n.viewMode.value=e,ae("viewMode",e),e!=="write"&&_()},toggleFullscreen:()=>{n.fullscreen.value=!n.fullscreen.peek(),ae("fullscreen",n.fullscreen.peek())},toggleCss:()=>{n.cssMode.peek()?(n.cssMode.value=!1,n.viewMode.value=Qe.includes(q().viewMode)?q().viewMode:"split",x.refresh()):(Ie(),n.cssMode.value=!0,n.viewMode.value="split")},formatMarkdown:()=>{const e=k.selectionStart,t=Zt(z());x.unfoldAll(),I=!0,k.value=t,I=!1,k.selectionStart=k.selectionEnd=Math.min(e,t.length),k.dispatchEvent(new Event("input")),x.refresh(),E.toast("Markdown formatted.",{type:"success"})},toggleFold:()=>{n.folded.peek()?x.unfoldAll():x.foldAll(),n.folded.value=!n.folded.peek()},setWidth:e=>{n.liveWidth.value=e;const t=w("#live-preview-stage");t&&(t.scrollTop=0)},refreshLive:()=>le(),share:async()=>{if(!h){E.toast("Save the page first - a share link needs a page to point at.",{type:"warning"});return}await Gt(d)},toggleAll:e=>{const t=!!e?.target?.checked;n.versions.peek().forEach(f=>{f.checked.value=t})},deleteSelected:async()=>{const e=n.versions.peek().filter(f=>f.checked.peek()).map(f=>f.filename),t=e.length;if(!(!t||!await E.confirm(`Delete ${t} version${t>1?"s":""}? This cannot be undone.`)))try{await g.versions.bulkDelete(d,e),E.toast(`${t} version${t>1?"s":""} deleted.`,{type:"success"}),await G()}catch(f){E.toast("Delete failed: "+f.message,{type:"error"})}},saveNamed:async()=>{await Yt(d)&&c()&&(n.tab.peek()==="history"?await G():pe=!1)},closeCompare:()=>{n.compare.value=null,ue=null},restoreCompared:()=>Ne(ue)};de.querySelectorAll("[data-tip]").forEach(e=>E.tooltip(e,{content:e.getAttribute("data-tip"),position:"top"}));const mt=M.applyBindings(vt,je,{methods:ft});s(()=>mt.dispose()),E.tabs(w("#editor-meta-tabs"));let ge=null;s(()=>clearTimeout(ge)),k.addEventListener("input",()=>{x.refresh(),O.scrollTop=k.scrollTop,!I&&(clearTimeout(ge),ge=setTimeout(Fe,120),_(),Le())}),k.addEventListener("scroll",()=>{O.scrollTop=k.scrollTop}),F.addEventListener("scroll",()=>{O.scrollTop=F.scrollTop});let Ve=!0;s(M.effect(()=>{for(const e of Object.keys(a))e!=="css"&&e!=="cssOpened"&&a[e].value;if(n.bodyRev.value,Ve){Ve=!1,_();return}_(),Le()}));let be=null;if(s(()=>clearTimeout(be)),s(M.effect(()=>{const e=a.css.value;n.cssMode.value&&(ta(O,e,F),clearTimeout(be),be=setTimeout(Pe,400))})),h){const e=w(".pe-version-list"),t=E.contextMenu(e,{cursor:"glyph",match:"tr[data-file]",inherit:!1,density:"compact",items:f=>{const y=ve(f.dataset.file);return y?[{header:Ge(y)},{label:"Compare with the editor",icon:"columns",action:()=>fe(y)},{label:"Restore this version\u2026",icon:"rotate-ccw",action:()=>Ne(y.filename)},{type:"divider"},{label:"Delete\u2026",icon:"trash",danger:!0,action:()=>ut(y)}]:[]}});s(()=>t?.destroy?.()),e.addEventListener("click",f=>{const y=f.target.closest("tr[data-file]");if(!y||f.target.matches("input"))return;const A=f.target.closest(".pe-kebab");if(A){Ue(A);return}const N=ve(y.dataset.file);N&&fe(N)}),e.addEventListener("keydown",f=>{const y=f.target.closest("tr[data-file]");if(y){if(f.key==="F10"&&f.shiftKey)f.preventDefault(),Ue(y);else if(f.key==="Enter"&&f.target===y){const A=ve(y.dataset.file);A&&fe(A)}}})}aa(w("#editor-body"),w("#editor-divider"),s),Mt({image:e=>(n.cssMode.value=!1,sa(e)),scribe:e=>Ct(e),card:e=>gt.open(e,{onMediaBrowse:()=>g.media.list().catch(()=>[])}),timeline:e=>bt.open(e,{onPreview:async t=>{try{return await g.pages.preview(t)}catch{return null}},onListCollections:()=>g.collections.list().catch(()=>[]),onGetCollection:t=>g.collections.get(t).catch(()=>null)})}),ce.onEffects(e=>kt.open(e)),ce.onHelp(()=>_e()),ce.onTutorial(e=>xt(e));const qe=e=>{(e.ctrlKey||e.metaKey)&&!e.shiftKey&&!e.altKey&&e.key.toLowerCase()==="s"&&c()&&(e.preventDefault(),ze())};document.addEventListener("keydown",qe),s(()=>document.removeEventListener("keydown",qe));const X=p.querySelector(".dm-plugin-banner-name");s(M.effect(()=>{const e=zt(h,a.title.value,d);if(!c()||(document.title=`${e} - Domma CMS`,!X))return;const t=X.lastChild;t&&t.nodeType===3&&X.querySelector(".dm-plugin-banner-sep")?t.textContent=e:X.textContent=`Pages \u203A ${e}`})),j(o,{id:"page-editor-back",icon:"arrow-left",title:"Back to Pages",onClick:()=>R.navigate("/pages")}),j(o,{id:"page-editor-help",icon:"help-circle",title:"Editor reference",onClick:()=>_e()}),h&&j(o,{id:"page-editor-view",icon:"external-link",title:"View on the site",onClick:()=>window.open(a.urlPath.peek()||d,"_blank","noopener")});const he=j(o,{id:"page-editor-clone",icon:"copy",title:"Clone page",onClick:()=>{if(!h||n.saving.peek()||!c())return;const e=D(),t=we({...e,urlPath:d});if(t.length){E.toast(t[0].text,{type:"warning"});return}const f=At({page:m,frontmatter:{...K(se()),adminTags:a.adminTags.peek()},body:e.body,source:d,pages:P,onCloned:y=>{c()&&(u.cloneTarget=`/pages/edit${y}`,R.navigate(u.cloneTarget))}});s(()=>f.close())}});he&&(he.disabled=!h,h||(he.title="Save the page before cloning it")),j(o,{id:"page-editor-settings",icon:"settings",title:"Editor settings - font, size, spacing",onClick:()=>{Se=Wt(Me)}}),s(Ke(je,{position:"bottom"})),Domma.icons.scan();let He=null;try{He=S.get(Y)}catch{}const B=Kt(He);if(B&&(me(),V(B.state)!==n.base.peek())){const e=B.at?` (${ee(B.at)})`:"",t=jt(B,n.base.peek())?" The saved page has changed since - restoring puts your version back over it (the saved one stays in History).":"";await E.confirm(`You left unsaved changes to this page${e}. Restore them?${t}`)&&c()&&Be(B.state)}}};function ta(o,i,l){o.replaceChildren(...String(i).split(`
-`).map((s,r)=>{const v=document.createElement("span");v.className="editor-line-number-row";const u=document.createElement("span");u.className="fold-toggle fold-toggle--empty";const p=document.createElement("span");return p.className="editor-line-num",p.textContent=String(r+1),v.append(u,p),v})),o.scrollTop=l.scrollTop}function aa(o,i,l){if(!o||!i)return;const s=15,r=85,v=d=>Math.min(r,Math.max(s,d));let u=v(parseFloat(q().splitRatio)||50);const p=d=>{o.style.setProperty("--dm-editor-split",u+"%"),i.setAttribute("aria-valuenow",String(Math.round(u))),d&&ae("splitRatio",u)};p(!1);const c=d=>{const h=o.getBoundingClientRect();h.width&&(u=v((d.clientX-h.left)/h.width*100)),p(!1)},C=()=>{document.removeEventListener("pointermove",c),document.removeEventListener("pointerup",C),o.classList.remove("is-resizing"),i.classList.remove("is-dragging"),p(!0)};l(C),i.addEventListener("pointerdown",d=>{window.matchMedia("(max-width: 768px)").matches||(d.preventDefault(),o.classList.add("is-resizing"),i.classList.add("is-dragging"),document.addEventListener("pointermove",c),document.addEventListener("pointerup",C))}),i.addEventListener("dblclick",()=>{u=50,p(!0)}),i.addEventListener("keydown",d=>{const h=d.shiftKey?10:2;let b=u;if(d.key==="ArrowLeft")b=u-h;else if(d.key==="ArrowRight")b=u+h;else if(d.key==="Home")b=s;else if(d.key==="End")b=r;else if(d.key==="Enter"||d.key===" ")b=50;else return;d.preventDefault(),u=v(b),p(!0)})}async function sa(o){const i=o.selectionStart,l=o.selectionEnd,s=await Pt({title:"Upload or insert an image"});if(!s||!o.isConnected)return;let r=s.split("/").pop().split("?")[0];try{r=decodeURIComponent(r)}catch{}const v=r.replace(/[\\[\]]/g,"\\$&"),u=s.replace(/\(/g,"%28").replace(/\)/g,"%29").replace(/ /g,"%20");o.setSelectionRange(i,l),wt(o,`![${v}](${u})`),o.dispatchEvent(new Event("input",{bubbles:!0}))}function oa(o,i,l){const s=Object.entries(i||{});return o?(o.replaceChildren(...s.map(([r,v])=>new Option(v?.label||r,r))),s.some(([r])=>r===l)?l:s[0]?.[0]||l):l}async function na(o,i){if(!o)return;let l=[];try{const c=await g.get("/collections/roles/entries?limit=100");l=Array.isArray(c)?c:c?.entries||[]}catch{}const s=l.map(c=>({name:c.data?.name,label:c.data?.label||c.data?.name,level:c.data?.level??99})).filter(c=>c.name&&c.level!==0).sort((c,C)=>C.level-c.level),r=(c,C)=>Object.assign(document.createElement("option"),{value:c,textContent:C}),v=()=>{typeof i=="string"&&i&&![...o.options].some(c=>c.value===i)&&o.append(r(i,`${i} (custom)`))};if(!s.length)return v();const u=document.createElement("optgroup");u.label="Role and above",s.forEach(c=>u.append(r(c.name,`${c.label} and above`)));const p=document.createElement("optgroup");p.label="Role only",s.forEach(c=>p.append(r(`=${c.name}`,`${c.label} only`))),o.replaceChildren(r("public","Public - everyone"),u,p,r("private","Private - super-admin only")),v()}
+            </span>`);fe.prepend(yt);const Be=e=>(Array.isArray(e)?e:[]).map(t=>({value:t,label:t})),Ie=w("#field-tags");let W=null;W=Ie?E.pillbox(Ie,{data:Be(it),value:a.tags.peek(),creatable:!0,searchable:!0,placeholder:"Add tag\u2026",onChange:()=>{W&&(a.tags.value=[...W.getValue()])}}):null;const Fe=w("#field-admin-tags");let Y=null;Y=Fe?E.pillbox(Fe,{data:Be(lt),value:a.adminTags.peek(),creatable:!0,searchable:!0,placeholder:"Add admin tag\u2026",onChange:()=>{Y&&(a.adminTags.value=[...Y.getValue()])}}):null;let ve=!1,be=null;const G=async()=>{ve=!0,n.histLoading.value=!0,n.histError.value="";try{const e=(await v.versions.list(r)).versions||[];if(!h())return;n.versions.value=e.map(t=>({...t,when:te(t.createdAt),author:t.author||"",label:t.label||"",checked:M.observable(!1)}))}catch(e){n.histError.value="Failed to load versions: "+e.message}finally{n.histLoading.value=!1}},ge=e=>n.versions.peek().find(t=>t.filename===e),he=async e=>{try{const t=await v.versions.get(r,e.filename);be=e.filename,n.compare.value={label:tt(e),old:t.content,current:$()}}catch(t){E.toast("Failed to load version: "+t.message,{type:"error"})}},ze=async e=>{if(!(!e||!await E.confirm("Restore this version? The current page content will be overwritten (a pre-restore snapshot will be saved automatically).")))try{await v.versions.restore(r,e),E.toast("Page restored. Reloading editor\u2026",{type:"success"}),R.navigate("/pages"),setTimeout(()=>R.navigate(`/pages/edit${r}`),300)}catch(t){E.toast("Restore failed: "+t.message,{type:"error"})}},kt=async e=>{if(await E.confirm("Delete this version? This cannot be undone."))try{await v.versions.delete(r,e.filename),E.toast("Version deleted.",{type:"success"}),await G()}catch(t){E.toast("Failed to delete: "+t.message,{type:"error"})}},$e=()=>{n.bodyRev.value=n.bodyRev.peek()+1},je=()=>{a.cssOpened.peek()||(a.css.value=De,a.cssOpened.value=!0,At(F))},ye=e=>{for(const t of["urlPath","title","description","layout","status","sortOrder","category","visibility","project","theme","seoTitle","seoDesc","dconfig"])a[t].value=e[t]==null?"":String(e[t]);for(const t of["showInNav","sidebar","breadcrumbs","bundled"])a[t].value=!!e[t];a.tags.value=Array.isArray(e.tags)?e.tags:[],W?.setValue(a.tags.peek()),Array.isArray(e.adminTags)&&(a.adminTags.value=e.adminTags),Y?.setValue(a.adminTags.peek()),x.unfoldAll(),z=!0,T.value=e.body==null?"":String(e.body),z=!1,x.refresh(),e.css!=null&&(je(),a.css.value=String(e.css)),$e()};n.base.value=j(B());const X=Xt(r||"");m=()=>{if(i())try{S.set(X,Qt(B(),n.base.peek()))}catch{}};const ke=()=>{try{S.remove?S.remove(X):S.set(X,null)}catch{}},Ve=e=>{i()&&(m(),e.preventDefault(),e.returnValue="")};window.addEventListener("beforeunload",Ve),s(()=>window.removeEventListener("beforeunload",Ve));const qe=async()=>{if(n.saving.peek())return;const e=B(),t=Te(e);if(t.length){E.toast(t[0].text,{type:"warning"}),b.querySelectorAll("#editor-meta-tabs .tab-item")[ba.indexOf(t[0].field==="dconfig"?"dconfig":"details")]?.click();return}const u=(e.dconfig||"").trim(),y=U(u?JSON.parse(u):null),A=a.cssOpened.peek();n.saving.value=!0;try{if(d){const I={frontmatter:y,body:e.body};e.urlPath!==r&&(I.newUrlPath=e.urlPath),await v.pages.update(r,I)}else await v.pages.create({urlPath:e.urlPath,frontmatter:y,body:e.body});if(A&&await v.settings.saveCustomCss(a.css.peek()),E.toast(A?"Page and CSS saved.":"Page saved.",{type:"success"}),!h())return;ke(),d&&sa({kind:"page",id:e.urlPath,label:a.title.peek().trim()||"Untitled"}),Ae=JSON.stringify(a.adminTags.peek()),n.base.value=j(B()),d?e.urlPath!==r&&R.navigate(`/pages/edit${e.urlPath}`):R.navigate("/pages")}catch(I){E.toast(`Save failed: ${I.message||"Unknown error"}`,{type:"error"})}finally{n.saving.value=!1}},He=b.querySelector(".dm-plugin-body")||b,wt={...a,...n,dirty:ut,problem:mt,anySelected:ft,allSelected:vt,someSelected:bt,isEdit:d,savedPath:r||""},Et={save:()=>qe(),discard:async()=>{!i()||!await E.confirm("Discard the changes you have not saved?")||(ye(JSON.parse(n.base.peek())),ke())},showTab:e=>{n.tab.value=e,e==="live"&&ce&&ue(),e==="history"&&d&&!ve&&G()},setMode:e=>{n.cssMode.peek()&&(n.cssMode.value=!1),n.viewMode.value=e,se("viewMode",e),e!=="write"&&J()},toggleFullscreen:()=>{n.fullscreen.value=!n.fullscreen.peek(),se("fullscreen",n.fullscreen.peek())},toggleCss:()=>{n.cssMode.peek()?(n.cssMode.value=!1,n.viewMode.value=nt.includes(q().viewMode)?q().viewMode:"split",x.refresh()):(je(),n.cssMode.value=!0,n.viewMode.value="split")},formatMarkdown:()=>{const e=T.selectionStart,t=va($());x.unfoldAll(),z=!0,T.value=t,z=!1,T.selectionStart=T.selectionEnd=Math.min(e,t.length),T.dispatchEvent(new Event("input")),x.refresh(),E.toast("Markdown formatted.",{type:"success"})},toggleFold:()=>{n.folded.peek()?x.unfoldAll():x.foldAll(),n.folded.value=!n.folded.peek()},setWidth:e=>{n.liveWidth.value=e;const t=w("#live-preview-stage");t&&(t.scrollTop=0)},refreshLive:()=>ue(),share:async()=>{if(!d){E.toast("Save the page first - a share link needs a page to point at.",{type:"warning"});return}await ua(r)},toggleAll:e=>{const t=!!e?.target?.checked;n.versions.peek().forEach(u=>{u.checked.value=t})},deleteSelected:async()=>{const e=n.versions.peek().filter(u=>u.checked.peek()).map(u=>u.filename),t=e.length;if(!(!t||!await E.confirm(`Delete ${t} version${t>1?"s":""}? This cannot be undone.`)))try{await v.versions.bulkDelete(r,e),E.toast(`${t} version${t>1?"s":""} deleted.`,{type:"success"}),await G()}catch(u){E.toast("Delete failed: "+u.message,{type:"error"})}},saveNamed:async()=>{await ma(r)&&h()&&(n.tab.peek()==="history"?await G():ve=!1)},closeCompare:()=>{n.compare.value=null,be=null},restoreCompared:()=>ze(be)};fe.querySelectorAll("[data-tip]").forEach(e=>E.tooltip(e,{content:e.getAttribute("data-tip"),position:"top"}));const Mt=M.applyBindings(wt,He,{methods:Et});s(()=>Mt.dispose());const Ke=aa(w("#page-hop"),{current:{kind:"page",id:r||"",label:f?.title||r||""},pages:O,blocks:H});s(()=>Ke.dispose()),E.tabs(w("#editor-meta-tabs"));let we=null;s(()=>clearTimeout(we)),T.addEventListener("input",()=>{x.refresh(),N.scrollTop=T.scrollTop,!z&&(clearTimeout(we),we=setTimeout($e,120),J(),Ne())}),T.addEventListener("scroll",()=>{N.scrollTop=T.scrollTop}),F.addEventListener("scroll",()=>{N.scrollTop=F.scrollTop});let Ue=!0;s(M.effect(()=>{for(const e of Object.keys(a))e!=="css"&&e!=="cssOpened"&&a[e].value;if(n.bodyRev.value,Ue){Ue=!1,J();return}J(),Ne()}));const St=oe.map(e=>e.name),Tt=oe.filter(e=>e.shortTag).map(e=>e.name);s(M.effect(()=>{n.bodyRev.value,re=ia($(),St,Tt),Ke.setRelated(re.map(e=>({kind:"block",id:e,label:e}))),ie()}));let Ee=null;if(s(()=>clearTimeout(Ee)),s(M.effect(()=>{const e=a.css.value;n.cssMode.value&&(ha(N,e,F),clearTimeout(Ee),Ee=setTimeout(Oe,400))})),d){const e=w(".pe-version-list"),t=E.contextMenu(e,{cursor:"glyph",match:"tr[data-file]",inherit:!1,density:"compact",items:u=>{const y=ge(u.dataset.file);return y?[{header:tt(y)},{label:"Compare with the editor",icon:"columns",action:()=>he(y)},{label:"Restore this version\u2026",icon:"rotate-ccw",action:()=>ze(y.filename)},{type:"divider"},{label:"Delete\u2026",icon:"trash",danger:!0,action:()=>kt(y)}]:[]}});s(()=>t?.destroy?.()),e.addEventListener("click",u=>{const y=u.target.closest("tr[data-file]");if(!y||u.target.matches("input"))return;const A=u.target.closest(".pe-kebab");if(A){Ye(A);return}const I=ge(y.dataset.file);I&&he(I)}),e.addEventListener("keydown",u=>{const y=u.target.closest("tr[data-file]");if(y){if(u.key==="F10"&&u.shiftKey)u.preventDefault(),Ye(y);else if(u.key==="Enter"&&u.target===y){const A=ge(y.dataset.file);A&&he(A)}}})}ya(w("#editor-body"),w("#editor-divider"),s),Nt({image:e=>(n.cssMode.value=!1,ka(e)),scribe:e=>Ft(e),card:e=>xt.open(e,{onMediaBrowse:()=>v.media.list().catch(()=>[])}),timeline:e=>Pt.open(e,{onPreview:async t=>{try{return await v.pages.preview(t)}catch{return null}},onListCollections:()=>v.collections.list().catch(()=>[]),onGetCollection:t=>v.collections.get(t).catch(()=>null)})}),me.onEffects(e=>Ot.open(e)),me.onHelp(()=>Ge()),me.onTutorial(e=>zt(e));const _e=e=>{(e.ctrlKey||e.metaKey)&&!e.shiftKey&&!e.altKey&&e.key.toLowerCase()==="s"&&h()&&(e.preventDefault(),qe())};document.addEventListener("keydown",_e),s(()=>document.removeEventListener("keydown",_e));const Z=b.querySelector(".dm-plugin-banner-name");s(M.effect(()=>{const e=Gt(d,a.title.value,r);if(!h()||(document.title=`${e} - Domma CMS`,!Z))return;const t=Z.lastChild;t&&t.nodeType===3&&Z.querySelector(".dm-plugin-banner-sep")?t.textContent=e:Z.textContent=`Pages \u203A ${e}`})),V(o,{id:"page-editor-back",icon:"arrow-left",title:"Back to Pages",onClick:()=>R.navigate("/pages")}),V(o,{id:"page-editor-help",icon:"help-circle",title:"Editor reference",onClick:()=>Ge()}),d&&V(o,{id:"page-editor-view",icon:"external-link",title:"View on the site",onClick:()=>window.open(a.urlPath.peek()||r,"_blank","noopener")});const Me=V(o,{id:"page-editor-clone",icon:"copy",title:"Clone page",onClick:()=>{if(!d||n.saving.peek()||!h())return;const e=B(),t=Te({...e,urlPath:r});if(t.length){E.toast(t[0].text,{type:"warning"});return}const u=jt({page:f,frontmatter:{...U(ne()),adminTags:a.adminTags.peek()},body:e.body,source:r,pages:O,onCloned:y=>{h()&&(C.cloneTarget=`/pages/edit${y}`,R.navigate(C.cloneTarget))}});s(()=>u.close())}});Me&&(Me.disabled=!d,d||(Me.title="Save the page before cloning it")),V(o,{id:"page-editor-settings",icon:"settings",title:"Editor settings - font, size, spacing",onClick:()=>{Pe=pa(xe)}}),s(We(He,{position:"bottom"})),Domma.icons.scan();let Je=null;try{Je=S.get(X)}catch{}const P=ea(Je),Ct=oa(C.item);if(P){if(ke(),j(P.state)!==n.base.peek()&&Ct&&!Qe(P,n.base.peek()))ye(P.state),E.toast("Your unsaved changes to this page are back.",{type:"info"});else if(j(P.state)!==n.base.peek()){const e=P.at?` (${te(P.at)})`:"",t=Qe(P,n.base.peek())?" The saved page has changed since - restoring puts your version back over it (the saved one stays in History).":"";await E.confirm(`You left unsaved changes to this page${e}. Restore them?${t}`)&&h()&&ye(P.state)}}}};function ha(o,l,c){o.replaceChildren(...String(l).split(`
+`).map((s,i)=>{const m=document.createElement("span");m.className="editor-line-number-row";const p=document.createElement("span");p.className="fold-toggle fold-toggle--empty";const r=document.createElement("span");return r.className="editor-line-num",r.textContent=String(i+1),m.append(p,r),m})),o.scrollTop=c.scrollTop}function ya(o,l,c){if(!o||!l)return;const s=15,i=85,m=b=>Math.min(i,Math.max(s,b));let p=m(parseFloat(q().splitRatio)||50);const r=b=>{o.style.setProperty("--dm-editor-split",p+"%"),l.setAttribute("aria-valuenow",String(Math.round(p))),b&&se("splitRatio",p)};r(!1);const d=b=>{const h=o.getBoundingClientRect();h.width&&(p=m((b.clientX-h.left)/h.width*100)),r(!1)},C=()=>{document.removeEventListener("pointermove",d),document.removeEventListener("pointerup",C),o.classList.remove("is-resizing"),l.classList.remove("is-dragging"),r(!0)};c(C),l.addEventListener("pointerdown",b=>{window.matchMedia("(max-width: 768px)").matches||(b.preventDefault(),o.classList.add("is-resizing"),l.classList.add("is-dragging"),document.addEventListener("pointermove",d),document.addEventListener("pointerup",C))}),l.addEventListener("dblclick",()=>{p=50,r(!0)}),l.addEventListener("keydown",b=>{const h=b.shiftKey?10:2;let g=p;if(b.key==="ArrowLeft")g=p-h;else if(b.key==="ArrowRight")g=p+h;else if(b.key==="Home")g=s;else if(b.key==="End")g=i;else if(b.key==="Enter"||b.key===" ")g=50;else return;b.preventDefault(),p=m(g),r(!0)})}async function ka(o){const l=o.selectionStart,c=o.selectionEnd,s=await $t({title:"Upload or insert an image"});if(!s||!o.isConnected)return;let i=s.split("/").pop().split("?")[0];try{i=decodeURIComponent(i)}catch{}const m=i.replace(/[\\[\]]/g,"\\$&"),p=s.replace(/\(/g,"%28").replace(/\)/g,"%29").replace(/ /g,"%20");o.setSelectionRange(l,c),Dt(o,`![${m}](${p})`),o.dispatchEvent(new Event("input",{bubbles:!0}))}function wa(o,l,c){const s=Object.entries(l||{});return o?(o.replaceChildren(...s.map(([i,m])=>new Option(m?.label||i,i))),s.some(([i])=>i===c)?c:s[0]?.[0]||c):c}async function Ea(o,l){if(!o)return;let c=[];try{const d=await v.get("/collections/roles/entries?limit=100");c=Array.isArray(d)?d:d?.entries||[]}catch{}const s=c.map(d=>({name:d.data?.name,label:d.data?.label||d.data?.name,level:d.data?.level??99})).filter(d=>d.name&&d.level!==0).sort((d,C)=>C.level-d.level),i=(d,C)=>Object.assign(document.createElement("option"),{value:d,textContent:C}),m=()=>{typeof l=="string"&&l&&![...o.options].some(d=>d.value===l)&&o.append(i(l,`${l} (custom)`))};if(!s.length)return m();const p=document.createElement("optgroup");p.label="Role and above",s.forEach(d=>p.append(i(d.name,`${d.label} and above`)));const r=document.createElement("optgroup");r.label="Role only",s.forEach(d=>r.append(i(`=${d.name}`,`${d.label} only`))),o.replaceChildren(i("public","Public - everyone"),p,r,i("private","Private - super-admin only")),m()}

package/docs/markdown-shortcodes.md

@@ -1264,6 +1264,23 @@ Short tags are self-closing only, and only work for block names made of lowercas
 do not clash with a built-in shortcode name (a block called `card` or `menu`, for example, can only be used through
 `[block template="…"]`).
 
+**In the page editor:** right-click and choose **Add block…** to insert any block with all its parameters written
+out (`[cta-banner title="" tagline="" … /]`), the cursor in the first one. Right-clicking inside a block's tag - the
+short tag or `[block template="…"]` - lists that block's own parameters to fill in there and then; a parameter the
+block's doc comment writes as `dark | light | gold` is offered as a choice. **Edit parameters…** opens them in a
+form, and **Open the block** goes to the block editor. The parameters come from the template's `{{placeholders}}`;
+the hints and choices from the "Parameters:" list in the block's opening comment:
+
+```
+<!--
+  cta-banner - Reusable statement call-to-action block.
+
+  Parameters (all optional):
+    title    - Heading text          (default: empty)
+    variant  - dark | light | gold   (default: dark)
+-->
+```
+
 **Example:**
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domma-cms",
-  "version": "1.8.16",
+  "version": "1.8.18",
   "description": "File-based CMS powered by Domma and Fastify. Run npx domma-cms my-site to create a new project.",
   "type": "module",
   "main": "server/server.js",

package/server/routes/api/blocks.js

@@ -1,7 +1,8 @@
 /**
  * Blocks API
  * CRUD for reusable HTML block templates stored in content/blocks/*.html.
- * GET    /api/blocks              - list all blocks (each with hasCss, description, example;
+ * GET    /api/blocks              - list all blocks (each with hasCss, description, example,
+ *                                    fields (its parameters) and shortTag;
  *                                    ?usage=1 adds where each is used: pages and views)
  * GET    /api/blocks/_count       - the sidebar badge (`_` is outside the block-name alphabet)
  * GET    /api/blocks/:name        - get block content
@@ -16,6 +17,7 @@ import {authenticate, requirePermission} from '../../middleware/auth.js';
 import {deleteBlock, getBlock, listBlocks, saveBlock} from '../../services/blocks.js';
 import {config, getConfig} from '../../config.js';
 import {fmtDate} from '../../services/dates.js';
+import {BUILTIN_SHORTCODES} from '../../services/markdown.js';
 
 /**
  * A block's own doc comment - the one every block opens with - read for the
@@ -59,6 +61,58 @@ export function blockDoc(html, name = '') {
     return {description: description.slice(0, 200), example: example.slice(0, 300)};
 }
 
+/**
+ * The parameters a block takes, for the page editor's short-tag menu: every
+ * `{{field}}` / `{{field:FORMAT}}` / `{{{field}}}` the template uses (outside
+ * HTML comments, which the renderer strips), in order, with what the doc
+ * comment's "Parameters" list says about each - `name - hint (default: x)`,
+ * where a hint written `a | b | c` is a choice. Fields starting `_` are
+ * collection meta (`_createdAt`), never set from a tag, so they are left out.
+ * Plain text; a field the doc does not mention gets no hint.
+ *
+ * @param {string} html
+ * @returns {{name: string, raw: boolean, hint: string, default: string, options: string[]}[]}
+ */
+export function blockFields(html) {
+    const src = String(html || '');
+    const docs = new Map();
+    const m = /^\s*<!--([\s\S]*?)-->/.exec(src);
+    if (m) {
+        const lines = m[1].split('\n').map(l => l.trim());
+        const at = lines.findIndex(l => /^parameters\b.*:$/i.test(l));
+        for (let i = at + 1; at >= 0 && i < lines.length && lines[i]; i++) {
+            const p = /^([\w]+)\s+[-–]\s+(.*)$/.exec(lines[i]);
+            if (!p) continue;
+            let hint = p[2].trim();
+            let def = '';
+            const d = /\s*\(default:\s*([^)]*)\)\s*$/i.exec(hint);
+            if (d) {
+                hint = hint.slice(0, d.index).trim();
+                def = d[1].trim().replace(/^"(.*)"$/, '$1');
+                if (/^empty$/i.test(def)) def = '';
+            }
+            const options = /^[\w-]+(?:\s*\|\s*[\w-]+)+$/.test(hint) ? hint.split('|').map(s => s.trim()) : [];
+            docs.set(p[1], {hint: hint.slice(0, 160), default: def.slice(0, 120), options});
+        }
+    }
+    const body = src.replace(/<!--[\s\S]*?-->/g, '');
+    const out = new Map();
+    for (const [, rawKey, key] of body.matchAll(/\{\{\{(\w+)\}\}\}|\{\{([\w_]+)(?::[^{}]+)?\}\}/g)) {
+        const name = rawKey ?? key;
+        if (name.startsWith('_')) continue;
+        const had = out.get(name);
+        if (had) { had.raw = had.raw || rawKey !== undefined; continue; }
+        out.set(name, {name, raw: rawKey !== undefined, hint: '', default: '', options: [], ...docs.get(name)});
+    }
+    // The doc's order where it has one (it is written in order of importance), then the rest as used.
+    const rank = [...docs.keys()];
+    const at = (n) => (rank.includes(n) ? rank.indexOf(n) : rank.length);
+    return [...out.values()].sort((a, b) => at(a.name) - at(b.name)).slice(0, 60);
+}
+
+/** A block name the page can use as its own tag (`[name … /]`) - not one a built-in shortcode owns. */
+export const isShortTag = (name) => /^[a-z0-9][a-z0-9-]*$/.test(name) && !BUILTIN_SHORTCODES.has(name);
+
 /** Escape a block name for a RegExp. Names are [a-z0-9-] so only `-` needs care. */
 const reName = (n) => n.replace(/-/g, '\\-');
 
@@ -173,7 +227,8 @@ export async function blocksRoutes(fastify) {
             let full = null;
             try { full = await getBlock(b.name); } catch { /* skip */ }
             if (!canSeeArtefact(user, full)) continue;
-            out.push({...b, hasCss: Boolean(full?.css), cssSize: full?.css?.length || 0, ...blockDoc(full?.content, b.name)});
+            out.push({...b, hasCss: Boolean(full?.css), cssSize: full?.css?.length || 0, ...blockDoc(full?.content, b.name),
+                fields: blockFields(full?.content), shortTag: isShortTag(b.name)});
         }
         return out;
     }

package/server/routes/api/pages.js

@@ -7,13 +7,14 @@
  * PUT    /api/pages/*        - update page
  * DELETE /api/pages/*        - delete page
  * POST   /api/pages/preview  - render markdown body to HTML (no page shell)
- * POST   /api/pages/preview/full      - render UNSAVED frontmatter+body as a complete page
+ * POST   /api/pages/preview/full      - render UNSAVED frontmatter+body as a complete page;
+ *                                      `blocks` {name: {content, css}} = unsaved block edits to use
  * GET    /api/pages/preview-links     - list share links (optionally ?urlPath=)
  * POST   /api/pages/preview-links     - mint a share link for one page
  * DELETE /api/pages/preview-links/:id - revoke a share link
  */
 import {buildPreviewPage, createPage, deletePage, getPage, listPages, renamePage, updatePage} from '../../services/content.js';
-import {parseMarkdown} from '../../services/markdown.js';
+import {parseMarkdown, readBlockOverrides, withBlockOverrides} from '../../services/markdown.js';
 import {renderPage} from '../../services/renderer.js';
 import {
     createPreviewLink,
@@ -97,11 +98,18 @@ export async function pagesRoutes(fastify) {
             return reply.status(400).send({error: 'frontmatter must be an object'});
         }
 
-        const page = await buildPreviewPage(urlPath, frontmatter, body, {user: request.user || null});
-        const html = await renderPage(page, {
-            baseUrl: `${request.protocol}://${request.host}`,
-            user: request.user || null,
-            noTrack: true
+        // Unsaved block edits (the block editor's "show on this page", a page editor with
+        // block changes held): this render only. The output is sanitised as any page is.
+        const overrides = readBlockOverrides(request.body?.blocks);
+        if (overrides.error) return reply.status(400).send({error: overrides.error});
+
+        const html = await withBlockOverrides(overrides.blocks, async () => {
+            const page = await buildPreviewPage(urlPath, frontmatter, body, {user: request.user || null});
+            return renderPage(page, {
+                baseUrl: `${request.protocol}://${request.host}`,
+                user: request.user || null,
+                noTrack: true
+            });
         });
         return {html};
     });

package/server/services/markdown.js

@@ -8,6 +8,7 @@ import matter from 'gray-matter';
 import {marked} from 'marked';
 import sanitizeHtml from 'sanitize-html';
 import {readdir, readFile} from 'fs/promises';
+import {AsyncLocalStorage} from 'node:async_hooks';
 import path from 'path';
 import {fileURLToPath} from 'url';
 import {applyTransforms, getSanitizeExtensions, getShortcodeProcessors} from './hooks.js';
@@ -141,6 +142,49 @@ function buildShortcodeFilter(attrs) {
     return filter;
 }
 
+/**
+ * Unsaved block edits for ONE render: the editor previews ask for a page as it
+ * would look with the block they are editing (POST /api/pages/preview/full,
+ * `blocks`). Held in an AsyncLocalStorage, so every place that loads a block -
+ * the short tag, [block], a display's block="…", the footer blocks - sees the
+ * same edit without each call site being handed it, and no other request ever
+ * does. Never used for a cached or public render.
+ */
+const blockOverrides = new AsyncLocalStorage();
+
+/** The longest unsaved template or stylesheet a preview may send (characters), and how many blocks. The request as a whole is still held to Fastify's body limit. */
+export const BLOCK_OVERRIDE_LIMITS = {count: 20, chars: 200_000};
+
+/**
+ * Check a preview's `blocks` map: {name: {content, css}} with plain block names
+ * and strings, within the limits. Returns the clean map, or a message.
+ *
+ * @param {unknown} raw
+ * @returns {{blocks: Map<string, {content: string, css: string}>}|{error: string}}
+ */
+export function readBlockOverrides(raw) {
+    if (raw == null) return {blocks: new Map()};
+    if (typeof raw !== 'object' || Array.isArray(raw)) return {error: 'blocks must be an object'};
+    const entries = Object.entries(raw);
+    if (entries.length > BLOCK_OVERRIDE_LIMITS.count) return {error: `at most ${BLOCK_OVERRIDE_LIMITS.count} blocks`};
+    const blocks = new Map();
+    for (const [name, v] of entries) {
+        if (!/^[a-z0-9][a-z0-9-]*$/.test(name)) return {error: `"${name.slice(0, 40)}" is not a block name`};
+        if (!v || typeof v !== 'object' || typeof v.content !== 'string' || (v.css != null && typeof v.css !== 'string')) {
+            return {error: `blocks.${name} needs content (and css) as text`};
+        }
+        const css = v.css ?? '';
+        if (v.content.length > BLOCK_OVERRIDE_LIMITS.chars || css.length > BLOCK_OVERRIDE_LIMITS.chars) return {error: `blocks.${name} is too large`};
+        blocks.set(name, {content: v.content, css});
+    }
+    return {blocks};
+}
+
+/** Run `fn` with these unsaved blocks in place of the saved ones (an empty map = as saved). */
+export function withBlockOverrides(blocks, fn) {
+    return blocks?.size ? blockOverrides.run(blocks, fn) : fn();
+}
+
 /**
  * Load a block template by name from content/blocks/{name}.html.
  * Throws if the file does not exist.
@@ -164,7 +208,8 @@ function buildShortcodeFilter(attrs) {
  */
 async function loadBlockTemplate(blockName) {
     const safe = path.basename(blockName).replace(/[^a-z0-9-]/g, '');
-    const raw = await readFile(path.join(BLOCKS_DIR, `${safe}.html`), 'utf8');
+    const unsaved = blockOverrides.getStore()?.get(safe);
+    const raw = unsaved ? unsaved.content : await readFile(path.join(BLOCKS_DIR, `${safe}.html`), 'utf8');
     return stripTemplateComments(raw);
 }
 
@@ -191,6 +236,8 @@ export function stripTemplateComments(tpl) {
  */
 async function loadBlockCss(blockName) {
     const safe = path.basename(blockName).replace(/[^a-z0-9-]/g, '');
+    const unsaved = blockOverrides.getStore()?.get(safe);
+    if (unsaved) return unsaved.css;
     try {
         return await readFile(path.join(BLOCKS_DIR, `${safe}.css`), 'utf8');
     } catch {