@fieldia/core 0.11.0 → 0.13.0

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

@@ -1,5 +1,6 @@
 import type { Field, LineField } from '../format/field.mjs';
 import type { Page } from '../format/page.mjs';
+import { type About } from './env.mjs';
 import { type Value, type Values } from './values.mjs';
 /**
  * Values worked out from others: a field's `compute`. A page's own fields are
@@ -11,8 +12,8 @@ import { type Value, type Values } from './values.mjs';
 export interface Computed {
     /** The values with every worked-out field brought up to date. */
     apply(values: Values): Values;
-    /** One line of a one2many with its worked-out fields brought up to date. */
-    line(field: string, values: Values): Values;
+    /** One line of a one2many on the record `values`, with its worked-out fields brought up to date. */
+    line(field: string, line: Values, values: Values): Values;
 }
 /**
  * A worked-out value as its field holds it: a whole number rounded, a number
@@ -20,5 +21,5 @@ export interface Computed {
  * Python's idea of true, and null for what the field cannot hold.
  */
 export declare function fitTo(def: Field | LineField, value: unknown): Value;
-/** Read every `compute` of a page once. `today` is the day `today()` gives. */
-export declare function compileComputed(page: Page, today: () => string): Computed;
+/** Read every `compute` of a page once. `today` is the day `today()` gives; `about`, the record's id and the person, as lines read them on `parent`. */
+export declare function compileComputed(page: Page, today: () => string, about?: () => About): Computed;

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

@@ -1,5 +1,6 @@
 import type { Field, LineField } from '../format/field';
 import type { Page } from '../format/page';
+import { type About } from './env';
 import { type Value, type Values } from './values';
 /**
  * Values worked out from others: a field's `compute`. A page's own fields are
@@ -11,8 +12,8 @@ import { type Value, type Values } from './values';
 export interface Computed {
     /** The values with every worked-out field brought up to date. */
     apply(values: Values): Values;
-    /** One line of a one2many with its worked-out fields brought up to date. */
-    line(field: string, values: Values): Values;
+    /** One line of a one2many on the record `values`, with its worked-out fields brought up to date. */
+    line(field: string, line: Values, values: Values): Values;
 }
 /**
  * A worked-out value as its field holds it: a whole number rounded, a number
@@ -20,5 +21,5 @@ export interface Computed {
  * Python's idea of true, and null for what the field cannot hold.
  */
 export declare function fitTo(def: Field | LineField, value: unknown): Value;
-/** Read every `compute` of a page once. `today` is the day `today()` gives. */
-export declare function compileComputed(page: Page, today: () => string): Computed;
+/** Read every `compute` of a page once. `today` is the day `today()` gives; `about`, the record's id and the person, as lines read them on `parent`. */
+export declare function compileComputed(page: Page, today: () => string, about?: () => About): Computed;

package/src/lib/record/compute.js

@@ -45,8 +45,8 @@ function fitTo(def, value) {
             return value;
     }
 }
-/** Read every `compute` of a page once. `today` is the day `today()` gives. */
-function compileComputed(page, today) {
+/** Read every `compute` of a page once. `today` is the day `today()` gives; `about`, the record's id and the person, as lines read them on `parent`. */
+function compileComputed(page, today, about = () => ({ recordId: null })) {
     const own = steps(page.fields);
     const lineSteps = new Map();
     for (const [name, def] of Object.entries(page.fields)) {
@@ -58,10 +58,10 @@ function compileComputed(page, today) {
     }
     // Lines hold no lines of their own: inside one, only today() needs the env.
     const lineEnv = { today };
-    /** Work out the steps on these values, writing each change into a copy. */
-    function run(values, list, fields, env) {
+    /** Work out the steps on these values, writing each change into a copy; `read` gives the values as expressions read them. */
+    function run(values, list, fields, env, read) {
         let next = values;
-        const context = (0, values_1.expressionContext)(values, fields);
+        const context = read(values);
         for (const [name, expression, def] of list) {
             const value = fitTo(def, expression.evaluate(context, env));
             if ((0, values_1.sameValue)(value, next[name]))
@@ -72,24 +72,25 @@ function compileComputed(page, today) {
         }
         return next;
     }
-    function line(field, values) {
+    function line(field, values, parent) {
         const found = lineSteps.get(field);
         // A section or a note has nothing to work out.
         if (!found || (0, values_1.lineKind)(found.def, values) !== null)
             return values;
-        return run(values, found.steps, found.def.fields, lineEnv);
+        return run(values, found.steps, found.def.fields, lineEnv, (v) => (0, env_1.lineContext)(v, found.def.fields, parent));
     }
     return {
-        line,
+        line: (field, values, record) => line(field, values, (0, env_1.recordContext)(record, page.fields, about())),
         apply(values) {
             let next = values;
+            const parent = lineSteps.size ? (0, env_1.recordContext)(values, page.fields, about()) : {};
             for (const field of lineSteps.keys()) {
                 const current = next[field];
                 if (!Array.isArray(current))
                     continue;
                 let changed = false;
                 const updated = current.map((l) => {
-                    const worked = line(field, l.values);
+                    const worked = line(field, l.values, parent);
                     if (worked === l.values)
                         return l;
                     changed = true;
@@ -100,7 +101,7 @@ function compileComputed(page, today) {
             }
             if (!own.length)
                 return next;
-            return run(next, own, page.fields, (0, env_1.expressionEnv)(next, page.fields, today));
+            return run(next, own, page.fields, (0, env_1.expressionEnv)(next, page.fields, today), (v) => (0, env_1.recordContext)(v, page.fields, about()));
         },
     };
 }

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

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

package/src/lib/record/compute.mjs

@@ -1,7 +1,7 @@
 import { compileExpression } from '../expression/expression.mjs';
 import { isNumber, roundTo, truthy } from '../expression/operations.mjs';
 import { dependencyOrder } from '../expression/order.mjs';
-import { expressionEnv } from './env.mjs';
+import { expressionEnv, lineContext, recordContext } from './env.mjs';
 import { expressionContext, lineKind, sameValue } from './values.mjs';
 /** The worked-out fields among `fields`, each read once, in the order to work them out. */
 function steps(fields) {
@@ -41,8 +41,8 @@ export function fitTo(def, value) {
             return value;
     }
 }
-/** Read every `compute` of a page once. `today` is the day `today()` gives. */
-export function compileComputed(page, today) {
+/** Read every `compute` of a page once. `today` is the day `today()` gives; `about`, the record's id and the person, as lines read them on `parent`. */
+export function compileComputed(page, today, about = () => ({ recordId: null })) {
     const own = steps(page.fields);
     const lineSteps = new Map();
     for (const [name, def] of Object.entries(page.fields)) {
@@ -54,10 +54,10 @@ export function compileComputed(page, today) {
     }
     // Lines hold no lines of their own: inside one, only today() needs the env.
     const lineEnv = { today };
-    /** Work out the steps on these values, writing each change into a copy. */
-    function run(values, list, fields, env) {
+    /** Work out the steps on these values, writing each change into a copy; `read` gives the values as expressions read them. */
+    function run(values, list, fields, env, read) {
         let next = values;
-        const context = expressionContext(values, fields);
+        const context = read(values);
         for (const [name, expression, def] of list) {
             const value = fitTo(def, expression.evaluate(context, env));
             if (sameValue(value, next[name]))
@@ -68,24 +68,25 @@ export function compileComputed(page, today) {
         }
         return next;
     }
-    function line(field, values) {
+    function line(field, values, parent) {
         const found = lineSteps.get(field);
         // A section or a note has nothing to work out.
         if (!found || lineKind(found.def, values) !== null)
             return values;
-        return run(values, found.steps, found.def.fields, lineEnv);
+        return run(values, found.steps, found.def.fields, lineEnv, (v) => lineContext(v, found.def.fields, parent));
     }
     return {
-        line,
+        line: (field, values, record) => line(field, values, recordContext(record, page.fields, about())),
         apply(values) {
             let next = values;
+            const parent = lineSteps.size ? recordContext(values, page.fields, about()) : {};
             for (const field of lineSteps.keys()) {
                 const current = next[field];
                 if (!Array.isArray(current))
                     continue;
                 let changed = false;
                 const updated = current.map((l) => {
-                    const worked = line(field, l.values);
+                    const worked = line(field, l.values, parent);
                     if (worked === l.values)
                         return l;
                     changed = true;
@@ -96,7 +97,7 @@ export function compileComputed(page, today) {
             }
             if (!own.length)
                 return next;
-            return run(next, own, page.fields, expressionEnv(next, page.fields, today));
+            return run(next, own, page.fields, expressionEnv(next, page.fields, today), (v) => recordContext(v, page.fields, about()));
         },
     };
 }

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

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

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

@@ -1,6 +1,6 @@
-import type { FilterCondition, Fields, Option } from '../format/field.mjs';
+import type { FilterCondition, Fields, Option, PropertyDefinition } from '../format/field.mjs';
 import type { JsonValue } from '../format/json.mjs';
-import type { RecordId, RelatedRecord, Values } from './values.mjs';
+import type { FileValue, RecordId, RelatedRecord, Values } from './values.mjs';
 import type { RunStop } from './run.mjs';
 /**
  * How Fieldia reaches data. Fieldia knows no backend: an app implements this
@@ -26,6 +26,34 @@ export interface DataSource {
     groups?(request: GroupRequest): Promise<Group[]>;
     /** The choices of one of the app's lists, for a selection with `optionsFrom`. */
     options?(request: OptionsRequest): Promise<Option[]>;
+    /** The definitions of a properties field with `definitionsFrom`: those the linked record keeps. */
+    definitions?(request: OptionsRequest): Promise<PropertyDefinition[]>;
+    /** Keep a properties field's definitions, a property added in place among them, on the record they come from. */
+    saveDefinitions?(request: OptionsRequest & {
+        definitions: PropertyDefinition[];
+    }): Promise<void>;
+    /** Archive a record, or bring it back (`archive: false`): Flectra's `active` set false or true. For the `archive` and `unarchive` steps. */
+    archive?(request: ArchiveRequest): Promise<void>;
+    /** Copy a record, as a backend's copy does: the copy's id, and its values when the source has them. For the `duplicate` step. */
+    copy?(request: RecordRequest): Promise<SaveResult>;
+    /** Delete a record. For the `delete` step. */
+    delete?(request: RecordRequest): Promise<void>;
+    /**
+     * The record's attachments, its main one first, for a sheet's attachment
+     * preview: each a file with its `url` (or its `data`) and its media type.
+     */
+    attachments?(request: RecordRequest): Promise<FileValue[]>;
+}
+/** One stored record, by its model and id. */
+export interface RecordRequest {
+    model: string;
+    id: RecordId;
+    /** The page's fields, so the source knows what the page shows of it. */
+    fields: Fields;
+}
+export interface ArchiveRequest extends RecordRequest {
+    /** True to archive it, false to bring it back. */
+    archive: boolean;
 }
 export interface OptionsRequest {
     /** The list's name, from the field's `optionsFrom.list`. */
@@ -37,6 +65,8 @@ export interface CreateRequest {
     model: string;
     /** What the person typed: the new record's name. */
     name: string;
+    /** What else it starts with, from the link's `createValues`: links as `{ id, label }`. */
+    values?: Values;
 }
 export interface LoadRequest {
     model: string;

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

@@ -1,6 +1,6 @@
-import type { FilterCondition, Fields, Option } from '../format/field';
+import type { FilterCondition, Fields, Option, PropertyDefinition } from '../format/field';
 import type { JsonValue } from '../format/json';
-import type { RecordId, RelatedRecord, Values } from './values';
+import type { FileValue, RecordId, RelatedRecord, Values } from './values';
 import type { RunStop } from './run';
 /**
  * How Fieldia reaches data. Fieldia knows no backend: an app implements this
@@ -26,6 +26,34 @@ export interface DataSource {
     groups?(request: GroupRequest): Promise<Group[]>;
     /** The choices of one of the app's lists, for a selection with `optionsFrom`. */
     options?(request: OptionsRequest): Promise<Option[]>;
+    /** The definitions of a properties field with `definitionsFrom`: those the linked record keeps. */
+    definitions?(request: OptionsRequest): Promise<PropertyDefinition[]>;
+    /** Keep a properties field's definitions, a property added in place among them, on the record they come from. */
+    saveDefinitions?(request: OptionsRequest & {
+        definitions: PropertyDefinition[];
+    }): Promise<void>;
+    /** Archive a record, or bring it back (`archive: false`): Flectra's `active` set false or true. For the `archive` and `unarchive` steps. */
+    archive?(request: ArchiveRequest): Promise<void>;
+    /** Copy a record, as a backend's copy does: the copy's id, and its values when the source has them. For the `duplicate` step. */
+    copy?(request: RecordRequest): Promise<SaveResult>;
+    /** Delete a record. For the `delete` step. */
+    delete?(request: RecordRequest): Promise<void>;
+    /**
+     * The record's attachments, its main one first, for a sheet's attachment
+     * preview: each a file with its `url` (or its `data`) and its media type.
+     */
+    attachments?(request: RecordRequest): Promise<FileValue[]>;
+}
+/** One stored record, by its model and id. */
+export interface RecordRequest {
+    model: string;
+    id: RecordId;
+    /** The page's fields, so the source knows what the page shows of it. */
+    fields: Fields;
+}
+export interface ArchiveRequest extends RecordRequest {
+    /** True to archive it, false to bring it back. */
+    archive: boolean;
 }
 export interface OptionsRequest {
     /** The list's name, from the field's `optionsFrom.list`. */
@@ -37,6 +65,8 @@ export interface CreateRequest {
     model: string;
     /** What the person typed: the new record's name. */
     name: string;
+    /** What else it starts with, from the link's `createValues`: links as `{ id, label }`. */
+    values?: Values;
 }
 export interface LoadRequest {
     model: string;

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

@@ -1 +1 @@
-{"version":3,"file":"data-source.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":";;AA0LA,kCAEC;AAGD,sCAMC;AAZD,8EAA8E;AAC9E,SAAgB,WAAW,CAAC,OAAoB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,wGAAwG;AACxG,SAAgB,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAI,KAA0C,EAAE,OAAO,CAAC;IACrE,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,KAAK,YAAY,SAAS,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAClH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"data-source.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":";;AAwNA,kCAEC;AAGD,sCAMC;AAZD,8EAA8E;AAC9E,SAAgB,WAAW,CAAC,OAAoB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,wGAAwG;AACxG,SAAgB,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAI,KAA0C,EAAE,OAAO,CAAC;IACrE,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,KAAK,YAAY,SAAS,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAClH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"data-source.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":"AAyLA,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAI,KAA0C,EAAE,OAAO,CAAC;IACrE,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,KAAK,YAAY,SAAS,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAClH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"data-source.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":"AAuNA,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAI,KAA0C,EAAE,OAAO,CAAC;IACrE,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,KAAK,YAAY,SAAS,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAClH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

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

@@ -1,9 +1,46 @@
 import type { Field, LineField } from '../format/field.mjs';
 import type { ExpressionEnv } from '../expression/functions.mjs';
-import { type Values } from './values.mjs';
+import type { JsonValue } from '../format/json.mjs';
+import { type RecordId, type Values } from './values.mjs';
+/**
+ * What expressions read besides a record's fields: `id`, the record's id
+ * (null while it is new), `user`, the person using the form (`id`, `name`,
+ * `roles`), `editing`, whether the record is being edited — false while
+ * a view shows it locked, to be read, as Flectra's oe_edit_only and
+ * oe_read_only — and `context`, the values the app passes in, as Flectra's
+ * context. A page's own field of the same name comes first.
+ */
+export declare function builtIns(fields: Record<string, unknown>, recordId: RecordId | null, user: {
+    id: RecordId | null;
+    name?: string;
+    roles?: readonly string[];
+} | undefined, editing?: boolean, context?: Readonly<Record<string, JsonValue>>, parent?: Record<string, unknown>): Record<string, unknown>;
 /**
  * What an expression on a record is worked out with besides its values: the
  * rows of each one2many for `sum` and `count` — the items, not the sections
  * and notes between them — and today's date for `today()`.
  */
+/** The record's id and the person, for what is worked out away from the form. */
+export interface About {
+    recordId: RecordId | null;
+    user?: {
+        id: RecordId | null;
+        name?: string;
+        roles?: readonly string[];
+    };
+    /** Whether the record is being edited; true unless said. */
+    editing?: boolean;
+    /** The values the app passes in (the form's `context`). */
+    context?: Readonly<Record<string, JsonValue>>;
+    /** For a line's own form: the record the line is on, as expressions read it. */
+    parent?: Record<string, unknown>;
+}
+/** The record as expressions read it: its values, its `id` and `user`. What a line reads as `parent`. */
+export declare function recordContext(values: Values, fields: Record<string, Field | LineField>, about: About): Record<string, unknown>;
+/**
+ * A line as its expressions read it: its values, `parent` — the record it is
+ * on, as that record's expressions read it — and `user`. A line field of the
+ * same name comes first.
+ */
+export declare function lineContext(values: Values, fields: Record<string, LineField>, parent: Record<string, unknown>, id?: RecordId | null): Record<string, unknown>;
 export declare function expressionEnv(values: Values, fields: Record<string, Field | LineField>, today: () => string): ExpressionEnv;

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

@@ -1,9 +1,46 @@
 import type { Field, LineField } from '../format/field';
 import type { ExpressionEnv } from '../expression/functions';
-import { type Values } from './values';
+import type { JsonValue } from '../format/json';
+import { type RecordId, type Values } from './values';
+/**
+ * What expressions read besides a record's fields: `id`, the record's id
+ * (null while it is new), `user`, the person using the form (`id`, `name`,
+ * `roles`), `editing`, whether the record is being edited — false while
+ * a view shows it locked, to be read, as Flectra's oe_edit_only and
+ * oe_read_only — and `context`, the values the app passes in, as Flectra's
+ * context. A page's own field of the same name comes first.
+ */
+export declare function builtIns(fields: Record<string, unknown>, recordId: RecordId | null, user: {
+    id: RecordId | null;
+    name?: string;
+    roles?: readonly string[];
+} | undefined, editing?: boolean, context?: Readonly<Record<string, JsonValue>>, parent?: Record<string, unknown>): Record<string, unknown>;
 /**
  * What an expression on a record is worked out with besides its values: the
  * rows of each one2many for `sum` and `count` — the items, not the sections
  * and notes between them — and today's date for `today()`.
  */
+/** The record's id and the person, for what is worked out away from the form. */
+export interface About {
+    recordId: RecordId | null;
+    user?: {
+        id: RecordId | null;
+        name?: string;
+        roles?: readonly string[];
+    };
+    /** Whether the record is being edited; true unless said. */
+    editing?: boolean;
+    /** The values the app passes in (the form's `context`). */
+    context?: Readonly<Record<string, JsonValue>>;
+    /** For a line's own form: the record the line is on, as expressions read it. */
+    parent?: Record<string, unknown>;
+}
+/** The record as expressions read it: its values, its `id` and `user`. What a line reads as `parent`. */
+export declare function recordContext(values: Values, fields: Record<string, Field | LineField>, about: About): Record<string, unknown>;
+/**
+ * A line as its expressions read it: its values, `parent` — the record it is
+ * on, as that record's expressions read it — and `user`. A line field of the
+ * same name comes first.
+ */
+export declare function lineContext(values: Values, fields: Record<string, LineField>, parent: Record<string, unknown>, id?: RecordId | null): Record<string, unknown>;
 export declare function expressionEnv(values: Values, fields: Record<string, Field | LineField>, today: () => string): ExpressionEnv;

package/src/lib/record/env.js

@@ -1,12 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtIns = builtIns;
+exports.recordContext = recordContext;
+exports.lineContext = lineContext;
 exports.expressionEnv = expressionEnv;
 const values_1 = require("./values");
 /**
- * What an expression on a record is worked out with besides its values: the
- * rows of each one2many for `sum` and `count` — the items, not the sections
- * and notes between them — and today's date for `today()`.
+ * What expressions read besides a record's fields: `id`, the record's id
+ * (null while it is new), `user`, the person using the form (`id`, `name`,
+ * `roles`), `editing`, whether the record is being edited — false while
+ * a view shows it locked, to be read, as Flectra's oe_edit_only and
+ * oe_read_only — and `context`, the values the app passes in, as Flectra's
+ * context. A page's own field of the same name comes first.
  */
+function builtIns(fields, recordId, user, editing = true, context = {}, parent) {
+    const names = {
+        id: recordId ?? null,
+        user: { id: user?.id ?? null, name: user?.name ?? null, roles: [...(user?.roles ?? [])] },
+        editing,
+        context,
+        // A line's own form reads the record the line is on, as a line does.
+        ...(parent ? { parent } : {}),
+    };
+    for (const name of Object.keys(names))
+        if (name in fields)
+            delete names[name];
+    return names;
+}
+/** The record as expressions read it: its values, its `id` and `user`. What a line reads as `parent`. */
+function recordContext(values, fields, about) {
+    return { ...builtIns(fields, about.recordId, about.user, about.editing, about.context, about.parent), ...(0, values_1.expressionContext)(values, fields) };
+}
+/**
+ * A line as its expressions read it: its values, `parent` — the record it is
+ * on, as that record's expressions read it — and `user`. A line field of the
+ * same name comes first.
+ */
+function lineContext(values, fields, parent, id = null) {
+    // The line's own id, empty until it is saved: Flectra's readonly="id" on a saved line.
+    // The app's values a line reads are its record's.
+    const names = { parent, user: parent['user'] ?? builtIns({}, null, undefined)['user'], id, context: parent['context'] ?? {} };
+    for (const name of Object.keys(names))
+        if (name in fields)
+            delete names[name];
+    return { ...names, ...(0, values_1.expressionContext)(values, fields) };
+}
 function expressionEnv(values, fields, today) {
     const rows = new Map();
     return {

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

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/env.ts"],"names":[],"mappings":";;AASA,sCAgBC;AAvBD,qCAA+E;AAE/E;;;;GAIG;AACH,SAAgB,aAAa,CAAC,MAAc,EAAE,MAAyC,EAAE,KAAmB;IAC1G,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC1D,OAAO;QACL,KAAK;QACL,KAAK,CAAC,IAAI;YACR,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,GAAG,EAAE,IAAI,KAAK,UAAU;gBAAE,OAAO,SAAS,CAAC;YAC/C,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,KAAK,GAAG,CAAE,MAAM,CAAC,IAAI,CAAmB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,iBAAQ,EAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;gBAC5G,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,0BAAiB,EAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACxB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/env.ts"],"names":[],"mappings":"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"}

package/src/lib/record/env.mjs

@@ -1,9 +1,44 @@
 import { expressionContext, lineKind } from './values.mjs';
 /**
- * What an expression on a record is worked out with besides its values: the
- * rows of each one2many for `sum` and `count` — the items, not the sections
- * and notes between them — and today's date for `today()`.
+ * What expressions read besides a record's fields: `id`, the record's id
+ * (null while it is new), `user`, the person using the form (`id`, `name`,
+ * `roles`), `editing`, whether the record is being edited — false while
+ * a view shows it locked, to be read, as Flectra's oe_edit_only and
+ * oe_read_only — and `context`, the values the app passes in, as Flectra's
+ * context. A page's own field of the same name comes first.
  */
+export function builtIns(fields, recordId, user, editing = true, context = {}, parent) {
+    const names = {
+        id: recordId ?? null,
+        user: { id: user?.id ?? null, name: user?.name ?? null, roles: [...(user?.roles ?? [])] },
+        editing,
+        context,
+        // A line's own form reads the record the line is on, as a line does.
+        ...(parent ? { parent } : {}),
+    };
+    for (const name of Object.keys(names))
+        if (name in fields)
+            delete names[name];
+    return names;
+}
+/** The record as expressions read it: its values, its `id` and `user`. What a line reads as `parent`. */
+export function recordContext(values, fields, about) {
+    return { ...builtIns(fields, about.recordId, about.user, about.editing, about.context, about.parent), ...expressionContext(values, fields) };
+}
+/**
+ * A line as its expressions read it: its values, `parent` — the record it is
+ * on, as that record's expressions read it — and `user`. A line field of the
+ * same name comes first.
+ */
+export function lineContext(values, fields, parent, id = null) {
+    // The line's own id, empty until it is saved: Flectra's readonly="id" on a saved line.
+    // The app's values a line reads are its record's.
+    const names = { parent, user: parent['user'] ?? builtIns({}, null, undefined)['user'], id, context: parent['context'] ?? {} };
+    for (const name of Object.keys(names))
+        if (name in fields)
+            delete names[name];
+    return { ...names, ...expressionContext(values, fields) };
+}
 export function expressionEnv(values, fields, today) {
     const rows = new Map();
     return {

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

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAA0B,MAAM,UAAU,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAyC,EAAE,KAAmB;IAC1G,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC1D,OAAO;QACL,KAAK;QACL,KAAK,CAAC,IAAI;YACR,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,GAAG,EAAE,IAAI,KAAK,UAAU;gBAAE,OAAO,SAAS,CAAC;YAC/C,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,KAAK,GAAG,CAAE,MAAM,CAAC,IAAI,CAAmB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;gBAC5G,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACxB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"env.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/env.ts"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,4 @@
+import type { FilterItem } from '../format/field.mjs';
 import type { ResolvedFilter } from './data-source.mjs';
 import type { Values } from './values.mjs';
 /**
@@ -6,3 +7,12 @@ import type { Values } from './values.mjs';
  * group when each does. The memory data source searches with it; an app may too.
  */
 export declare function matchesFilter(values: Values, filter: readonly ResolvedFilter[]): boolean;
+/**
+ * A filter as a search or a list receives it: each `valueFrom` — a field, or a
+ * path such as `parent.company_id` or `user.id` — replaced by its value in
+ * `context`. A `=?` whose value is empty is left out, and so is a group it
+ * makes always hold: an `any` group with one item always holding, an `all`
+ * group left with none. A `=?` with a value goes as `=`, so a data source
+ * never sees `=?`.
+ */
+export declare function resolveFilter(items: readonly FilterItem[], context: Readonly<Record<string, unknown>>): ResolvedFilter[];

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

@@ -1,3 +1,4 @@
+import type { FilterItem } from '../format/field';
 import type { ResolvedFilter } from './data-source';
 import type { Values } from './values';
 /**
@@ -6,3 +7,12 @@ import type { Values } from './values';
  * group when each does. The memory data source searches with it; an app may too.
  */
 export declare function matchesFilter(values: Values, filter: readonly ResolvedFilter[]): boolean;
+/**
+ * A filter as a search or a list receives it: each `valueFrom` — a field, or a
+ * path such as `parent.company_id` or `user.id` — replaced by its value in
+ * `context`. A `=?` whose value is empty is left out, and so is a group it
+ * makes always hold: an `any` group with one item always holding, an `all`
+ * group left with none. A `=?` with a value goes as `=`, so a data source
+ * never sees `=?`.
+ */
+export declare function resolveFilter(items: readonly FilterItem[], context: Readonly<Record<string, unknown>>): ResolvedFilter[];