@fieldia/core 0.1.0

package/src/lib/record/scheduler.mjs

@@ -0,0 +1,12 @@
+/** The host's own timers: the browser's or Node's, whichever is running. */
+export const hostScheduler = {
+    setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),
+    clearTimeout: (handle) => globalThis.clearTimeout(handle),
+};
+/** Resolve after `ms`, on the given scheduler. */
+export function wait(ms, scheduler = hostScheduler) {
+    return new Promise((resolve) => {
+        scheduler.setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=scheduler.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/scheduler.ts"],"names":[],"mappings":"AAcA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAE,UAAoC,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC5F,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAE,UAAoC,CAAC,YAAY,CAAC,MAAM,CAAC;CACrF,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,IAAI,CAAC,EAAU,EAAE,YAAuB,aAAa;IACnE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,54 @@
+import type { Field, LineField } from '../format/field.mjs';
+import type { JsonValue } from '../format/json.mjs';
+/**
+ * The values a form holds while someone edits it. Plain JSON, so a draft can
+ * be stored and a record handed to any data source.
+ */
+export type RecordId = number | string;
+/** A related record, as a many2one or many2many holds it: enough to show it. */
+export interface RelatedRecord {
+    id: RecordId;
+    label: string;
+}
+/** A reference points at a record of one of several models. */
+export interface ReferenceValue {
+    model: string;
+    id: RecordId;
+    label: string;
+}
+/** An uploaded or stored file. `data` is base64; `url` is where a stored one lives. */
+export interface FileValue {
+    name: string;
+    type: string;
+    size: number;
+    data?: string;
+    url?: string;
+}
+/**
+ * One line of a one2many. `key` is stable for the life of the form, so a line
+ * keeps its identity while it is edited; `id` is the saved record's id, absent
+ * until the line is saved.
+ */
+export interface Line {
+    key: string;
+    id?: RecordId;
+    values: Values;
+}
+export type Value = JsonValue | RelatedRecord | RelatedRecord[] | ReferenceValue | FileValue | Line[];
+export type Values = Record<string, Value>;
+type AnyField = Field | LineField;
+/** What a field holds before anyone types in it. */
+export declare function emptyValue(field: AnyField): Value;
+/** A fresh record: each field's default, or its empty value. */
+export declare function initialValues(fields: Record<string, AnyField>): Values;
+/** Nothing worth keeping: no value, blank text, or an empty list. Numbers and booleans never are. */
+export declare function isEmpty(_field: AnyField, value: Value | undefined): boolean;
+/**
+ * The values as modifiers read them, matching what backends write in their
+ * expressions: a many2one is its id, a many2many its ids, a reference
+ * "model,id", a file its name, and lines a list (so `not child_ids` works).
+ */
+export declare function expressionContext(values: Values, fields: Record<string, AnyField>): Record<string, unknown>;
+/** A deep copy of plain JSON. */
+export declare function structuredCopy<T>(value: T): T;
+export {};

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

@@ -0,0 +1,54 @@
+import type { Field, LineField } from '../format/field';
+import type { JsonValue } from '../format/json';
+/**
+ * The values a form holds while someone edits it. Plain JSON, so a draft can
+ * be stored and a record handed to any data source.
+ */
+export type RecordId = number | string;
+/** A related record, as a many2one or many2many holds it: enough to show it. */
+export interface RelatedRecord {
+    id: RecordId;
+    label: string;
+}
+/** A reference points at a record of one of several models. */
+export interface ReferenceValue {
+    model: string;
+    id: RecordId;
+    label: string;
+}
+/** An uploaded or stored file. `data` is base64; `url` is where a stored one lives. */
+export interface FileValue {
+    name: string;
+    type: string;
+    size: number;
+    data?: string;
+    url?: string;
+}
+/**
+ * One line of a one2many. `key` is stable for the life of the form, so a line
+ * keeps its identity while it is edited; `id` is the saved record's id, absent
+ * until the line is saved.
+ */
+export interface Line {
+    key: string;
+    id?: RecordId;
+    values: Values;
+}
+export type Value = JsonValue | RelatedRecord | RelatedRecord[] | ReferenceValue | FileValue | Line[];
+export type Values = Record<string, Value>;
+type AnyField = Field | LineField;
+/** What a field holds before anyone types in it. */
+export declare function emptyValue(field: AnyField): Value;
+/** A fresh record: each field's default, or its empty value. */
+export declare function initialValues(fields: Record<string, AnyField>): Values;
+/** Nothing worth keeping: no value, blank text, or an empty list. Numbers and booleans never are. */
+export declare function isEmpty(_field: AnyField, value: Value | undefined): boolean;
+/**
+ * The values as modifiers read them, matching what backends write in their
+ * expressions: a many2one is its id, a many2many its ids, a reference
+ * "model,id", a file its name, and lines a list (so `not child_ids` works).
+ */
+export declare function expressionContext(values: Values, fields: Record<string, AnyField>): Record<string, unknown>;
+/** A deep copy of plain JSON. */
+export declare function structuredCopy<T>(value: T): T;
+export {};

package/src/lib/record/values.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyValue = emptyValue;
+exports.initialValues = initialValues;
+exports.isEmpty = isEmpty;
+exports.expressionContext = expressionContext;
+exports.structuredCopy = structuredCopy;
+/** What a field holds before anyone types in it. */
+function emptyValue(field) {
+    switch (field.type) {
+        case 'boolean':
+            return false;
+        case 'many2many':
+        case 'one2many':
+            return [];
+        case 'selection':
+            return field.multiple ? [] : null;
+        default:
+            return null;
+    }
+}
+/** A fresh record: each field's default, or its empty value. */
+function initialValues(fields) {
+    const values = {};
+    for (const [name, field] of Object.entries(fields)) {
+        values[name] = field.default !== undefined ? structuredCopy(field.default) : emptyValue(field);
+    }
+    return values;
+}
+/** Nothing worth keeping: no value, blank text, or an empty list. Numbers and booleans never are. */
+function isEmpty(_field, value) {
+    if (value === null || value === undefined)
+        return true;
+    if (typeof value === 'string')
+        return value.trim() === '';
+    if (Array.isArray(value))
+        return value.length === 0;
+    return false;
+}
+/**
+ * The values as modifiers read them, matching what backends write in their
+ * expressions: a many2one is its id, a many2many its ids, a reference
+ * "model,id", a file its name, and lines a list (so `not child_ids` works).
+ */
+function expressionContext(values, fields) {
+    const context = {};
+    for (const [name, value] of Object.entries(values)) {
+        const field = fields[name];
+        context[name] = field ? forExpressions(field, value) : value;
+    }
+    return context;
+}
+function forExpressions(field, value) {
+    if (value === null || value === undefined)
+        return null;
+    switch (field.type) {
+        case 'many2one':
+            return value.id;
+        case 'many2many':
+            return value.map((record) => record.id);
+        case 'one2many':
+            return value.map((line) => line.key);
+        case 'reference': {
+            const ref = value;
+            return `${ref.model},${ref.id}`;
+        }
+        case 'binary':
+        case 'image':
+            return value.name;
+        default:
+            return value;
+    }
+}
+/** A deep copy of plain JSON. */
+function structuredCopy(value) {
+    return value === undefined ? value : JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=values.js.map

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

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

package/src/lib/record/values.mjs

@@ -0,0 +1,71 @@
+/** What a field holds before anyone types in it. */
+export function emptyValue(field) {
+    switch (field.type) {
+        case 'boolean':
+            return false;
+        case 'many2many':
+        case 'one2many':
+            return [];
+        case 'selection':
+            return field.multiple ? [] : null;
+        default:
+            return null;
+    }
+}
+/** A fresh record: each field's default, or its empty value. */
+export function initialValues(fields) {
+    const values = {};
+    for (const [name, field] of Object.entries(fields)) {
+        values[name] = field.default !== undefined ? structuredCopy(field.default) : emptyValue(field);
+    }
+    return values;
+}
+/** Nothing worth keeping: no value, blank text, or an empty list. Numbers and booleans never are. */
+export function isEmpty(_field, value) {
+    if (value === null || value === undefined)
+        return true;
+    if (typeof value === 'string')
+        return value.trim() === '';
+    if (Array.isArray(value))
+        return value.length === 0;
+    return false;
+}
+/**
+ * The values as modifiers read them, matching what backends write in their
+ * expressions: a many2one is its id, a many2many its ids, a reference
+ * "model,id", a file its name, and lines a list (so `not child_ids` works).
+ */
+export function expressionContext(values, fields) {
+    const context = {};
+    for (const [name, value] of Object.entries(values)) {
+        const field = fields[name];
+        context[name] = field ? forExpressions(field, value) : value;
+    }
+    return context;
+}
+function forExpressions(field, value) {
+    if (value === null || value === undefined)
+        return null;
+    switch (field.type) {
+        case 'many2one':
+            return value.id;
+        case 'many2many':
+            return value.map((record) => record.id);
+        case 'one2many':
+            return value.map((line) => line.key);
+        case 'reference': {
+            const ref = value;
+            return `${ref.model},${ref.id}`;
+        }
+        case 'binary':
+        case 'image':
+            return value.name;
+        default:
+            return value;
+    }
+}
+/** A deep copy of plain JSON. */
+export function structuredCopy(value) {
+    return value === undefined ? value : JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=values.mjs.map

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

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