@fieldia/core 0.1.0

package/src/lib/record/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/check.ts"],"names":[],"mappings":"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"}

package/src/lib/record/check.mjs

@@ -0,0 +1,163 @@
+import { fill, MESSAGES } from './messages.mjs';
+import { isEmpty } from './values.mjs';
+/**
+ * Check one value against its field. Returns the message to show, or
+ * undefined when the value is fine. The wording follows the React engine's
+ * ("Name is required", "Maximum 120 characters allowed").
+ *
+ * An empty optional value passes everything: a pattern or a minimum applies
+ * to what someone typed, not to a field they left alone.
+ */
+export function checkValue(field, value, required, messages = MESSAGES.en) {
+    const label = field.label || 'This field';
+    const say = (key, values = {}) => fill(messages[key], { label, ...values });
+    if (isEmpty(field, value))
+        return required ? say('required') : undefined;
+    switch (field.type) {
+        case 'char':
+        case 'text':
+        case 'html': {
+            if (typeof value !== 'string')
+                return say('text');
+            if ((field.type === 'char' || field.type === 'text') && field.size !== undefined && value.length > field.size) {
+                return say('maxLength', { max: field.size });
+            }
+            if (field.type === 'char' && field.pattern !== undefined && !new RegExp(field.pattern).test(value)) {
+                return say('pattern');
+            }
+            return undefined;
+        }
+        case 'integer':
+        case 'float':
+        case 'monetary': {
+            if (typeof value !== 'number' || !Number.isFinite(value))
+                return say('number');
+            if (field.type === 'integer' && !Number.isInteger(value))
+                return say('integer');
+            if (field.min !== undefined && value < field.min)
+                return say('min', { min: field.min });
+            if (field.max !== undefined && value > field.max)
+                return say('max', { max: field.max });
+            if (field.type !== 'integer' && field.digits && decimals(value) > field.digits[1]) {
+                return say('decimals', { digits: field.digits[1] });
+            }
+            return undefined;
+        }
+        case 'boolean':
+            return typeof value === 'boolean' ? undefined : say('boolean');
+        case 'date':
+            return checkDate(value, say);
+        case 'datetime':
+            return checkDateTime(value, say);
+        case 'selection': {
+            const allowed = new Set(field.options.map((o) => o.value));
+            const listing = say('choice', { options: field.options.map((o) => o.label).join(', ') });
+            if (field.multiple) {
+                if (!Array.isArray(value))
+                    return say('choices');
+                return value.every((v) => allowed.has(v)) ? undefined : listing;
+            }
+            return allowed.has(value) ? undefined : listing;
+        }
+        case 'many2one':
+            return isRecord(value) ? undefined : say('record');
+        case 'many2many':
+            return Array.isArray(value) && value.every(isRecord) ? undefined : say('records');
+        case 'reference': {
+            const ref = value;
+            if (!isRecord(value) || typeof ref.model !== 'string')
+                return say('record');
+            if (!field.models.some((m) => m.value === ref.model)) {
+                const models = listOr(field.models.map((m) => m.label), messages.or);
+                return say('reference', { models, aModels: article(models) });
+            }
+            return undefined;
+        }
+        case 'binary':
+        case 'image':
+            return checkFile(field, value, say, messages);
+        default:
+            return undefined;
+    }
+}
+function decimals(value) {
+    const text = String(value);
+    if (text.includes('e-'))
+        return Number(text.split('e-')[1]);
+    const dot = text.indexOf('.');
+    return dot === -1 ? 0 : text.length - dot - 1;
+}
+function isRecord(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        !Array.isArray(value) &&
+        (typeof value.id === 'number' || typeof value.id === 'string') &&
+        typeof value.label === 'string');
+}
+function checkDate(value, say) {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return say('dateFormat');
+    const [y, m, d] = value.split('-').map(Number);
+    return realDay(y, m, d) ? undefined : say('dateInvalid');
+}
+const ISO_DATETIME = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,9})?)?(?:Z|[+-]\d{2}:\d{2})?$/;
+function checkDateTime(value, say) {
+    const match = typeof value === 'string' ? ISO_DATETIME.exec(value) : null;
+    if (!match)
+        return say('datetimeFormat');
+    const [y, mo, d, h, mi, s] = match.slice(1).map((part) => Number(part ?? 0));
+    return realDay(y, mo, d) && h < 24 && mi < 60 && s < 60 ? undefined : say('datetimeInvalid');
+}
+function realDay(year, month, day) {
+    if (month < 1 || month > 12 || day < 1)
+        return false;
+    const lengths = [31, year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+    return day <= lengths[month - 1];
+}
+function checkFile(field, value, say, messages) {
+    const file = value;
+    if (!isFile(value))
+        return say('file');
+    if ('maxSize' in field && field.maxSize !== undefined && file.size > field.maxSize) {
+        return say('fileSize', { size: formatBytes(field.maxSize) });
+    }
+    if (field.type === 'binary' && field.accept && !field.accept.some((pattern) => matchesType(pattern, file.type))) {
+        const types = listOr(field.accept.map(describeType), messages.or);
+        return say('fileType', { types, aTypes: article(types) });
+    }
+    return undefined;
+}
+function isFile(value) {
+    const file = value;
+    return value !== null && typeof value === 'object' && typeof file.name === 'string' && typeof file.size === 'number';
+}
+function matchesType(pattern, type) {
+    return pattern.endsWith('/*') ? type.startsWith(pattern.slice(0, -1)) : pattern === type;
+}
+function describeType(pattern) {
+    if (pattern.endsWith('/*'))
+        return pattern.slice(0, -2);
+    if (pattern === 'application/pdf')
+        return 'PDF';
+    return (pattern.split('/')[1] ?? pattern).toUpperCase();
+}
+function listOr(items, or) {
+    if (items.length <= 1)
+        return items.join('');
+    return `${items.slice(0, -1).join(', ')} ${or} ${items[items.length - 1]}`;
+}
+function article(phrase) {
+    return /^[aeiou]/i.test(phrase) ? `an ${phrase}` : `a ${phrase}`;
+}
+/** 1048576 -> "1 MB". */
+export function formatBytes(bytes) {
+    const units = ['bytes', 'KB', 'MB', 'GB'];
+    let size = bytes;
+    let unit = 0;
+    while (size >= 1024 && unit < units.length - 1) {
+        size /= 1024;
+        unit++;
+    }
+    return `${Number(size.toFixed(1))} ${units[unit]}`;
+}
+//# sourceMappingURL=check.mjs.map

package/src/lib/record/check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAuE,MAAM,UAAU,CAAC;AAExG;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,KAAwB,EACxB,KAAwB,EACxB,QAAiB,EACjB,WAAqB,QAAQ,CAAC,EAAE;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,YAAY,CAAC;IAC1C,MAAM,GAAG,GAAG,CAAC,GAAmB,EAAE,SAA0C,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC7H,IAAI,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC9G,OAAO,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnG,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,SAAS,CAAC;QACf,KAAK,OAAO,CAAC;QACb,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC/E,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;YAChF,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG;gBAAE,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACxF,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG;gBAAE,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACxF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClF,OAAO,GAAG,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjE,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/B,KAAK,UAAU;YACb,OAAO,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnC,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzF,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBAAE,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;gBACjD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;YACrF,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAwB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QACrE,CAAC;QACD,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrD,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpF,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,GAAG,GAAG,KAAuB,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;gBAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5E,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACrE,OAAO,GAAG,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,CAAC,OAAQ,KAAuB,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAQ,KAAuB,CAAC,EAAE,KAAK,QAAQ,CAAC;QACpG,OAAQ,KAAuB,CAAC,KAAK,KAAK,QAAQ,CACnD,CAAC;AACJ,CAAC;AAID,SAAS,SAAS,CAAC,KAAwB,EAAE,GAAQ;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC;IAC9F,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,YAAY,GAAG,4FAA4F,CAAC;AAElH,SAAS,aAAa,CAAC,KAAwB,EAAE,GAAQ;IACvD,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACzC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACvD,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,OAAO,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjI,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,SAAS,CAAC,KAAwB,EAAE,KAAwB,EAAE,GAAQ,EAAE,QAAkB;IACjG,MAAM,IAAI,GAAG,KAAkB,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACnF,OAAO,GAAG,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAChH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,MAAM,IAAI,GAAG,KAAkB,CAAC;IAChC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AACvH,CAAC;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,IAAY;IAChD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;AAC3F,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,MAAM,CAAC,KAAe,EAAE,EAAU;IACzC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,OAAO,CAAC,MAAc;IAC7B,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;AACnE,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,IAAI,IAAI,CAAC;QACb,IAAI,EAAE,CAAC;IACT,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/src/lib/record/data-source.d.mts

@@ -0,0 +1,109 @@
+import type { FilterCondition, Fields } from '../format/field.mjs';
+import type { JsonValue } from '../format/json.mjs';
+import type { RecordId, RelatedRecord, Values } from './values.mjs';
+/**
+ * How Fieldia reaches data. Fieldia knows no backend: an app implements this
+ * interface for its own (a Flectra adapter, a REST client, a survey store),
+ * and every method is optional so a page uses only what it needs.
+ */
+export interface DataSource {
+    /** Read a record. Needed to edit an existing record. */
+    load?(request: LoadRequest): Promise<Values>;
+    /** Create (`id: null`) or update a record. Needed to save a record page. */
+    save?(request: SaveRequest): Promise<SaveResult>;
+    /** Recalculate after a value changes, the way a backend's onchange does. */
+    onchange?(request: OnchangeRequest): Promise<OnchangeResult>;
+    /** Find records a many2one, many2many or reference may point to. */
+    search?(request: SearchRequest): Promise<RelatedRecord[]>;
+    /** Store one response to a `responses` page, such as a survey. */
+    submit?(request: SubmitRequest): Promise<SubmitResult>;
+}
+export interface LoadRequest {
+    model: string;
+    id: RecordId;
+    /** The page's fields, so the source reads exactly what the page shows. */
+    fields: Fields;
+}
+export interface SaveRequest {
+    model: string;
+    id: RecordId | null;
+    /** The page's fields, so the source knows each relation's model. */
+    fields: Fields;
+    /** Only what changed since the record was loaded or last saved. */
+    changes: RecordChanges;
+    /** Every value, for sources that save whole records. */
+    values: Values;
+}
+export interface SaveResult {
+    id: RecordId;
+    /** The record as stored, when the source recalculated anything. */
+    values?: Values;
+}
+export interface OnchangeRequest {
+    model: string;
+    id: RecordId | null;
+    /** The field that changed. */
+    changed: string;
+    values: Values;
+}
+export interface OnchangeResult {
+    /** New values for other fields. */
+    values?: Values;
+    /** Something to tell the person editing, without blocking them. */
+    warning?: string;
+}
+export interface SearchRequest {
+    /** The related model, from the field's `relation`. */
+    model: string;
+    query: string;
+    /** The field's filter, with every `valueFrom` already replaced by its value. */
+    filter?: ResolvedFilterCondition[];
+    limit?: number;
+}
+export type ResolvedFilterCondition = Omit<FilterCondition, 'valueFrom' | 'value'> & {
+    value: JsonValue;
+};
+export interface SubmitRequest {
+    pageId: string;
+    /** The answers to the questions that were shown. Skipped steps are left out. */
+    values: Values;
+}
+export interface SubmitResult {
+    id?: RecordId;
+}
+/**
+ * What changed, using the operation names Odoo gives its x2many commands, so
+ * an adapter maps them one to one.
+ */
+export interface RecordChanges {
+    /** Changed values of every field that is not one2many or many2many. */
+    values: Values;
+    /** one2many changes, per field. */
+    lines: Record<string, LineOp[]>;
+    /** many2many changes, per field. */
+    links: Record<string, LinkOp[]>;
+}
+export type LineOp = {
+    op: 'create';
+    key: string;
+    values: Values;
+} | {
+    op: 'update';
+    id: RecordId;
+    values: Values;
+} | {
+    op: 'delete';
+    id: RecordId;
+};
+export type LinkOp = {
+    op: 'link';
+    id: RecordId;
+} | {
+    op: 'unlink';
+    id: RecordId;
+} | {
+    op: 'set';
+    ids: RecordId[];
+} | {
+    op: 'clear';
+};

package/src/lib/record/data-source.d.ts

@@ -0,0 +1,109 @@
+import type { FilterCondition, Fields } from '../format/field';
+import type { JsonValue } from '../format/json';
+import type { RecordId, RelatedRecord, Values } from './values';
+/**
+ * How Fieldia reaches data. Fieldia knows no backend: an app implements this
+ * interface for its own (a Flectra adapter, a REST client, a survey store),
+ * and every method is optional so a page uses only what it needs.
+ */
+export interface DataSource {
+    /** Read a record. Needed to edit an existing record. */
+    load?(request: LoadRequest): Promise<Values>;
+    /** Create (`id: null`) or update a record. Needed to save a record page. */
+    save?(request: SaveRequest): Promise<SaveResult>;
+    /** Recalculate after a value changes, the way a backend's onchange does. */
+    onchange?(request: OnchangeRequest): Promise<OnchangeResult>;
+    /** Find records a many2one, many2many or reference may point to. */
+    search?(request: SearchRequest): Promise<RelatedRecord[]>;
+    /** Store one response to a `responses` page, such as a survey. */
+    submit?(request: SubmitRequest): Promise<SubmitResult>;
+}
+export interface LoadRequest {
+    model: string;
+    id: RecordId;
+    /** The page's fields, so the source reads exactly what the page shows. */
+    fields: Fields;
+}
+export interface SaveRequest {
+    model: string;
+    id: RecordId | null;
+    /** The page's fields, so the source knows each relation's model. */
+    fields: Fields;
+    /** Only what changed since the record was loaded or last saved. */
+    changes: RecordChanges;
+    /** Every value, for sources that save whole records. */
+    values: Values;
+}
+export interface SaveResult {
+    id: RecordId;
+    /** The record as stored, when the source recalculated anything. */
+    values?: Values;
+}
+export interface OnchangeRequest {
+    model: string;
+    id: RecordId | null;
+    /** The field that changed. */
+    changed: string;
+    values: Values;
+}
+export interface OnchangeResult {
+    /** New values for other fields. */
+    values?: Values;
+    /** Something to tell the person editing, without blocking them. */
+    warning?: string;
+}
+export interface SearchRequest {
+    /** The related model, from the field's `relation`. */
+    model: string;
+    query: string;
+    /** The field's filter, with every `valueFrom` already replaced by its value. */
+    filter?: ResolvedFilterCondition[];
+    limit?: number;
+}
+export type ResolvedFilterCondition = Omit<FilterCondition, 'valueFrom' | 'value'> & {
+    value: JsonValue;
+};
+export interface SubmitRequest {
+    pageId: string;
+    /** The answers to the questions that were shown. Skipped steps are left out. */
+    values: Values;
+}
+export interface SubmitResult {
+    id?: RecordId;
+}
+/**
+ * What changed, using the operation names Odoo gives its x2many commands, so
+ * an adapter maps them one to one.
+ */
+export interface RecordChanges {
+    /** Changed values of every field that is not one2many or many2many. */
+    values: Values;
+    /** one2many changes, per field. */
+    lines: Record<string, LineOp[]>;
+    /** many2many changes, per field. */
+    links: Record<string, LinkOp[]>;
+}
+export type LineOp = {
+    op: 'create';
+    key: string;
+    values: Values;
+} | {
+    op: 'update';
+    id: RecordId;
+    values: Values;
+} | {
+    op: 'delete';
+    id: RecordId;
+};
+export type LinkOp = {
+    op: 'link';
+    id: RecordId;
+} | {
+    op: 'unlink';
+    id: RecordId;
+} | {
+    op: 'set';
+    ids: RecordId[];
+} | {
+    op: 'clear';
+};

package/src/lib/record/data-source.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data-source.js.map

package/src/lib/record/data-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":""}

package/src/lib/record/data-source.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data-source.mjs.map

package/src/lib/record/data-source.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":""}

package/src/lib/record/form.d.mts

@@ -0,0 +1,106 @@
+import type { JsonValue } from '../format/json.mjs';
+import type { Page } from '../format/page.mjs';
+import { type Messages } from './messages.mjs';
+import type { DataSource, RecordChanges } from './data-source.mjs';
+import { type Scheduler } from './scheduler.mjs';
+import { type RecordId, type RelatedRecord, type Value, type Values } from './values.mjs';
+export type FormStatus = 'idle' | 'loading' | 'ready' | 'saving' | 'saved' | 'error';
+export interface FormState {
+    readonly status: FormStatus;
+    readonly recordId: RecordId | null;
+    readonly values: Readonly<Values>;
+    /** Messages by field name; a line's field is `field.lineKey.subfield`. */
+    readonly errors: Readonly<Record<string, string>>;
+    /** Fields that differ from the record as loaded or last saved. */
+    readonly dirty: readonly string[];
+    /** A warning from the data source's onchange, shown without blocking. */
+    readonly warning: string | null;
+    /** Why loading or saving failed. */
+    readonly error: string | null;
+    /** A saved draft that can be restored. */
+    readonly draft: {
+        savedAt: string;
+    } | null;
+    /** The wizard step on screen, for a wizard page. */
+    readonly step: string | null;
+}
+/** What a layout element looks like right now. */
+export interface NodeState {
+    invisible: boolean;
+    readonly: boolean;
+    required: boolean;
+}
+/** localStorage fits this, and so does anything else with the same three methods. */
+export interface DraftStore {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface ActionRequest {
+    /** The button or stat button pressed. */
+    id: string;
+    action: string;
+    params?: {
+        [key: string]: JsonValue;
+    };
+    recordId: RecordId | null;
+    values: Values;
+}
+export interface FormOptions {
+    page: Page;
+    dataSource?: DataSource;
+    /** The record to edit. Leave out for a new record or a survey. */
+    recordId?: RecordId | null;
+    /** Values to start with, on top of each field's default. */
+    values?: Values;
+    /** What a button does. Fieldia hands the press over; the app decides. */
+    onAction?: (request: ActionRequest) => void | Promise<void>;
+    drafts?: {
+        store: DraftStore;
+        restore?: 'auto' | 'ask';
+        delayMs?: number;
+    };
+    autosave?: {
+        delayMs: number;
+    };
+    scheduler?: Scheduler;
+    /** Validation messages in the page's language. English by default. */
+    messages?: Messages;
+}
+export interface Form {
+    readonly page: Page;
+    getState(): FormState;
+    subscribe(listener: (state: FormState) => void): () => void;
+    load(): Promise<void>;
+    setValue(name: string, value: Value): void;
+    node(id: string): NodeState;
+    fieldReadonly(name: string): boolean;
+    validate(): boolean;
+    save(): Promise<boolean>;
+    reset(): void;
+    changes(): RecordChanges;
+    addLine(field: string, values?: Values): string;
+    updateLine(field: string, key: string, name: string, value: Value): void;
+    removeLine(field: string, key: string): void;
+    /** Records a many2one, many2many or reference may point to. A reference needs `options.model`. */
+    search(field: string, query: string, limit?: number, options?: {
+        model?: string;
+    }): Promise<RelatedRecord[]>;
+    /** The same, for a relation inside a one2many line, filtered by that line's values. */
+    searchLine(field: string, key: string, subfield: string, query: string, limit?: number): Promise<RelatedRecord[]>;
+    steps(): string[];
+    next(): boolean;
+    back(): boolean;
+    runAction(id: string): Promise<void>;
+    restoreDraft(): void;
+    discardDraft(): void;
+    /** Resolves once every onchange, save and autosave started so far has finished. */
+    settled(): Promise<void>;
+    dispose(): void;
+}
+/**
+ * The record state behind a page: values, what changed, what is visible and
+ * required, errors, loading and saving. No DOM and no framework — every
+ * binding renders from `getState()` and calls these methods.
+ */
+export declare function createForm(options: FormOptions): Form;

package/src/lib/record/form.d.ts

@@ -0,0 +1,106 @@
+import type { JsonValue } from '../format/json';
+import type { Page } from '../format/page';
+import { type Messages } from './messages';
+import type { DataSource, RecordChanges } from './data-source';
+import { type Scheduler } from './scheduler';
+import { type RecordId, type RelatedRecord, type Value, type Values } from './values';
+export type FormStatus = 'idle' | 'loading' | 'ready' | 'saving' | 'saved' | 'error';
+export interface FormState {
+    readonly status: FormStatus;
+    readonly recordId: RecordId | null;
+    readonly values: Readonly<Values>;
+    /** Messages by field name; a line's field is `field.lineKey.subfield`. */
+    readonly errors: Readonly<Record<string, string>>;
+    /** Fields that differ from the record as loaded or last saved. */
+    readonly dirty: readonly string[];
+    /** A warning from the data source's onchange, shown without blocking. */
+    readonly warning: string | null;
+    /** Why loading or saving failed. */
+    readonly error: string | null;
+    /** A saved draft that can be restored. */
+    readonly draft: {
+        savedAt: string;
+    } | null;
+    /** The wizard step on screen, for a wizard page. */
+    readonly step: string | null;
+}
+/** What a layout element looks like right now. */
+export interface NodeState {
+    invisible: boolean;
+    readonly: boolean;
+    required: boolean;
+}
+/** localStorage fits this, and so does anything else with the same three methods. */
+export interface DraftStore {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface ActionRequest {
+    /** The button or stat button pressed. */
+    id: string;
+    action: string;
+    params?: {
+        [key: string]: JsonValue;
+    };
+    recordId: RecordId | null;
+    values: Values;
+}
+export interface FormOptions {
+    page: Page;
+    dataSource?: DataSource;
+    /** The record to edit. Leave out for a new record or a survey. */
+    recordId?: RecordId | null;
+    /** Values to start with, on top of each field's default. */
+    values?: Values;
+    /** What a button does. Fieldia hands the press over; the app decides. */
+    onAction?: (request: ActionRequest) => void | Promise<void>;
+    drafts?: {
+        store: DraftStore;
+        restore?: 'auto' | 'ask';
+        delayMs?: number;
+    };
+    autosave?: {
+        delayMs: number;
+    };
+    scheduler?: Scheduler;
+    /** Validation messages in the page's language. English by default. */
+    messages?: Messages;
+}
+export interface Form {
+    readonly page: Page;
+    getState(): FormState;
+    subscribe(listener: (state: FormState) => void): () => void;
+    load(): Promise<void>;
+    setValue(name: string, value: Value): void;
+    node(id: string): NodeState;
+    fieldReadonly(name: string): boolean;
+    validate(): boolean;
+    save(): Promise<boolean>;
+    reset(): void;
+    changes(): RecordChanges;
+    addLine(field: string, values?: Values): string;
+    updateLine(field: string, key: string, name: string, value: Value): void;
+    removeLine(field: string, key: string): void;
+    /** Records a many2one, many2many or reference may point to. A reference needs `options.model`. */
+    search(field: string, query: string, limit?: number, options?: {
+        model?: string;
+    }): Promise<RelatedRecord[]>;
+    /** The same, for a relation inside a one2many line, filtered by that line's values. */
+    searchLine(field: string, key: string, subfield: string, query: string, limit?: number): Promise<RelatedRecord[]>;
+    steps(): string[];
+    next(): boolean;
+    back(): boolean;
+    runAction(id: string): Promise<void>;
+    restoreDraft(): void;
+    discardDraft(): void;
+    /** Resolves once every onchange, save and autosave started so far has finished. */
+    settled(): Promise<void>;
+    dispose(): void;
+}
+/**
+ * The record state behind a page: values, what changed, what is visible and
+ * required, errors, loading and saving. No DOM and no framework — every
+ * binding renders from `getState()` and calls these methods.
+ */
+export declare function createForm(options: FormOptions): Form;