@fieldia/designer 0.28.0 → 0.29.0

package/src/lib/bottom-bar.mjs

@@ -0,0 +1,93 @@
+/** The air left between a control and the bar at the foot of the screen. */
+const AIR = 8;
+/**
+ * A bar kept at the foot of the screen (`position: sticky` with a `bottom`) never hides what a person works on, and
+ * keeping it clear never hides it under the bar at the top instead (WCAG 2.4.11, both ways). A control focused in the
+ * area the bar floats over — by Tab or Shift+Tab, by a press — is moved up from behind the bar once the engine's own
+ * scroll on focus is done (that scroll knows nothing of it), but never so far that its top goes under the room the
+ * top bar keeps (the scroller's `scroll-padding-top`, the designer bar's): where it cannot fit between the two, its
+ * top wins. The bar stays where it is; the area's end is the bar's own place in the flow, where it rests once the area
+ * is scrolled to its end. Where the bar is not at the foot (sticky no longer: a wide screen's rail beside its card),
+ * nothing is moved.
+ *
+ * No `scroll-margin-bottom` on what is focused: an element taller than the room between the bars would then be
+ * aligned by its end as the engine scrolls to it — walking up by Shift+Tab, its top under the top bar.
+ */
+export function keepClearOfBar(bar, area) {
+    const view = bar.ownerDocument.defaultView;
+    /** Whether the bar has been in the page: once taken out of it (a new drawer in its place), the watch ends. */
+    let placed = false;
+    const measure = () => {
+        if (!bar.isConnected)
+            return placed ? stop() : undefined;
+        placed = true;
+        const style = view?.getComputedStyle(bar);
+        const atFoot = !!style && style.position === 'sticky' && style.bottom !== 'auto' && !bar.hidden;
+        const room = atFoot ? Math.ceil(bar.getBoundingClientRect().height + (parseFloat(style.bottom) || 0) + AIR) : 0;
+        area.style.setProperty('--fd-foot-room', `${room}px`);
+    };
+    const onFocus = (event) => {
+        const control = event.target;
+        if (!control?.getBoundingClientRect || !view)
+            return;
+        // After the engine's own scroll on focus, which comes after the focus event.
+        view.requestAnimationFrame(() => {
+            if (barRoom(area) && view.document.activeElement === control)
+                clearOfBar(bar, control);
+        });
+    };
+    area.addEventListener('focusin', onFocus);
+    const ResizeWatcher = view?.ResizeObserver;
+    const watcher = ResizeWatcher ? new ResizeWatcher(measure) : null;
+    // The bar's own size, and the area's width: a container query that puts the bar at the foot or takes it away.
+    watcher?.observe(bar);
+    watcher?.observe(area);
+    measure();
+    function stop() {
+        watcher?.disconnect();
+        area.removeEventListener('focusin', onFocus);
+        area.style.removeProperty('--fd-foot-room');
+    }
+    return stop;
+}
+/**
+ * The scroller that can move an element up by `by`: its nearest ancestor that scrolls up and down with that much room
+ * left — a row of tabs that scrolls sideways is no such scroller, though its `overflow-y` reads `auto` — else the page.
+ */
+function scrollerOf(element, by) {
+    const doc = element.ownerDocument;
+    const view = doc.defaultView;
+    for (let at = element.parentElement; at && at !== doc.body && at !== doc.documentElement; at = at.parentElement) {
+        const overflow = view?.getComputedStyle(at).overflowY ?? 'visible';
+        if ((overflow === 'auto' || overflow === 'scroll') && at.scrollHeight - at.clientHeight - at.scrollTop >= by)
+            return at;
+    }
+    return null;
+}
+/**
+ * An element moved up from behind the bar at the foot (with a little air), as far as that takes — but its top never
+ * under the room its scroller keeps at its top (`scroll-padding-top`: the designer bar's, on the page). Where both
+ * cannot hold, the top wins. Nothing moves for an element clear of the bar already.
+ */
+export function clearOfBar(bar, element) {
+    const box = element.getBoundingClientRect();
+    const limit = bar.getBoundingClientRect().top - AIR;
+    if (box.bottom <= limit)
+        return;
+    const doc = element.ownerDocument;
+    const view = doc.defaultView;
+    const want = box.bottom - limit;
+    const own = scrollerOf(element, want);
+    const scroller = own ?? (doc.scrollingElement ?? doc.documentElement);
+    const top = (own ? own.getBoundingClientRect().top : 0) + (parseFloat(view?.getComputedStyle(scroller).scrollPaddingTop ?? '') || 0);
+    const by = Math.min(want, box.top - top);
+    if (by <= 0)
+        return;
+    if (own)
+        own.scrollTop += by;
+    else
+        view?.scrollBy(0, by);
+}
+/** The room the bar takes now, as `keepClearOfBar` measured it: 0 where it is not at the foot. */
+export const barRoom = (area) => parseFloat(area.style.getPropertyValue('--fd-foot-room')) || 0;
+//# sourceMappingURL=bottom-bar.mjs.map

package/src/lib/bottom-bar.mjs.map

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

package/src/lib/designer.d.mts

@@ -279,6 +279,27 @@ export interface Designer extends HeaderCommands, ListCommands, ChoiceCommands,
     }): boolean;
     /** "Continue later" (`continueLater`): the answers kept on the app's server with a link to carry on; false takes it away. */
     setContinueLater(on: boolean): boolean;
+    /**
+     * Approvals on a record's screen (`approval`): on, its records waiting for approval as the app's data source says —
+     * `on: false` takes the setting away — the fields left open while one waits (`open`; `null` or none, every field
+     * locked), and whether it locks at all (`lock: false`, which leaves none open to name). A record's own screen only,
+     * refused on a form of responses or a list.
+     */
+    setApproval(patch: {
+        on?: boolean;
+        open?: string[] | null;
+        lock?: boolean | null;
+    }): boolean;
+    /**
+     * AI help's Fill from text (`suggest`): `{}` offers it, `null` takes it away; its button's words (`label`), the fields
+     * it may fill (`fields`: none, every one shown a person can set) and a text field whose words it reads in place of
+     * words pasted (`fromField`) — each `null` (or empty) taking that one away. Refused on a list of records.
+     */
+    setSuggest(patch: {
+        label?: string | null;
+        fields?: string[] | null;
+        fromField?: string | null;
+    } | null): boolean;
     /**
      * The page's phone numbers (`phone`): read the world over (`on`), or text boxes as typed (`on: false` takes the
      * setting away); the country a number typed without its + is read in, and whether a number shows abroad's way or at

package/src/lib/designer.d.ts

@@ -279,6 +279,27 @@ export interface Designer extends HeaderCommands, ListCommands, ChoiceCommands,
     }): boolean;
     /** "Continue later" (`continueLater`): the answers kept on the app's server with a link to carry on; false takes it away. */
     setContinueLater(on: boolean): boolean;
+    /**
+     * Approvals on a record's screen (`approval`): on, its records waiting for approval as the app's data source says —
+     * `on: false` takes the setting away — the fields left open while one waits (`open`; `null` or none, every field
+     * locked), and whether it locks at all (`lock: false`, which leaves none open to name). A record's own screen only,
+     * refused on a form of responses or a list.
+     */
+    setApproval(patch: {
+        on?: boolean;
+        open?: string[] | null;
+        lock?: boolean | null;
+    }): boolean;
+    /**
+     * AI help's Fill from text (`suggest`): `{}` offers it, `null` takes it away; its button's words (`label`), the fields
+     * it may fill (`fields`: none, every one shown a person can set) and a text field whose words it reads in place of
+     * words pasted (`fromField`) — each `null` (or empty) taking that one away. Refused on a list of records.
+     */
+    setSuggest(patch: {
+        label?: string | null;
+        fields?: string[] | null;
+        fromField?: string | null;
+    } | null): boolean;
     /**
      * The page's phone numbers (`phone`): read the world over (`on`), or text boxes as typed (`on: false` takes the
      * setting away); the country a number typed without its + is read in, and whether a number shows abroad's way or at

package/src/lib/designer.js

@@ -299,6 +299,10 @@ function createDesigner(options) {
         (0, steps_places_1.forgetGoneTargets)(draft);
         // A field taken away, or made a kind records are not compared by, is no longer one possible duplicates are found by.
         forgetGoneDuplicates(draft);
+        // A field taken away is no longer one left open while a record waits for approval.
+        forgetGoneOpenFields(draft);
+        // Nor one AI help fills or reads, and a field no longer of text has no text tools.
+        forgetGoneAssist(draft);
         // A related list taken out of a tab takes the tab's count of it with it.
         (0, head_parts_1.forgetGoneCounts)(draft);
         const checked = checkEdit(page, draft);
@@ -624,6 +628,10 @@ function createDesigner(options) {
                     next.help = old.help;
                 if (old.required)
                     next.required = true;
+                // Typed in several languages, it stays so as words of another kind typed: a short answer made a paragraph.
+                const languages = old;
+                if (languages.translate && ['char', 'text', 'html'].includes(next.type) && !kind.widget)
+                    Object.assign(next, { translate: languages.translate, ...(languages.requiredIn ? { requiredIn: languages.requiredIn } : {}) });
                 draft.fields[node.field] = next;
                 if (kind.widget)
                     node.widget = kind.widget;
@@ -1099,6 +1107,46 @@ function createDesigner(options) {
                     delete draft.continueLater;
             }, 'continueLater');
         },
+        setApproval(patch) {
+            return apply((draft) => {
+                if (patch.on === false)
+                    return void delete draft.approval;
+                if (draft.data.kind !== 'record' || draft.layout.type === 'list')
+                    throw new refusal_1.Refusal((w) => w.refusals.approvalForRecords);
+                const now = { ...(draft.approval ?? {}) };
+                if (patch.open !== undefined) {
+                    const open = [...new Set(patch.open ?? [])].filter((name) => draft.fields[name]);
+                    if (open.length)
+                        now.open = open;
+                    else
+                        delete now.open;
+                }
+                // Nothing locked, nothing to leave open.
+                if (patch.lock === false) {
+                    now.lock = false;
+                    delete now.open;
+                }
+                else if (patch.lock !== undefined)
+                    delete now.lock;
+                draft.approval = now;
+            }, `approval:${Object.keys(patch).join(',')}`);
+        },
+        setSuggest(patch) {
+            return apply((draft) => {
+                if (patch === null)
+                    return void delete draft.suggest;
+                if (draft.layout.type === 'list')
+                    throw new refusal_1.Refusal((w) => w.refusals.suggestForForms);
+                const now = { ...draft.suggest };
+                for (const [key, value] of Object.entries(patch)) {
+                    if (value === null || value === '' || (Array.isArray(value) && !value.length))
+                        delete now[key];
+                    else
+                        now[key] = Array.isArray(value) ? [...new Set(value)] : typeof value === 'string' && key === 'label' ? value.trim() : value;
+                }
+                draft.suggest = now;
+            }, patch ? `suggest:${Object.keys(patch).join(',')}` : null);
+        },
         setDuplicates(patch) {
             return apply((draft) => {
                 if (patch.fields !== undefined && !patch.fields?.length)
@@ -1208,6 +1256,9 @@ function createDesigner(options) {
                 if (rules.multiple === true)
                     field.multiple = true;
                 else if (rules.multiple === false) {
+                    // A photo set is several photos: one has no order, no cover.
+                    if (fieldNode(draft, id).widget === 'photos')
+                        throw new refusal_1.Refusal((w) => w.refusals.photoSetSeveral);
                     delete field.multiple;
                     delete field.minFiles;
                     delete field.maxFiles;
@@ -1678,6 +1729,51 @@ function changeRelated(draft, node, patch, functions) {
         }
     }
 }
+/** The fields left open while a record waits for approval (`approval.open`) that are still on the page: none left, every field locks. */
+function forgetGoneOpenFields(page) {
+    const open = page.approval?.open;
+    if (!page.approval || !open)
+        return;
+    const kept = open.filter((name) => page.fields[name]);
+    if (kept.length === open.length)
+        return;
+    const { open: _, ...rest } = page.approval;
+    page.approval = kept.length ? { ...rest, open: kept } : rest;
+}
+/** The kinds AI help fills (`suggest.fields`), and those whose words it reads and rewrites. */
+const FILLED = new Set(['char', 'text', 'html', 'integer', 'float', 'monetary', 'boolean', 'selection', 'date', 'datetime', 'many2one', 'many2many', 'one2many']);
+const TEXTS = new Set(['char', 'text', 'html']);
+/**
+ * AI help as its fields change: those Fill from text fills still on the page, of a kind it fills and a person can set
+ * (none left, it fills every one shown); the words it reads a text field's still; a text field's tools on text alone.
+ */
+function forgetGoneAssist(page) {
+    const suggest = page.suggest;
+    if (suggest) {
+        const from = suggest.fromField && TEXTS.has(page.fields[suggest.fromField]?.type ?? '') ? suggest.fromField : undefined;
+        const fields = suggest.fields?.filter((name) => name !== from && FILLED.has(page.fields[name]?.type ?? '') && page.fields[name]?.readonly !== true && page.fields[name]?.compute === undefined);
+        const { fields: _fields, fromField: _from, ...rest } = suggest;
+        page.suggest = { ...rest, ...(fields?.length ? { fields } : {}), ...(from ? { fromField: from } : {}) };
+    }
+    const visit = (value) => {
+        if (Array.isArray(value))
+            return value.forEach(visit);
+        if (!value || typeof value !== 'object')
+            return;
+        const node = value;
+        if (node.type === 'field' && node.options && 'rewrite' in node.options && !TEXTS.has(page.fields[node.field]?.type ?? '')) {
+            const { rewrite: _, ...options } = node.options;
+            if (Object.keys(options).length)
+                node.options = options;
+            else
+                delete node.options;
+        }
+        for (const child of Object.values(value))
+            if (child && typeof child === 'object')
+                visit(child);
+    };
+    visit(page.layout);
+}
 /** The fields possible duplicates are found by (`duplicates`) that are still on the page and of a kind to compare: none left, the setting goes. */
 function forgetGoneDuplicates(page) {
     if (!page.duplicates)