domma-cms 0.93.0 → 0.94.0

package/admin/js/templates/pro-docs.html

@@ -1,259 +1,78 @@
 <div class="view-header">
   <h1><span data-icon="zap"></span> Pro Documentation</h1>
+  <a href="#/documentation" class="btn btn-ghost btn-sm"><span data-icon="arrow-left"></span> All usage topics</a>
 </div>
 
 <div class="tabs" id="pro-docs-tabs">
   <div class="tab-list">
-    <button class="tab-item active">Views</button>
+    <button class="tab-item active">What needs Pro</button>
+    <button class="tab-item">Views</button>
     <button class="tab-item">Actions</button>
-    <button class="tab-item">CTA Shortcode</button>
   </div>
+
   <div class="tab-content">
 
-    <!-- ── Views tab ─────────────────────────────────────── -->
+    <!-- What needs Pro -->
     <div class="tab-panel active">
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="eye"></span> What is a View?</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <p>A <strong>View</strong> is a saved MongoDB aggregation pipeline that runs against a collection and returns shaped results. Views are created under <strong>Data → Views</strong> and exposed via a REST endpoint that respects role-level and row-level access.</p>
-          <p>Views require a MongoDB connection configured in <code>config/connections.json</code>.</p>
-        </div>
-      </div>
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="layers"></span> Allowed Pipeline Stages</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
+      <div class="card mb-4">
         <div class="card-body docs-body">
-          <table class="table table-sm">
-            <thead><tr><th>Stage</th><th>Purpose</th></tr></thead>
-            <tbody>
-              <tr><td><code>$match</code></td><td>Filter documents by field values</td></tr>
-              <tr><td><code>$sort</code></td><td>Order results</td></tr>
-              <tr><td><code>$project</code></td><td>Include, exclude, or rename fields</td></tr>
-              <tr><td><code>$lookup</code></td><td>Join from another collection</td></tr>
-              <tr><td><code>$unwind</code></td><td>Flatten an array field</td></tr>
-              <tr><td><code>$addFields</code></td><td>Compute new fields</td></tr>
-              <tr><td><code>$group</code></td><td>Aggregate (count, sum, etc.)</td></tr>
-              <tr><td><code>$limit</code></td><td>Cap results</td></tr>
-              <tr><td><code>$skip</code></td><td>Skip N results</td></tr>
-              <tr><td><code>$count</code></td><td>Return a document count</td></tr>
-            </tbody>
-          </table>
-          <p class="text-muted" style="margin-top:.75rem;">Blocked: <code>$out</code>, <code>$merge</code>, <code>$function</code>, <code>$accumulator</code>, <code>$graphLookup</code></p>
-          <p>Collections are prefixed <code>cms_</code> in MongoDB - use this prefix in <code>$lookup</code> <code>from</code> values.</p>
+          <p>Pro, for the data features, means one thing: a working <strong>MongoDB connection</strong>
+            (the <strong>Database connections</strong> tab on Data &gt; Collections, stored in <code>config/connections.json</code>). With one, a site gets:</p>
+          <ul>
+            <li><strong>Actions</strong> - workflow buttons, transitions and <code>[cta]</code>. Without MongoDB,
+              Data &gt; Actions says so and nothing can be run.</li>
+            <li><strong>MongoDB storage</strong> for any collection, chosen on its Storage tab. Moving a collection
+              either way keeps every entry's id.</li>
+            <li><strong>Notes and Todo on MongoDB</strong>, as their collections declare. A site whose files
+              still hold notes or to-dos stays on files until the Storage move settles it.</li>
+          </ul>
+          <p>Everything else works without it: collections on files, <strong>Views</strong> (a built-in
+            evaluator runs the same pipeline stages), forms, <code>[collection]</code> and <code>[view]</code>
+            displays, the Collection Browser, the API and API Builder.</p>
+          <p>Pro plugins (SEO Pro, Analytics Pro, Security Pro, Blog Pro and others) are a separate matter: they come
+            from the Marketplace with a licence. See <a href="#/docs/usage/editions">Editions &amp; Licences</a> and
+            <a href="#/docs/plugins">Plugin guides</a>.</p>
         </div>
       </div>
+    </div>
 
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="code"></span> Example Pipeline</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <p>Match active entries and count related submissions:</p>
-          <pre class="code-block"><code>[
-  { "$match": { "data.isActive": true } },
-  {
-    "$lookup": {
-      "from": "cms_feedback",
-      "localField": "_id",
-      "foreignField": "data.userId",
-      "as": "submissions"
-    }
-  },
-  { "$addFields": { "submissionCount": { "$size": "$submissions" } } },
-  { "$project": { "data.name": 1, "data.email": 1, "submissionCount": 1 } },
-  { "$sort": { "submissionCount": -1 } }
-]</code></pre>
-        </div>
-      </div>
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="lock"></span> Access Control</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <table class="table table-sm">
-            <thead><tr><th>Setting</th><th>Description</th></tr></thead>
-            <tbody>
-              <tr><td>Allowed Roles</td><td>Which roles can call <code>GET /api/views/:slug/public</code></td></tr>
-              <tr><td>Public</td><td>No authentication required when checked</td></tr>
-              <tr><td>Row-Level - Owner</td><td>User sees only entries they created</td></tr>
-              <tr><td>Row-Level - Field Match</td><td>A specified entry field must match a user property</td></tr>
-            </tbody>
-          </table>
-        </div>
-      </div>
-
-    </div><!-- /Views tab -->
-
-    <!-- ── Actions tab ───────────────────────────────────── -->
+    <!-- Views -->
     <div class="tab-panel">
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="zap"></span> What is an Action?</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <p>An <strong>Action</strong> is a named sequence of steps that runs against a single collection entry. Actions are defined under <strong>Data → Actions</strong> and can be triggered from the entry list or via the <code>[cta]</code> shortcode on any public page.</p>
-          <p>Actions require a MongoDB connection configured in <code>config/connections.json</code>.</p>
-          <p>Steps run in order. If a step fails, execution stops and a partial result is returned with a <code>stepsCompleted</code> count.</p>
-        </div>
-      </div>
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="list"></span> Step Types</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
+      <div class="card mb-4">
         <div class="card-body docs-body">
-          <table class="table table-sm">
-            <thead><tr><th>Type</th><th>What it does</th></tr></thead>
-            <tbody>
-              <tr><td><code>updateField</code></td><td>Sets a field on the entry to a new value</td></tr>
-              <tr><td><code>deleteEntry</code></td><td>Permanently deletes the target entry</td></tr>
-              <tr><td><code>moveToCollection</code></td><td>Moves the entry to a different collection</td></tr>
-              <tr><td><code>webhook</code></td><td>POSTs entry data to an external URL</td></tr>
-              <tr><td><code>email</code></td><td>Sends an email via the configured SMTP server</td></tr>
-            </tbody>
-          </table>
+          <p>A <strong>View</strong> is a saved pipeline over a collection (<code>$match</code>,
+            <code>$lookup</code>, <code>$sort</code>, <code>$project</code>, <code>$unwind</code>,
+            <code>$addFields</code>, <code>$group</code>, <code>$count</code>, <code>$skip</code>,
+            <code>$limit</code>). Views do <strong>not</strong> need MongoDB: a MongoDB collection runs a native
+            aggregation, any other runs the built-in evaluator.</p>
+          <p>Who may read a view is set on its Access tab: public, any listed role and everyone more senior, or -
+            with no roles - the admin tier. A row-level rule (Owner or Field match) shows each user only their
+            results.</p>
+          <p>Full guide: <a href="#/docs/usage/views">Views</a> and the <a href="#/docs/api/views">Views API</a>.</p>
         </div>
       </div>
+    </div>
 
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="tag"></span> Template Variables</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <p>All step field values support <code>&#123;&#123;...&#125;&#125;</code> interpolation:</p>
-          <table class="table table-sm">
-            <thead><tr><th>Variable</th><th>Value</th></tr></thead>
-            <tbody>
-              <tr><td><code>&#123;&#123;entry.data.fieldName&#125;&#125;</code></td><td>Any field from the target entry</td></tr>
-              <tr><td><code>&#123;&#123;entry.id&#125;&#125;</code></td><td>The entry's UUID</td></tr>
-              <tr><td><code>&#123;&#123;now&#125;&#125;</code></td><td>Current ISO 8601 timestamp</td></tr>
-              <tr><td><code>&#123;&#123;user.name&#125;&#125;</code></td><td>Name of the triggering user</td></tr>
-              <tr><td><code>&#123;&#123;user.email&#125;&#125;</code></td><td>Email of the triggering user</td></tr>
-              <tr><td><code>&#123;&#123;user.id&#125;&#125;</code></td><td>UUID of the triggering user</td></tr>
-              <tr><td><code>&#123;&#123;env.CMS_PUBLIC_*&#125;&#125;</code></td><td>Public environment variables</td></tr>
-            </tbody>
-          </table>
-        </div>
-      </div>
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="code"></span> Step Examples</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <p><strong>updateField</strong> - mark an entry as approved:</p>
-          <pre class="code-block"><code>{ "field": "status", "value": "approved" }</code></pre>
-          <p><strong>webhook</strong> - notify an external service:</p>
-          <pre class="code-block"><code>{
-  "url": "https://hooks.example.com/notify",
-  "headers": { "X-Secret": "{{env.CMS_PUBLIC_HOOK_SECRET}}" }
-}</code></pre>
-          <p><strong>email</strong> - send confirmation to applicant:</p>
-          <pre class="code-block"><code>{
-  "to": "{{entry.data.email}}",
-  "subject": "Your application was approved",
-  "body": "Hi {{entry.data.name}}, your application has been approved."
-}</code></pre>
-        </div>
-      </div>
-
-    </div><!-- /Actions tab -->
-
-    <!-- ── CTA Shortcode tab ──────────────────────────────── -->
+    <!-- Actions -->
     <div class="tab-panel">
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="mouse-pointer"></span> What is the CTA shortcode?</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <p>The <code>[cta]</code> shortcode places an action-trigger button in any public page. Clicking it calls <code>POST /api/actions/:slug/public</code> with the entry ID, using the logged-in user's JWT.</p>
-          <p>If the user is not logged in, a warning toast is shown instead.</p>
-        </div>
-      </div>
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="code"></span> Syntax &amp; Attributes</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <p><strong>Wrapping form:</strong></p>
-          <pre class="code-block"><code>[cta action="slug" entry="entry-id" icon="check" confirm="Are you sure?"]Button label[/cta]</code></pre>
-          <p><strong>Self-closing form:</strong></p>
-          <pre class="code-block"><code>[cta action="slug" entry="entry-id" label="Button label" /]</code></pre>
-          <table class="table table-sm" style="margin-top:1rem;">
-            <thead><tr><th>Attribute</th><th>Required</th><th>Default</th><th>Description</th></tr></thead>
-            <tbody>
-              <tr><td><code>action</code></td><td>Yes</td><td>-</td><td>Action slug</td></tr>
-              <tr><td><code>entry</code></td><td>Yes</td><td>-</td><td>Entry UUID to act on</td></tr>
-              <tr><td><code>label</code></td><td>No</td><td><code>"Run"</code></td><td>Button text (self-closing only)</td></tr>
-              <tr><td><code>style</code></td><td>No</td><td><code>"primary"</code></td><td>primary · secondary · ghost · danger</td></tr>
-              <tr><td><code>icon</code></td><td>No</td><td>-</td><td>Domma icon name</td></tr>
-              <tr><td><code>size</code></td><td>No</td><td>-</td><td>sm · md · lg</td></tr>
-              <tr><td><code>confirm</code></td><td>No</td><td>-</td><td>Confirmation prompt before executing</td></tr>
-            </tbody>
-          </table>
-        </div>
-      </div>
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="grid"></span> Collection Integration</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
-        <div class="card-body docs-body">
-          <p>Add per-entry buttons to any <code>[collection]</code> shortcode:</p>
-          <pre class="code-block"><code>[collection slug="applications" display="cards" title-field="name"
-  cta="approve-application"
-  cta-label="Approve"
-  cta-icon="check"
-  cta-style="primary"
-  cta-confirm="Approve this application?" /]</code></pre>
-          <table class="table table-sm" style="margin-top:1rem;">
-            <thead><tr><th>Attribute</th><th>Default</th><th>Description</th></tr></thead>
-            <tbody>
-              <tr><td><code>cta</code></td><td>-</td><td>Action slug - enables per-entry buttons</td></tr>
-              <tr><td><code>cta-label</code></td><td><code>"Run"</code></td><td>Button label</td></tr>
-              <tr><td><code>cta-icon</code></td><td>-</td><td>Domma icon name</td></tr>
-              <tr><td><code>cta-style</code></td><td><code>"primary"</code></td><td>Button variant</td></tr>
-              <tr><td><code>cta-confirm</code></td><td>-</td><td>Confirmation prompt</td></tr>
-            </tbody>
-          </table>
-          <p>All three display modes support CTA buttons: <strong>cards</strong> (card footer), <strong>list</strong> (inline), <strong>table</strong> (dedicated column).</p>
-        </div>
-      </div>
-
-      <div class="card card-collapsible mb-4">
-        <div class="card-header" role="button" tabindex="0">
-          <div class="card-header-content"><h2><span data-icon="book-open"></span> Full Reference</h2></div>
-          <span class="card-collapse-icon" data-icon="chevron-down"></span>
-        </div>
+      <div class="card mb-4">
         <div class="card-body docs-body">
-          <p>See the public documentation for live examples and the complete attribute reference:</p>
-          <a href="/resources/pro/cta" target="_blank" class="btn btn-ghost btn-sm">
-            <span data-icon="external-link"></span> CTA Shortcode Reference
-          </a>
+          <p>An <strong>Action</strong> is a named sequence of steps (update a field, delete, move to or create in
+            another collection, webhook, email, notify) run against one entry. Actions need MongoDB.</p>
+          <ul>
+            <li>Any role the action lists is enough to run it, and everyone more senior. No roles means admins
+              only; a role the site does not have admits only the level-0 role.</li>
+            <li>A transition makes the action a workflow step, offered only in the states it starts from. An
+              interactive <code>[collection ... transitions]</code> shows the buttons that apply to each row,
+              including on a <code>scope="mine"</code> block. A move that no longer applies is refused with 409.</li>
+            <li>Steps are not rolled back if a later one fails - put deletes and emails last.</li>
+          </ul>
+          <p>Full guides: <a href="#/docs/usage/actions">Actions</a>,
+            <a href="#/docs/usage/cta-shortcode">CTA Shortcode</a> and the
+            <a href="#/docs/api/actions">Actions API</a>.</p>
         </div>
       </div>
+    </div>
 
-    </div><!-- /CTA tab -->
-
-  </div><!-- .tab-content -->
-</div><!-- .tabs -->
+  </div>
+</div>

package/admin/js/templates/tutorials.html

@@ -28,8 +28,8 @@
           <div class="card-body">
             <h3 style="margin-top:0;"><span data-icon="package"></span> Writing a Plugin</h3>
             <p class="text-muted" style="margin-bottom:0;">
-              Extend the CMS with your own server routes, admin pages and page-injection snippets.
-              The three required files, the Fastify entry point, and how to register and test.
+              Extend the CMS with your own server routes, admin pages and page-injection snippets:
+              the manifest, the Fastify entry point, switching it on and testing it.
             </p>
           </div>
         </a>
@@ -50,8 +50,9 @@
 
       <p class="text-muted" style="font-size:.9rem;">
         Looking for reusable custom elements? See <a href="#/docs/components">Documentation → Components</a>.
-        For task-by-task usage, see <a href="#/documentation">Usage</a>; for the REST surface, see
-        <a href="#/api-reference">API Reference</a>.
+        For task-by-task usage, see <a href="#/documentation">Documentation</a>; for the REST surface, see
+        <a href="#/api-reference">API Reference</a>; for installed Marketplace plugins, see
+        <a href="#/docs/plugins">Plugin guides</a>.
       </p>
 
     </div>

package/admin/js/views/doc-pages.js

@@ -1 +1 @@
-import{mountScaffolder as i}from"../lib/crud-tutorial.js";function t(o,n){return{templateUrl:`/admin/js/templates/docs/${o}.html`,async onMount(e){typeof n=="function"&&n(e),Domma.icons.scan(),Domma.syntax.scan()}}}export const docViews={tutorialCrud:t("tutorial-crud",o=>{const n=o.find("#tutorial-scaffolder-mount").get(0);n&&i(n,null,null)}),tutorialPlugin:t("tutorial-plugin"),tutorialForms:t("tutorial-forms"),componentsReference:t("components-reference"),componentsHowto:t("components-howto"),componentsWalkthrough:t("components-walkthrough"),componentsRules:t("components-rules")};const a=["pages","media","navigation","dconfig","shortcodes","site-settings","plugins","users-roles","views","actions","cta-shortcode"],c=["authentication","pages","settings","layouts","navigation","media","users","plugins","collections","views","actions"],s=o=>o.split("-").map(n=>n.charAt(0).toUpperCase()+n.slice(1)).join("");for(const o of a)docViews["usage"+s(o)]=t(`usage-${o}`);for(const o of c)docViews["apiRef"+s(o)]=t(`api-${o}`);
+import{mountScaffolder as i}from"../lib/crud-tutorial.js";function t(o,s){return{templateUrl:`/admin/js/templates/docs/${o}.html`,async onMount(e){typeof s=="function"&&s(e),Domma.icons.scan(),Domma.syntax.scan()}}}export const docViews={tutorialCrud:t("tutorial-crud",o=>{const s=o.find("#tutorial-scaffolder-mount").get(0);s&&i(s,null,null)}),tutorialPlugin:t("tutorial-plugin"),tutorialForms:t("tutorial-forms"),componentsReference:t("components-reference"),componentsHowto:t("components-howto"),componentsWalkthrough:t("components-walkthrough"),componentsRules:t("components-rules")};const a=["pages","media","navigation","dconfig","shortcodes","site-settings","plugins","users-roles","views","actions","cta-shortcode","editions","collections","tools"],c=["authentication","pages","settings","layouts","navigation","media","users","plugins","collections","views","actions","forms","scaffold","external","builder"],n=o=>o.split("-").map(s=>s.charAt(0).toUpperCase()+s.slice(1)).join("");for(const o of a)docViews["usage"+n(o)]=t(`usage-${o}`);for(const o of c)docViews["apiRef"+n(o)]=t(`api-${o}`);

package/admin/js/views/index.js

@@ -1 +1 @@
-import{dashboardView as o}from"./dashboard.js";import{pagesView as i}from"./pages.js";import{pageEditorView as r}from"./page-editor.js";import{settingsView as t}from"./settings.js";import{themeView as e}from"./theme.js";import{notificationsView as m}from"./notifications.js";import{layoutsView as p}from"./layouts.js";import{mediaView as s}from"./media.js";import{loginView as n}from"./login.js";import{usersView as f}from"./users.js";import{userEditorView as w}from"./user-editor.js";import{pluginsView as c}from"./plugins.js";import{pluginCodeView as V}from"./plugin-code.js";import{documentationView as a}from"./documentation.js";import{tutorialsView as d}from"./tutorials.js";import{docViews as l}from"./doc-pages.js";import{apiReferenceView as u}from"./api-reference.js";import{collectionsView as E}from"./collections.js";import{collectionEditorView as g}from"./collection-editor.js";import{collectionEntriesView as v}from"./collection-entries.js";import{formsView as b}from"./forms.js";import{formEditorView as h}from"./form-editor.js";import{formSubmissionsView as y}from"./form-submissions.js";import{viewsListView as j}from"./views-list.js";import{viewEditorView as k}from"./view-editor.js";import{viewPreviewView as L}from"./view-preview.js";import{actionsListView as x}from"./actions-list.js";import{actionEditorView as M}from"./action-editor.js";import{proDocsView as D}from"./pro-docs.js";import{blocksView as P}from"./blocks.js";import{blockEditorView as R}from"./block-editor.js";import{componentsView as S}from"./components.js";import{componentEditorView as C}from"./component-editor.js";import{myProfileView as T}from"./my-profile.js";import{rolesView as U}from"./roles.js";import{roleEditorView as q}from"./role-editor.js";import{effectsView as z}from"./effects.js";import{searchView as A}from"./search.js";import{notesView as B}from"./notes.js";import{todoView as F}from"./todo.js";import{analyticsView as G}from"./analytics.js";import{seoView as H}from"./seo.js";import{contactsView as I}from"./contacts.js";import{menusView as J}from"./menus.js";import{contextMenusView as K}from"./context-menus.js";import{contextMenuEditorView as N}from"./context-menu-editor.js";import{menuEditorView as O}from"./menu-editor.js";import{menuLocationsView as Q}from"./menu-locations.js";import{projectsView as W}from"./projects.js";import{projectDetailView as X}from"./project-detail.js";import{projectSettingsView as Y}from"./project-settings.js";import{apiTokensView as Z}from"./api-tokens.js";import{apiEndpointsView as _}from"./api-endpoints.js";import{apiEndpointEditorView as $}from"./api-endpoint-editor.js";const oo={templateUrl:"",async onMount(){location.hash="#/menus"}};export const views={projects:W,projectDetail:X,projectSettings:Y,apiTokens:Z,apiEndpoints:_,apiEndpointEditor:$,dashboard:o,pages:i,pageEditor:r,settings:t,theme:e,layouts:p,media:s,login:n,users:f,userEditor:w,plugins:c,pluginCode:V,documentation:a,tutorials:d,apiReference:u,collections:E,collectionEditor:g,collectionEntries:v,forms:b,formEditor:h,formSubmissions:y,viewsList:j,viewEditor:k,viewPreview:L,actionsList:x,actionEditor:M,proDocs:D,blocks:P,blockEditor:R,components:S,componentEditor:C,myProfile:T,roles:U,roleEditor:q,effects:z,search:A,notes:B,todo:F,analytics:G,seo:H,contacts:I,notifications:m,menus:J,contextMenus:K,contextMenuEditor:N,menuEditor:O,menuLocations:Q,menusRedirect:oo,...l};
+import{dashboardView as o}from"./dashboard.js";import{pagesView as i}from"./pages.js";import{pageEditorView as r}from"./page-editor.js";import{settingsView as t}from"./settings.js";import{themeView as e}from"./theme.js";import{notificationsView as m}from"./notifications.js";import{layoutsView as p}from"./layouts.js";import{mediaView as n}from"./media.js";import{loginView as s}from"./login.js";import{usersView as f}from"./users.js";import{userEditorView as w}from"./user-editor.js";import{pluginsView as c}from"./plugins.js";import{pluginCodeView as V}from"./plugin-code.js";import{documentationView as d}from"./documentation.js";import{tutorialsView as a}from"./tutorials.js";import{docViews as l}from"./doc-pages.js";import{pluginGuidesView as u,pluginGuideView as E}from"./plugin-guides.js";import{apiReferenceView as g}from"./api-reference.js";import{collectionsView as v}from"./collections.js";import{collectionEditorView as b}from"./collection-editor.js";import{collectionEntriesView as h}from"./collection-entries.js";import{formsView as y}from"./forms.js";import{formEditorView as j}from"./form-editor.js";import{formSubmissionsView as k}from"./form-submissions.js";import{viewsListView as L}from"./views-list.js";import{viewEditorView as x}from"./view-editor.js";import{viewPreviewView as M}from"./view-preview.js";import{actionsListView as D}from"./actions-list.js";import{actionEditorView as G}from"./action-editor.js";import{proDocsView as P}from"./pro-docs.js";import{blocksView as R}from"./blocks.js";import{blockEditorView as S}from"./block-editor.js";import{componentsView as C}from"./components.js";import{componentEditorView as T}from"./component-editor.js";import{myProfileView as U}from"./my-profile.js";import{rolesView as q}from"./roles.js";import{roleEditorView as z}from"./role-editor.js";import{effectsView as A}from"./effects.js";import{searchView as B}from"./search.js";import{notesView as F}from"./notes.js";import{todoView as H}from"./todo.js";import{analyticsView as I}from"./analytics.js";import{seoView as J}from"./seo.js";import{contactsView as K}from"./contacts.js";import{menusView as N}from"./menus.js";import{contextMenusView as O}from"./context-menus.js";import{contextMenuEditorView as Q}from"./context-menu-editor.js";import{menuEditorView as W}from"./menu-editor.js";import{menuLocationsView as X}from"./menu-locations.js";import{projectsView as Y}from"./projects.js";import{projectDetailView as Z}from"./project-detail.js";import{projectSettingsView as _}from"./project-settings.js";import{apiTokensView as $}from"./api-tokens.js";import{apiEndpointsView as oo}from"./api-endpoints.js";import{apiEndpointEditorView as io}from"./api-endpoint-editor.js";const ro={templateUrl:"",async onMount(){location.hash="#/menus"}};export const views={projects:Y,projectDetail:Z,projectSettings:_,apiTokens:$,apiEndpoints:oo,apiEndpointEditor:io,dashboard:o,pages:i,pageEditor:r,settings:t,theme:e,layouts:p,media:n,login:s,users:f,userEditor:w,plugins:c,pluginCode:V,documentation:d,tutorials:a,apiReference:g,collections:v,collectionEditor:b,collectionEntries:h,forms:y,formEditor:j,formSubmissions:k,viewsList:L,viewEditor:x,viewPreview:M,actionsList:D,actionEditor:G,proDocs:P,blocks:R,blockEditor:S,components:C,componentEditor:T,myProfile:U,roles:q,roleEditor:z,effects:A,search:B,notes:F,todo:H,analytics:I,seo:J,contacts:K,notifications:m,menus:N,contextMenus:O,contextMenuEditor:Q,menuEditor:W,menuLocations:X,menusRedirect:ro,pluginGuides:u,pluginGuide:E,...l};

package/admin/js/views/plugin-guides.js

@@ -0,0 +1,5 @@
+const a=t=>String(t??"").replace(/[&<>"']/g,n=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"})[n]),l=t=>/^[a-z0-9-]+$/i.test(String(t||""))?t:"package";export function parseGuideHash(t){const n=String(t||"").match(/^#\/docs\/plugins\/([^/?#]+)(?:\/([^/?#]+))?/);return n?{name:decodeURIComponent(n[1]),page:n[2]?decodeURIComponent(n[2]):null}:null}function d(){Domma.icons.scan(),Domma.syntax?.scan?.()}export const pluginGuidesView={templateUrl:"/admin/js/templates/plugin-guides.html",async onMount(t){const n=t.find("#pg-grid").get(0);let o=[];try{o=(await H.get("/api/documentation/plugins"))?.guides??[]}catch{o=[]}if(n?.isConnected){if(!o.length){t.find("#pg-empty").get(0)?.removeAttribute("hidden"),d();return}n.innerHTML=o.map(e=>{const s=e.pages.length>1?`<p class="pg-card-pages">${e.pages.map(p=>a(p.title)).join(" \xB7 ")}</p>`:"";return`<a href="#/docs/plugins/${encodeURIComponent(e.name)}" class="card pg-card">
+                <div class="card-body">
+                    <h3><span data-icon="${a(l(e.icon))}"></span> ${a(e.displayName)}</h3>
+                    <p class="text-muted">${a(e.description)}</p>${s}
+                </div></a>`}).join(""),d()}}},pluginGuideView={templateUrl:"/admin/js/templates/plugin-guide.html",async onMount(t){const n=parseGuideHash(location.hash),o=t.find("#pg-body").get(0);if(!n||!o)return;let e=null,s="";try{const i=`/api/documentation/plugins/${encodeURIComponent(n.name)}`+(n.page?`/${encodeURIComponent(n.page)}`:"");e=await H.get(i)}catch(i){s=i?.status===403||/403|forbidden/i.test(String(i?.message))?"Your role cannot use this plugin, so its guide is not shown.":"There is no guide here. The plugin may be disabled, or the page may have moved."}if(!o.isConnected)return;if(!e?.page){o.innerHTML=`<p class="text-muted">${a(s||"There is no guide here.")}</p><p><a href="#/docs/plugins">See all plugin guides</a></p>`,d();return}t.find("#pg-title").get(0).textContent=`${e.displayName} - ${e.page.title}`;const p=t.find("#pg-icon").get(0);p&&(p.innerHTML=`<span data-icon="${a(l(e.icon))}"></span>`),document.title=`${e.displayName} guide - Domma CMS`;const c=[e.version&&`Version ${e.version}`,e.tier==="free"?"Free plugin":e.tier==="paid"?"Paid plugin":""].filter(Boolean).join(" \xB7 ");if(t.find("#pg-meta").get(0).textContent=[c,e.description].filter(Boolean).join(" - "),e.toolUrl){const i=t.find("#pg-tool").get(0);i.setAttribute("href",e.toolUrl),t.find("#pg-tool-text").get(0).textContent=`Open ${e.displayName}`,i.removeAttribute("hidden")}if(e.pages.length>1){const i=t.find("#pg-pages").get(0);i.innerHTML=e.pages.map(g=>{const r=g.slug===e.page.slug;return`<a href="#/docs/plugins/${encodeURIComponent(e.name)}/${encodeURIComponent(g.slug)}" class="btn btn-sm ${r?"btn-secondary":"btn-ghost"}"${r?' aria-current="page"':""}>${a(g.title)}</a>`}).join(""),i.removeAttribute("hidden")}o.innerHTML=e.page.html,d()}};

package/bin/cli.js

@@ -24,14 +24,14 @@ const PACKAGE_ROOT = path.resolve(__dirname, '..');
 // Node version check
 // ---------------------------------------------------------------------------
 
-// The minimum comes from package.json `engines`. Below it, a WARNING rather
-// than a refusal: the manager's fleet tooling (tools/fleet-update.mjs) runs
-// `cli.js update` on the Node it runs on, which is older than engines today,
-// and a hard stop here would halt every fleet roll. Make it exit(1) once the
-// fleet is on the engines version.
+// The minimum comes from package.json `engines`, and below it the CLI stops:
+// scaffolding or updating on an older Node leaves a site that will not run.
+// The fleet (the manager and every site it forks) runs on Node 24, so fleet
+// rolls pass this check.
 const NODE_RANGE = JSON.parse(readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8')).engines?.node;
 if (!nodeVersionOk(process.versions.node, NODE_RANGE)) {
-  console.warn(`\n  ⚠  Domma CMS needs Node.js ${minNodeMajor(NODE_RANGE)} or higher (this is ${process.versions.node}). Continuing, but upgrade Node.\n`);
+  console.error(`\n  ✗ Domma CMS requires Node.js ${minNodeMajor(NODE_RANGE)} or higher (this is ${process.versions.node}). Upgrade Node and run this again.\n`);
+  process.exit(1);
 }
 
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domma-cms",
-  "version": "0.93.0",
+  "version": "0.94.0",
   "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",