domma-cms 0.89.0 → 0.90.0

package/admin/js/templates/navigation.html

@@ -1,226 +0,0 @@
-<div class="view-header">
-    <h1><span data-icon="menu"></span> Navigation</h1>
-    <button id="save-nav-btn" class="btn btn-primary"><span data-icon="save"></span> Save</button>
-</div>
-
-<div id="nav-tabs" class="tabs">
-    <div class="tab-list">
-        <button class="tab-item active">Brand</button>
-        <button class="tab-item">Navbar Style</button>
-        <button class="tab-item">Menu</button>
-        <button class="tab-item">Footer</button>
-  </div>
-
-    <div class="tab-panel active" style="padding: 1.5rem;">
-        <div class="row mb-3">
-            <div class="col-4">
-                <label class="form-label">Site Name</label>
-                <input id="field-brand-text" type="text" class="form-input" placeholder="My Site">
-            </div>
-            <div class="col-3">
-                <label class="form-label">Brand URL</label>
-                <input id="field-brand-url" type="text" class="form-input" value="/">
-            </div>
-            <div class="col-3">
-                <label class="form-label">Icon <span class="text-muted" style="font-weight:normal;font-size:.8em;">(optional)</span></label>
-                <input id="field-brand-icon" type="text" class="form-input" placeholder="e.g. star, home">
-            </div>
-            <div class="col-2">
-                <label class="form-label">Variant</label>
-                <select id="field-nav-variant" class="form-select">
-                    <option value="dark">Dark</option>
-                    <option value="light">Light</option>
-                    <option value="transparent">Transparent</option>
-                </select>
-            </div>
-        </div>
-        <div class="row mb-3">
-            <div class="col-4">
-                <label class="form-label">Tagline <span class="text-muted" style="font-weight:normal;font-size:.8em;">(optional)</span></label>
-                <input id="field-brand-tagline" type="text" class="form-input" placeholder="A short strapline">
-            </div>
-            <div class="col-4">
-                <label class="form-label">Logo URL <span class="text-muted" style="font-weight:normal;font-size:.8em;">(optional, overrides icon)</span></label>
-                <input id="field-brand-logo" type="text" class="form-input" placeholder="/content/media/logo.png">
-            </div>
-            <div class="col-2">
-                <label class="form-label">Position</label>
-                <select id="field-nav-position" class="form-select">
-                    <option value="sticky">Sticky</option>
-                    <option value="fixed">Fixed</option>
-                    <option value="static">Static</option>
-                </select>
-            </div>
-            <div class="col-2">
-                <label class="form-label">Brand Size</label>
-                <select id="field-brand-size" class="form-select">
-                    <option value="sm">Small</option>
-                    <option value="md">Medium</option>
-                    <option value="lg">Large</option>
-                </select>
-            </div>
-        </div>
-        <p class="form-hint">Icon uses Domma icon names (e.g. <code>star</code>, <code>home</code>, <code>bolt</code>).
-            Logo URL overrides the icon when set. Leave both blank for text-only brand.</p>
-
-        <hr style="margin: 1.25rem 0; border-color: var(--dm-border, rgba(255,255,255,.1));">
-        <h3 style="font-size:.9rem;font-weight:600;margin-bottom:1rem;opacity:.7;text-transform:uppercase;letter-spacing:.05em;">
-            Admin Panel</h3>
-        <div class="row">
-            <div class="col-4">
-                <label class="form-label">Admin Title</label>
-                <input id="field-admin-brand-title" type="text" class="form-input" placeholder="Domma CMS">
-            </div>
-            <div class="col-3">
-                <label class="form-label">Admin Icon <span class="text-muted"
-                                                           style="font-weight:normal;font-size:.8em;">(optional)</span></label>
-                <input id="field-admin-brand-icon" type="text" class="form-input" placeholder="layout">
-            </div>
-            <div class="col-5">
-                <label class="form-label">Admin Logo URL <span class="text-muted"
-                                                               style="font-weight:normal;font-size:.8em;">(optional, overrides icon)</span></label>
-                <input id="field-admin-brand-logo" type="text" class="form-input" placeholder="/content/media/logo.png">
-            </div>
-    </div>
-    </div>
-
-    <div class="tab-panel" style="padding: 1.5rem;">
-        <div class="row mb-3">
-            <div class="col-5">
-                <label class="form-label">Font Family</label>
-                <select id="field-nav-font-family" class="form-select">
-                    <option value="">Inherit from site</option>
-                    <option value="system-ui">System UI (no web font)</option>
-                    <optgroup label="Sans-serif">
-                        <option value="Roboto">Roboto</option>
-                        <option value="Inter">Inter</option>
-                        <option value="Open Sans">Open Sans</option>
-                        <option value="Lato">Lato</option>
-                        <option value="Nunito">Nunito</option>
-                        <option value="Poppins">Poppins</option>
-                        <option value="Montserrat">Montserrat</option>
-                        <option value="Raleway">Raleway</option>
-                        <option value="Oswald">Oswald</option>
-                        <option value="Ubuntu">Ubuntu</option>
-                        <option value="Mulish">Mulish</option>
-                        <option value="Rubik">Rubik</option>
-                        <option value="DM Sans">DM Sans</option>
-                        <option value="Plus Jakarta Sans">Plus Jakarta Sans</option>
-                        <option value="Outfit">Outfit</option>
-                        <option value="Urbanist">Urbanist</option>
-                        <option value="Manrope">Manrope</option>
-                        <option value="Quicksand">Quicksand</option>
-                        <option value="Source Sans 3">Source Sans 3</option>
-                        <option value="Figtree">Figtree</option>
-                        <option value="Noto Sans">Noto Sans</option>
-                        <option value="Work Sans">Work Sans</option>
-                        <option value="Barlow">Barlow</option>
-                        <option value="IBM Plex Sans">IBM Plex Sans</option>
-                    </optgroup>
-                    <optgroup label="Serif">
-                        <option value="Merriweather">Merriweather</option>
-                        <option value="Playfair Display">Playfair Display</option>
-                        <option value="Lora">Lora</option>
-                        <option value="Cormorant Garamond">Cormorant Garamond</option>
-                        <option value="DM Serif Display">DM Serif Display</option>
-                        <option value="IBM Plex Serif">IBM Plex Serif</option>
-                    </optgroup>
-                    <optgroup label="Monospace">
-                        <option value="Fira Code">Fira Code</option>
-                        <option value="JetBrains Mono">JetBrains Mono</option>
-                        <option value="IBM Plex Mono">IBM Plex Mono</option>
-                    </optgroup>
-                    <optgroup label="Dyslexia-friendly">
-                        <option value="Lexend">Lexend</option>
-                        <option value="Atkinson Hyperlegible">Atkinson Hyperlegible</option>
-                        <option value="Andika">Andika</option>
-                    </optgroup>
-                </select>
-            </div>
-            <div class="col-2">
-                <label class="form-label">Font Size</label>
-                <select id="field-nav-font-size" class="form-select">
-                    <option value="">Default</option>
-                    <option value="12px">12px - XS</option>
-                    <option value="13px">13px - Small</option>
-                    <option value="14px">14px - Compact</option>
-                    <option value="15px">15px</option>
-                    <option value="16px">16px - Base</option>
-                    <option value="17px">17px</option>
-                    <option value="18px">18px - Large</option>
-                    <option value="20px">20px - XL</option>
-                </select>
-            </div>
-            <div class="col-2">
-                <label class="form-label">Font Weight</label>
-                <select id="field-nav-font-weight" class="form-select">
-                    <option value="">Default</option>
-                    <option value="300">Light (300)</option>
-                    <option value="400">Normal (400)</option>
-                    <option value="500">Medium (500)</option>
-                    <option value="600">Semibold (600)</option>
-                    <option value="700">Bold (700)</option>
-                </select>
-            </div>
-            <div class="col-3">
-                <label class="form-label">Letter Spacing</label>
-                <select id="field-nav-letter-spacing" class="form-select">
-                    <option value="">Default</option>
-                    <option value="-0.03em">Tight (−0.03em)</option>
-                    <option value="0em">None (0)</option>
-                    <option value="0.02em">Slightly wide (0.02em)</option>
-                    <option value="0.05em">Wide (0.05em)</option>
-                    <option value="0.1em">Very wide (0.1em)</option>
-                    <option value="0.15em">Spaced (0.15em)</option>
-                </select>
-            </div>
-        </div>
-        <div class="row mb-3">
-            <div class="col-3">
-                <label class="form-label">Icon Size</label>
-                <select id="field-nav-icon-size" class="form-select">
-                    <option value="">Default</option>
-                    <option value="12px">12px - XS</option>
-                    <option value="14px">14px - Small</option>
-                    <option value="16px">16px - Base</option>
-                    <option value="18px">18px</option>
-                    <option value="20px">20px</option>
-                    <option value="22px">22px</option>
-                    <option value="24px">24px - Large</option>
-                    <option value="28px">28px - XL</option>
-                </select>
-            </div>
-        </div>
-        <p class="form-hint">Font is loaded from Google Fonts automatically. Leave all fields at default to inherit the
-            public site font.</p>
-    </div>
-
-    <div class="tab-panel">
-        <div style="display:flex;align-items:center;justify-content:space-between;padding:.75rem 1rem;border-bottom:1px solid var(--dm-border,rgba(255,255,255,.08));">
-            <span class="text-muted" style="font-size:.85rem;">Add and arrange navbar menu items.</span>
-            <button id="add-nav-item" class="btn btn-sm btn-outline"><span data-icon="plus"></span> Add Item</button>
-    </div>
-        <div class="nav-items-header">
-            <span class="nav-col-indent"></span>
-            <span class="nav-col-main text-muted"><small>Label</small></span>
-            <span class="nav-col-main text-muted"><small>URL</small></span>
-            <span class="nav-col-icon text-muted"><small>Icon</small></span>
-            <span class="nav-col-parent text-muted"><small>Parent</small></span>
-            <span class="nav-col-action text-muted"><small>Actions</small></span>
-        </div>
-        <div id="nav-items-list"></div>
-    </div>
-
-    <div class="tab-panel">
-        <div style="display:flex;align-items:center;justify-content:space-between;padding:.75rem 1rem;border-bottom:1px solid var(--dm-border,rgba(255,255,255,.08));">
-            <span class="text-muted" style="font-size:.85rem;">Links shown in the site footer.</span>
-            <button id="add-footer-link" class="btn btn-sm btn-outline"><span data-icon="plus"></span> Add Link</button>
-        </div>
-    <div class="nav-items-header">
-      <span class="nav-col-main text-muted"><small>Label</small></span>
-      <span class="nav-col-main text-muted"><small>URL</small></span>
-      <span class="nav-col-action"></span>
-    </div>
-    <div id="footer-links-list"></div>
-  </div>
-</div>

package/admin/js/views/navigation.js

@@ -1,23 +0,0 @@
-import{api as x}from"../api.js";let I=1;const v=t=>String(t||"").replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;");function S(t){const d=[];return(t||[]).forEach(l=>{const o=I++;d.push({_id:o,text:l.text||"",url:l.url||"",icon:l.icon||"",hidden:l.hidden||!1,bundled:l.bundled||!1,parentId:null}),(l.items||l.children||[]).forEach(a=>{d.push({_id:I++,text:a.text||"",url:a.url||"",icon:a.icon||"",hidden:a.hidden||!1,bundled:a.bundled||!1,parentId:o})})}),d}function F(t){return t.filter(d=>d.parentId===null).map(d=>{const l=t.filter(a=>a.parentId===d._id).map(a=>({text:a.text,url:a.url,...a.icon&&{icon:a.icon},...a.hidden&&{hidden:!0},...a.bundled&&{bundled:!0}})),o={text:d.text,url:d.url,...d.icon&&{icon:d.icon},...d.hidden&&{hidden:!0},...d.bundled&&{bundled:!0}};return l.length&&(o.items=l),o})}function A(t){const d=[];return t.filter(l=>l.parentId===null).forEach(l=>{d.push(l),t.filter(o=>o.parentId===l._id).forEach(o=>d.push(o))}),d}export const navigationView={templateUrl:"/admin/js/templates/navigation.html",async onMount(t){let[d,l]=await Promise.all([x.navigation.get().catch(()=>({brand:{},items:[]})),x.settings.get().catch(()=>({}))]),o=S(d.items),a=(l.footer?.links||[]).map(e=>({text:e.text||"",url:e.url||"",...e.hidden&&{hidden:!0}}));const m=()=>{t.find("#nav-items-list .nav-item-row").each(function(){const i=parseInt($(this).data("id"),10),n=o.find(f=>f._id===i);if(!n)return;n.text=$(this).find(".item-text").val(),n.url=$(this).find(".item-url").val(),n.icon=$(this).find(".item-icon").val(),n.hidden=$(this).find(".btn-toggle-hidden").attr("data-hidden")==="true",n.bundled=$(this).find(".btn-toggle-bundled").attr("data-bundled")==="true";const r=$(this).find(".item-parent").val();n.parentId=r?parseInt(r,10):null});const e=new Set(o.filter(i=>i.parentId!==null).map(i=>i._id));o.forEach(i=>{i.parentId!==null&&e.has(i.parentId)&&(i.parentId=null)})},p=()=>{const e=t.find("#nav-items-list").empty(),i=o.filter(n=>n.parentId===null);A(o).forEach(n=>{const r=n.parentId!==null,f=n.hidden===!0,g='<option value="">- top-level -</option>'+i.filter(c=>c._id!==n._id).map(c=>`<option value="${c._id}"${c._id===n.parentId?" selected":""}>${v(c.text)||"(untitled)"}</option>`).join("");e.append(`
-                    <div class="nav-item-row${r?" nav-item-row--child":""}${f?" nav-item-row--hidden":""}" data-id="${n._id}">
-                        <span class="nav-col-indent">${r?"\u21B3":""}</span>
-                        <input type="text" class="form-input item-text nav-col-main" value="${v(n.text)}" placeholder="Label">
-                        <input type="text" class="form-input item-url nav-col-main" value="${v(n.url)}" placeholder="/url">
-                        <input type="text" class="form-input item-icon nav-col-icon" value="${v(n.icon)}" placeholder="icon">
-                        <select class="form-select item-parent nav-col-parent">${g}</select>
-                        <span class="nav-col-action">
-                            <button class="btn btn-sm btn-ghost btn-toggle-bundled${n.bundled?" active":""}" data-id="${n._id}" data-bundled="${!!n.bundled}" data-tooltip="${n.bundled?"Unbundle":"Bundle (seed on install)"}"><span data-icon="package"></span></button>
-                            <button class="btn btn-sm btn-ghost btn-toggle-hidden${f?" active":""}" data-id="${n._id}" data-hidden="${f}" data-tooltip="${f?"Show":"Hide"}"><span data-icon="eye-off"></span></button>
-                            <button class="btn btn-sm btn-ghost btn-remove-item" data-id="${n._id}" data-tooltip="Remove"><span data-icon="trash"></span></button>
-                        </span>
-                    </div>
-                `)}),Domma.icons.scan("#nav-items-list"),document.querySelectorAll("#nav-items-list [data-tooltip]").forEach(n=>{E.tooltip(n,{content:n.getAttribute("data-tooltip"),position:"top"})})},u=()=>{const e=t.find("#footer-links-list").empty();a.forEach((i,n)=>{const r=i.hidden===!0;e.append(`
-                <div class="nav-item-row${r?" nav-item-row--hidden":""}" data-footer-idx="${n}">
-                    <input type="text" class="form-input footer-link-text nav-col-main" value="${v(i.text)}" placeholder="Label">
-                    <input type="text" class="form-input footer-link-url nav-col-main" value="${v(i.url)}" placeholder="/url">
-                    <span class="nav-col-action">
-                        <button class="btn btn-sm btn-ghost btn-toggle-hidden${r?" active":""}" data-idx="${n}" data-hidden="${r}" data-tooltip="${r?"Show":"Hide"}"><span data-icon="eye-off"></span></button>
-                        <button class="btn btn-sm btn-ghost btn-remove-footer" data-idx="${n}" data-tooltip="Remove"><span data-icon="trash"></span></button>
-                    </span>
-                </div>
-            `)}),Domma.icons.scan("#footer-links-list"),document.querySelectorAll("#footer-links-list [data-tooltip]").forEach(i=>{E.tooltip(i,{content:i.getAttribute("data-tooltip"),position:"top"})})},h=()=>{a=[],t.find("#footer-links-list .nav-item-row").each(function(){const e=$(this).find(".btn-toggle-hidden").attr("data-hidden")==="true",i={text:$(this).find(".footer-link-text").val().trim(),url:$(this).find(".footer-link-url").val().trim()};e&&(i.hidden=!0),a.push(i)})};t.find("#add-footer-link").on("click",()=>{h(),a.push({text:"",url:"",hidden:!1}),u()}),t.off("click",".btn-remove-footer").on("click",".btn-remove-footer",function(){h();const e=parseInt($(this).data("idx"),10);a.splice(e,1),u()}),t.find("#field-brand-text").val(d.brand?.text||""),t.find("#field-brand-url").val(d.brand?.url||"/"),t.find("#field-brand-icon").val(d.brand?.icon||""),t.find("#field-nav-variant").val(d.variant||"dark"),t.find("#field-brand-tagline").val(d.brand?.tagline||""),t.find("#field-brand-logo").val(d.brand?.logo||""),t.find("#field-nav-position").val(d.position||"sticky"),t.find("#field-brand-size").val(d.brand?.size||"md"),t.find("#field-nav-font-family").val(d.style?.fontFamily||""),t.find("#field-nav-font-size").val(d.style?.fontSize||""),t.find("#field-nav-font-weight").val(d.style?.fontWeight||""),t.find("#field-nav-letter-spacing").val(d.style?.letterSpacing||""),t.find("#field-nav-icon-size").val(d.style?.iconSize||""),t.find("#field-admin-brand-title").val(l.adminBrand?.title||""),t.find("#field-admin-brand-icon").val(l.adminBrand?.icon||""),t.find("#field-admin-brand-logo").val(l.adminBrand?.logo||""),p(),u(),E.tabs(t.find("#nav-tabs").get(0)),t.find("#add-nav-item").on("click",()=>{m(),o.push({_id:I++,text:"",url:"",icon:"",hidden:!1,parentId:null}),p()}),t.off("click",".btn-remove-item").on("click",".btn-remove-item",function(){m();const e=parseInt($(this).data("id"),10);o=o.filter(i=>i._id!==e&&i.parentId!==e),p()}),t.off("click","#nav-items-list .btn-toggle-bundled").on("click","#nav-items-list .btn-toggle-bundled",function(e){e.stopPropagation(),m();const i=parseInt($(this).data("id"),10),n=o.find(r=>r._id===i);n&&(n.bundled=!n.bundled),p()}),t.off("click","#nav-items-list .btn-toggle-hidden").on("click","#nav-items-list .btn-toggle-hidden",function(e){e.stopPropagation(),m();const i=parseInt($(this).data("id"),10),n=o.find(r=>r._id===i);n&&(n.hidden=!n.hidden),p()}),t.off("click","#footer-links-list .btn-toggle-hidden").on("click","#footer-links-list .btn-toggle-hidden",function(e){e.stopPropagation(),h();const i=parseInt($(this).data("idx"),10);a[i]&&(a[i].hidden=!a[i].hidden),u()}),t.off("change",".item-parent").on("change",".item-parent",function(){m(),p()}),t.find("#save-nav-btn").on("click",async()=>{m(),h();const e=F(o.map(s=>({...s,text:s.text.trim(),url:s.url.trim(),icon:s.icon.trim()}))).filter(s=>s.text||s.url),i=t.find("#field-brand-icon").val().trim(),n=t.find("#field-brand-tagline").val().trim(),r=t.find("#field-brand-logo").val().trim(),f=t.find("#field-brand-size").val(),g={brand:{text:t.find("#field-brand-text").val().trim(),url:t.find("#field-brand-url").val().trim()||"/",...r&&{logo:r},...i&&!r&&{icon:i},...n&&{tagline:n},...f!=="md"&&{size:f}},items:e,variant:t.find("#field-nav-variant").val(),position:t.find("#field-nav-position").val()||"sticky",style:{...t.find("#field-nav-font-family").val()&&{fontFamily:t.find("#field-nav-font-family").val()},...t.find("#field-nav-font-size").val()&&{fontSize:t.find("#field-nav-font-size").val()},...t.find("#field-nav-font-weight").val()&&{fontWeight:t.find("#field-nav-font-weight").val()},...t.find("#field-nav-letter-spacing").val()&&{letterSpacing:t.find("#field-nav-letter-spacing").val()},...t.find("#field-nav-icon-size").val()&&{iconSize:t.find("#field-nav-icon-size").val()}}},c=a.filter(s=>s.text||s.url);try{await x.navigation.save(g),d=g,o=S(d.items),p(),E.toast("Navigation saved.",{type:"success"})}catch(s){console.error("[navigation] save failed:",s),E.toast("Failed to save navigation.",{type:"error"});return}const y=t.find("#field-admin-brand-logo").val().trim(),k=t.find("#field-admin-brand-icon").val().trim(),_=t.find("#field-admin-brand-title").val().trim(),b={..._&&{title:_},...y&&{logo:y},...!y&&k&&{icon:k}};try{await x.settings.save({adminBrand:b,footer:{links:c}}),l={...l,adminBrand:b},a=c,u();const s=b.title||"CMS Admin",B=b.icon||"layout",w=b.logo||"",z=$("#admin-topbar .topbar-brand");w?z.html(`<img src="${w}" class="topbar-brand-logo" alt="${s}"><span class="topbar-brand-text">${s}</span>`):z.html(`<span data-icon="${B}"></span><span class="topbar-brand-text">${s}</span>`),Domma.icons.scan("#admin-topbar .topbar-brand")}catch(s){console.error("[navigation] admin brand / footer save failed:",s),E.toast(`Admin brand save failed: ${s.message||s}`,{type:"error"})}})}};

package/plugins/seo/CLAUDE.md

@@ -1,48 +0,0 @@
-# SEO (free) - AI Assistant Guide
-
-How the site looks to search engines, and what to fix. Free tier (`make sync-free-tier` ships it with the engine).
-SEO Pro (paid) is an ADD-ON (`requires: ["seo"]`, no supersedes) that plugs in through `server/registry.js`.
-Social (paid, planned) will be its own plugin, sold with SEO Pro.
-
-Needs core 0.89 for: `hooks.registerSitemapSource` / `sitemapChanged`, and the `seo:meta`, `sitemap:entries`,
-`robots:lines` transforms (core `renderer.js` buildSeoMeta/renderSeoTags, `sitemap.js`). On an older engine the plugin
-logs it, the screen says so, and the audit, editor and redirects still work (`hasCore` in plugin.js).
-
-## What it does
-- **Audit** (`server/audit.js`): every sitemap URL (`listSitemapEntries`) plus published pages kept out of it, fetched
-  IN-PROCESS with `fastify.inject` (UA `DommaSEO/1 (audit)`, header `x-domma-seo: audit` - analytics / SEO Pro skip
-  those), judged by `admin/lib/analyse.js` (pure: `scanHtml` regex scanner - no DOM, `analyse`, `siteIssues`, `snippet`).
-  Every `audit.everyHours` (first run 3 min after start if stale), or POST /audit. Kept in `data/audit.json`.
-- **Editor per URL** (GET/PUT /item): a core page is edited IN PLACE (`updatePage(path, {seo})`, empty -> null so core's
-  merge removes the key); anything else (a blog post) gets an override in `data/overrides.json`, applied by the
-  `seo:meta` transform (`admin/lib/schema.js applySeo`). Fields: title, description, image, noindex, focus.
-- **Redirects** (`admin/lib/redirects.js`, pure): exact and "/prefix/*" rules, 301/302/307/308/410, query kept, no
-  loops (checkRule follows the chain), `onMoved` on core's `content:pageRenamed` re-aims older rules (no chains) and
-  drops a rule FROM the new address. Guard = global `onRequest` (fastify-plugin), GET/HEAD, never /api or /admin.
-  Hits counted in memory, saved each minute.
-- **Sitemap/robots**: `sitemap:entries` drops excluded paths, switched-off sources, overridden noindex and redirected
-  addresses; `robots:lines` adds rules (plain rules into the `*` group; `User-agent:` blocks as their own groups) or
-  blocks everything. JSON-LD: Organization/LocalBusiness/Person on `/`, BlogPosting when `page.item.type === 'blog:post'`.
-
-## Data (plugins/seo/data - kept by updates, never bundled)
-`redirects.json`, `overrides.json`, `audit.json` - in memory (the guard and transform run on every request), debounced
-writes, re-read within ~3 s when changed on disk (`server/store.js`).
-
-## Permission
-`seo` (read / manage), granted to admin. Routes: /overview /count /audit (GET, POST) /item (GET, PUT) /redirects
-(GET, POST, PUT/:id, DELETE/:id - ids comma-separated) /redirects/import /redirects/test /sitemap /settings /extensions.
-
-## Extensions (SEO Pro)
-`globalThis[Symbol.for('domma.seo')]` (`server/registry.js`): `register(owner, {label, tabs})`, `on('audit', fn)`,
-`services` {settings, listEntries, auditList, fetchPage, scanHtml, analyse, audit {latest, summary, run},
-redirects {list, match, add}, auditUserAgent}. Tabs: `{key, label, icon, module, help}`; `module` is a
-`/plugins/<slug>/...` URL exporting `mount(root, ctx)` -> dispose; ctx = {kit, api, scope, here, openItem, reload, E, M, I}.
-
-## Admin
-`admin/views/seo.js` + `admin/templates/seo.html` (prefix `sox-`): Pages (the audit + "Across the site"), Redirects,
-Sitemap, extension tabs; page editor slideover (search result + share card previews, meters, checks); settings
-slideover. Rows by index, text through data-bind-text only.
-
-## Tests
-`tests/seo.test.js` (pure). Headless: throwaway CMS from a clean domma-cms worktree with plugins/seo + blog copied in;
-puppeteer-core + ~/.cache/ms-playwright chromium_headless_shell for screenshots.

package/plugins/seo/admin/lib/analyse.js

@@ -1,286 +0,0 @@
-/**
- * SEO - reading a rendered page and judging it. Pure: no DOM, no network, so
- * the server's audit, the admin screen and the tests share it.
- *
- *   scanHtml(html)            -> facts (title, description, headings, images, links, words...)
- *   analyse(facts, opts)      -> {score, checks: [{id, group, status, title, detail, fix}]}
- *   siteIssues(results)       -> duplicates across pages (titles, descriptions)
- *   snippet({title, ...})     -> what a search result would show, cut where Google cuts
- *
- * A status is 'pass' | 'warn' | 'fail' | 'info'. The score counts a pass as
- * 1, a warn as 0.5, a fail as 0, and leaves 'info' out - as Security does.
- *
- * @module seo/admin/lib/analyse
- */
-
-export const LIMITS = {titleMin: 30, titleMax: 60, descMin: 70, descMax: 160, minWords: 300};
-
-const ENTITIES = {amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ', ndash: '–', mdash: '—', hellip: '…',
-    lsquo: '‘', rsquo: '’', ldquo: '“', rdquo: '”', pound: '£', euro: '€', copy: '©'};
-
-/** Undo HTML entities in text. */
-export function decode(s) {
-    return String(s ?? '').replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (m, e) => {
-        if (e[0] === '#') {
-            const n = e[1] === 'x' || e[1] === 'X' ? parseInt(e.slice(2), 16) : parseInt(e.slice(1), 10);
-            return Number.isFinite(n) && n > 0 && n < 0x110000 ? String.fromCodePoint(n) : m;
-        }
-        return ENTITIES[e.toLowerCase()] ?? m;
-    });
-}
-
-const squash = (s) => decode(String(s ?? '').replace(/<[^>]*>/g, ' ')).replace(/\s+/g, ' ').trim();
-
-/** The attributes of one start tag: `<meta name="x" content='y' async>` -> {name, content, async: ''}. */
-export function attrs(tag) {
-    const out = {};
-    const body = String(tag).replace(/^<\s*[a-z0-9-]+/i, '').replace(/\/?>$/, '');
-    const re = /([^\s"'=<>`/]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+)))?/g;
-    let m;
-    while ((m = re.exec(body))) out[m[1].toLowerCase()] = decode(m[2] ?? m[3] ?? m[4] ?? '');
-    return out;
-}
-
-/**
- * The facts of one page, from its HTML. Scripts, styles, templates and
- * comments are removed first, so nothing inside them counts.
- *
- * @param {string} html
- * @returns {object}
- */
-export function scanHtml(html) {
-    const src = String(html ?? '');
-    const headEnd = src.search(/<\/head\s*>/i);
-    const head = headEnd >= 0 ? src.slice(0, headEnd) : src;
-
-    const jsonLdTypes = [];
-    for (const m of src.matchAll(/<script\b[^>]*type\s*=\s*["']?application\/ld\+json["']?[^>]*>([\s\S]*?)<\/script>/gi)) {
-        try {
-            const j = JSON.parse(m[1]);
-            for (const x of [j, ...(Array.isArray(j) ? j : []), ...(Array.isArray(j?.['@graph']) ? j['@graph'] : [])]) {
-                const t = x?.['@type'];
-                if (t) jsonLdTypes.push(...(Array.isArray(t) ? t : [t]).map(String));
-            }
-        } catch { jsonLdTypes.push('(invalid)'); }
-    }
-
-    const clean = src
-        .replace(/<!--[\s\S]*?-->/g, ' ')
-        .replace(/<(script|style|template|noscript|svg)\b[\s\S]*?<\/\1\s*>/gi, ' ');
-
-    const metas = [...head.matchAll(/<meta\b[^>]*>/gi)].map(m => attrs(m[0]));
-    const meta = (key, val) => metas.find(a => (a[key] || '').toLowerCase() === val)?.content;
-    const links = [...head.matchAll(/<link\b[^>]*>/gi)].map(m => attrs(m[0]));
-
-    const bodyStart = clean.search(/<body\b/i);
-    const body = bodyStart >= 0 ? clean.slice(bodyStart) : clean;
-
-    const headings = [...body.matchAll(/<h([1-6])\b[^>]*>([\s\S]*?)<\/h\1\s*>/gi)].map(m => ({level: Number(m[1]), text: squash(m[2])}));
-    const images = [...body.matchAll(/<img\b[^>]*>/gi)].map(m => {
-        const a = attrs(m[0]);
-        return {src: a.src || a['data-src'] || '', alt: 'alt' in a ? a.alt : null, role: a.role || ''};
-    });
-    const anchors = [...body.matchAll(/<a\b([^>]*)>([\s\S]*?)<\/a\s*>/gi)].map(m => {
-        const a = attrs(`<a ${m[1]}>`);
-        return {href: a.href || '', text: squash(m[2]), rel: a.rel || '', title: a.title || ''};
-    });
-    const text = squash(body);
-    const firstPara = squash(body.match(/<p\b[^>]*>([\s\S]*?)<\/p\s*>/i)?.[1] || '');
-
-    return {
-        title: squash(head.match(/<title\b[^>]*>([\s\S]*?)<\/title\s*>/i)?.[1] || ''),
-        description: meta('name', 'description') ?? null,
-        robots: meta('name', 'robots') || '',
-        viewport: Boolean(meta('name', 'viewport')),
-        canonical: links.find(l => (l.rel || '').toLowerCase() === 'canonical')?.href || '',
-        lang: attrs(src.match(/<html\b[^>]*>/i)?.[0] || '<html>').lang || '',
-        og: {
-            title: meta('property', 'og:title') || '',
-            description: meta('property', 'og:description') || '',
-            image: meta('property', 'og:image') || '',
-            type: meta('property', 'og:type') || ''
-        },
-        twitter: {card: meta('name', 'twitter:card') || '', image: meta('name', 'twitter:image') || ''},
-        headings,
-        images,
-        links: anchors,
-        words: text ? text.split(/\s+/).filter(w => /[\p{L}\p{N}]/u.test(w)).length : 0,
-        text: text.slice(0, 20000),
-        firstPara: firstPara.slice(0, 1000),
-        jsonLdTypes: [...new Set(jsonLdTypes)]
-    };
-}
-
-const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
-const has = (hay, needle) => Boolean(needle) && String(hay || '').toLowerCase().includes(needle);
-const slugWords = (s) => String(s || '').toLowerCase().normalize('NFKD').replace(/[̀-ͯ]/g, '').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
-
-/**
- * Judge one page.
- *
- * @param {object} f - scanHtml() facts
- * @param {object} [opts]
- * @param {string} [opts.urlPath]
- * @param {string} [opts.focus] - the focus keyphrase, if one is set
- * @param {object} [opts.limits] - LIMITS overrides
- * @param {string} [opts.origin] - the site's own origin, to tell internal links
- * @returns {{score: number, failing: number, checks: object[]}}
- */
-export function analyse(f, {urlPath = '/', focus = '', limits = {}, origin = ''} = {}) {
-    const L = {...LIMITS, ...limits};
-    const checks = [];
-    const add = (id, group, status, title, detail, fix = '') => checks.push({id, group, status, title, detail, fix});
-    const noindex = /noindex/i.test(f.robots);
-
-    // --- Search result ---
-    const tl = f.title.length;
-    if (!tl) add('title', 'Search result', 'fail', 'Title', 'The page has no title.', 'Give it one: it is the blue link people click in the results.');
-    else if (tl < L.titleMin) add('title', 'Search result', 'warn', 'Title', `${tl} characters - short. Search engines may write their own.`, `Aim for ${L.titleMin}-${L.titleMax} characters that say what the page is about.`);
-    else if (tl > L.titleMax) add('title', 'Search result', 'warn', 'Title', `${tl} characters - it will be cut off after about ${L.titleMax}.`, 'Put the words that matter first, or shorten it.');
-    else add('title', 'Search result', 'pass', 'Title', `${tl} characters.`);
-
-    const d = f.description;
-    const dl = (d || '').length;
-    if (!dl) add('description', 'Search result', 'fail', 'Description', 'No description: search engines pick any sentence from the page.', 'Write one or two sentences that make someone want to click.');
-    else if (dl < L.descMin) add('description', 'Search result', 'warn', 'Description', `${dl} characters - short.`, `Aim for ${L.descMin}-${L.descMax} characters.`);
-    else if (dl > L.descMax) add('description', 'Search result', 'warn', 'Description', `${dl} characters - it will be cut off after about ${L.descMax}.`, 'Shorten it, keeping the point in the first half.');
-    else add('description', 'Search result', 'pass', 'Description', `${dl} characters.`);
-
-    const slug = urlPath.split('/').filter(Boolean).pop() || '';
-    if (urlPath !== '/' && (slug.length > 60 || /[A-Z_ %]/.test(slug) || /\d{5,}/.test(slug))) {
-        add('url', 'Search result', 'warn', 'Address', `"${slug}" is long or hard to read.`, 'Short, lower-case words joined by hyphens read best - rename the page (a redirect is added for you).');
-    } else {
-        add('url', 'Search result', 'pass', 'Address', urlPath === '/' ? 'The home page.' : `"${slug}" reads well.`);
-    }
-
-    // --- Content ---
-    const h1s = f.headings.filter(h => h.level === 1);
-    if (!h1s.length) add('h1', 'Content', 'fail', 'Main heading', 'There is no H1 heading.', 'Start the page with one main heading (# in Markdown) saying what it is about.');
-    else if (h1s.length > 1) add('h1', 'Content', 'warn', 'Main heading', `${h1s.length} H1 headings: "${h1s.slice(0, 3).map(h => h.text).join('", "')}".`, 'Keep one H1; make the others H2.');
-    else if (!h1s[0].text) add('h1', 'Content', 'warn', 'Main heading', 'The H1 heading is empty.', 'Give it words.');
-    else add('h1', 'Content', 'pass', 'Main heading', `"${h1s[0].text.slice(0, 80)}".`);
-
-    const skips = [];
-    for (let i = 1; i < f.headings.length; i++) {
-        if (f.headings[i].level > f.headings[i - 1].level + 1) skips.push(`H${f.headings[i - 1].level} → H${f.headings[i].level}`);
-    }
-    if (skips.length) add('headings', 'Content', 'warn', 'Heading order', `Levels are skipped: ${[...new Set(skips)].slice(0, 3).join(', ')}.`, 'Go down one level at a time (H2, then H3) - screen readers and search engines read them as an outline.');
-    else if (f.headings.length > 1) add('headings', 'Content', 'pass', 'Heading order', `${plural(f.headings.length, 'heading')}, in order.`);
-
-    if (f.words < Math.round(L.minWords / 3)) add('words', 'Content', 'warn', 'Length', `${plural(f.words, 'word')}. Very little for a search engine to go on.`, `Pages that rank usually have ${L.minWords}+ words - unless the page is a form or a contact page.`);
-    else if (f.words < L.minWords) add('words', 'Content', 'info', 'Length', `${plural(f.words, 'word')}.`, `Pages that rank usually have ${L.minWords}+ words.`);
-    else add('words', 'Content', 'pass', 'Length', `${f.words.toLocaleString('en-GB')} words.`);
-
-    const content = f.images.filter(i => i.role !== 'presentation');
-    const noAlt = content.filter(i => i.alt === null);
-    if (noAlt.length) add('alt', 'Content', 'fail', 'Image descriptions', `${plural(noAlt.length, 'image')} of ${content.length} ${noAlt.length === 1 ? 'has' : 'have'} no alt text.`, 'Describe each image in a few words (empty alt="" only for decoration). It is how search and screen readers see them.');
-    else if (content.length) add('alt', 'Content', 'pass', 'Image descriptions', `All ${plural(content.length, 'image')} described.`);
-
-    const internal = f.links.filter(l => isInternal(l.href, origin));
-    if (!internal.length && f.links.length < 50) add('links', 'Content', 'warn', 'Links to your other pages', 'None in the page itself.', 'Link to related pages: it helps visitors, and search engines find pages through links.');
-    else add('links', 'Content', 'pass', 'Links to your other pages', `${plural(internal.length, 'link')}.`);
-
-    // --- Focus keyphrase ---
-    const k = String(focus || '').trim().toLowerCase();
-    if (k) {
-        const where = [
-            ['title', has(f.title, k)],
-            ['description', has(d, k)],
-            ['main heading', h1s.some(h => has(h.text, k))],
-            ['address', slugWords(urlPath).includes(slugWords(k))],
-            ['first paragraph', has(f.firstPara, k)]
-        ];
-        const missing = where.filter(([, ok]) => !ok).map(([w]) => w);
-        const count = countPhrase(f.text, k);
-        const density = f.words ? (count * k.split(/\s+/).length * 100) / f.words : 0;
-        if (missing.length >= 3) add('focus', 'Keyphrase', 'fail', `"${focus}"`, `Missing from the ${missing.join(', ')}.`, 'Use the phrase people search for where they look first: the title, the heading and the opening.');
-        else if (missing.length) add('focus', 'Keyphrase', 'warn', `"${focus}"`, `Missing from the ${missing.join(', ')}.`, 'Work it in naturally - never at the cost of reading well.');
-        else add('focus', 'Keyphrase', 'pass', `"${focus}"`, 'In the title, description, heading, address and opening.');
-        if (f.words < 100) { /* too short for a share of the words to mean anything */ }
-        else if (density > 3) add('density', 'Keyphrase', 'warn', 'Repetition', `The phrase is ${density.toFixed(1)}% of the words (${plural(count, 'time')}).`, 'Over about 3% reads as stuffing - use other words for the same thing.');
-        else if (count) add('density', 'Keyphrase', 'pass', 'Repetition', `Used ${plural(count, 'time')} (${density.toFixed(1)}%).`);
-    } else {
-        add('focus', 'Keyphrase', 'info', 'Focus keyphrase', 'None set.', 'Say which search this page should be found for, and the checks will look for it.');
-    }
-
-    // --- Sharing and technical ---
-    if (noindex) add('index', 'Technical', 'info', 'Search engines', 'Hidden from search engines (noindex).', 'On purpose for thank-you pages and the like; otherwise switch it off.');
-    else add('index', 'Technical', 'pass', 'Search engines', 'May be indexed.');
-    if (!f.canonical) add('canonical', 'Technical', 'warn', 'Canonical address', 'No canonical link.', 'Set the site address in Settings so every page names its one true address.');
-    else if (!f.canonical.replace(/\/$/, '').endsWith(urlPath === '/' ? '' : urlPath)) add('canonical', 'Technical', 'info', 'Canonical address', `Points elsewhere: ${f.canonical}.`, 'Right when this page is a copy of that one; otherwise it hides this page.');
-    else add('canonical', 'Technical', 'pass', 'Canonical address', f.canonical);
-    if (!f.og.image) add('share-image', 'Sharing', 'warn', 'Share image', 'No image when the page is shared.', 'Choose an image (1200 × 630 is ideal), or set a default one for the site.');
-    else add('share-image', 'Sharing', 'pass', 'Share image', f.og.image);
-    if (f.jsonLdTypes.includes('(invalid)')) add('schema', 'Technical', 'fail', 'Structured data', 'A JSON-LD block is not valid JSON.', 'Fix or remove it - search engines ignore the lot.');
-    else if (f.jsonLdTypes.length) add('schema', 'Technical', 'pass', 'Structured data', f.jsonLdTypes.join(', '));
-    else add('schema', 'Technical', 'info', 'Structured data', 'None.', 'Structured data lets search engines show rich results.');
-    if (!f.lang) add('lang', 'Technical', 'warn', 'Language', 'The page does not say what language it is in.', 'The site template sets <html lang="…">.');
-
-    return {...score(checks), checks};
-}
-
-function isInternal(href, origin) {
-    const h = String(href || '').trim();
-    if (!h || h.startsWith('#') || /^(mailto|tel|javascript|data):/i.test(h)) return false;
-    if (h.startsWith('/') && !h.startsWith('//')) return true;
-    if (!origin) return false;
-    try { return new URL(h).origin === new URL(origin).origin; } catch { return false; }
-}
-
-function countPhrase(text, phrase) {
-    if (!phrase) return 0;
-    const esc = phrase.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/\s+/g, '\\s+');
-    return (String(text).match(new RegExp(`(^|[^\\p{L}\\p{N}])${esc}(?=$|[^\\p{L}\\p{N}])`, 'giu')) || []).length;
-}
-
-/** Score and failing count of a list of checks. */
-export function score(checks) {
-    const counted = checks.filter(c => c.status !== 'info');
-    const got = counted.reduce((n, c) => n + (c.status === 'pass' ? 1 : c.status === 'warn' ? 0.5 : 0), 0);
-    return {
-        score: counted.length ? Math.round((got / counted.length) * 100) : 100,
-        failing: checks.filter(c => c.status === 'fail').length,
-        warnings: checks.filter(c => c.status === 'warn').length
-    };
-}
-
-/**
- * Problems only visible across pages: the same title or description on more
- * than one. `results` are audit rows `{urlPath, title, description, noindex}`.
- *
- * @returns {{duplicateTitles: Array<{text, paths}>, duplicateDescriptions: Array<{text, paths}>}}
- */
-export function siteIssues(results) {
-    const dupes = (key) => {
-        const by = new Map();
-        for (const r of results) {
-            const v = String(r[key] || '').trim().toLowerCase();
-            if (!v || r.noindex || r.error) continue;
-            if (!by.has(v)) by.set(v, {text: r[key], paths: []});
-            by.get(v).paths.push(r.urlPath);
-        }
-        return [...by.values()].filter(x => x.paths.length > 1).sort((a, b) => b.paths.length - a.paths.length);
-    };
-    return {duplicateTitles: dupes('title'), duplicateDescriptions: dupes('description')};
-}
-
-/**
- * A search result as Google would show it, cut where it cuts (roughly: it
- * measures pixels; characters are close enough to show the problem).
- */
-export function snippet({title = '', description = '', url = '', limits = {}} = {}) {
-    const L = {...LIMITS, ...limits};
-    const cut = (s, n) => (s.length > n ? `${s.slice(0, n - 1).replace(/\s+\S*$/, '')} …` : s);
-    let crumbs = url;
-    try {
-        const u = new URL(url);
-        crumbs = [u.hostname, ...u.pathname.split('/').filter(Boolean)].join(' › ');
-    } catch { /* a path */ }
-    return {
-        title: cut(String(title), L.titleMax),
-        description: cut(String(description), L.descMax),
-        crumbs,
-        titleCut: String(title).length > L.titleMax,
-        descriptionCut: String(description).length > L.descMax
-    };
-}