domma-cms 0.55.1 → 0.66.0

package/plugins/invoice/plugin.json

@@ -1,14 +1,15 @@
 {
   "name": "invoice",
   "displayName": "Invoices",
-  "version": "1.0.0",
-  "description": "Lightweight invoice generator. Manage issuers, receivers, line items, optional VAT, and produce a print-ready invoice you can save as PDF from the browser.",
+  "version": "1.4.0",
+  "description": "Invoice generator. Issuer profiles, receivers importable from Contacts, line items, optional VAT, payments, archiving, CSV/Excel export, and a print-ready invoice you can email or download as a PDF.",
   "author": "Darryl Waterhouse",
-  "date": "2026-05-04",
-  "icon": "file-text",
+  "date": "2026-09-21",
+  "icon": "receipt",
   "admin": {
     "css": [
-      "admin/css/index.css"
+      "admin/css/index.css",
+      "../_lib/admin/ui/help.css"
     ],
     "sidebar": [
       {
@@ -65,19 +66,19 @@
     ],
     "views": {
       "plugin-invoice-list": {
-        "entry": "invoice/admin/views/index.js?v=9c70ea80",
+        "entry": "invoice/admin/views/index.js?v=350310c2",
         "exportName": "indexView"
       },
       "plugin-invoice-editor": {
-        "entry": "invoice/admin/views/editor.js?v=e5e153c1",
+        "entry": "invoice/admin/views/editor.js?v=78cd5797",
         "exportName": "editorView"
       },
       "plugin-invoice-issuers": {
-        "entry": "invoice/admin/views/issuers.js?v=ac69a08a",
+        "entry": "invoice/admin/views/issuers.js?v=e2dd5ab2",
         "exportName": "issuersView"
       },
       "plugin-invoice-receivers": {
-        "entry": "invoice/admin/views/receivers.js?v=f016e1ff",
+        "entry": "invoice/admin/views/receivers.js?v=ce0e3964",
         "exportName": "receiversView"
       }
     }

package/plugins/invoice/templates/_base.css

@@ -0,0 +1 @@
+:root{color-scheme:light}*{box-sizing:border-box}body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica,Arial,sans-serif;color:#222;background:#f3f3f3;margin:0;padding:24px;font-size:14px;line-height:1.5}.invoice{max-width:800px;margin:0 auto;background:#fff;padding:48px 56px;box-shadow:0 4px 20px #00000014}.top{display:flex;justify-content:space-between;align-items:flex-start;gap:24px;border-bottom:2px solid #e5e5e5;padding-bottom:24px;margin-bottom:32px}.logo{max-height:80px;max-width:240px;display:block;margin-bottom:12px}.meta{text-align:right}.meta h1{margin:0;font-size:28px;letter-spacing:1px;color:#000}.meta .number{font-size:18px;color:#555;margin-top:4px}.status{display:inline-block;padding:4px 10px;border-radius:4px;font-size:11px;font-weight:600;letter-spacing:.5px;background:#eee;color:#444;margin-top:8px}.parties{display:grid;grid-template-columns:1fr 1fr;gap:32px;margin-bottom:32px}.party h3{margin:0 0 8px;font-size:11px;text-transform:uppercase;letter-spacing:1px;color:#888}.party .name{font-weight:700;font-size:15px;margin-bottom:4px}.party .lines{color:#555;font-size:13px}table.items{width:100%;border-collapse:collapse;margin-bottom:24px}table.items th{text-align:left;font-size:11px;text-transform:uppercase;letter-spacing:1px;color:#888;padding:8px 10px;border-bottom:2px solid #e5e5e5}table.items td{padding:10px;border-bottom:1px solid #f0f0f0}table.items td.num,table.items th.num{text-align:right}.totals{width:320px;margin-left:auto;margin-bottom:32px}.totals table{width:100%;border-collapse:collapse}.totals th{text-align:left;padding:8px 10px;font-weight:500;color:#555}.totals td.num{text-align:right;padding:8px 10px;font-variant-numeric:tabular-nums}.bank .pay{border-collapse:collapse;margin-top:6px}.bank .pay th{text-align:left;font-weight:400;color:#666;padding:2px 14px 2px 0;white-space:nowrap;vertical-align:top}.bank .pay td{padding:2px 0;font-variant-numeric:tabular-nums;font-weight:600}.bank .pay-notes{margin-top:6px}.totals .balance th,.totals .balance td{font-weight:700;border-top:1px solid #ddd}.totals .settled th,.totals .settled td{color:#197a3d}.totals .grand th,.totals .grand td{font-size:17px;font-weight:700;color:#000;border-top:2px solid #222;padding-top:12px}.footer{margin-top:32px;padding-top:16px;border-top:1px solid #e5e5e5;font-size:12px;color:#888}.notes,.bank{margin-top:24px;padding:12px 16px;background:#fafafa;border-radius:4px;font-size:13px}.muted{color:#999;font-style:italic;text-align:center}.actions{max-width:800px;margin:0 auto 16px;display:flex;justify-content:flex-end;gap:8px}.actions button{background:#222;color:#fff;border:0;padding:8px 16px;font-size:13px;border-radius:4px;cursor:pointer}@media print{body{background:#fff;padding:0}.invoice{box-shadow:none;padding:24px}.actions{display:none}}

package/plugins/invoice/templates/classic-nologo.html

@@ -0,0 +1,100 @@
+<!--
+  Classic, for an issuer with no logo.
+
+  Not the logo template with an empty slot: an invoice whose masthead is a
+  blank 80px gap looks like a page that failed to load. The trading name takes
+  the space instead, set as a wordmark, which is what a letterhead does when
+  there is no mark to print.
+
+  Chosen automatically - buildPrintHtml() asks for `<style>-nologo` first when
+  neither the issuer nor Settings > Branding has a logo.
+-->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>Invoice {{number}}</title>
+<style>
+{{baseCss}}
+
+/* The name IS the masthead here, so it is set like one. */
+.wordmark {
+    font-size: 26px;
+    font-weight: 700;
+    letter-spacing: -0.4px;
+    color: #000;
+    margin-bottom: 10px;
+    line-height: 1.1;
+}
+.top .party .name { display: none; }
+</style>
+</head>
+<body>
+
+<div class="actions">
+    <button onclick="window.print()">Print / Save as PDF</button>
+</div>
+
+<div class="invoice">
+    <div class="top">
+        <div>
+            <div class="wordmark">{{issuerName}}</div>
+            <div class="party">
+                <div class="lines">{{issuerAddress}}</div>
+                <div class="lines">{{issuerEmail}}</div>
+                <div class="lines">{{issuerPhone}}</div>
+                {{issuerVat}}
+            </div>
+        </div>
+        <div class="meta">
+            <h1>INVOICE</h1>
+            <div class="number">{{number}}</div>
+            <div>{{issueDate}}</div>
+            {{dueDate}}
+            <div class="status">{{status}}</div>
+        </div>
+    </div>
+
+    <div class="parties">
+        <div class="party">
+            <h3>Billed To</h3>
+            <div class="name">{{receiverName}}</div>
+            <div class="lines">{{receiverAddress}}</div>
+            <div class="lines">{{receiverEmail}}</div>
+            {{receiverVat}}
+        </div>
+    </div>
+
+    <table class="items">
+        <thead>
+            <tr>
+                <th>Description</th>
+                <th class="num">Qty</th>
+                <th class="num">Unit</th>
+                <th class="num">Total</th>
+            </tr>
+        </thead>
+        <tbody>
+            {{items}}
+        </tbody>
+    </table>
+
+    <div class="totals">
+        <table>
+            <tr><th>Subtotal</th><td class="num">{{subtotal}}</td></tr>
+            {{vatRow}}
+            <tr class="grand"><th>Total</th><td class="num">{{total}}</td></tr>
+            {{paidRows}}
+        </table>
+    </div>
+
+    {{notes}}
+    {{bankDetails}}
+
+    <div class="footer">{{footerNote}}</div>
+</div>
+
+{{autoPrint}}
+
+</body>
+</html>

package/plugins/invoice/templates/classic.html

@@ -0,0 +1,91 @@
+<!--
+  Classic - the default. Logo top left, invoice meta top right.
+
+  Every template is a whole HTML document: a printout has no stylesheet of its
+  own to fetch, so `{{baseCss}}` inlines the shared rules and anything below it
+  is what makes this style itself.
+
+  Slots: number issueDate dueDate status issuerLogo issuerName issuerAddress
+  issuerEmail issuerPhone issuerVat receiverName receiverAddress receiverEmail
+  receiverVat items subtotal vatRow paidRows total notes bankDetails footerNote
+  autoPrint baseCss
+-->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>Invoice {{number}}</title>
+<style>
+{{baseCss}}
+</style>
+</head>
+<body>
+
+<div class="actions">
+    <button onclick="window.print()">Print / Save as PDF</button>
+</div>
+
+<div class="invoice">
+    <div class="top">
+        <div>
+            {{issuerLogo}}
+            <div class="party">
+                <div class="name">{{issuerName}}</div>
+                <div class="lines">{{issuerAddress}}</div>
+                <div class="lines">{{issuerEmail}}</div>
+                <div class="lines">{{issuerPhone}}</div>
+                {{issuerVat}}
+            </div>
+        </div>
+        <div class="meta">
+            <h1>INVOICE</h1>
+            <div class="number">{{number}}</div>
+            <div>{{issueDate}}</div>
+            {{dueDate}}
+            <div class="status">{{status}}</div>
+        </div>
+    </div>
+
+    <div class="parties">
+        <div class="party">
+            <h3>Billed To</h3>
+            <div class="name">{{receiverName}}</div>
+            <div class="lines">{{receiverAddress}}</div>
+            <div class="lines">{{receiverEmail}}</div>
+            {{receiverVat}}
+        </div>
+    </div>
+
+    <table class="items">
+        <thead>
+            <tr>
+                <th>Description</th>
+                <th class="num">Qty</th>
+                <th class="num">Unit</th>
+                <th class="num">Total</th>
+            </tr>
+        </thead>
+        <tbody>
+            {{items}}
+        </tbody>
+    </table>
+
+    <div class="totals">
+        <table>
+            <tr><th>Subtotal</th><td class="num">{{subtotal}}</td></tr>
+            {{vatRow}}
+            <tr class="grand"><th>Total</th><td class="num">{{total}}</td></tr>
+            {{paidRows}}
+        </table>
+    </div>
+
+    {{notes}}
+    {{bankDetails}}
+
+    <div class="footer">{{footerNote}}</div>
+</div>
+
+{{autoPrint}}
+
+</body>
+</html>

package/plugins/invoice/templates/invoice-print.html

@@ -97,6 +97,29 @@
         padding: 8px 10px;
         font-variant-numeric: tabular-nums;
     }
+    .bank .pay {
+      border-collapse: collapse;
+      margin-top: 6px;
+    }
+    .bank .pay th {
+      text-align: left;
+      font-weight: 400;
+      color: #666;
+      padding: 2px 14px 2px 0;
+      white-space: nowrap;
+      vertical-align: top;
+    }
+    .bank .pay td {
+      padding: 2px 0;
+      font-variant-numeric: tabular-nums;
+      font-weight: 600;
+    }
+    .bank .pay-notes { margin-top: 6px; }
+    .totals .balance th, .totals .balance td {
+      font-weight: 700;
+      border-top: 1px solid #ddd;
+    }
+    .totals .settled th, .totals .settled td { color: #197a3d; }
     .totals .grand th, .totals .grand td {
         font-size: 17px;
         font-weight: 700;
@@ -198,6 +221,7 @@
             <tr><th>Subtotal</th><td class="num">{{subtotal}}</td></tr>
             {{vatRow}}
             <tr class="grand"><th>Total</th><td class="num">{{total}}</td></tr>
+            {{paidRows}}
         </table>
     </div>
 

package/plugins/invoice/templates/minimal.html

@@ -0,0 +1,99 @@
+<!--
+  Minimal - typographic, no rules, no fills, no logo by design.
+
+  It has no `-nologo` sibling on purpose: there is nowhere in this layout a
+  logo would go, so it is the same document either way and the resolver falls
+  back to this file.
+-->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>Invoice {{number}}</title>
+<style>
+{{baseCss}}
+
+/* Minimal: no card, no shadow, no bands - just the page. */
+body { background: #fff; padding: 40px 24px; }
+.invoice { box-shadow: none; padding: 0; max-width: 680px; }
+.top { border-bottom: 1px solid #222; padding-bottom: 12px; margin-bottom: 28px; }
+.top .party .name { font-size: 15px; }
+.meta h1 { font-size: 15px; letter-spacing: 4px; font-weight: 600; }
+.meta .number { font-size: 14px; }
+.status { background: transparent; padding: 0; color: #666; letter-spacing: 1.5px; }
+table.items th { border-bottom-color: #222; }
+table.items td { border-bottom-color: #eee; }
+.totals .grand th, .totals .grand td { border-top-color: #222; font-size: 15px; }
+.notes, .bank { background: transparent; padding: 0; border-top: 1px solid #eee; padding-top: 12px; border-radius: 0; }
+.footer { border-top: 1px solid #eee; }
+</style>
+</head>
+<body>
+
+<div class="actions">
+    <button onclick="window.print()">Print / Save as PDF</button>
+</div>
+
+<div class="invoice">
+    <div class="top">
+        <div>
+            <div class="party">
+                <div class="name">{{issuerName}}</div>
+                <div class="lines">{{issuerAddress}}</div>
+                <div class="lines">{{issuerEmail}}</div>
+                <div class="lines">{{issuerPhone}}</div>
+                {{issuerVat}}
+            </div>
+        </div>
+        <div class="meta">
+            <h1>INVOICE</h1>
+            <div class="number">{{number}}</div>
+            <div>{{issueDate}}</div>
+            {{dueDate}}
+            <div class="status">{{status}}</div>
+        </div>
+    </div>
+
+    <div class="parties">
+        <div class="party">
+            <h3>Billed To</h3>
+            <div class="name">{{receiverName}}</div>
+            <div class="lines">{{receiverAddress}}</div>
+            <div class="lines">{{receiverEmail}}</div>
+            {{receiverVat}}
+        </div>
+    </div>
+
+    <table class="items">
+        <thead>
+            <tr>
+                <th>Description</th>
+                <th class="num">Qty</th>
+                <th class="num">Unit</th>
+                <th class="num">Total</th>
+            </tr>
+        </thead>
+        <tbody>
+            {{items}}
+        </tbody>
+    </table>
+
+    <div class="totals">
+        <table>
+            <tr><th>Subtotal</th><td class="num">{{subtotal}}</td></tr>
+            {{vatRow}}
+            <tr class="grand"><th>Total</th><td class="num">{{total}}</td></tr>
+            {{paidRows}}
+        </table>
+    </div>
+
+    {{notes}}
+    {{bankDetails}}
+
+    <div class="footer">{{footerNote}}</div>
+</div>
+
+{{autoPrint}}
+
+</body>
+</html>

package/plugins/invoice/templates/modern-nologo.html

@@ -0,0 +1,114 @@
+<!--
+  Modern, for an issuer with no logo: the trading name is the wordmark in
+  the band, so the band is never a dark strip with a hole in it.
+-->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>Invoice {{number}}</title>
+<style>
+{{baseCss}}
+
+/* Modern - a dark masthead band, the numbers doing the talking underneath. */
+.invoice { padding: 0 0 48px; }
+.band {
+    background: #1b1f23;
+    color: #fff;
+    padding: 28px 56px;
+    display: flex;
+    justify-content: space-between;
+    align-items: flex-start;
+    gap: 24px;
+}
+.band .wordmark { font-size: 22px; font-weight: 700; letter-spacing: -0.3px; }
+.band .logo { max-height: 56px; margin: 0; }
+.band h1 { margin: 0; font-size: 24px; letter-spacing: 3px; font-weight: 600; }
+.band .number { font-size: 15px; opacity: .75; margin-top: 2px; }
+.band .meta { text-align: right; }
+.band .meta div { opacity: .85; font-size: 13px; }
+.band .status {
+    background: rgba(255,255,255,.15);
+    color: #fff;
+    margin-top: 8px;
+}
+.top { display: none; }
+.body { padding: 32px 56px 0; }
+.parties { grid-template-columns: 1fr 1fr; }
+table.items th { border-bottom-color: #1b1f23; }
+.totals .grand th, .totals .grand td { border-top-color: #1b1f23; }
+</style>
+</head>
+<body>
+
+<div class="actions">
+    <button onclick="window.print()">Print / Save as PDF</button>
+</div>
+
+<div class="invoice">
+    <div class="band">
+        <div>
+            <div class="wordmark">{{issuerName}}</div>
+            <div class="lines" style="opacity:.8;font-size:12px;margin-top:6px;">{{issuerEmail}}</div>
+        </div>
+        <div class="meta">
+            <h1>INVOICE</h1>
+            <div class="number">{{number}}</div>
+            <div>{{issueDate}}</div>
+            {{dueDate}}
+            <div class="status">{{status}}</div>
+        </div>
+    </div>
+
+    <div class="body">
+        <div class="parties">
+            <div class="party">
+                <h3>From</h3>
+                <div class="name">{{issuerName}}</div>
+                <div class="lines">{{issuerAddress}}</div>
+                <div class="lines">{{issuerPhone}}</div>
+                {{issuerVat}}
+            </div>
+            <div class="party">
+                <h3>Billed To</h3>
+                <div class="name">{{receiverName}}</div>
+                <div class="lines">{{receiverAddress}}</div>
+                <div class="lines">{{receiverEmail}}</div>
+                {{receiverVat}}
+            </div>
+        </div>
+
+        <table class="items">
+            <thead>
+                <tr>
+                    <th>Description</th>
+                    <th class="num">Qty</th>
+                    <th class="num">Unit</th>
+                    <th class="num">Total</th>
+                </tr>
+            </thead>
+            <tbody>
+                {{items}}
+            </tbody>
+        </table>
+
+        <div class="totals">
+            <table>
+                <tr><th>Subtotal</th><td class="num">{{subtotal}}</td></tr>
+                {{vatRow}}
+                <tr class="grand"><th>Total</th><td class="num">{{total}}</td></tr>
+                {{paidRows}}
+            </table>
+        </div>
+
+        {{notes}}
+        {{bankDetails}}
+
+        <div class="footer">{{footerNote}}</div>
+    </div>
+</div>
+
+{{autoPrint}}
+
+</body>
+</html>

package/plugins/invoice/templates/modern.html

@@ -0,0 +1,113 @@
+<!--
+  Modern - a dark masthead band carrying the logo and the invoice meta.
+-->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>Invoice {{number}}</title>
+<style>
+{{baseCss}}
+
+/* Modern - a dark masthead band, the numbers doing the talking underneath. */
+.invoice { padding: 0 0 48px; }
+.band {
+    background: #1b1f23;
+    color: #fff;
+    padding: 28px 56px;
+    display: flex;
+    justify-content: space-between;
+    align-items: flex-start;
+    gap: 24px;
+}
+.band .wordmark { font-size: 22px; font-weight: 700; letter-spacing: -0.3px; }
+.band .logo { max-height: 56px; margin: 0; }
+.band h1 { margin: 0; font-size: 24px; letter-spacing: 3px; font-weight: 600; }
+.band .number { font-size: 15px; opacity: .75; margin-top: 2px; }
+.band .meta { text-align: right; }
+.band .meta div { opacity: .85; font-size: 13px; }
+.band .status {
+    background: rgba(255,255,255,.15);
+    color: #fff;
+    margin-top: 8px;
+}
+.top { display: none; }
+.body { padding: 32px 56px 0; }
+.parties { grid-template-columns: 1fr 1fr; }
+table.items th { border-bottom-color: #1b1f23; }
+.totals .grand th, .totals .grand td { border-top-color: #1b1f23; }
+</style>
+</head>
+<body>
+
+<div class="actions">
+    <button onclick="window.print()">Print / Save as PDF</button>
+</div>
+
+<div class="invoice">
+    <div class="band">
+        <div>
+            {{issuerLogo}}
+            <div class="lines" style="opacity:.8;font-size:12px;margin-top:6px;">{{issuerEmail}}</div>
+        </div>
+        <div class="meta">
+            <h1>INVOICE</h1>
+            <div class="number">{{number}}</div>
+            <div>{{issueDate}}</div>
+            {{dueDate}}
+            <div class="status">{{status}}</div>
+        </div>
+    </div>
+
+    <div class="body">
+        <div class="parties">
+            <div class="party">
+                <h3>From</h3>
+                <div class="name">{{issuerName}}</div>
+                <div class="lines">{{issuerAddress}}</div>
+                <div class="lines">{{issuerPhone}}</div>
+                {{issuerVat}}
+            </div>
+            <div class="party">
+                <h3>Billed To</h3>
+                <div class="name">{{receiverName}}</div>
+                <div class="lines">{{receiverAddress}}</div>
+                <div class="lines">{{receiverEmail}}</div>
+                {{receiverVat}}
+            </div>
+        </div>
+
+        <table class="items">
+            <thead>
+                <tr>
+                    <th>Description</th>
+                    <th class="num">Qty</th>
+                    <th class="num">Unit</th>
+                    <th class="num">Total</th>
+                </tr>
+            </thead>
+            <tbody>
+                {{items}}
+            </tbody>
+        </table>
+
+        <div class="totals">
+            <table>
+                <tr><th>Subtotal</th><td class="num">{{subtotal}}</td></tr>
+                {{vatRow}}
+                <tr class="grand"><th>Total</th><td class="num">{{total}}</td></tr>
+                {{paidRows}}
+            </table>
+        </div>
+
+        {{notes}}
+        {{bankDetails}}
+
+        <div class="footer">{{footerNote}}</div>
+    </div>
+</div>
+
+{{autoPrint}}
+
+</body>
+</html>

package/plugins/invoice/templates/templates.json

@@ -0,0 +1,11 @@
+{
+  "_comment": "The templates offered in Settings > Templates. A site can add its own: drop <id>.html (and optionally <id>-nologo.html) beside this file and add an entry. `nologo: false` means the style has nowhere to put a logo, so it is used as-is either way.",
+  "templates": [
+    { "id": "classic", "name": "Classic", "nologo": true,
+      "description": "Logo top left, invoice details top right. The traditional letterhead layout." },
+    { "id": "modern", "name": "Modern", "nologo": true,
+      "description": "A dark masthead band across the top carrying the logo and the invoice number." },
+    { "id": "minimal", "name": "Minimal", "nologo": false,
+      "description": "Typographic and unfilled - no logo, no colour. Prints cleanly in black and white." }
+  ]
+}

package/plugins/mail-reader/admin/views/mail.js

@@ -0,0 +1,19 @@
+/**
+ * Mail Reader admin view.
+ *
+ * The three-pane reader is shared with the other edition and lives in
+ * `plugins/_lib/admin/mail/reader-view.js`. It is imported dynamically so the
+ * loader's cache-busting token reaches it: a static specifier is fixed, so the
+ * shared code would keep being served from cache after an update while this
+ * file was refetched.
+ *
+ * @module mail-reader/admin/views/mail
+ */
+const ASSET_VERSION = new URL(import.meta.url).searchParams.get('v') ?? '1';
+
+const {createReaderView} = await import(`/plugins/_lib/admin/mail/reader-view.js?v=${ASSET_VERSION}`);
+
+export const mailView = createReaderView({
+    pluginName: 'mail-reader',
+    assetVersion: ASSET_VERSION
+});

package/plugins/mail-reader/config.js

@@ -0,0 +1,7 @@
+/**
+ * Mail Reader - default configuration.
+ *
+ * The reading defaults are shared with `email-pro` and live in
+ * `plugins/_lib/mail/defaults.js`. The free edition uses them unchanged.
+ */
+export {default} from '../_lib/mail/defaults.js';