@fieldia/designer 0.0.0-stage → 0.11.0

package/src/lib/rules-formula-box.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formulaBox = formulaBox;
+const rules_formula_1 = require("./rules-formula");
+let made = 0;
+/** The name being typed just before the cursor, with an @ before it when there is one. */
+function typing(value, caret) {
+    const before = value.slice(0, caret);
+    const match = /(@?)([A-Za-z_][\w]*)?$/.exec(before);
+    if (!match || (!match[1] && !match[2]))
+        return null;
+    // Inside quotes it is text, not a name.
+    if ((before.slice(0, match.index).match(/'/g) ?? []).length % 2 === 1)
+        return null;
+    return { from: match.index, query: match[2] ?? '', at: match[1] === '@' };
+}
+/** Words that are the language's own, not the start of a field's name. */
+const OWN_WORDS = /^(and|or|not|in|True|False|None|round|abs|min|max|len|today|sum|count|if)$/i;
+function formulaBox(el, options) {
+    const id = `fd-formula-${++made}`;
+    const input = el('input', {
+        class: 'fd-input fd-formula-input',
+        role: 'combobox',
+        'aria-label': options.label,
+        'aria-autocomplete': 'list',
+        'aria-expanded': 'false',
+        'aria-controls': `${id}-list`,
+        autocomplete: 'off',
+        spellcheck: 'false',
+        placeholder: options.placeholder ?? '',
+        'aria-describedby': `${id}-words`,
+    });
+    const list = el('div', { class: 'fd-formula-suggest', role: 'listbox', id: `${id}-list`, 'aria-label': options.words.rulesUi.fields, hidden: '' });
+    // The formula in words, above the box it is about.
+    const reads = el('p', { class: 'fd-formula-reads', id: `${id}-words`, hidden: '' });
+    const element = el('div', { class: 'fd-formula' }, reads, input, list);
+    const words = el('span', { class: 'fd-formula-problem-words' });
+    const copy = el('code', { class: 'fd-formula-copy' });
+    const problem = el('p', { class: 'fd-formula-problem', role: 'alert', hidden: '' }, words, copy);
+    const outcome = el('span', { class: 'fd-formula-outcome' });
+    const result = el('p', { class: 'fd-formula-result', role: 'status', hidden: '' }, outcome);
+    let page = null;
+    let found = [];
+    let at = 0;
+    let current = null;
+    /** The formula the page held when last drawn. */
+    let lastKept = '';
+    /** The page's fields that start with, or hold, what is typed: by label first, then by name. */
+    function suggest() {
+        const caret = input.selectionStart ?? input.value.length;
+        current = page ? typing(input.value, caret) : null;
+        const query = current?.query.toLowerCase() ?? '';
+        if (!page || !current || (!current.at && (!query || OWN_WORDS.test(query))))
+            return close();
+        const all = Object.entries(page.fields)
+            .filter(([name]) => name !== options.own?.())
+            .map(([name, def]) => ({ name, label: def.label || name }));
+        const starts = all.filter((f) => f.label.toLowerCase().startsWith(query) || f.name.toLowerCase().startsWith(query));
+        const holds = all.filter((f) => !starts.includes(f) && (f.label.toLowerCase().includes(query) || f.name.toLowerCase().includes(query)));
+        found = [...starts, ...holds];
+        // A name typed out in full needs no list.
+        if (!found.length || (!current.at && found.length === 1 && found[0].name === current.query))
+            return close();
+        at = Math.min(at, found.length - 1);
+        draw();
+    }
+    function draw() {
+        list.replaceChildren(...found.map((f, i) => {
+            const option = el('div', { class: 'fd-formula-suggest-option', role: 'option', id: `${id}-${i}`, 'aria-selected': String(i === at) }, el('span', { class: 'fd-formula-suggest-label' }, f.label), el('code', { class: 'fd-formula-suggest-name' }, f.name));
+            // Picked with the pointer, the box keeps the cursor.
+            option.addEventListener('pointerdown', (event) => event.preventDefault());
+            option.addEventListener('mousedown', (event) => event.preventDefault());
+            option.addEventListener('click', () => pick(i));
+            return option;
+        }));
+        list.hidden = false;
+        input.setAttribute('aria-expanded', 'true');
+        input.setAttribute('aria-activedescendant', `${id}-${at}`);
+        problem.hidden = true;
+    }
+    function close() {
+        found = [];
+        at = 0;
+        list.hidden = true;
+        list.replaceChildren();
+        input.setAttribute('aria-expanded', 'false');
+        input.removeAttribute('aria-activedescendant');
+    }
+    /** Put the field's name in place of what was typed for it. */
+    function pick(i) {
+        const chosen = found[i];
+        if (!chosen || !current)
+            return;
+        const caret = input.selectionStart ?? input.value.length;
+        input.value = input.value.slice(0, current.from) + chosen.name + input.value.slice(caret);
+        const after = current.from + chosen.name.length;
+        input.setSelectionRange(after, after);
+        close();
+        changed();
+    }
+    /** The box as typed: checked, said, and handed on when it reads. */
+    function changed() {
+        if (!page)
+            return;
+        const source = input.value;
+        const wrong = source.trim() ? options.check(page, source) : null;
+        showProblem(source, wrong);
+        say(page, wrong || !source.trim() ? '' : source);
+        if (!wrong)
+            options.commit(source.trim());
+    }
+    function showProblem(source, wrong) {
+        // While a name is being picked, the half-typed name is not yet wrong.
+        problem.hidden = !wrong || !list.hidden;
+        if (!wrong)
+            return;
+        words.textContent = (0, rules_formula_1.problemWords)(wrong, options.words);
+        if (wrong.from === undefined) {
+            copy.hidden = true;
+            return;
+        }
+        const [from, to] = [wrong.from - 1, wrong.to ?? wrong.from];
+        copy.replaceChildren(source.slice(0, from), el('mark', {}, source.slice(from, to)), source.slice(to));
+        copy.hidden = false;
+    }
+    /** What the formula reads as, and gives: shown only where there is something to say. */
+    function say(on, source) {
+        // In words only when the words are not the formula as it is written: `120` reads as itself.
+        const pieces = source ? (0, rules_formula_1.formulaPieces)(on, source, options.words) : [];
+        reads.replaceChildren(...(pieces.some((piece) => piece.text !== piece.was)
+            ? [options.words.rulesUi.reads, ...pieces.flatMap((piece) => [...(piece.space ? [' '] : []), piece.field ? el('span', { class: 'fd-formula-name' }, piece.text) : piece.text])]
+            : []));
+        reads.hidden = !reads.textContent;
+        outcome.textContent = source && options.said ? options.said(on, source) : '';
+        result.hidden = !outcome.textContent;
+    }
+    input.addEventListener('input', () => {
+        suggest();
+        changed();
+    });
+    input.addEventListener('click', () => suggest());
+    input.addEventListener('blur', () => close());
+    input.addEventListener('keydown', (event) => {
+        if (list.hidden)
+            return;
+        if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+            event.preventDefault();
+            at = (at + (event.key === 'ArrowDown' ? 1 : -1) + found.length) % found.length;
+            draw();
+            list.querySelector('[aria-selected="true"]')?.scrollIntoView?.({ block: 'nearest' });
+        }
+        else if (event.key === 'Enter' || event.key === 'Tab') {
+            event.preventDefault();
+            pick(at);
+        }
+        else if (event.key === 'Escape') {
+            // Only the list closes: the panel and the editor keep what is open.
+            event.preventDefault();
+            event.stopPropagation();
+            close();
+            changed();
+        }
+    });
+    return {
+        element,
+        input,
+        problem,
+        result,
+        update(next, source) {
+            page = next;
+            if (input.ownerDocument.activeElement === input)
+                return;
+            // A formula that does not read stays as typed until another is kept.
+            if (problem.hidden || source !== lastKept)
+                input.value = source;
+            lastKept = source;
+            if (problem.hidden)
+                say(next, source);
+        },
+        insert(text, back = 0) {
+            const from = input.selectionStart ?? input.value.length;
+            const to = input.selectionEnd ?? from;
+            input.value = input.value.slice(0, from) + text + input.value.slice(to);
+            input.focus();
+            const caret = from + text.length - back;
+            input.setSelectionRange(caret, caret);
+            changed();
+        },
+    };
+}
+//# sourceMappingURL=rules-formula-box.js.map

package/src/lib/rules-formula-box.js.map

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

package/src/lib/rules-formula-box.mjs

@@ -0,0 +1,188 @@
+import { formulaPieces, problemWords } from './rules-formula.mjs';
+let made = 0;
+/** The name being typed just before the cursor, with an @ before it when there is one. */
+function typing(value, caret) {
+    const before = value.slice(0, caret);
+    const match = /(@?)([A-Za-z_][\w]*)?$/.exec(before);
+    if (!match || (!match[1] && !match[2]))
+        return null;
+    // Inside quotes it is text, not a name.
+    if ((before.slice(0, match.index).match(/'/g) ?? []).length % 2 === 1)
+        return null;
+    return { from: match.index, query: match[2] ?? '', at: match[1] === '@' };
+}
+/** Words that are the language's own, not the start of a field's name. */
+const OWN_WORDS = /^(and|or|not|in|True|False|None|round|abs|min|max|len|today|sum|count|if)$/i;
+export function formulaBox(el, options) {
+    const id = `fd-formula-${++made}`;
+    const input = el('input', {
+        class: 'fd-input fd-formula-input',
+        role: 'combobox',
+        'aria-label': options.label,
+        'aria-autocomplete': 'list',
+        'aria-expanded': 'false',
+        'aria-controls': `${id}-list`,
+        autocomplete: 'off',
+        spellcheck: 'false',
+        placeholder: options.placeholder ?? '',
+        'aria-describedby': `${id}-words`,
+    });
+    const list = el('div', { class: 'fd-formula-suggest', role: 'listbox', id: `${id}-list`, 'aria-label': options.words.rulesUi.fields, hidden: '' });
+    // The formula in words, above the box it is about.
+    const reads = el('p', { class: 'fd-formula-reads', id: `${id}-words`, hidden: '' });
+    const element = el('div', { class: 'fd-formula' }, reads, input, list);
+    const words = el('span', { class: 'fd-formula-problem-words' });
+    const copy = el('code', { class: 'fd-formula-copy' });
+    const problem = el('p', { class: 'fd-formula-problem', role: 'alert', hidden: '' }, words, copy);
+    const outcome = el('span', { class: 'fd-formula-outcome' });
+    const result = el('p', { class: 'fd-formula-result', role: 'status', hidden: '' }, outcome);
+    let page = null;
+    let found = [];
+    let at = 0;
+    let current = null;
+    /** The formula the page held when last drawn. */
+    let lastKept = '';
+    /** The page's fields that start with, or hold, what is typed: by label first, then by name. */
+    function suggest() {
+        const caret = input.selectionStart ?? input.value.length;
+        current = page ? typing(input.value, caret) : null;
+        const query = current?.query.toLowerCase() ?? '';
+        if (!page || !current || (!current.at && (!query || OWN_WORDS.test(query))))
+            return close();
+        const all = Object.entries(page.fields)
+            .filter(([name]) => name !== options.own?.())
+            .map(([name, def]) => ({ name, label: def.label || name }));
+        const starts = all.filter((f) => f.label.toLowerCase().startsWith(query) || f.name.toLowerCase().startsWith(query));
+        const holds = all.filter((f) => !starts.includes(f) && (f.label.toLowerCase().includes(query) || f.name.toLowerCase().includes(query)));
+        found = [...starts, ...holds];
+        // A name typed out in full needs no list.
+        if (!found.length || (!current.at && found.length === 1 && found[0].name === current.query))
+            return close();
+        at = Math.min(at, found.length - 1);
+        draw();
+    }
+    function draw() {
+        list.replaceChildren(...found.map((f, i) => {
+            const option = el('div', { class: 'fd-formula-suggest-option', role: 'option', id: `${id}-${i}`, 'aria-selected': String(i === at) }, el('span', { class: 'fd-formula-suggest-label' }, f.label), el('code', { class: 'fd-formula-suggest-name' }, f.name));
+            // Picked with the pointer, the box keeps the cursor.
+            option.addEventListener('pointerdown', (event) => event.preventDefault());
+            option.addEventListener('mousedown', (event) => event.preventDefault());
+            option.addEventListener('click', () => pick(i));
+            return option;
+        }));
+        list.hidden = false;
+        input.setAttribute('aria-expanded', 'true');
+        input.setAttribute('aria-activedescendant', `${id}-${at}`);
+        problem.hidden = true;
+    }
+    function close() {
+        found = [];
+        at = 0;
+        list.hidden = true;
+        list.replaceChildren();
+        input.setAttribute('aria-expanded', 'false');
+        input.removeAttribute('aria-activedescendant');
+    }
+    /** Put the field's name in place of what was typed for it. */
+    function pick(i) {
+        const chosen = found[i];
+        if (!chosen || !current)
+            return;
+        const caret = input.selectionStart ?? input.value.length;
+        input.value = input.value.slice(0, current.from) + chosen.name + input.value.slice(caret);
+        const after = current.from + chosen.name.length;
+        input.setSelectionRange(after, after);
+        close();
+        changed();
+    }
+    /** The box as typed: checked, said, and handed on when it reads. */
+    function changed() {
+        if (!page)
+            return;
+        const source = input.value;
+        const wrong = source.trim() ? options.check(page, source) : null;
+        showProblem(source, wrong);
+        say(page, wrong || !source.trim() ? '' : source);
+        if (!wrong)
+            options.commit(source.trim());
+    }
+    function showProblem(source, wrong) {
+        // While a name is being picked, the half-typed name is not yet wrong.
+        problem.hidden = !wrong || !list.hidden;
+        if (!wrong)
+            return;
+        words.textContent = problemWords(wrong, options.words);
+        if (wrong.from === undefined) {
+            copy.hidden = true;
+            return;
+        }
+        const [from, to] = [wrong.from - 1, wrong.to ?? wrong.from];
+        copy.replaceChildren(source.slice(0, from), el('mark', {}, source.slice(from, to)), source.slice(to));
+        copy.hidden = false;
+    }
+    /** What the formula reads as, and gives: shown only where there is something to say. */
+    function say(on, source) {
+        // In words only when the words are not the formula as it is written: `120` reads as itself.
+        const pieces = source ? formulaPieces(on, source, options.words) : [];
+        reads.replaceChildren(...(pieces.some((piece) => piece.text !== piece.was)
+            ? [options.words.rulesUi.reads, ...pieces.flatMap((piece) => [...(piece.space ? [' '] : []), piece.field ? el('span', { class: 'fd-formula-name' }, piece.text) : piece.text])]
+            : []));
+        reads.hidden = !reads.textContent;
+        outcome.textContent = source && options.said ? options.said(on, source) : '';
+        result.hidden = !outcome.textContent;
+    }
+    input.addEventListener('input', () => {
+        suggest();
+        changed();
+    });
+    input.addEventListener('click', () => suggest());
+    input.addEventListener('blur', () => close());
+    input.addEventListener('keydown', (event) => {
+        if (list.hidden)
+            return;
+        if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+            event.preventDefault();
+            at = (at + (event.key === 'ArrowDown' ? 1 : -1) + found.length) % found.length;
+            draw();
+            list.querySelector('[aria-selected="true"]')?.scrollIntoView?.({ block: 'nearest' });
+        }
+        else if (event.key === 'Enter' || event.key === 'Tab') {
+            event.preventDefault();
+            pick(at);
+        }
+        else if (event.key === 'Escape') {
+            // Only the list closes: the panel and the editor keep what is open.
+            event.preventDefault();
+            event.stopPropagation();
+            close();
+            changed();
+        }
+    });
+    return {
+        element,
+        input,
+        problem,
+        result,
+        update(next, source) {
+            page = next;
+            if (input.ownerDocument.activeElement === input)
+                return;
+            // A formula that does not read stays as typed until another is kept.
+            if (problem.hidden || source !== lastKept)
+                input.value = source;
+            lastKept = source;
+            if (problem.hidden)
+                say(next, source);
+        },
+        insert(text, back = 0) {
+            const from = input.selectionStart ?? input.value.length;
+            const to = input.selectionEnd ?? from;
+            input.value = input.value.slice(0, from) + text + input.value.slice(to);
+            input.focus();
+            const caret = from + text.length - back;
+            input.setSelectionRange(caret, caret);
+            changed();
+        },
+    };
+}
+//# sourceMappingURL=rules-formula-box.mjs.map

package/src/lib/rules-formula-box.mjs.map

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

package/src/lib/rules-formula.d.mts

@@ -0,0 +1,75 @@
+import { type Field, type Page } from '@fieldia/core';
+import type { DesignerWords } from './designer-words.mjs';
+/**
+ * A formula as a person types it — "Worked out from" a field's value, or a
+ * value to set when something holds: what is wrong with it and where (by
+ * character, counted from 1, as an editor counts them), what it reads, how it
+ * reads in words, and what it gives on made-up values. The page's own parser
+ * decides what reads; this only says where it stopped, and in words.
+ */
+/** What is wrong, and the characters it is about, from 1; none when it is about the whole. */
+export interface FormulaProblem {
+    words: string;
+    from?: number;
+    to?: number;
+}
+/** A piece of a formula, and where it is: `from` and `to` count characters from 0, `to` not included. */
+export interface FormulaToken {
+    kind: 'name' | 'number' | 'text' | 'list' | 'sign' | 'word' | 'open' | 'close' | 'comma';
+    text: string;
+    from: number;
+    to: number;
+}
+/** The pieces of a formula, or the character it cannot read. */
+export declare function formulaTokens(source: string): FormulaToken[] | {
+    bad: number;
+};
+/** "Unknown field “prise” at 1–5": the words, and where, as they are shown under the box. */
+export declare function problemWords(problem: FormulaProblem | null, words?: DesignerWords): string;
+/**
+ * What is wrong with a formula on this page, or null when it reads: a sign it
+ * cannot hold, a piece out of place, something missing, a function there is
+ * not or given too many values, a field the page does not have.
+ */
+export declare function formulaProblem(page: Page, source: string, words?: DesignerWords): FormulaProblem | null;
+/** The fields a formula reads, by name, once each; none when it cannot be read. */
+export declare function fieldsReadBy(source: string | boolean | undefined): string[];
+/**
+ * Whether working a field out from this formula would have it worked out
+ * from itself, directly or through other worked-out fields; the words if so.
+ */
+export declare function wouldCircle(page: Page, own: string, source: string, words?: DesignerWords): string | null;
+/** A literal as written, as its value: `'bulk'` is bulk, `-5` is −5; null for anything else. */
+export declare function literalOf(source: string): {
+    value: string | number | boolean | null;
+} | null;
+/** A value as a person reads it: a choice by its label, yes or no, text as it is. */
+export declare function valueInWords(field: Field | undefined, value: unknown, words?: DesignerWords): string;
+/** A piece of a formula in words, with the space before it and what it was written as; `field` names the field it stands for. */
+export interface WordPiece {
+    text: string;
+    was: string;
+    space: boolean;
+    field?: string;
+}
+/** A formula in words, piece by piece: what `formulaInWords` joins, and the box draws with each field marked. */
+export declare function formulaPieces(page: Page, source: string, words?: DesignerWords): WordPiece[];
+/**
+ * A formula in words: its fields by their labels, × and ÷ for * and /, ≥
+ * and ≤ for >= and <=, "is" and "is not" for == and !=, and a choice
+ * compared with a value by the value's label: `state == 'done'` reads
+ * "Status is Done". A label with a sign in it is quoted.
+ */
+export declare function formulaInWords(page: Page, source: string, words?: DesignerWords): string;
+/**
+ * The formula worked out on made-up values, the way the form works it out
+ * (a whole number rounded, text as text): "With Price 120 and Quantity 3:
+ * 360". Empty when the formula does not read.
+ */
+export declare function sampleResult(page: Page, own: string, source: string, words?: DesignerWords): string;
+/**
+ * Whether a rule across fields holds on made-up values, as the form checks
+ * it: "With Contract ends 2026-03-14 and Start date 2026-03-01: holds".
+ * Empty when the formula does not read.
+ */
+export declare function sampleHolds(page: Page, source: string, words?: DesignerWords): string;

package/src/lib/rules-formula.d.ts

@@ -0,0 +1,75 @@
+import { type Field, type Page } from '@fieldia/core';
+import type { DesignerWords } from './designer-words';
+/**
+ * A formula as a person types it — "Worked out from" a field's value, or a
+ * value to set when something holds: what is wrong with it and where (by
+ * character, counted from 1, as an editor counts them), what it reads, how it
+ * reads in words, and what it gives on made-up values. The page's own parser
+ * decides what reads; this only says where it stopped, and in words.
+ */
+/** What is wrong, and the characters it is about, from 1; none when it is about the whole. */
+export interface FormulaProblem {
+    words: string;
+    from?: number;
+    to?: number;
+}
+/** A piece of a formula, and where it is: `from` and `to` count characters from 0, `to` not included. */
+export interface FormulaToken {
+    kind: 'name' | 'number' | 'text' | 'list' | 'sign' | 'word' | 'open' | 'close' | 'comma';
+    text: string;
+    from: number;
+    to: number;
+}
+/** The pieces of a formula, or the character it cannot read. */
+export declare function formulaTokens(source: string): FormulaToken[] | {
+    bad: number;
+};
+/** "Unknown field “prise” at 1–5": the words, and where, as they are shown under the box. */
+export declare function problemWords(problem: FormulaProblem | null, words?: DesignerWords): string;
+/**
+ * What is wrong with a formula on this page, or null when it reads: a sign it
+ * cannot hold, a piece out of place, something missing, a function there is
+ * not or given too many values, a field the page does not have.
+ */
+export declare function formulaProblem(page: Page, source: string, words?: DesignerWords): FormulaProblem | null;
+/** The fields a formula reads, by name, once each; none when it cannot be read. */
+export declare function fieldsReadBy(source: string | boolean | undefined): string[];
+/**
+ * Whether working a field out from this formula would have it worked out
+ * from itself, directly or through other worked-out fields; the words if so.
+ */
+export declare function wouldCircle(page: Page, own: string, source: string, words?: DesignerWords): string | null;
+/** A literal as written, as its value: `'bulk'` is bulk, `-5` is −5; null for anything else. */
+export declare function literalOf(source: string): {
+    value: string | number | boolean | null;
+} | null;
+/** A value as a person reads it: a choice by its label, yes or no, text as it is. */
+export declare function valueInWords(field: Field | undefined, value: unknown, words?: DesignerWords): string;
+/** A piece of a formula in words, with the space before it and what it was written as; `field` names the field it stands for. */
+export interface WordPiece {
+    text: string;
+    was: string;
+    space: boolean;
+    field?: string;
+}
+/** A formula in words, piece by piece: what `formulaInWords` joins, and the box draws with each field marked. */
+export declare function formulaPieces(page: Page, source: string, words?: DesignerWords): WordPiece[];
+/**
+ * A formula in words: its fields by their labels, × and ÷ for * and /, ≥
+ * and ≤ for >= and <=, "is" and "is not" for == and !=, and a choice
+ * compared with a value by the value's label: `state == 'done'` reads
+ * "Status is Done". A label with a sign in it is quoted.
+ */
+export declare function formulaInWords(page: Page, source: string, words?: DesignerWords): string;
+/**
+ * The formula worked out on made-up values, the way the form works it out
+ * (a whole number rounded, text as text): "With Price 120 and Quantity 3:
+ * 360". Empty when the formula does not read.
+ */
+export declare function sampleResult(page: Page, own: string, source: string, words?: DesignerWords): string;
+/**
+ * Whether a rule across fields holds on made-up values, as the form checks
+ * it: "With Contract ends 2026-03-14 and Start date 2026-03-01: holds".
+ * Empty when the formula does not read.
+ */
+export declare function sampleHolds(page: Page, source: string, words?: DesignerWords): string;