@fieldia/core 0.23.0 → 0.25.0

package/src/lib/format/autofill.mjs

@@ -0,0 +1,48 @@
+/**
+ * What a box is filled in with by the browser — its autocomplete purpose,
+ * from the WHATWG HTML standard's list ("Autofilling form controls: the
+ * autocomplete attribute") — and the keyboard a phone shows for it.
+ *
+ * A field placed on a page may name its purpose (`autocomplete`): one of the
+ * names below, after which `section-…` and `shipping` or `billing` may come
+ * first, `home`, `work`, `mobile`, `fax` or `pager` before a phone, an email
+ * or an `impp`, and `webauthn` last — "shipping postal-code", "work email" —
+ * or `off`, so the browser offers nothing. An address in parts names each
+ * part's own purpose, so its field gives only the group: "shipping",
+ * "section-home billing", or `off`. Written in small letters.
+ */
+import { autofillGroupProblem } from './autofill-group.mjs';
+export { INPUT_MODES } from './autofill-group.mjs';
+/** The purposes a box may name, but a phone's, an email's and an instant messenger's (`AUTOFILL_CONTACT`). */
+export const AUTOFILL_NAMES = [
+    'name', 'honorific-prefix', 'given-name', 'additional-name', 'family-name', 'honorific-suffix', 'nickname',
+    'username', 'new-password', 'current-password', 'one-time-code', 'organization-title', 'organization',
+    'street-address', 'address-line1', 'address-line2', 'address-line3', 'address-level4', 'address-level3',
+    'address-level2', 'address-level1', 'country', 'country-name', 'postal-code',
+    'cc-name', 'cc-given-name', 'cc-additional-name', 'cc-family-name', 'cc-number', 'cc-exp', 'cc-exp-month',
+    'cc-exp-year', 'cc-csc', 'cc-type', 'transaction-currency', 'transaction-amount',
+    'language', 'bday', 'bday-day', 'bday-month', 'bday-year', 'sex', 'url', 'photo',
+];
+/** The purposes that may say whose they are (`home`, `work`, `mobile`, `fax`, `pager` before them). */
+export const AUTOFILL_CONTACT = ['tel', 'tel-country-code', 'tel-national', 'tel-area-code', 'tel-local', 'tel-local-prefix', 'tel-local-suffix', 'tel-extension', 'email', 'impp'];
+const GROUP = '(?:section-\\S*(?: +(?:shipping|billing))?|shipping|billing)';
+const PURPOSE = `(?:${AUTOFILL_NAMES.join('|')}|(?:(?:home|work|mobile|fax|pager) +)?(?:${AUTOFILL_CONTACT.join('|')}))`;
+/** A purpose as a page may write it: `on`, `off`, a group alone (an address's), or a purpose with its group first and `webauthn` last. */
+export const AUTOFILL = new RegExp(`^(?:on|off|${GROUP}|(?:${GROUP} +)?${PURPOSE}(?: +webauthn)?)$`);
+/**
+ * Why a field placed on a page cannot name this purpose, or null when it can: one the standard does not list, a group
+ * with no purpose on a box, a purpose on an address in parts (`parts`), which names each part's own.
+ */
+export function autofillProblem(value, parts = false) {
+    if (!AUTOFILL.test(value)) {
+        return `"${value}" is no purpose a browser fills in: use one of the HTML standard's, in small letters, such as "email", "given-name", "shipping postal-code" or "off"`;
+    }
+    return autofillGroupProblem(value, parts);
+}
+/** The purpose itself, its group and whose it is left out: "shipping work tel" is "tel"; empty for `on`, `off` and a group alone. */
+export function autofillPurpose(value) {
+    const words = value.split(/ +/).filter((word) => word !== 'webauthn');
+    const last = words[words.length - 1] ?? '';
+    return AUTOFILL_NAMES.includes(last) || AUTOFILL_CONTACT.includes(last) ? last : '';
+}
+//# sourceMappingURL=autofill.mjs.map

package/src/lib/format/autofill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"autofill.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/autofill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAE/D,8GAA8G;AAC9G,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU;IAC1G,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,oBAAoB,EAAE,cAAc;IACrG,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB;IACvG,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa;IAC5E,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc;IACzG,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,sBAAsB,EAAE,oBAAoB;IAChF,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO;CACxE,CAAC;AAEX,uGAAuG;AACvG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAE7L,MAAM,KAAK,GAAG,8DAA8D,CAAC;AAC7E,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,4CAA4C,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;AAEzH,0IAA0I;AAC1I,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,cAAc,KAAK,OAAO,KAAK,OAAO,OAAO,mBAAmB,CAAC,CAAC;AAErG;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAK,GAAG,KAAK;IAC1D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,KAAK,sJAAsJ,CAAC;IACzK,CAAC;IACD,OAAO,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,qIAAqI;AACrI,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAQ,cAAoC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAK,gBAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACpI,CAAC"}

package/src/lib/format/bulk-edit.d.mts

@@ -0,0 +1,18 @@
+import type { Field } from './field.mjs';
+import type { ListNode } from './layout.mjs';
+import type { Page } from './page.mjs';
+/**
+ * The kinds of field one value can set in many records at once (a list's
+ * `bulkEdit`): words, numbers, money, yes or no, a day, a choice and a link.
+ * Never a table of lines, links, files, formatted text, JSON or properties,
+ * which one value would wipe or cannot say.
+ */
+export declare const BULK_KINDS: ReadonlySet<string>;
+/** Whether a field can be set in many records at once: of such a kind, neither read-only nor worked out from others. */
+export declare function bulkSettable(def: Field | undefined): boolean;
+/**
+ * The fields a list's Edit offers, in order: none unless the list says
+ * `bulkEdit`; with true, its columns that can be set; with a list, those of
+ * it that can.
+ */
+export declare function bulkEditFields(page: Page, list: ListNode): string[];

package/src/lib/format/bulk-edit.d.ts

@@ -0,0 +1,18 @@
+import type { Field } from './field';
+import type { ListNode } from './layout';
+import type { Page } from './page';
+/**
+ * The kinds of field one value can set in many records at once (a list's
+ * `bulkEdit`): words, numbers, money, yes or no, a day, a choice and a link.
+ * Never a table of lines, links, files, formatted text, JSON or properties,
+ * which one value would wipe or cannot say.
+ */
+export declare const BULK_KINDS: ReadonlySet<string>;
+/** Whether a field can be set in many records at once: of such a kind, neither read-only nor worked out from others. */
+export declare function bulkSettable(def: Field | undefined): boolean;
+/**
+ * The fields a list's Edit offers, in order: none unless the list says
+ * `bulkEdit`; with true, its columns that can be set; with a list, those of
+ * it that can.
+ */
+export declare function bulkEditFields(page: Page, list: ListNode): string[];

package/src/lib/format/bulk-edit.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BULK_KINDS = void 0;
+exports.bulkSettable = bulkSettable;
+exports.bulkEditFields = bulkEditFields;
+/**
+ * The kinds of field one value can set in many records at once (a list's
+ * `bulkEdit`): words, numbers, money, yes or no, a day, a choice and a link.
+ * Never a table of lines, links, files, formatted text, JSON or properties,
+ * which one value would wipe or cannot say.
+ */
+exports.BULK_KINDS = new Set(['char', 'text', 'integer', 'float', 'monetary', 'boolean', 'date', 'datetime', 'selection', 'many2one']);
+/** Whether a field can be set in many records at once: of such a kind, neither read-only nor worked out from others. */
+function bulkSettable(def) {
+    return !!def && exports.BULK_KINDS.has(def.type) && def.readonly !== true && !def.compute;
+}
+/**
+ * The fields a list's Edit offers, in order: none unless the list says
+ * `bulkEdit`; with true, its columns that can be set; with a list, those of
+ * it that can.
+ */
+function bulkEditFields(page, list) {
+    const named = list.bulkEdit === true ? list.columns : Array.isArray(list.bulkEdit) ? list.bulkEdit : [];
+    return [...new Set(named)].filter((name) => bulkSettable(page.fields[name]));
+}
+//# sourceMappingURL=bulk-edit.js.map

package/src/lib/format/bulk-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-edit.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/bulk-edit.ts"],"names":[],"mappings":";;;AAaA,oCAEC;AAOD,wCAGC;AArBD;;;;;GAKG;AACU,QAAA,UAAU,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEjK,wHAAwH;AACxH,SAAgB,YAAY,CAAC,GAAsB;IACjD,OAAO,CAAC,CAAC,GAAG,IAAI,kBAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,IAAU,EAAE,IAAc;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/src/lib/format/bulk-edit.mjs

@@ -0,0 +1,21 @@
+/**
+ * The kinds of field one value can set in many records at once (a list's
+ * `bulkEdit`): words, numbers, money, yes or no, a day, a choice and a link.
+ * Never a table of lines, links, files, formatted text, JSON or properties,
+ * which one value would wipe or cannot say.
+ */
+export const BULK_KINDS = new Set(['char', 'text', 'integer', 'float', 'monetary', 'boolean', 'date', 'datetime', 'selection', 'many2one']);
+/** Whether a field can be set in many records at once: of such a kind, neither read-only nor worked out from others. */
+export function bulkSettable(def) {
+    return !!def && BULK_KINDS.has(def.type) && def.readonly !== true && !def.compute;
+}
+/**
+ * The fields a list's Edit offers, in order: none unless the list says
+ * `bulkEdit`; with true, its columns that can be set; with a list, those of
+ * it that can.
+ */
+export function bulkEditFields(page, list) {
+    const named = list.bulkEdit === true ? list.columns : Array.isArray(list.bulkEdit) ? list.bulkEdit : [];
+    return [...new Set(named)].filter((name) => bulkSettable(page.fields[name]));
+}
+//# sourceMappingURL=bulk-edit.mjs.map

package/src/lib/format/bulk-edit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-edit.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/bulk-edit.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEjK,wHAAwH;AACxH,MAAM,UAAU,YAAY,CAAC,GAAsB;IACjD,OAAO,CAAC,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,IAAc;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/src/lib/format/duplicate-kinds.d.mts

@@ -0,0 +1,10 @@
+import type { Field } from './field.mjs';
+/**
+ * The kinds of field a record is compared by, for possible duplicates (`duplicates` on a page): words (a name, a
+ * phone, an email, an id), a number (an id kept as one), a day (a birthday), a choice or a link (a company). Never a
+ * table, links, a file, formatted text or JSON, whose likeness is no one value's. Apart from the format's schema
+ * (duplicates.ts), so the page's quick check carries no validation library.
+ */
+export declare const DUPLICATE_KINDS: ReadonlySet<string>;
+/** Whether records may be compared by this field: of such a kind. */
+export declare const comparable: (def: Field | undefined) => boolean;

package/src/lib/format/duplicate-kinds.d.ts

@@ -0,0 +1,10 @@
+import type { Field } from './field';
+/**
+ * The kinds of field a record is compared by, for possible duplicates (`duplicates` on a page): words (a name, a
+ * phone, an email, an id), a number (an id kept as one), a day (a birthday), a choice or a link (a company). Never a
+ * table, links, a file, formatted text or JSON, whose likeness is no one value's. Apart from the format's schema
+ * (duplicates.ts), so the page's quick check carries no validation library.
+ */
+export declare const DUPLICATE_KINDS: ReadonlySet<string>;
+/** Whether records may be compared by this field: of such a kind. */
+export declare const comparable: (def: Field | undefined) => boolean;

package/src/lib/format/duplicate-kinds.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.comparable = exports.DUPLICATE_KINDS = void 0;
+/**
+ * The kinds of field a record is compared by, for possible duplicates (`duplicates` on a page): words (a name, a
+ * phone, an email, an id), a number (an id kept as one), a day (a birthday), a choice or a link (a company). Never a
+ * table, links, a file, formatted text or JSON, whose likeness is no one value's. Apart from the format's schema
+ * (duplicates.ts), so the page's quick check carries no validation library.
+ */
+exports.DUPLICATE_KINDS = new Set(['char', 'text', 'integer', 'float', 'date', 'selection', 'many2one']);
+/** Whether records may be compared by this field: of such a kind. */
+const comparable = (def) => !!def && exports.DUPLICATE_KINDS.has(def.type);
+exports.comparable = comparable;
+//# sourceMappingURL=duplicate-kinds.js.map

package/src/lib/format/duplicate-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-kinds.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/duplicate-kinds.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACU,QAAA,eAAe,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEnI,qEAAqE;AAC9D,MAAM,UAAU,GAAG,CAAC,GAAsB,EAAW,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,uBAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAAzF,QAAA,UAAU,cAA+E"}

package/src/lib/format/duplicate-kinds.mjs

@@ -0,0 +1,10 @@
+/**
+ * The kinds of field a record is compared by, for possible duplicates (`duplicates` on a page): words (a name, a
+ * phone, an email, an id), a number (an id kept as one), a day (a birthday), a choice or a link (a company). Never a
+ * table, links, a file, formatted text or JSON, whose likeness is no one value's. Apart from the format's schema
+ * (duplicates.ts), so the page's quick check carries no validation library.
+ */
+export const DUPLICATE_KINDS = new Set(['char', 'text', 'integer', 'float', 'date', 'selection', 'many2one']);
+/** Whether records may be compared by this field: of such a kind. */
+export const comparable = (def) => !!def && DUPLICATE_KINDS.has(def.type);
+//# sourceMappingURL=duplicate-kinds.mjs.map

package/src/lib/format/duplicate-kinds.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-kinds.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/duplicate-kinds.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEnI,qEAAqE;AACrE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAsB,EAAW,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}

package/src/lib/format/duplicates.d.mts

@@ -0,0 +1,22 @@
+import * as z from 'zod';
+/**
+ * Possible duplicates (`duplicates` on a record's page): while a person types a record — and again as it is saved —
+ * the page asks the data source's `duplicates` whether records like it exist already, by the fields named here: the
+ * same phone, the same email, the same tax or national id, a name close enough. What matched is said under the field
+ * it matched on, with Open it, "It's someone new" and Merge. Without the source's `duplicates`, nothing is asked and
+ * nothing shows.
+ *
+ *   "duplicates": { "fields": ["name", "phone", "email", "vat"] }
+ *   "duplicates": { "fields": ["phone", "email"], "on": "save" }
+ *
+ * `on`: `type` (the default) asks as a field named here is typed in, a moment after the typing stops, as a saved
+ * record is opened, and as the record is saved; `save` only as it is saved.
+ */
+export declare const PageDuplicatesSchema: z.ZodObject<{
+    fields: z.ZodArray<z.ZodString>;
+    on: z.ZodOptional<z.ZodEnum<{
+        type: "type";
+        save: "save";
+    }>>;
+}, z.core.$strict>;
+export type PageDuplicates = z.infer<typeof PageDuplicatesSchema>;

package/src/lib/format/duplicates.d.ts

@@ -0,0 +1,22 @@
+import * as z from 'zod';
+/**
+ * Possible duplicates (`duplicates` on a record's page): while a person types a record — and again as it is saved —
+ * the page asks the data source's `duplicates` whether records like it exist already, by the fields named here: the
+ * same phone, the same email, the same tax or national id, a name close enough. What matched is said under the field
+ * it matched on, with Open it, "It's someone new" and Merge. Without the source's `duplicates`, nothing is asked and
+ * nothing shows.
+ *
+ *   "duplicates": { "fields": ["name", "phone", "email", "vat"] }
+ *   "duplicates": { "fields": ["phone", "email"], "on": "save" }
+ *
+ * `on`: `type` (the default) asks as a field named here is typed in, a moment after the typing stops, as a saved
+ * record is opened, and as the record is saved; `save` only as it is saved.
+ */
+export declare const PageDuplicatesSchema: z.ZodObject<{
+    fields: z.ZodArray<z.ZodString>;
+    on: z.ZodOptional<z.ZodEnum<{
+        type: "type";
+        save: "save";
+    }>>;
+}, z.z.core.$strict>;
+export type PageDuplicates = z.infer<typeof PageDuplicatesSchema>;

package/src/lib/format/duplicates.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageDuplicatesSchema = void 0;
+const z = require("zod");
+/**
+ * Possible duplicates (`duplicates` on a record's page): while a person types a record — and again as it is saved —
+ * the page asks the data source's `duplicates` whether records like it exist already, by the fields named here: the
+ * same phone, the same email, the same tax or national id, a name close enough. What matched is said under the field
+ * it matched on, with Open it, "It's someone new" and Merge. Without the source's `duplicates`, nothing is asked and
+ * nothing shows.
+ *
+ *   "duplicates": { "fields": ["name", "phone", "email", "vat"] }
+ *   "duplicates": { "fields": ["phone", "email"], "on": "save" }
+ *
+ * `on`: `type` (the default) asks as a field named here is typed in, a moment after the typing stops, as a saved
+ * record is opened, and as the record is saved; `save` only as it is saved.
+ */
+exports.PageDuplicatesSchema = z
+    .strictObject({
+    fields: z.array(z.string().min(1)).min(1),
+    on: z.enum(['type', 'save'], { error: 'on is "type" (asked as the fields are typed in, and as the record is saved) or "save" (as it is saved)' }).optional(),
+})
+    .meta({ id: 'PageDuplicates' });
+//# sourceMappingURL=duplicates.js.map

package/src/lib/format/duplicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/duplicates.ts"],"names":[],"mappings":";;;AAAA,yBAAyB;AAEzB;;;;;;;;;;;;GAYG;AACU,QAAA,oBAAoB,GAAG,CAAC;KAClC,YAAY,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,wGAAwG,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7J,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC"}

package/src/lib/format/duplicates.mjs

@@ -0,0 +1,21 @@
+import * as z from 'zod';
+/**
+ * Possible duplicates (`duplicates` on a record's page): while a person types a record — and again as it is saved —
+ * the page asks the data source's `duplicates` whether records like it exist already, by the fields named here: the
+ * same phone, the same email, the same tax or national id, a name close enough. What matched is said under the field
+ * it matched on, with Open it, "It's someone new" and Merge. Without the source's `duplicates`, nothing is asked and
+ * nothing shows.
+ *
+ *   "duplicates": { "fields": ["name", "phone", "email", "vat"] }
+ *   "duplicates": { "fields": ["phone", "email"], "on": "save" }
+ *
+ * `on`: `type` (the default) asks as a field named here is typed in, a moment after the typing stops, as a saved
+ * record is opened, and as the record is saved; `save` only as it is saved.
+ */
+export const PageDuplicatesSchema = z
+    .strictObject({
+    fields: z.array(z.string().min(1)).min(1),
+    on: z.enum(['type', 'save'], { error: 'on is "type" (asked as the fields are typed in, and as the record is saved) or "save" (as it is saved)' }).optional(),
+})
+    .meta({ id: 'PageDuplicates' });
+//# sourceMappingURL=duplicates.mjs.map

package/src/lib/format/duplicates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/duplicates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,YAAY,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,wGAAwG,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7J,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC"}