@fieldia/core 0.28.0 → 0.29.0

package/src/lib/format/scan-options.d.ts

@@ -0,0 +1,84 @@
+import * as z from 'zod';
+/**
+ * A code scanned with the camera into a field (`options.scan`): a Scan button beside its box opens the camera in a sheet
+ * (the back camera on a phone), and a code read fills the field — a char's or a text's words, a link's record found by
+ * its code. On a table of lines, each code read counts: the line holding what it names gets one more, else a line is
+ * added with one. A scanner gun (a keyboard wedge) types into the box as ever.
+ *
+ * `true`, or its settings:
+ *
+ * - `formats`: the kinds of code read — `qr_code`, `data_matrix`, `ean_13`, `ean_8`, `upc_a`, `upc_e`, `code_128`,
+ *   `code_39`; every one when left out. Fewer read faster, and never mistake a box's other codes for the one meant.
+ * - `by`: a link's — the field of the linked records that holds their code ("barcode"), whose value must be the code
+ *   exactly; left out, the code is searched as a name is (an app's name search may find a product by its barcode).
+ * - `part`: a GS1 code's part this field takes, by its Application Identifier — "10" a batch or lot, "21" a serial
+ *   number, "01" a product's GTIN, "17" an expiry date; left out, the whole code.
+ * - `fills`: the other fields the same GS1 code fills, each by its part — `{ "expiry": "17", "product_id": { "part":
+ *   "01", "by": "barcode" } }` — a line's other columns for a cell or a counted line.
+ * - `sound`: false keeps the scan silent (a beep where the browser lets it, and a phone's buzz, otherwise).
+ * - A table of lines' own: `field`, the column a code names (a link, found as above, or words) and `count`, the column
+ *   counted (a whole number).
+ *
+ *   { "field": "lot", "options": { "scan": { "formats": ["data_matrix"], "part": "10", "fills": { "expiry": "17" } } } }
+ *   { "field": "line_ids", "options": { "scan": { "field": "product_id", "count": "counted", "by": "barcode" } } }
+ */
+export declare const SCAN_FORMATS: readonly ["qr_code", "data_matrix", "ean_13", "ean_8", "upc_a", "upc_e", "code_128", "code_39"];
+export type ScanFormat = (typeof SCAN_FORMATS)[number];
+/** What one field takes of a GS1 code, among those a scan `fills`: its part, and for a link the field holding the code. */
+export declare const ScanFillSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    part: z.ZodString;
+    by: z.ZodOptional<z.ZodString>;
+}, z.z.core.$strict>]>;
+export declare const ScanSettingsSchema: z.ZodObject<{
+    formats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        qr_code: "qr_code";
+        data_matrix: "data_matrix";
+        ean_13: "ean_13";
+        ean_8: "ean_8";
+        upc_a: "upc_a";
+        upc_e: "upc_e";
+        code_128: "code_128";
+        code_39: "code_39";
+    }>>>;
+    by: z.ZodOptional<z.ZodString>;
+    part: z.ZodOptional<z.ZodString>;
+    fills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        part: z.ZodString;
+        by: z.ZodOptional<z.ZodString>;
+    }, z.z.core.$strict>]>>>;
+    sound: z.ZodOptional<z.ZodBoolean>;
+    field: z.ZodOptional<z.ZodString>;
+    count: z.ZodOptional<z.ZodString>;
+}, z.z.core.$strict>;
+/** `options.scan`: true for a Scan button as the field is, or its settings; false for none. */
+export declare const ScanOptionSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    formats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        qr_code: "qr_code";
+        data_matrix: "data_matrix";
+        ean_13: "ean_13";
+        ean_8: "ean_8";
+        upc_a: "upc_a";
+        upc_e: "upc_e";
+        code_128: "code_128";
+        code_39: "code_39";
+    }>>>;
+    by: z.ZodOptional<z.ZodString>;
+    part: z.ZodOptional<z.ZodString>;
+    fills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        part: z.ZodString;
+        by: z.ZodOptional<z.ZodString>;
+    }, z.z.core.$strict>]>>>;
+    sound: z.ZodOptional<z.ZodBoolean>;
+    field: z.ZodOptional<z.ZodString>;
+    count: z.ZodOptional<z.ZodString>;
+}, z.z.core.$strict>]>;
+export type ScanFill = z.infer<typeof ScanFillSchema>;
+export type ScanSettings = z.infer<typeof ScanSettingsSchema>;
+export type ScanOption = z.infer<typeof ScanOptionSchema>;
+/** The issues of a field's or a cell's `options.scan`, each at its path under `options`. */
+export declare function scanOptionIssues(node: {
+    options?: Record<string, unknown>;
+}): {
+    message: string;
+    path: (string | number)[];
+}[];

package/src/lib/format/scan-options.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScanOptionSchema = exports.ScanSettingsSchema = exports.ScanFillSchema = exports.SCAN_FORMATS = void 0;
+exports.scanOptionIssues = scanOptionIssues;
+const z = require("zod");
+/**
+ * A code scanned with the camera into a field (`options.scan`): a Scan button beside its box opens the camera in a sheet
+ * (the back camera on a phone), and a code read fills the field — a char's or a text's words, a link's record found by
+ * its code. On a table of lines, each code read counts: the line holding what it names gets one more, else a line is
+ * added with one. A scanner gun (a keyboard wedge) types into the box as ever.
+ *
+ * `true`, or its settings:
+ *
+ * - `formats`: the kinds of code read — `qr_code`, `data_matrix`, `ean_13`, `ean_8`, `upc_a`, `upc_e`, `code_128`,
+ *   `code_39`; every one when left out. Fewer read faster, and never mistake a box's other codes for the one meant.
+ * - `by`: a link's — the field of the linked records that holds their code ("barcode"), whose value must be the code
+ *   exactly; left out, the code is searched as a name is (an app's name search may find a product by its barcode).
+ * - `part`: a GS1 code's part this field takes, by its Application Identifier — "10" a batch or lot, "21" a serial
+ *   number, "01" a product's GTIN, "17" an expiry date; left out, the whole code.
+ * - `fills`: the other fields the same GS1 code fills, each by its part — `{ "expiry": "17", "product_id": { "part":
+ *   "01", "by": "barcode" } }` — a line's other columns for a cell or a counted line.
+ * - `sound`: false keeps the scan silent (a beep where the browser lets it, and a phone's buzz, otherwise).
+ * - A table of lines' own: `field`, the column a code names (a link, found as above, or words) and `count`, the column
+ *   counted (a whole number).
+ *
+ *   { "field": "lot", "options": { "scan": { "formats": ["data_matrix"], "part": "10", "fills": { "expiry": "17" } } } }
+ *   { "field": "line_ids", "options": { "scan": { "field": "product_id", "count": "counted", "by": "barcode" } } }
+ */
+exports.SCAN_FORMATS = ['qr_code', 'data_matrix', 'ean_13', 'ean_8', 'upc_a', 'upc_e', 'code_128', 'code_39'];
+/** A GS1 Application Identifier: two to four digits. */
+const AI = /^\d{2,4}$/;
+const part = z.string().regex(AI, 'a GS1 part is its Application Identifier, two to four digits: "10" a lot, "17" an expiry, "01" a GTIN');
+const fieldName = z.string().min(1);
+/** What one field takes of a GS1 code, among those a scan `fills`: its part, and for a link the field holding the code. */
+exports.ScanFillSchema = z.union([part, z.strictObject({ part, by: fieldName.optional() })], { error: 'a field filled is its GS1 part ("17"), or { "part": "01", "by": "barcode" } for a link' }).meta({ id: 'ScanFill' });
+exports.ScanSettingsSchema = z
+    .strictObject({
+    formats: z.array(z.enum(exports.SCAN_FORMATS, { error: `a format is one of ${exports.SCAN_FORMATS.join(', ')}` })).min(1).optional(),
+    by: fieldName.optional(),
+    part: part.optional(),
+    fills: z.record(fieldName, exports.ScanFillSchema).optional(),
+    sound: z.boolean().optional(),
+    field: fieldName.optional(),
+    count: fieldName.optional(),
+})
+    .meta({ id: 'ScanSettings' });
+/** `options.scan`: true for a Scan button as the field is, or its settings; false for none. */
+exports.ScanOptionSchema = z.union([z.boolean(), exports.ScanSettingsSchema], { error: 'scan is true, or its settings: { "formats": […], "by": "barcode", "part": "10", "fills": {…} }' }).meta({ id: 'ScanOption' });
+/** The issues of a field's or a cell's `options.scan`, each at its path under `options`. */
+function scanOptionIssues(node) {
+    const scan = node.options?.['scan'];
+    if (scan === undefined)
+        return [];
+    // Its settings checked as settings, so what is wrong in them is said where it is: never as "true or its settings".
+    const schema = scan && typeof scan === 'object' && !Array.isArray(scan) ? exports.ScanSettingsSchema : exports.ScanOptionSchema;
+    return (schema.safeParse(scan).error?.issues ?? []).map((issue) => ({ message: issue.message, path: ['options', 'scan', ...issue.path] }));
+}
+//# sourceMappingURL=scan-options.js.map

package/src/lib/format/scan-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-options.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/scan-options.ts"],"names":[],"mappings":";;;AAwDA,4CAMC;AA9DD,yBAAyB;AAEzB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACU,QAAA,YAAY,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAG5H,wDAAwD;AACxD,MAAM,EAAE,GAAG,WAAW,CAAC;AACvB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,uGAAuG,CAAC,CAAC;AAC3I,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEpC,2HAA2H;AAC9G,QAAA,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,wFAAwF,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAEnN,QAAA,kBAAkB,GAAG,CAAC;KAChC,YAAY,CAAC;IACZ,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAY,EAAE,EAAE,KAAK,EAAE,sBAAsB,oBAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpH,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE;IACxB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,sBAAc,CAAC,CAAC,QAAQ,EAAE;IACrD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;CAC5B,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AAEhC,+FAA+F;AAClF,QAAA,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,0BAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,gGAAgG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAMnN,4FAA4F;AAC5F,SAAgB,gBAAgB,CAAC,IAA2C;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,mHAAmH;IACnH,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,0BAAkB,CAAC,CAAC,CAAC,wBAAgB,CAAC;IAChH,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAwB,EAAE,CAAC,CAAC,CAAC;AACpK,CAAC"}

package/src/lib/format/scan-options.mjs

@@ -0,0 +1,54 @@
+import * as z from 'zod';
+/**
+ * A code scanned with the camera into a field (`options.scan`): a Scan button beside its box opens the camera in a sheet
+ * (the back camera on a phone), and a code read fills the field — a char's or a text's words, a link's record found by
+ * its code. On a table of lines, each code read counts: the line holding what it names gets one more, else a line is
+ * added with one. A scanner gun (a keyboard wedge) types into the box as ever.
+ *
+ * `true`, or its settings:
+ *
+ * - `formats`: the kinds of code read — `qr_code`, `data_matrix`, `ean_13`, `ean_8`, `upc_a`, `upc_e`, `code_128`,
+ *   `code_39`; every one when left out. Fewer read faster, and never mistake a box's other codes for the one meant.
+ * - `by`: a link's — the field of the linked records that holds their code ("barcode"), whose value must be the code
+ *   exactly; left out, the code is searched as a name is (an app's name search may find a product by its barcode).
+ * - `part`: a GS1 code's part this field takes, by its Application Identifier — "10" a batch or lot, "21" a serial
+ *   number, "01" a product's GTIN, "17" an expiry date; left out, the whole code.
+ * - `fills`: the other fields the same GS1 code fills, each by its part — `{ "expiry": "17", "product_id": { "part":
+ *   "01", "by": "barcode" } }` — a line's other columns for a cell or a counted line.
+ * - `sound`: false keeps the scan silent (a beep where the browser lets it, and a phone's buzz, otherwise).
+ * - A table of lines' own: `field`, the column a code names (a link, found as above, or words) and `count`, the column
+ *   counted (a whole number).
+ *
+ *   { "field": "lot", "options": { "scan": { "formats": ["data_matrix"], "part": "10", "fills": { "expiry": "17" } } } }
+ *   { "field": "line_ids", "options": { "scan": { "field": "product_id", "count": "counted", "by": "barcode" } } }
+ */
+export const SCAN_FORMATS = ['qr_code', 'data_matrix', 'ean_13', 'ean_8', 'upc_a', 'upc_e', 'code_128', 'code_39'];
+/** A GS1 Application Identifier: two to four digits. */
+const AI = /^\d{2,4}$/;
+const part = z.string().regex(AI, 'a GS1 part is its Application Identifier, two to four digits: "10" a lot, "17" an expiry, "01" a GTIN');
+const fieldName = z.string().min(1);
+/** What one field takes of a GS1 code, among those a scan `fills`: its part, and for a link the field holding the code. */
+export const ScanFillSchema = z.union([part, z.strictObject({ part, by: fieldName.optional() })], { error: 'a field filled is its GS1 part ("17"), or { "part": "01", "by": "barcode" } for a link' }).meta({ id: 'ScanFill' });
+export const ScanSettingsSchema = z
+    .strictObject({
+    formats: z.array(z.enum(SCAN_FORMATS, { error: `a format is one of ${SCAN_FORMATS.join(', ')}` })).min(1).optional(),
+    by: fieldName.optional(),
+    part: part.optional(),
+    fills: z.record(fieldName, ScanFillSchema).optional(),
+    sound: z.boolean().optional(),
+    field: fieldName.optional(),
+    count: fieldName.optional(),
+})
+    .meta({ id: 'ScanSettings' });
+/** `options.scan`: true for a Scan button as the field is, or its settings; false for none. */
+export const ScanOptionSchema = z.union([z.boolean(), ScanSettingsSchema], { error: 'scan is true, or its settings: { "formats": […], "by": "barcode", "part": "10", "fills": {…} }' }).meta({ id: 'ScanOption' });
+/** The issues of a field's or a cell's `options.scan`, each at its path under `options`. */
+export function scanOptionIssues(node) {
+    const scan = node.options?.['scan'];
+    if (scan === undefined)
+        return [];
+    // Its settings checked as settings, so what is wrong in them is said where it is: never as "true or its settings".
+    const schema = scan && typeof scan === 'object' && !Array.isArray(scan) ? ScanSettingsSchema : ScanOptionSchema;
+    return (schema.safeParse(scan).error?.issues ?? []).map((issue) => ({ message: issue.message, path: ['options', 'scan', ...issue.path] }));
+}
+//# sourceMappingURL=scan-options.mjs.map

package/src/lib/format/scan-options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-options.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/scan-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAG5H,wDAAwD;AACxD,MAAM,EAAE,GAAG,WAAW,CAAC;AACvB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,uGAAuG,CAAC,CAAC;AAC3I,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEpC,2HAA2H;AAC3H,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,wFAAwF,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAEhO,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,YAAY,CAAC;IACZ,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,sBAAsB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpH,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE;IACxB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,QAAQ,EAAE;IACrD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;CAC5B,CAAC;KACD,IAAI,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AAEhC,+FAA+F;AAC/F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,gGAAgG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAMnN,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,IAA2C;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,mHAAmH;IACnH,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAChH,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAwB,EAAE,CAAC,CAAC,CAAC;AACpK,CAAC"}

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

@@ -30,8 +30,10 @@ export interface PageUpgrade {
  * page's `endings`, `limits` and `continueLater`, an option's `seats` and `invisible`, `optionsFrom` carried from a
  * question (`{ field, picked }`) and on a table's line, a signature's `signs` and `signerField`, a list's
  * `filterRanges`, `filterCounts` and `filterSheet`, `{field}` words in a page's words — so a 0.5 page is a 0.6 page as
- * it is; and 0.7 (Fieldia 0.28) only added — a table of lines' `cards: "never"`, its rows kept at a phone's width — so a
- * 0.6 page is a 0.7 page as it is. A release that renames or reshapes a setting adds a step here, with its example; one that only adds needs
+ * it is; 0.7 (Fieldia 0.28) only added — a table of lines' `cards: "never"`, its rows kept at a phone's width — so a
+ * 0.6 page is a 0.7 page as it is; and 0.8 (Fieldia 0.29) only added — a record's `approval`, a list's `editable` and
+ * `searchToFilter`, a text's `translate` and `requiredIn`, a page's `suggest`, a text field's `options.rewrite`, a
+ * photo set's options and a field's `options.scan` — so a 0.7 page is a 0.8 page as it is. A release that renames or reshapes a setting adds a step here, with its example; one that only adds needs
  * none: the page is the same, and upgradePage writes the new version in it.
  */
 export declare const PAGE_UPGRADES: readonly PageUpgrade[];

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

@@ -30,8 +30,10 @@ export interface PageUpgrade {
  * page's `endings`, `limits` and `continueLater`, an option's `seats` and `invisible`, `optionsFrom` carried from a
  * question (`{ field, picked }`) and on a table's line, a signature's `signs` and `signerField`, a list's
  * `filterRanges`, `filterCounts` and `filterSheet`, `{field}` words in a page's words — so a 0.5 page is a 0.6 page as
- * it is; and 0.7 (Fieldia 0.28) only added — a table of lines' `cards: "never"`, its rows kept at a phone's width — so a
- * 0.6 page is a 0.7 page as it is. A release that renames or reshapes a setting adds a step here, with its example; one that only adds needs
+ * it is; 0.7 (Fieldia 0.28) only added — a table of lines' `cards: "never"`, its rows kept at a phone's width — so a
+ * 0.6 page is a 0.7 page as it is; and 0.8 (Fieldia 0.29) only added — a record's `approval`, a list's `editable` and
+ * `searchToFilter`, a text's `translate` and `requiredIn`, a page's `suggest`, a text field's `options.rewrite`, a
+ * photo set's options and a field's `options.scan` — so a 0.7 page is a 0.8 page as it is. A release that renames or reshapes a setting adds a step here, with its example; one that only adds needs
  * none: the page is the same, and upgradePage writes the new version in it.
  */
 export declare const PAGE_UPGRADES: readonly PageUpgrade[];

package/src/lib/format/upgrade.js

@@ -17,8 +17,10 @@ const version_1 = require("./version");
  * page's `endings`, `limits` and `continueLater`, an option's `seats` and `invisible`, `optionsFrom` carried from a
  * question (`{ field, picked }`) and on a table's line, a signature's `signs` and `signerField`, a list's
  * `filterRanges`, `filterCounts` and `filterSheet`, `{field}` words in a page's words — so a 0.5 page is a 0.6 page as
- * it is; and 0.7 (Fieldia 0.28) only added — a table of lines' `cards: "never"`, its rows kept at a phone's width — so a
- * 0.6 page is a 0.7 page as it is. A release that renames or reshapes a setting adds a step here, with its example; one that only adds needs
+ * it is; 0.7 (Fieldia 0.28) only added — a table of lines' `cards: "never"`, its rows kept at a phone's width — so a
+ * 0.6 page is a 0.7 page as it is; and 0.8 (Fieldia 0.29) only added — a record's `approval`, a list's `editable` and
+ * `searchToFilter`, a text's `translate` and `requiredIn`, a page's `suggest`, a text field's `options.rewrite`, a
+ * photo set's options and a field's `options.scan` — so a 0.7 page is a 0.8 page as it is. A release that renames or reshapes a setting adds a step here, with its example; one that only adds needs
  * none: the page is the same, and upgradePage writes the new version in it.
  */
 exports.PAGE_UPGRADES = [];

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/upgrade.ts"],"names":[],"mappings":";;;AAuDA,kCAYC;AAnED,uCAA4D;AAiB5D;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,aAAa,GAA2B,EAAE,CAAC;AAQxD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAqB,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE7H;;;;;;;;;GASG;AACH,SAAgB,WAAW,CAAI,IAAO,EAAE,UAAyB,EAAE,QAAQ,EAAE,yBAAe,EAAE,KAAK,EAAE,qBAAa,EAAE;IAClH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAA,wBAAc,EAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAA,wBAAc,EAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvI,mHAAmH;IACnH,gFAAgF;IAChF,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;IAC7D,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAa,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC7E,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/upgrade.ts"],"names":[],"mappings":";;;AAyDA,kCAYC;AArED,uCAA4D;AAiB5D;;;;;;;;;;;;;;;;;;;GAmBG;AACU,QAAA,aAAa,GAA2B,EAAE,CAAC;AAQxD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAqB,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE7H;;;;;;;;;GASG;AACH,SAAgB,WAAW,CAAI,IAAO,EAAE,UAAyB,EAAE,QAAQ,EAAE,yBAAe,EAAE,KAAK,EAAE,qBAAa,EAAE;IAClH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAA,wBAAc,EAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAA,wBAAc,EAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvI,mHAAmH;IACnH,gFAAgF;IAChF,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;IAC7D,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAa,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC7E,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;AAC5C,CAAC"}

package/src/lib/format/upgrade.mjs

@@ -13,8 +13,10 @@ import { compareFormats, FORMAT_VERSIONS } from './version.mjs';
  * page's `endings`, `limits` and `continueLater`, an option's `seats` and `invisible`, `optionsFrom` carried from a
  * question (`{ field, picked }`) and on a table's line, a signature's `signs` and `signerField`, a list's
  * `filterRanges`, `filterCounts` and `filterSheet`, `{field}` words in a page's words — so a 0.5 page is a 0.6 page as
- * it is; and 0.7 (Fieldia 0.28) only added — a table of lines' `cards: "never"`, its rows kept at a phone's width — so a
- * 0.6 page is a 0.7 page as it is. A release that renames or reshapes a setting adds a step here, with its example; one that only adds needs
+ * it is; 0.7 (Fieldia 0.28) only added — a table of lines' `cards: "never"`, its rows kept at a phone's width — so a
+ * 0.6 page is a 0.7 page as it is; and 0.8 (Fieldia 0.29) only added — a record's `approval`, a list's `editable` and
+ * `searchToFilter`, a text's `translate` and `requiredIn`, a page's `suggest`, a text field's `options.rewrite`, a
+ * photo set's options and a field's `options.scan` — so a 0.7 page is a 0.8 page as it is. A release that renames or reshapes a setting adds a step here, with its example; one that only adds needs
  * none: the page is the same, and upgradePage writes the new version in it.
  */
 export const PAGE_UPGRADES = [];

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAiB5D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B,EAAE,CAAC;AAQxD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAqB,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE7H;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAI,IAAO,EAAE,UAAyB,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE;IAClH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvI,mHAAmH;IACnH,gFAAgF;IAChF,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;IAC7D,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAa,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC7E,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"upgrade.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAiB5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B,EAAE,CAAC;AAQxD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAqB,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE7H;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAI,IAAO,EAAE,UAAyB,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE;IAClH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvI,mHAAmH;IACnH,gFAAgF;IAChF,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;IAC7D,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAa,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC7E,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;AAC5C,CAAC"}

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

@@ -1,11 +1,11 @@
 /** The page format version this build reads and writes. */
-export declare const FORMAT_VERSION: "0.7";
+export declare const FORMAT_VERSION: "0.8";
 /**
  * Every format Fieldia has had, oldest first; the last is FORMAT_VERSION. A page in an older one is brought up to date
  * by `upgradePage`, step by step (`PAGE_UPGRADES`), wherever it is read: `checkPage`, `validatePage`, the viewer, the
  * designer. A release that changes what a page may say adds its version here (see the format's docs, "Versions").
  */
-export declare const FORMAT_VERSIONS: readonly ["0.1", "0.2", "0.3", "0.4", "0.5", "0.6", "0.7"];
+export declare const FORMAT_VERSIONS: readonly ["0.1", "0.2", "0.3", "0.4", "0.5", "0.6", "0.7", "0.8"];
 /** A format Fieldia has had: a page may say any of them, and is read in the current one. */
 export type FormatVersion = (typeof FORMAT_VERSIONS)[number];
 /** Which of two format versions is newer: below 0 when `a` is older, 0 when they are the same, null when either is not a version. */

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

@@ -1,11 +1,11 @@
 /** The page format version this build reads and writes. */
-export declare const FORMAT_VERSION: "0.7";
+export declare const FORMAT_VERSION: "0.8";
 /**
  * Every format Fieldia has had, oldest first; the last is FORMAT_VERSION. A page in an older one is brought up to date
  * by `upgradePage`, step by step (`PAGE_UPGRADES`), wherever it is read: `checkPage`, `validatePage`, the viewer, the
  * designer. A release that changes what a page may say adds its version here (see the format's docs, "Versions").
  */
-export declare const FORMAT_VERSIONS: readonly ["0.1", "0.2", "0.3", "0.4", "0.5", "0.6", "0.7"];
+export declare const FORMAT_VERSIONS: readonly ["0.1", "0.2", "0.3", "0.4", "0.5", "0.6", "0.7", "0.8"];
 /** A format Fieldia has had: a page may say any of them, and is read in the current one. */
 export type FormatVersion = (typeof FORMAT_VERSIONS)[number];
 /** Which of two format versions is newer: below 0 when `a` is older, 0 when they are the same, null when either is not a version. */

package/src/lib/format/version.js

@@ -4,13 +4,13 @@ exports.FORMAT_VERSIONS = exports.FORMAT_VERSION = void 0;
 exports.compareFormats = compareFormats;
 exports.formatProblem = formatProblem;
 /** The page format version this build reads and writes. */
-exports.FORMAT_VERSION = '0.7';
+exports.FORMAT_VERSION = '0.8';
 /**
  * Every format Fieldia has had, oldest first; the last is FORMAT_VERSION. A page in an older one is brought up to date
  * by `upgradePage`, step by step (`PAGE_UPGRADES`), wherever it is read: `checkPage`, `validatePage`, the viewer, the
  * designer. A release that changes what a page may say adds its version here (see the format's docs, "Versions").
  */
-exports.FORMAT_VERSIONS = ['0.1', '0.2', '0.3', '0.4', '0.5', '0.6', '0.7'];
+exports.FORMAT_VERSIONS = ['0.1', '0.2', '0.3', '0.4', '0.5', '0.6', '0.7', '0.8'];
 /** `major.minor` as two numbers, or null when it is not a version at all. */
 function parts(version) {
     const match = typeof version === 'string' ? /^(\d+)\.(\d+)$/.exec(version) : null;

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

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/version.ts"],"names":[],"mappings":";;;AAoBA,wCAIC;AAMD,sCAQC;AAtCD,2DAA2D;AAC9C,QAAA,cAAc,GAAG,KAAc,CAAC;AAE7C;;;;GAIG;AACU,QAAA,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAsC,CAAC;AAKtH,6EAA6E;AAC7E,SAAS,KAAK,CAAC,OAAgB;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,qIAAqI;AACrI,SAAgB,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAgB,EAAE,WAA8B,uBAAe;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,wDAAwD,OAAO,oBAAoB,CAAC;IAClH,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,8BAA8B,CAAC;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAiB,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,EAAE,CAAC;IAC1I,OAAO,UAAU,OAAiB,mDAAmD,OAAO,EAAE,CAAC;AACjG,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/version.ts"],"names":[],"mappings":";;;AAoBA,wCAIC;AAMD,sCAQC;AAtCD,2DAA2D;AAC9C,QAAA,cAAc,GAAG,KAAc,CAAC;AAE7C;;;;GAIG;AACU,QAAA,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAsC,CAAC;AAK7H,6EAA6E;AAC7E,SAAS,KAAK,CAAC,OAAgB;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,qIAAqI;AACrI,SAAgB,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAgB,EAAE,WAA8B,uBAAe;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,wDAAwD,OAAO,oBAAoB,CAAC;IAClH,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,8BAA8B,CAAC;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAiB,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,EAAE,CAAC;IAC1I,OAAO,UAAU,OAAiB,mDAAmD,OAAO,EAAE,CAAC;AACjG,CAAC"}

package/src/lib/format/version.mjs

@@ -1,11 +1,11 @@
 /** The page format version this build reads and writes. */
-export const FORMAT_VERSION = '0.7';
+export const FORMAT_VERSION = '0.8';
 /**
  * Every format Fieldia has had, oldest first; the last is FORMAT_VERSION. A page in an older one is brought up to date
  * by `upgradePage`, step by step (`PAGE_UPGRADES`), wherever it is read: `checkPage`, `validatePage`, the viewer, the
  * designer. A release that changes what a page may say adds its version here (see the format's docs, "Versions").
  */
-export const FORMAT_VERSIONS = ['0.1', '0.2', '0.3', '0.4', '0.5', '0.6', '0.7'];
+export const FORMAT_VERSIONS = ['0.1', '0.2', '0.3', '0.4', '0.5', '0.6', '0.7', '0.8'];
 /** `major.minor` as two numbers, or null when it is not a version at all. */
 function parts(version) {
     const match = typeof version === 'string' ? /^(\d+)\.(\d+)$/.exec(version) : null;

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

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/version.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,KAAc,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAsC,CAAC;AAKtH,6EAA6E;AAC7E,SAAS,KAAK,CAAC,OAAgB;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,qIAAqI;AACrI,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,WAA8B,eAAe;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,wDAAwD,OAAO,oBAAoB,CAAC;IAClH,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,8BAA8B,CAAC;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAiB,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,EAAE,CAAC;IAC1I,OAAO,UAAU,OAAiB,mDAAmD,OAAO,EAAE,CAAC;AACjG,CAAC"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/version.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,KAAc,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAsC,CAAC;AAK7H,6EAA6E;AAC7E,SAAS,KAAK,CAAC,OAAgB;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,qIAAqI;AACrI,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,WAA8B,eAAe;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,wDAAwD,OAAO,oBAAoB,CAAC;IAClH,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,8BAA8B,CAAC;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAiB,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,EAAE,CAAC;IAC1I,OAAO,UAAU,OAAiB,mDAAmD,OAAO,EAAE,CAAC;AACjG,CAAC"}

package/src/lib/record/approvals-part.d.mts

@@ -0,0 +1,6 @@
+/**
+ * The approvals part's form code (approving.ts, `formApprovalsPart`): a record's approvals asked of the data source,
+ * a decision taken, its fields locked while it waits, and a moment of its history in words (form-approvals.ts). In the
+ * one-tag script it comes in one script with the viewer's approvals part, which draws them (fieldia.approvals.js).
+ */
+export { approvalOf, approvalStatus, approvalWhen, formApprovals } from './form-approvals.mjs';

package/src/lib/record/approvals-part.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The approvals part's form code (approving.ts, `formApprovalsPart`): a record's approvals asked of the data source,
+ * a decision taken, its fields locked while it waits, and a moment of its history in words (form-approvals.ts). In the
+ * one-tag script it comes in one script with the viewer's approvals part, which draws them (fieldia.approvals.js).
+ */
+export { approvalOf, approvalStatus, approvalWhen, formApprovals } from './form-approvals';

package/src/lib/record/approvals-part.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formApprovals = exports.approvalWhen = exports.approvalStatus = exports.approvalOf = void 0;
+/**
+ * The approvals part's form code (approving.ts, `formApprovalsPart`): a record's approvals asked of the data source,
+ * a decision taken, its fields locked while it waits, and a moment of its history in words (form-approvals.ts). In the
+ * one-tag script it comes in one script with the viewer's approvals part, which draws them (fieldia.approvals.js).
+ */
+var form_approvals_1 = require("./form-approvals");
+Object.defineProperty(exports, "approvalOf", { enumerable: true, get: function () { return form_approvals_1.approvalOf; } });
+Object.defineProperty(exports, "approvalStatus", { enumerable: true, get: function () { return form_approvals_1.approvalStatus; } });
+Object.defineProperty(exports, "approvalWhen", { enumerable: true, get: function () { return form_approvals_1.approvalWhen; } });
+Object.defineProperty(exports, "formApprovals", { enumerable: true, get: function () { return form_approvals_1.formApprovals; } });
+//# sourceMappingURL=approvals-part.js.map

package/src/lib/record/approvals-part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals-part.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/approvals-part.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,mDAA2F;AAAlF,4GAAA,UAAU,OAAA;AAAE,gHAAA,cAAc,OAAA;AAAE,8GAAA,YAAY,OAAA;AAAE,+GAAA,aAAa,OAAA"}

package/src/lib/record/approvals-part.mjs

@@ -0,0 +1,7 @@
+/**
+ * The approvals part's form code (approving.ts, `formApprovalsPart`): a record's approvals asked of the data source,
+ * a decision taken, its fields locked while it waits, and a moment of its history in words (form-approvals.ts). In the
+ * one-tag script it comes in one script with the viewer's approvals part, which draws them (fieldia.approvals.js).
+ */
+export { approvalOf, approvalStatus, approvalWhen, formApprovals } from './form-approvals.mjs';
+//# sourceMappingURL=approvals-part.mjs.map

package/src/lib/record/approvals-part.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals-part.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/approvals-part.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,45 @@
+import { type Part } from '../parts.mjs';
+import type * as ApprovalsModule from './approvals-part.mjs';
+import type { ApprovalDecision, ApprovalEntry, ApprovalLevel } from './data-source.mjs';
+/**
+ * Approvals on a record (`approval` on a page): what the data source's `approvals` told of the record shown — the
+ * levels it must pass, what was decided so far, the levels this person may decide — kept in the form's state
+ * (`FormState.approval`), worked out by the approvals part (form-approvals.ts). A viewer says where it stands, offers
+ * Approve and Reject, and locks the record while it waits.
+ */
+/**
+ * Where a record stands as a whole: `none`, no approval asked of it (no levels, or not told yet); `needed`, levels to
+ * pass and none asked yet (it is not sent for approval); `waiting`, a level waits now; `approved`, every level passed;
+ * `rejected`, a level rejected it.
+ */
+export type ApprovalStatus = 'none' | 'needed' | 'waiting' | 'approved' | 'rejected';
+/** What a form knows of its record's approvals now (`FormState.approval`). */
+export interface FormApproval {
+    /** `asking`: the record shown's are asked and not told yet; `told`; `failed`: they could not be read (`error`). */
+    readonly state: 'asking' | 'told' | 'failed';
+    readonly status: ApprovalStatus;
+    /** The levels in their order, as the source told them. */
+    readonly levels: readonly ApprovalLevel[];
+    /** Asked all at once, not one after another. */
+    readonly together: boolean;
+    /** What happened, oldest first. */
+    readonly history: readonly ApprovalEntry[];
+    /** The levels this person may decide now, by id — where the source takes decisions (`decide`), each one waiting. */
+    readonly mine: readonly string[];
+    /** Why it needs approval, in the source's words. */
+    readonly why?: string;
+    /** A decision on its way: its level and what it decides. */
+    readonly deciding?: {
+        readonly level: string;
+        readonly decision: ApprovalDecision;
+    } | null;
+    /** Why they could not be read, where they could not (`failed`). */
+    readonly error?: string;
+}
+/** The approvals part's form code (form-approvals.ts). */
+export type FormApprovalsPart = typeof ApprovalsModule;
+/**
+ * A record's approvals — asked of the source, a decision taken, its fields locked while it waits — loaded before a page
+ * with `approval` is drawn: in the one-tag script, one script with the viewer's approvals part (fieldia.approvals.js).
+ */
+export declare const formApprovalsPart: Part<FormApprovalsPart>;

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

@@ -0,0 +1,45 @@
+import { type Part } from '../parts';
+import type * as ApprovalsModule from './approvals-part';
+import type { ApprovalDecision, ApprovalEntry, ApprovalLevel } from './data-source';
+/**
+ * Approvals on a record (`approval` on a page): what the data source's `approvals` told of the record shown — the
+ * levels it must pass, what was decided so far, the levels this person may decide — kept in the form's state
+ * (`FormState.approval`), worked out by the approvals part (form-approvals.ts). A viewer says where it stands, offers
+ * Approve and Reject, and locks the record while it waits.
+ */
+/**
+ * Where a record stands as a whole: `none`, no approval asked of it (no levels, or not told yet); `needed`, levels to
+ * pass and none asked yet (it is not sent for approval); `waiting`, a level waits now; `approved`, every level passed;
+ * `rejected`, a level rejected it.
+ */
+export type ApprovalStatus = 'none' | 'needed' | 'waiting' | 'approved' | 'rejected';
+/** What a form knows of its record's approvals now (`FormState.approval`). */
+export interface FormApproval {
+    /** `asking`: the record shown's are asked and not told yet; `told`; `failed`: they could not be read (`error`). */
+    readonly state: 'asking' | 'told' | 'failed';
+    readonly status: ApprovalStatus;
+    /** The levels in their order, as the source told them. */
+    readonly levels: readonly ApprovalLevel[];
+    /** Asked all at once, not one after another. */
+    readonly together: boolean;
+    /** What happened, oldest first. */
+    readonly history: readonly ApprovalEntry[];
+    /** The levels this person may decide now, by id — where the source takes decisions (`decide`), each one waiting. */
+    readonly mine: readonly string[];
+    /** Why it needs approval, in the source's words. */
+    readonly why?: string;
+    /** A decision on its way: its level and what it decides. */
+    readonly deciding?: {
+        readonly level: string;
+        readonly decision: ApprovalDecision;
+    } | null;
+    /** Why they could not be read, where they could not (`failed`). */
+    readonly error?: string;
+}
+/** The approvals part's form code (form-approvals.ts). */
+export type FormApprovalsPart = typeof ApprovalsModule;
+/**
+ * A record's approvals — asked of the source, a decision taken, its fields locked while it waits — loaded before a page
+ * with `approval` is drawn: in the one-tag script, one script with the viewer's approvals part (fieldia.approvals.js).
+ */
+export declare const formApprovalsPart: Part<FormApprovalsPart>;

package/src/lib/record/approving.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formApprovalsPart = void 0;
+const parts_1 = require("../parts");
+/**
+ * A record's approvals — asked of the source, a decision taken, its fields locked while it waits — loaded before a page
+ * with `approval` is drawn: in the one-tag script, one script with the viewer's approvals part (fieldia.approvals.js).
+ */
+exports.formApprovalsPart = (0, parts_1.lazyPart)('approvals', () => Promise.resolve().then(() => require('./approvals-part')));
+//# sourceMappingURL=approving.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approving.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/approving.ts"],"names":[],"mappings":";;;AAAA,oCAA+C;AA0C/C;;;GAGG;AACU,QAAA,iBAAiB,GAA4B,IAAA,gBAAQ,EAAC,WAAW,EAAE,GAAG,EAAE,sCAAQ,kBAAkB,EAAC,CAAC,CAAC"}

package/src/lib/record/approving.mjs

@@ -0,0 +1,7 @@
+import { lazyPart } from '../parts.mjs';
+/**
+ * A record's approvals — asked of the source, a decision taken, its fields locked while it waits — loaded before a page
+ * with `approval` is drawn: in the one-tag script, one script with the viewer's approvals part (fieldia.approvals.js).
+ */
+export const formApprovalsPart = lazyPart('approvals', () => import('./approvals-part.mjs'));
+//# sourceMappingURL=approving.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approving.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/approving.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,MAAM,UAAU,CAAC;AA0C/C;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA4B,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC"}

package/src/lib/record/check.js

@@ -11,6 +11,7 @@ const limits_1 = require("./limits");
 const messages_1 = require("./messages");
 const input_rules_1 = require("./input-rules");
 const record_words_1 = require("./record-words");
+const languages_1 = require("./languages");
 const values_1 = require("./values");
 /**
  * Check one value against its field. Returns the message to show, or
@@ -35,6 +36,9 @@ widget) {
         return required ? say((0, record_words_1.isQuestion)(label) ? 'requiredQuestion' : 'required') : undefined;
     if (field.type === 'matrix')
         return checkMatrix(field, value, required, say);
+    // A text kept in several languages, language by language, by its part: until it has come (a save waits for it), nothing is said.
+    if ((0, languages_1.languagesOf)(field))
+        return languages_1.formLanguagesPart.loaded?.checkTranslated(field, value, required, messages, today, widget);
     switch (field.type) {
         case 'char':
         case 'text':