@fieldia/designer 0.0.0-stage → 0.12.0

package/src/lib/steps-words.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stepSentence = stepSentence;
+exports.stepsLines = stepsLines;
+exports.placeName = placeName;
+exports.pageSteps = pageSteps;
+exports.withCode = withCode;
+exports.fieldPlace = fieldPlace;
+const en_1 = require("./locales/en");
+const page_tree_1 = require("./page-tree");
+const saved_forms_1 = require("./saved-forms");
+const rules_formula_1 = require("./rules-formula");
+const rules_words_1 = require("./rules-words");
+const steps_places_1 = require("./steps-places");
+const labelOf = (page, name) => page.fields[name]?.label || name;
+/** A step in words, without the steps it runs once a page it opened is saved. */
+function stepSentence(page, step, words = en_1.en, saved = () => undefined) {
+    const w = words.steps;
+    const field = (name) => labelOf(page, name);
+    const formula = (source) => (0, rules_formula_1.formulaInWords)(page, source, words);
+    let said;
+    switch (step.do) {
+        case 'open': {
+            // The condition before what comes back, so it reads as the page's: "Open Customer in a panel when VIP is Yes, then …".
+            const other = saved(step.page);
+            const opened = w.open((0, saved_forms_1.shownTitle)(other, page.language) || w.unknownPage(step.page), step.as ?? 'dialog', step.side);
+            const record = step.record ? w.onRecord(formula(step.record)) : '';
+            const values = Object.keys(step.values ?? {}).map((name) => other?.fields[name]?.label || name);
+            const into = Object.keys(step.into ?? {}).map(field);
+            // A list opened on some records: the first condition in words, the rest counted.
+            const [first, ...more] = step.filter ?? [];
+            const only = first && 'op' in first && first.op === '=' && first.valueFrom ? w.onlyThose(other?.fields[first.field]?.label || first.field, first.valueFrom === 'id' ? w.theRecordItself : field(first.valueFrom)) + (more.length ? w.moreConditions(more.length) : '') : '';
+            const head = `${opened}${record}${only}${values.length ? w.startingWith(values) : ''}`;
+            return `${whenOf(page, head, step.when, words)}${into.length ? w.thenPut(into) : ''}`;
+        }
+        case 'set':
+            said = w.set(field(step.field), (0, rules_words_1.setValueInWords)(page, page.fields[step.field], step.value, words));
+            break;
+        case 'clear':
+            said = w.clear(field(step.field));
+            break;
+        case 'addLine':
+            said = w.addLine(field(step.field));
+            break;
+        case 'check':
+            said = step.fields?.length ? w.checkFields(step.fields.map(field)) : w.checkAll;
+            break;
+        case 'save':
+            said = page.data.kind === 'responses' ? w.send : w.save;
+            break;
+        case 'reset':
+            said = w.reset;
+            break;
+        case 'goTo':
+            said = w.goTo((0, steps_places_1.showTargets)(page).find((t) => t.id === step.target)?.label || step.target);
+            break;
+        case 'say':
+            said = step.tone && step.tone !== 'info' ? w.sayTone(step.message, step.tone) : w.say(step.message);
+            break;
+        case 'ask':
+            said = w.ask(step.message);
+            break;
+        case 'call': {
+            const params = Object.keys(step.params ?? {}).length;
+            said = params ? w.callWith(step.action, params) : w.call(step.action);
+            break;
+        }
+        case 'close':
+            said = w.close;
+            break;
+        case 'openUrl':
+            said = w.openUrl(formula(step.url), step.newTab !== false);
+            break;
+        case 'reload':
+            said = w.reload;
+            break;
+        case 'archive':
+        case 'unarchive':
+        case 'duplicate':
+        case 'delete':
+            said = w[step.do];
+            break;
+        case 'post':
+            said = w.post(step.message, step.kind ?? 'note');
+            break;
+    }
+    return whenOf(page, said, step.when, words);
+}
+/** A sentence with when it runs: always, never, or when a condition holds. */
+function whenOf(page, sentence, when, words) {
+    if (when === undefined || when === true)
+        return sentence;
+    if (when === false)
+        return words.steps.never(sentence);
+    return words.steps.when(sentence, (0, rules_formula_1.formulaInWords)(page, when, words));
+}
+/** A list of steps, one sentence a line, the steps run once an opened page is saved under it. */
+function stepsLines(page, steps, words = en_1.en, saved) {
+    return (0, steps_places_1.eachStep)(steps).map(({ step, path }) => {
+        let line = stepSentence(page, step, words, saved);
+        for (let depth = 1; depth < path.length; depth++)
+            line = words.steps.nested(line);
+        return line;
+    });
+}
+/** A place's name as a person knows it: a button's words, a field's label, a moment, a tab shown. */
+function placeName(page, place, words = en_1.en) {
+    const w = words.steps;
+    if ('press' in place) {
+        const press = (0, steps_places_1.pressOf)(page, place.press);
+        const builtin = press && 'builtin' in press ? press.builtin : undefined;
+        return press?.label ?? (builtin ? words.canvas.menuKinds[builtin] : place.press);
+    }
+    if ('change' in place)
+        return labelOf(page, place.change);
+    if ('moment' in place)
+        return w.momentNames[place.moment];
+    return w.whenShown((0, steps_places_1.showTargets)(page).find((t) => t.id === place.show)?.label || place.show);
+}
+/** Every list of steps on the page, in reading order, said. */
+function pageSteps(page, words = en_1.en, saved) {
+    return (0, steps_places_1.everyPlace)(page).map(({ place, steps }) => {
+        const group = 'press' in place ? 'clicked' : 'change' in place ? 'changes' : 'moments';
+        const part = 'press' in place ? place.press : 'change' in place ? fieldPlace(page, place.change) : null;
+        const reads = [...new Set((0, steps_places_1.eachStep)(steps).flatMap(({ step }) => [...(0, steps_places_1.fieldsNamed)(step), ...(0, steps_places_1.fieldsRead)(step)]))];
+        const codes = [...new Set((0, steps_places_1.eachStep)(steps).flatMap(({ step }) => (step.do === 'call' ? [step.action] : step.do === 'open' && !saved?.(step.page) ? [step.page] : [])))];
+        return { place, group, part, name: placeName(page, place, words), lines: stepsLines(page, steps, words, saved), reads, codes };
+    });
+}
+/** Words with the app's names in them kept apart as code: each name, where it stands as a word, in a `code` of its own. */
+function withCode(doc, text, codes) {
+    const names = codes.filter(Boolean).sort((a, b) => b.length - a.length);
+    if (!names.length)
+        return [doc.createTextNode(text)];
+    const escaped = names.map((name) => name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+    const pattern = new RegExp(`(?<![\\w-])(${escaped.join('|')})(?![\\w-])`, 'g');
+    const out = [];
+    let at = 0;
+    for (const match of text.matchAll(pattern)) {
+        if (match.index > at)
+            out.push(doc.createTextNode(text.slice(at, match.index)));
+        const code = doc.createElement('code');
+        code.className = 'fd-do-code';
+        code.textContent = match[0];
+        out.push(code);
+        at = match.index + match[0].length;
+    }
+    if (at < text.length)
+        out.push(doc.createTextNode(text.slice(at)));
+    return out;
+}
+/** Where a field is on the page, by its part's id: the first place it shows; null when it is not on it. */
+function fieldPlace(page, name) {
+    for (const holder of (0, page_tree_1.containers)(page))
+        for (const node of holder.children)
+            if (node.type === 'field' && node.field === name)
+                return node.id;
+    return null;
+}
+//# sourceMappingURL=steps-words.js.map

package/src/lib/steps-words.js.map

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

package/src/lib/steps-words.mjs

@@ -0,0 +1,152 @@
+import { en } from './locales/en/index.mjs';
+import { containers } from './page-tree.mjs';
+import { shownTitle } from './saved-forms.mjs';
+import { formulaInWords } from './rules-formula.mjs';
+import { setValueInWords } from './rules-words.mjs';
+import { eachStep, everyPlace, fieldsNamed, fieldsRead, pressOf, showTargets } from './steps-places.mjs';
+const labelOf = (page, name) => page.fields[name]?.label || name;
+/** A step in words, without the steps it runs once a page it opened is saved. */
+export function stepSentence(page, step, words = en, saved = () => undefined) {
+    const w = words.steps;
+    const field = (name) => labelOf(page, name);
+    const formula = (source) => formulaInWords(page, source, words);
+    let said;
+    switch (step.do) {
+        case 'open': {
+            // The condition before what comes back, so it reads as the page's: "Open Customer in a panel when VIP is Yes, then …".
+            const other = saved(step.page);
+            const opened = w.open(shownTitle(other, page.language) || w.unknownPage(step.page), step.as ?? 'dialog', step.side);
+            const record = step.record ? w.onRecord(formula(step.record)) : '';
+            const values = Object.keys(step.values ?? {}).map((name) => other?.fields[name]?.label || name);
+            const into = Object.keys(step.into ?? {}).map(field);
+            // A list opened on some records: the first condition in words, the rest counted.
+            const [first, ...more] = step.filter ?? [];
+            const only = first && 'op' in first && first.op === '=' && first.valueFrom ? w.onlyThose(other?.fields[first.field]?.label || first.field, first.valueFrom === 'id' ? w.theRecordItself : field(first.valueFrom)) + (more.length ? w.moreConditions(more.length) : '') : '';
+            const head = `${opened}${record}${only}${values.length ? w.startingWith(values) : ''}`;
+            return `${whenOf(page, head, step.when, words)}${into.length ? w.thenPut(into) : ''}`;
+        }
+        case 'set':
+            said = w.set(field(step.field), setValueInWords(page, page.fields[step.field], step.value, words));
+            break;
+        case 'clear':
+            said = w.clear(field(step.field));
+            break;
+        case 'addLine':
+            said = w.addLine(field(step.field));
+            break;
+        case 'check':
+            said = step.fields?.length ? w.checkFields(step.fields.map(field)) : w.checkAll;
+            break;
+        case 'save':
+            said = page.data.kind === 'responses' ? w.send : w.save;
+            break;
+        case 'reset':
+            said = w.reset;
+            break;
+        case 'goTo':
+            said = w.goTo(showTargets(page).find((t) => t.id === step.target)?.label || step.target);
+            break;
+        case 'say':
+            said = step.tone && step.tone !== 'info' ? w.sayTone(step.message, step.tone) : w.say(step.message);
+            break;
+        case 'ask':
+            said = w.ask(step.message);
+            break;
+        case 'call': {
+            const params = Object.keys(step.params ?? {}).length;
+            said = params ? w.callWith(step.action, params) : w.call(step.action);
+            break;
+        }
+        case 'close':
+            said = w.close;
+            break;
+        case 'openUrl':
+            said = w.openUrl(formula(step.url), step.newTab !== false);
+            break;
+        case 'reload':
+            said = w.reload;
+            break;
+        case 'archive':
+        case 'unarchive':
+        case 'duplicate':
+        case 'delete':
+            said = w[step.do];
+            break;
+        case 'post':
+            said = w.post(step.message, step.kind ?? 'note');
+            break;
+    }
+    return whenOf(page, said, step.when, words);
+}
+/** A sentence with when it runs: always, never, or when a condition holds. */
+function whenOf(page, sentence, when, words) {
+    if (when === undefined || when === true)
+        return sentence;
+    if (when === false)
+        return words.steps.never(sentence);
+    return words.steps.when(sentence, formulaInWords(page, when, words));
+}
+/** A list of steps, one sentence a line, the steps run once an opened page is saved under it. */
+export function stepsLines(page, steps, words = en, saved) {
+    return eachStep(steps).map(({ step, path }) => {
+        let line = stepSentence(page, step, words, saved);
+        for (let depth = 1; depth < path.length; depth++)
+            line = words.steps.nested(line);
+        return line;
+    });
+}
+/** A place's name as a person knows it: a button's words, a field's label, a moment, a tab shown. */
+export function placeName(page, place, words = en) {
+    const w = words.steps;
+    if ('press' in place) {
+        const press = pressOf(page, place.press);
+        const builtin = press && 'builtin' in press ? press.builtin : undefined;
+        return press?.label ?? (builtin ? words.canvas.menuKinds[builtin] : place.press);
+    }
+    if ('change' in place)
+        return labelOf(page, place.change);
+    if ('moment' in place)
+        return w.momentNames[place.moment];
+    return w.whenShown(showTargets(page).find((t) => t.id === place.show)?.label || place.show);
+}
+/** Every list of steps on the page, in reading order, said. */
+export function pageSteps(page, words = en, saved) {
+    return everyPlace(page).map(({ place, steps }) => {
+        const group = 'press' in place ? 'clicked' : 'change' in place ? 'changes' : 'moments';
+        const part = 'press' in place ? place.press : 'change' in place ? fieldPlace(page, place.change) : null;
+        const reads = [...new Set(eachStep(steps).flatMap(({ step }) => [...fieldsNamed(step), ...fieldsRead(step)]))];
+        const codes = [...new Set(eachStep(steps).flatMap(({ step }) => (step.do === 'call' ? [step.action] : step.do === 'open' && !saved?.(step.page) ? [step.page] : [])))];
+        return { place, group, part, name: placeName(page, place, words), lines: stepsLines(page, steps, words, saved), reads, codes };
+    });
+}
+/** Words with the app's names in them kept apart as code: each name, where it stands as a word, in a `code` of its own. */
+export function withCode(doc, text, codes) {
+    const names = codes.filter(Boolean).sort((a, b) => b.length - a.length);
+    if (!names.length)
+        return [doc.createTextNode(text)];
+    const escaped = names.map((name) => name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+    const pattern = new RegExp(`(?<![\\w-])(${escaped.join('|')})(?![\\w-])`, 'g');
+    const out = [];
+    let at = 0;
+    for (const match of text.matchAll(pattern)) {
+        if (match.index > at)
+            out.push(doc.createTextNode(text.slice(at, match.index)));
+        const code = doc.createElement('code');
+        code.className = 'fd-do-code';
+        code.textContent = match[0];
+        out.push(code);
+        at = match.index + match[0].length;
+    }
+    if (at < text.length)
+        out.push(doc.createTextNode(text.slice(at)));
+    return out;
+}
+/** Where a field is on the page, by its part's id: the first place it shows; null when it is not on it. */
+export function fieldPlace(page, name) {
+    for (const holder of containers(page))
+        for (const node of holder.children)
+            if (node.type === 'field' && node.field === name)
+                return node.id;
+    return null;
+}
+//# sourceMappingURL=steps-words.mjs.map

package/src/lib/steps-words.mjs.map

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

package/src/lib/structure-changes.d.mts

@@ -0,0 +1,14 @@
+import type { Field, FieldNode } from '@fieldia/core';
+import type { DesignerWords } from './designer-words.mjs';
+/**
+ * What changed in a structure's own settings from one version of a page to
+ * the next, in words, for the Publish dialog: the records a link offers, a
+ * table's totals and the columns people may hide. The widgets' settings —
+ * a signature's pen, an address's parts — are "how it shows".
+ */
+interface Placed {
+    field: Field;
+    node: FieldNode;
+}
+export declare function structureChanges(name: string, was: Placed, now: Placed, words?: DesignerWords): string[];
+export {};

package/src/lib/structure-changes.d.ts

@@ -0,0 +1,14 @@
+import type { Field, FieldNode } from '@fieldia/core';
+import type { DesignerWords } from './designer-words';
+/**
+ * What changed in a structure's own settings from one version of a page to
+ * the next, in words, for the Publish dialog: the records a link offers, a
+ * table's totals and the columns people may hide. The widgets' settings —
+ * a signature's pen, an address's parts — are "how it shows".
+ */
+interface Placed {
+    field: Field;
+    node: FieldNode;
+}
+export declare function structureChanges(name: string, was: Placed, now: Placed, words?: DesignerWords): string[];
+export {};

package/src/lib/structure-changes.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.structureChanges = structureChanges;
+const en_1 = require("./locales/en");
+const same = (a, b) => JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+function structureChanges(name, was, now, words = en_1.en) {
+    const w = words.changes;
+    const lines = [];
+    const filterOf = (p) => (p.field.type === 'many2one' || p.field.type === 'many2many' ? p.field.filter : undefined);
+    const filter = filterOf(now);
+    if (!same(filterOf(was), filter)) {
+        const one = filter?.length === 1 && 'op' in filter[0] && filter[0].op === '=' && filter[0].valueFrom === undefined ? filter[0] : null;
+        lines.push(!filter ? w.offersEvery(name) : one ? w.offersWhere(name, one.field, JSON.stringify(one.value)) : w.offersChanged(name));
+    }
+    if (now.field.type === 'one2many') {
+        const fields = now.field.fields;
+        const labels = (names) => words.parts.commaList(names.map((n) => fields[n]?.label ?? n));
+        if (!same(was.node.totals, now.node.totals))
+            lines.push(now.node.totals?.length ? w.addsUp(name, labels(now.node.totals)) : w.addsUpNothing(name));
+        if (!same(was.node.optionalColumns, now.node.optionalColumns))
+            lines.push(w.optionalColumns(name));
+        // tables lane: the table's own rules, buttons and shape, said once.
+        const own = (p) => [p.node.cells, p.node.rowTones, p.node.rowBold, p.node.rowButtons, p.node.selectedButtons, p.node.controlButtons, p.node.lineOpens, p.node.cards, p.node.fit, p.node.options?.['copy']];
+        if (!same(own(was), own(now)))
+            lines.push(words.tables.tableChanged(name));
+    }
+    if (!same([was.node.tones, was.node.bold], [now.node.tones, now.node.bold]))
+        lines.push(words.tables.toneChanged(name));
+    return lines;
+}
+//# sourceMappingURL=structure-changes.js.map

package/src/lib/structure-changes.js.map

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

package/src/lib/structure-changes.mjs

@@ -0,0 +1,28 @@
+import { en } from './locales/en/index.mjs';
+const same = (a, b) => JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+export function structureChanges(name, was, now, words = en) {
+    const w = words.changes;
+    const lines = [];
+    const filterOf = (p) => (p.field.type === 'many2one' || p.field.type === 'many2many' ? p.field.filter : undefined);
+    const filter = filterOf(now);
+    if (!same(filterOf(was), filter)) {
+        const one = filter?.length === 1 && 'op' in filter[0] && filter[0].op === '=' && filter[0].valueFrom === undefined ? filter[0] : null;
+        lines.push(!filter ? w.offersEvery(name) : one ? w.offersWhere(name, one.field, JSON.stringify(one.value)) : w.offersChanged(name));
+    }
+    if (now.field.type === 'one2many') {
+        const fields = now.field.fields;
+        const labels = (names) => words.parts.commaList(names.map((n) => fields[n]?.label ?? n));
+        if (!same(was.node.totals, now.node.totals))
+            lines.push(now.node.totals?.length ? w.addsUp(name, labels(now.node.totals)) : w.addsUpNothing(name));
+        if (!same(was.node.optionalColumns, now.node.optionalColumns))
+            lines.push(w.optionalColumns(name));
+        // tables lane: the table's own rules, buttons and shape, said once.
+        const own = (p) => [p.node.cells, p.node.rowTones, p.node.rowBold, p.node.rowButtons, p.node.selectedButtons, p.node.controlButtons, p.node.lineOpens, p.node.cards, p.node.fit, p.node.options?.['copy']];
+        if (!same(own(was), own(now)))
+            lines.push(words.tables.tableChanged(name));
+    }
+    if (!same([was.node.tones, was.node.bold], [now.node.tones, now.node.bold]))
+        lines.push(words.tables.toneChanged(name));
+    return lines;
+}
+//# sourceMappingURL=structure-changes.mjs.map

package/src/lib/structure-changes.mjs.map

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

package/src/lib/structure-commands.d.mts

@@ -0,0 +1,31 @@
+import type { Page } from '@fieldia/core';
+/**
+ * The edits the structures need beyond their widget's settings: a table of
+ * lines' totals and the columns people may hide, and the records a link
+ * offers, by one condition. Each goes through the designer's `apply`, so it
+ * is validated, undone and saved as every other edit is.
+ */
+export interface StructureCommandsDeps {
+    apply(edit: (draft: Page) => void, merge?: string | null): boolean;
+    /** Whether a field is the backend's, whose definition the page does not change. */
+    fromModel(name: string): boolean;
+}
+/** A link's records, by one of their fields and a value it must have: "only where active is true". */
+export interface LinkCondition {
+    field: string;
+    value: string | number | boolean;
+}
+export interface StructureCommands {
+    /**
+     * A table of lines' number columns added up under it, and the columns people
+     * may hide or show, each shown or hidden to start with; `null` or none takes
+     * either away.
+     */
+    setLineTable(id: string, table: {
+        totals?: string[] | null;
+        optionalColumns?: Record<string, 'show' | 'hide'> | null;
+    }): boolean;
+    /** The records a link or links offer: only those where a field has a value; `null` offers them all. */
+    setLinkFilter(id: string, condition: LinkCondition | null): boolean;
+}
+export declare function structureCommands({ apply, fromModel }: StructureCommandsDeps): StructureCommands;

package/src/lib/structure-commands.d.ts

@@ -0,0 +1,31 @@
+import type { Page } from '@fieldia/core';
+/**
+ * The edits the structures need beyond their widget's settings: a table of
+ * lines' totals and the columns people may hide, and the records a link
+ * offers, by one condition. Each goes through the designer's `apply`, so it
+ * is validated, undone and saved as every other edit is.
+ */
+export interface StructureCommandsDeps {
+    apply(edit: (draft: Page) => void, merge?: string | null): boolean;
+    /** Whether a field is the backend's, whose definition the page does not change. */
+    fromModel(name: string): boolean;
+}
+/** A link's records, by one of their fields and a value it must have: "only where active is true". */
+export interface LinkCondition {
+    field: string;
+    value: string | number | boolean;
+}
+export interface StructureCommands {
+    /**
+     * A table of lines' number columns added up under it, and the columns people
+     * may hide or show, each shown or hidden to start with; `null` or none takes
+     * either away.
+     */
+    setLineTable(id: string, table: {
+        totals?: string[] | null;
+        optionalColumns?: Record<string, 'show' | 'hide'> | null;
+    }): boolean;
+    /** The records a link or links offer: only those where a field has a value; `null` offers them all. */
+    setLinkFilter(id: string, condition: LinkCondition | null): boolean;
+}
+export declare function structureCommands({ apply, fromModel }: StructureCommandsDeps): StructureCommands;

package/src/lib/structure-commands.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.structureCommands = structureCommands;
+const page_tree_1 = require("./page-tree");
+const refusal_1 = require("./refusal");
+function structureCommands({ apply, fromModel }) {
+    function question(draft, id) {
+        const found = (0, page_tree_1.findNode)(draft, id);
+        if (!found || found.node.type !== 'field')
+            throw new refusal_1.Refusal((w) => w.refusals.noQuestion(id));
+        return found.node;
+    }
+    return {
+        setLineTable(id, table) {
+            return apply((draft) => {
+                const node = question(draft, id);
+                const field = draft.fields[node.field];
+                if (field.type !== 'one2many')
+                    throw new refusal_1.Refusal((w) => w.refusals.onlyLinesTotals);
+                const numbers = (name) => ['integer', 'float', 'monetary'].includes(field.fields[name]?.type ?? '');
+                if (table.totals !== undefined) {
+                    const totals = (table.totals ?? []).filter((name) => field.fields[name]);
+                    if (totals.some((name) => !numbers(name)))
+                        throw new refusal_1.Refusal((w) => w.refusals.onlyNumbersAdd);
+                    if (totals.length)
+                        node.totals = totals;
+                    else
+                        delete node.totals;
+                }
+                if (table.optionalColumns !== undefined) {
+                    const optional = Object.entries(table.optionalColumns ?? {}).filter(([name]) => field.fields[name]);
+                    if (optional.length)
+                        node.optionalColumns = Object.fromEntries(optional);
+                    else
+                        delete node.optionalColumns;
+                }
+            });
+        },
+        setLinkFilter(id, condition) {
+            return apply((draft) => {
+                const node = question(draft, id);
+                const field = draft.fields[node.field];
+                if (field.type !== 'many2one' && field.type !== 'many2many')
+                    throw new refusal_1.Refusal((w) => w.refusals.onlyLinksOffer);
+                if (fromModel(node.field))
+                    throw new refusal_1.Refusal((w) => w.refusals.offersFromModel(field.label));
+                const name = condition?.field.trim() ?? '';
+                if (condition && !name)
+                    throw new refusal_1.Refusal((w) => w.refusals.sayWhichFields);
+                const kept = condition ? [{ field: name, op: '=', value: condition.value }] : [];
+                if (kept.length)
+                    field.filter = kept;
+                else
+                    delete field.filter;
+            }, `link-filter:${id}`);
+        },
+    };
+}
+//# sourceMappingURL=structure-commands.js.map

package/src/lib/structure-commands.js.map

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