shutro-erp 0.3.6 → 0.3.7

package/dist/recruitment/module.d.ts

@@ -1,3 +1,9 @@
+/**
+ * The data layer of Hiring (RFC 0021): openings for Workforce positions with their headcount, applicants moving
+ * through stages, and interviewers' scorecards — each interviewer sees only their own, so no opinion steers the next;
+ * the applicant's average rating shows to everyone. One email applies once per opening. Expected salaries are for
+ * hiring managers only.
+ */
 export declare const HiringStage: import("../server/orm.js").Model<"hiring.stage", {
     readonly id: import("../server/orm.js").IdField<"hiring.stage">;
     readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
@@ -1740,6 +1746,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+    readonly approvalUsers: import("../server/orm.js").Many2manyField<"res.users", {
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
 }, {} & import("../server/orm.js").TransitionMethods<{
     readonly name: import("../server/orm.js").CharField<{
         readonly required: true;
@@ -1771,6 +1787,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+    readonly approvalUsers: import("../server/orm.js").Many2manyField<"res.users", {
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
 }>>, import("../server/orm.js").Model<"hr.job", {
     readonly id: import("../server/orm.js").IdField<"hr.job">;
     readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
@@ -1856,6 +1882,214 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+}>>, import("../server/orm.js").Model<"hr.employee.tag", {
+    readonly id: import("../server/orm.js").IdField<"hr.employee.tag">;
+    readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly createdBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly displayName: import("../server/orm.js").CharField<{
+        required: true;
+        readonly: true;
+        computed: true;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly active: import("../server/orm.js").ActiveField;
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly color: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
+}, {} & import("../server/orm.js").TransitionMethods<{
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly color: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
+}>>, import("../server/orm.js").Model<"hr.contract.type", {
+    readonly id: import("../server/orm.js").IdField<"hr.contract.type">;
+    readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly createdBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly displayName: import("../server/orm.js").CharField<{
+        required: true;
+        readonly: true;
+        computed: true;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly active: import("../server/orm.js").ActiveField;
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly code: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly country: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly sequence: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
+}, {} & import("../server/orm.js").TransitionMethods<{
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly code: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly country: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly sequence: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
 }>>, import("../server/orm.js").Model<"hr.employee", {
     readonly id: import("../server/orm.js").IdField<"hr.employee">;
     readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
@@ -1910,6 +2144,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly jobTitle: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
     readonly user: import("../server/orm.js").Many2oneField<"res.users", {
         readonly required: false;
         readonly computed: false;
@@ -1960,6 +2204,46 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: true;
         readonly readonly: false;
     }>;
+    readonly unitHead: import("../server/orm.js").Many2oneField<"hr.employee", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
+    readonly coach: import("../server/orm.js").Many2oneField<"hr.employee", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
+    readonly property: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly tags: import("../server/orm.js").Many2manyField<"hr.employee.tag", {
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
     readonly workEmail: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;
@@ -1980,6 +2264,46 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly mobile: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly expenseApprover: import("../server/orm.js").Many2oneField<"res.users", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
+    readonly leaveApprover: import("../server/orm.js").Many2oneField<"res.users", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
+    readonly timezone: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }, string>;
     readonly hireDate: import("../server/orm.js").ScalarField<"date", string, string, {
         readonly required: false;
         readonly computed: false;
@@ -2041,6 +2365,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly jobTitle: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
     readonly user: import("../server/orm.js").Many2oneField<"res.users", {
         readonly required: false;
         readonly computed: false;
@@ -2091,6 +2425,46 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: true;
         readonly readonly: false;
     }>;
+    readonly unitHead: import("../server/orm.js").Many2oneField<"hr.employee", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
+    readonly coach: import("../server/orm.js").Many2oneField<"hr.employee", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
+    readonly property: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly tags: import("../server/orm.js").Many2manyField<"hr.employee.tag", {
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
     readonly workEmail: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;
@@ -2111,6 +2485,46 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly mobile: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly expenseApprover: import("../server/orm.js").Many2oneField<"res.users", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
+    readonly leaveApprover: import("../server/orm.js").Many2oneField<"res.users", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
+    readonly timezone: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }, string>;
     readonly hireDate: import("../server/orm.js").ScalarField<"date", string, string, {
         readonly required: false;
         readonly computed: false;
@@ -2224,6 +2638,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+    readonly employmentType: import("../server/orm.js").Many2oneField<"hr.contract.type", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
     readonly kind: import("../server/orm.js").SelectionField<"fixed" | "intern" | "permanent" | "probation", {
         readonly required: true;
         readonly computed: false;
@@ -2306,6 +2730,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+    readonly employmentType: import("../server/orm.js").Many2oneField<"hr.contract.type", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
     readonly kind: import("../server/orm.js").SelectionField<"fixed" | "intern" | "permanent" | "probation", {
         readonly required: true;
         readonly computed: false;
@@ -2562,16 +2996,14 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly approve: {
             readonly from: readonly ["submitted"];
             readonly to: "approved";
-            readonly requires: "hr.leave_decide";
             readonly guard: (records: never) => unknown;
-            readonly message: "Someone else decides your leave.";
+            readonly message: "Your own leave is decided by someone else; others’ by an HR manager or their leave approver.";
         };
         readonly refuse: {
             readonly from: readonly ["submitted"];
             readonly to: "refused";
-            readonly requires: "hr.leave_decide";
             readonly guard: (records: never) => unknown;
-            readonly message: "Someone else decides your leave.";
+            readonly message: "Your own leave is decided by someone else; others’ by an HR manager or their leave approver.";
         };
         readonly redraft: {
             readonly from: readonly ["submitted", "refused"];
@@ -2654,16 +3086,14 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly approve: {
             readonly from: readonly ["submitted"];
             readonly to: "approved";
-            readonly requires: "hr.leave_decide";
             readonly guard: (records: never) => unknown;
-            readonly message: "Someone else decides your leave.";
+            readonly message: "Your own leave is decided by someone else; others’ by an HR manager or their leave approver.";
         };
         readonly refuse: {
             readonly from: readonly ["submitted"];
             readonly to: "refused";
-            readonly requires: "hr.leave_decide";
             readonly guard: (records: never) => unknown;
-            readonly message: "Someone else decides your leave.";
+            readonly message: "Your own leave is decided by someone else; others’ by an HR manager or their leave approver.";
         };
         readonly redraft: {
             readonly from: readonly ["submitted", "refused"];
@@ -2874,6 +3304,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly lang: import("../server/orm.js").SelectionField<"bn" | "en", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
     readonly phone: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;
@@ -3095,6 +3535,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly lang: import("../server/orm.js").SelectionField<"bn" | "en", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
     readonly phone: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;

package/dist/recruitment/module.js

@@ -5,6 +5,7 @@
  * hiring managers only.
  */
 import { hrShutro } from '../hr/index.js';
+import { emitting } from '../server/index.js';
 import { orm } from '../server/orm.js';
 import { check, compute, defineModel, defineModule, f, record, } from './.kosh/bindings.js';
 const READ = ['read'];
@@ -51,10 +52,11 @@ export const HiringOpening = defineModel('hiring.opening', {
         applicants: f.one2many('hiring.applicant', 'opening'),
         description: f.text(),
         state: f.state({
+            help: 'An open opening takes applicants; it closes by hand or once its headcount is hired.',
             states: { open: 'Open', closed: 'Closed' },
             initial: 'open',
             transitions: {
-                close: { from: ['open'], to: 'closed' },
+                close: emitting('hiring.opening.closed', { from: ['open'], to: 'closed' }),
                 reopen: { from: ['closed'], to: 'open' },
             },
         }),
@@ -89,7 +91,7 @@ export const HiringApplicant = defineModel('hiring.applicant', {
             linkedin: 'LinkedIn',
             agency: 'Agency',
             other: 'Other',
-        }, {}),
+        }, { help: 'Where the candidate heard of the opening.' }),
         expectedSalary: f.decimal({ scale: 2, label: 'Expected salary', groups: ['hiring.manager'] }),
         refused: f.boolean({ default: false }),
         refuseReason: f.char({ label: 'Refused because' }),
@@ -99,6 +101,7 @@ export const HiringApplicant = defineModel('hiring.applicant', {
             scale: 1,
             store: true,
             label: 'Rating',
+            help: 'The average score of the interviewers’ scorecards, out of 5.',
             ...compute('hiring.applicant', 'rating', ['scorecards.score'], (applicants) => {
                 for (const a of applicants) {
                     const scores = [...a.scorecards].map((s) => s.score);
@@ -116,6 +119,7 @@ export const HiringApplicant = defineModel('hiring.applicant', {
         employee: f.many2one('hr.employee', { ondelete: 'set null' }),
         status: f.selection({ active: 'In progress', hired: 'Hired', refused: 'Refused' }, {
             store: true,
+            help: 'Hired once the candidate became an employee, refused when turned down, in progress otherwise.',
             ...compute('hiring.applicant', 'status', ['employee', 'refused'], (applicants) => {
                 for (const a of applicants)
                     a.status = a.employee !== null ? 'hired' : a.refused ? 'refused' : 'active';
@@ -168,7 +172,11 @@ export const HiringScorecard = defineModel('hiring.scorecard', {
         applicant: f.many2one('hiring.applicant', { required: true, ondelete: 'cascade' }),
         interviewer: f.many2one('res.users', { required: true, default: (env) => env.userId }),
         score: f.integer({ required: true, default: 3, label: 'Score (1–5)' }),
-        recommendation: f.selection({ strong_yes: 'Strong yes', yes: 'Yes', no: 'No', strong_no: 'Strong no' }, { required: true, default: 'yes' }),
+        recommendation: f.selection({ strong_yes: 'Strong yes', yes: 'Yes', no: 'No', strong_no: 'Strong no' }, {
+            required: true,
+            default: 'yes',
+            help: 'Whether the interviewer recommends hiring the candidate.',
+        }),
         notes: f.text(),
     },
     sqlConstraints: {

package/dist/reporting/documents.d.ts

@@ -34,6 +34,11 @@ export interface DocumentData {
     readonly locale?: string;
     readonly tz?: string;
 }
+/**
+ * A template's placeholders filled as plain text (RFC 0029 §3.3: an email's subject and body), formatted as in
+ * documents; nothing escaped.
+ */
+export declare function fillText(data: DocumentData, fields: DocumentFields, template: string): string;
 /**
  * A QR code as SVG (one path of dark modules, a quiet zone of 4), from `qrcode`'s synchronous matrix — rendering
  * stays synchronous. Medium error correction: a printed ticket survives a crease.

package/dist/reporting/documents.js

@@ -109,7 +109,17 @@ function resolve(data, fields, path) {
 }
 /** `{{path}}`, or `{{path|words}}`: an amount in words, in the document's language (RFC 0016). */
 function text(data, fields, template) {
-    return esc(template).replace(/\{\{\s*([\w.]+)\s*(?:\|\s*(\w+)\s*)?\}\}/g, (_, path, filter) => {
+    return fill(data, fields, esc(template), esc);
+}
+/**
+ * A template's placeholders filled as plain text (RFC 0029 §3.3: an email's subject and body), formatted as in
+ * documents; nothing escaped.
+ */
+export function fillText(data, fields, template) {
+    return fill(data, fields, template, (v) => String(v ?? ''));
+}
+function fill(data, fields, template, esc) {
+    return template.replace(/\{\{\s*([\w.]+)\s*(?:\|\s*(\w+)\s*)?\}\}/g, (_, path, filter) => {
         if (path === 'page' || path === 'pages')
             return `<span class="${path}"></span>`;
         const r = resolve(data, fields, path);

package/dist/reporting/index.d.ts

@@ -8,7 +8,7 @@
 import { defineModule } from '../modules-sdk/index.js';
 import { reportingShutro } from './models.js';
 import type { ScheduleEngine } from './schedules.js';
-export { type Block, closeDocuments, type DocumentData, type DocumentFields, type DocumentFormat, formatValue as formatDocumentValue, type Layout, loadDocumentData, qrSvg, renderHtml, renderPdf, } from './documents.js';
+export { type Block, closeDocuments, type DocumentData, type DocumentFields, type DocumentFormat, fillText, formatValue as formatDocumentValue, type Layout, loadDocumentData, qrSvg, renderHtml, renderPdf, } from './documents.js';
 export { type Amount, type Condition, type FieldInfo, type Header, type Measure, nextBucket, ReportError, type ReportQuery, type ReportResult, runReport, type Value, zonedStart, } from './pivot.js';
 export { parseReportQuery, registerReportRoutes, reportTable } from './routes.js';
 export { documentFields, installTemplates, layoutProblems, registerDocumentRoutes, renderDocument, scheduleRenderer, } from './routes-documents.js';