@fieldia/core 0.28.0 → 0.30.0

package/src/lib/record/form-approvals.mjs

@@ -0,0 +1,180 @@
+import { saveProblemOf } from './data-source.mjs';
+import { fill } from './messages.mjs';
+import { dayWords } from './day-words.mjs';
+import { isOwnZone, wallClock, wallDay, wallTime } from './zones.mjs';
+import { uploadGoing } from './uploads.mjs';
+const STATES = ['waiting', 'later', 'approved', 'rejected', 'skipped'];
+const said = (value) => typeof value === 'string' && value.trim() !== '';
+/** A level as the source told it, kept to what can be said: its id, its name, its approvers by name, a state Fieldia knows. */
+function levelOf(told) {
+    const level = told;
+    if (!level || !said(level.id) || !STATES.includes(level.state))
+        return null;
+    const approvers = (Array.isArray(level.approvers) ? level.approvers : []).filter((one) => !!one && said(one.name));
+    return { id: level.id, name: said(level.name) ? level.name : level.id, approvers, needs: level.needs === 'all' ? 'all' : 'any', state: level.state };
+}
+/** Where a record stands as a whole, from its levels: a rejection ends it, a level waiting is waited for. */
+export function approvalStatus(levels) {
+    const asked = levels.filter((level) => level.state !== 'skipped');
+    if (!asked.length)
+        return 'none';
+    if (asked.some((level) => level.state === 'rejected'))
+        return 'rejected';
+    if (asked.some((level) => level.state === 'waiting'))
+        return 'waiting';
+    if (asked.every((level) => level.state === 'approved'))
+        return 'approved';
+    return 'needed';
+}
+/** What the form keeps of a source's answer: the levels it can say, those this person may decide now — where the source takes decisions. */
+export function approvalOf(told, decides) {
+    const levels = (Array.isArray(told?.levels) ? told.levels : []).map(levelOf).filter((level) => level !== null);
+    const history = (Array.isArray(told?.history) ? told.history : []).filter((entry) => !!entry && said(entry.by) && said(entry.at) && ['approved', 'rejected', 'requested'].includes(entry.decision));
+    const waiting = new Set(levels.filter((level) => level.state === 'waiting').map((level) => level.id));
+    const mine = decides ? [...new Set((Array.isArray(told?.mine) ? told.mine : []).filter((id) => waiting.has(id)))] : [];
+    return {
+        state: 'told',
+        status: approvalStatus(levels),
+        levels,
+        together: told?.together === true,
+        history,
+        mine,
+        ...(said(told?.why) ? { why: told.why } : {}),
+        deciding: null,
+    };
+}
+/** Nothing told yet, for the record shown: asked. */
+const asking = { state: 'asking', status: 'none', levels: [], together: false, history: [], mine: [], deciding: null };
+/**
+ * A moment of a record's approval history in words, as the page's date boxes write a day — in its order and language —
+ * on its clock, the time after it: "18 Oct 2026, 10:42", with the zone's short name where it is not the browser's own.
+ */
+export function approvalWhen(at, messages, page) {
+    const ms = Date.parse(at);
+    if (Number.isNaN(ms))
+        return at;
+    const own = page.look?.dateOrder;
+    const order = own === 'dmy' || own === 'mdy' || own === 'ymd' ? own : messages.dateOrder;
+    const zone = page.timeZone;
+    const wall = wallTime(ms, zone);
+    const words = `${dayWords(wallDay(wall), messages, order)}${order === 'ymd' ? ' ' : ', '}${wallClock(wall)}`;
+    if (!zone || isOwnZone(zone))
+        return words;
+    const name = new Intl.DateTimeFormat(messages.locale === 'en' ? 'en-GB' : messages.locale, { timeZone: zone, timeZoneName: 'short' }).formatToParts(ms).find((part) => part.type === 'timeZoneName')?.value;
+    return name ? `${words} ${name}` : words;
+}
+/** A record's approvals: what the form keeps of them, and what it asks, decides and locks by them. */
+export function formApprovals(host) {
+    const { form, messages } = host;
+    const page = form.page;
+    /** Counted at each ask: only the latest answer is kept, a save's and a load's asks crossing. */
+    let asks = 0;
+    /** A decision on its way, from the save before it to the record loaded after: a second press is the same press. */
+    let deciding = false;
+    const user = () => {
+        const person = form.user();
+        return person ? { user: { id: person.id, ...(person.name ? { name: person.name } : {}) } } : {};
+    };
+    const state = () => form.getState();
+    const model = page.data.kind === 'record' ? page.data.model : '';
+    const nameOf = (level) => state().approval?.levels.find((one) => one.id === level)?.name ?? level;
+    /** What is typed read and the person's changes saved, before a decision: null once done, or why not, in words. */
+    async function saveFirst() {
+        await form.settle();
+        const now = state();
+        if (!now.dirty.length && !Object.keys(now.unread).length && !(now.uploads ?? []).some(uploadGoing))
+            return null;
+        if (await form.save())
+            return null;
+        const after = state();
+        return after.saveProblem?.message ?? after.error ?? Object.values(after.errors)[0] ?? '';
+    }
+    async function ask() {
+        const source = host.dataSource;
+        const recordId = state().recordId;
+        if (!source?.approvals || recordId == null || !model) {
+            if (state().approval)
+                host.set({ approval: null });
+            return;
+        }
+        const shown = form.recordShown();
+        const seq = ++asks;
+        const before = state().approval;
+        // Asked again for the record shown — after a save, a decision, a load — what it told stays meanwhile: what waits stays locked.
+        host.set({ approval: before && before.state === 'told' ? { ...before, state: 'asking' } : asking });
+        try {
+            const told = await source.approvals({ model, recordId, ...user() });
+            if (!shown() || seq !== asks)
+                return;
+            host.set({ approval: approvalOf(told, !!source.decide) });
+        }
+        catch (error) {
+            if (!shown() || seq !== asks)
+                return;
+            // Not told: nothing locked by it, and the page says they could not be read.
+            host.set({ approval: { ...asking, state: 'failed', error: saveProblemOf(error).message } });
+        }
+    }
+    async function decide(level, decision, reason) {
+        const source = host.dataSource;
+        const recordId = state().recordId;
+        if (!source?.decide || recordId == null || !model)
+            throw new Error('The data source has no decide()');
+        const now = state().approval;
+        if (!now?.mine.includes(level))
+            throw new Error(fill(messages.approvalNotYours, { level: nameOf(level) }));
+        const why = typeof reason === 'string' ? reason.trim() : '';
+        if (decision === 'rejected' && !why)
+            throw new Error(messages.approvalReasonNeeded);
+        // One decision at a time: a second press while one is on its way — its save, its answer — is the same press.
+        if (deciding || now.deciding)
+            return;
+        deciding = true;
+        try {
+            await decided(source.decide.bind(source), recordId, level, decision, why);
+        }
+        finally {
+            deciding = false;
+        }
+    }
+    async function decided(send, recordId, level, decision, why) {
+        const shown = form.recordShown();
+        // Decided on the record as it is saved: what is typed read, and the person's changes saved, first.
+        const refused = await saveFirst();
+        if (refused !== null)
+            throw new Error(refused);
+        if (!shown())
+            return;
+        const at = state().approval;
+        if (!at)
+            return;
+        host.set({ approval: { ...at, deciding: { level, decision } } });
+        try {
+            const answer = await send({ model, recordId, level, decision, ...(why ? { reason: why } : {}), ...user() });
+            if (!shown())
+                return;
+            const after = state().approval;
+            host.set({ approval: answer && Array.isArray(answer.levels) ? approvalOf(answer, true) : after ? { ...after, deciding: null } : null });
+        }
+        catch (error) {
+            const after = state().approval;
+            if (shown() && after)
+                host.set({ approval: { ...after, deciding: null } });
+            throw new Error(saveProblemOf(error).message, { cause: error });
+        }
+        // The decision may have moved the record on — its state, what may be changed: loaded again, its approvals with it.
+        if (shown())
+            await host.reload();
+    }
+    function locks(name) {
+        const own = page.approval;
+        return !!own && own.lock !== false && state().approval?.status === 'waiting' && !(own.open ?? []).includes(name);
+    }
+    return {
+        ask,
+        decide,
+        locks,
+        lockWords: (name) => (locks(name) ? messages.approvalLocked : null),
+    };
+}
+//# sourceMappingURL=form-approvals.mjs.map

package/src/lib/record/form-approvals.mjs.map

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

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

@@ -8,8 +8,9 @@ import { type AppFunctions } from '../expression/app-functions.mjs';
 import { type AskedFor } from './compute.mjs';
 import { type FieldTone, type LineState } from './cells.mjs';
 import { type Messages } from './messages.mjs';
-import { type DataSource, type RecordChanges, type RecordPermissions, type RecordVersion, type ResolvedFilter, type SaveProblem, type BotReport, type SlotsResult, type UploadFile, type DuplicateMatch, type MergeResult, type SavedDraft } from './data-source.mjs';
+import { type DataSource, type RecordChanges, type RecordPermissions, type RecordVersion, type ResolvedFilter, type SaveProblem, type BotReport, type SlotsResult, type UploadFile, type DuplicateMatch, type MergeResult, type SavedDraft, type ApprovalDecision } from './data-source.mjs';
 import { type FormLimits } from './taking.mjs';
+import { type FormApproval } from './approving.mjs';
 import { type WaitsFor } from './waits.mjs';
 import { type FileUpload, type UploadHow } from './uploads.mjs';
 import { type Scheduler } from './scheduler.mjs';
@@ -123,6 +124,12 @@ export interface FormState {
         readonly key: string;
         readonly missing?: boolean;
     } | null;
+    /**
+     * The record's approvals, on a page with `approval` whose data source tells them (`approvals`): its levels and where
+     * each stands, what was decided, the levels this person may decide, and whether it waits — when its fields lock but
+     * for those the page leaves open. Null for a new record, or a page without them.
+     */
+    readonly approval?: FormApproval | null;
 }
 /** A response sent, as `FormState.sent` keeps it. */
 export interface SentResponse {
@@ -139,6 +146,11 @@ export interface SearchOptions {
     ids?: RecordId[];
     /** Only the records named exactly the query, in any case (`SearchRequest.exact`): a typed name read as a record. */
     exact?: boolean;
+    /**
+     * Only the records whose `field` holds the query exactly — a code read by a scanner, by the field holding the linked
+     * records' codes ("barcode") — asked through the search's filter, whatever their names.
+     */
+    field?: string;
 }
 /** Text left in a box that does not read, and why, as `FormState.unread` keeps it. */
 export interface UnreadText {
@@ -695,6 +707,23 @@ export interface Form {
      * show what it tells (`limits`). The form asks it itself as it opens, before its answers go, and after they went.
      */
     refreshLimits(): Promise<void>;
+    /**
+     * Ask the data source's `approvals` again for the record shown, and keep what it tells (`approval`). The form asks it
+     * itself as a saved record is shown, after each save, and after a decision.
+     */
+    refreshApprovals(): Promise<void>;
+    /**
+     * Decide at a level of the record's approvals this person may decide now (`approval.mine`): approved, or rejected
+     * with why — a rejection always says why. What is typed is read and the person's changes saved first; the source's
+     * `decide` takes it; the record is loaded again after, its approvals with it. Rejects in words where the level is not
+     * theirs to decide now, a rejection gives no reason, the save is refused, or the source refused the decision.
+     */
+    decide(level: string, decision: ApprovalDecision, reason?: string): Promise<void>;
+    /**
+     * What a field's lock says while the record waits for approval — locked but for the fields the page leaves open
+     * (`approval.open`) — or null where no approval locks it.
+     */
+    approvalLock(name: string): string | null;
     /**
      * Whether a file picked for a file or picture field is stored at once,
      * through the data source's `upload`. False without one: a file then
@@ -774,6 +803,8 @@ export interface Form {
      * makes each ready first, one at a time (a photo made smaller). A field of
      * one file keeps the last one picked. Gives each upload's id. A save waits
      * for those still going, and stops, under the field, for one that failed.
+     * `how.replaces`: the file is stored for bytes the field holds (a photo
+     * cropped), its link taking their place once stored, as a save's would.
      */
     upload(field: string, files: readonly UploadFile[], how?: UploadHow): string[];
     /**

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

@@ -8,8 +8,9 @@ import { type AppFunctions } from '../expression/app-functions';
 import { type AskedFor } from './compute';
 import { type FieldTone, type LineState } from './cells';
 import { type Messages } from './messages';
-import { type DataSource, type RecordChanges, type RecordPermissions, type RecordVersion, type ResolvedFilter, type SaveProblem, type BotReport, type SlotsResult, type UploadFile, type DuplicateMatch, type MergeResult, type SavedDraft } from './data-source';
+import { type DataSource, type RecordChanges, type RecordPermissions, type RecordVersion, type ResolvedFilter, type SaveProblem, type BotReport, type SlotsResult, type UploadFile, type DuplicateMatch, type MergeResult, type SavedDraft, type ApprovalDecision } from './data-source';
 import { type FormLimits } from './taking';
+import { type FormApproval } from './approving';
 import { type WaitsFor } from './waits';
 import { type FileUpload, type UploadHow } from './uploads';
 import { type Scheduler } from './scheduler';
@@ -123,6 +124,12 @@ export interface FormState {
         readonly key: string;
         readonly missing?: boolean;
     } | null;
+    /**
+     * The record's approvals, on a page with `approval` whose data source tells them (`approvals`): its levels and where
+     * each stands, what was decided, the levels this person may decide, and whether it waits — when its fields lock but
+     * for those the page leaves open. Null for a new record, or a page without them.
+     */
+    readonly approval?: FormApproval | null;
 }
 /** A response sent, as `FormState.sent` keeps it. */
 export interface SentResponse {
@@ -139,6 +146,11 @@ export interface SearchOptions {
     ids?: RecordId[];
     /** Only the records named exactly the query, in any case (`SearchRequest.exact`): a typed name read as a record. */
     exact?: boolean;
+    /**
+     * Only the records whose `field` holds the query exactly — a code read by a scanner, by the field holding the linked
+     * records' codes ("barcode") — asked through the search's filter, whatever their names.
+     */
+    field?: string;
 }
 /** Text left in a box that does not read, and why, as `FormState.unread` keeps it. */
 export interface UnreadText {
@@ -695,6 +707,23 @@ export interface Form {
      * show what it tells (`limits`). The form asks it itself as it opens, before its answers go, and after they went.
      */
     refreshLimits(): Promise<void>;
+    /**
+     * Ask the data source's `approvals` again for the record shown, and keep what it tells (`approval`). The form asks it
+     * itself as a saved record is shown, after each save, and after a decision.
+     */
+    refreshApprovals(): Promise<void>;
+    /**
+     * Decide at a level of the record's approvals this person may decide now (`approval.mine`): approved, or rejected
+     * with why — a rejection always says why. What is typed is read and the person's changes saved first; the source's
+     * `decide` takes it; the record is loaded again after, its approvals with it. Rejects in words where the level is not
+     * theirs to decide now, a rejection gives no reason, the save is refused, or the source refused the decision.
+     */
+    decide(level: string, decision: ApprovalDecision, reason?: string): Promise<void>;
+    /**
+     * What a field's lock says while the record waits for approval — locked but for the fields the page leaves open
+     * (`approval.open`) — or null where no approval locks it.
+     */
+    approvalLock(name: string): string | null;
     /**
      * Whether a file picked for a file or picture field is stored at once,
      * through the data source's `upload`. False without one: a file then
@@ -774,6 +803,8 @@ export interface Form {
      * makes each ready first, one at a time (a photo made smaller). A field of
      * one file keeps the last one picked. Gives each upload's id. A save waits
      * for those still going, and stops, under the field, for one that failed.
+     * `how.replaces`: the file is stored for bytes the field holds (a photo
+     * cropped), its link taking their place once stored, as a save's would.
      */
     upload(field: string, files: readonly UploadFile[], how?: UploadHow): string[];
     /**

package/src/lib/record/form.js

@@ -27,6 +27,8 @@ const record_words_1 = require("./record-words");
 const line_choices_1 = require("./line-choices");
 const data_source_1 = require("./data-source");
 const taking_1 = require("./taking");
+const languages_1 = require("./languages");
+const approving_1 = require("./approving");
 const drafts_1 = require("./drafts");
 const waits_1 = require("./waits");
 const uploads_1 = require("./uploads");
@@ -367,6 +369,7 @@ function innerForm(options, within, place, outer) {
         // Worked out once the form has its state, as the limits part comes (`limitsCode`).
         limits: null,
         resume: null,
+        approval: null,
     };
     started = true;
     /**
@@ -963,6 +966,10 @@ function innerForm(options, within, place, outer) {
     }
     if ((0, choice_options_1.hasOptionRules)(page))
         void track(optionsCode());
+    // A text in several languages is checked by the languages part: asked for at once, a save waiting for it.
+    const languagesCode = () => languages_1.formLanguagesPart.load().then(() => undefined, () => undefined);
+    if ((0, languages_1.hasLanguages)(page))
+        void track(languagesCode());
     /** A table line's choice's options as they are offered on that line: its list's once loaded, or its own, by their conditions once they came. */
     function lineOffered(lines, line, column, record) {
         if (optionKit)
@@ -1130,6 +1137,9 @@ function innerForm(options, within, place, outer) {
         const answer = answerOf(node);
         if (answer !== undefined && signedNow().has(answer))
             readonly = true;
+        // A record waiting for approval: locked but for the fields the page leaves open (the approvals part).
+        if (answer !== undefined && approvalKit?.locks(answer))
+            readonly = true;
         return {
             invisible,
             readonly: readonly || (def !== undefined && lockedField(def)),
@@ -1768,6 +1778,15 @@ function innerForm(options, within, place, outer) {
     }
     /** A choice of a full option, picked by the person, refused under its field: the field keeps what it held. */
     const refusedFull = (name, value) => !!limitsKit?.refusedFull(name, value);
+    // ---- a record's approvals (the approvals part: form-approvals.ts) ---------------------------------------------------
+    /** The approvals made for this form from the approvals part, once it came: none before, nor on a page without them. */
+    let approvalKit = null;
+    /** Whether the form asks for approvals: a page with `approval` (a record's own, as its check says), its source telling them. */
+    const keepsApprovals = !outer && !!page.approval && !!options.dataSource?.approvals;
+    /** The approvals, made from their part once it came; null without them, or where it could not come. */
+    const approvalsCode = () => keepsApprovals ? approving_1.formApprovalsPart.load().then((part) => (approvalKit ??= part.formApprovals({ form, dataSource: options.dataSource, messages, set, reload: () => load(true) })), () => null) : Promise.resolve(null);
+    /** Ask the record shown's approvals, once their part came; nothing on a page without them. */
+    const askApprovals = () => approvalsCode().then((kit) => kit?.ask());
     function scheduleAutosave() {
         const autosave = options.autosave;
         // A record the person may not change is never saved unasked: it would only be refused.
@@ -1914,6 +1933,12 @@ function innerForm(options, within, place, outer) {
             if (asked !== generation)
                 return elsewhere();
         }
+        // A text in several languages, checked in each once its part has come.
+        if (!languages_1.formLanguagesPart.loaded && (0, languages_1.hasLanguages)(page)) {
+            await languagesCode();
+            if (asked !== generation)
+                return elsewhere();
+        }
         // Values the app's functions are asked for are waited for — those that failed asked again — so what is saved is worked out.
         if (asking.size || Object.values(state.asked).some((found) => found.failed !== undefined)) {
             set({ status: 'saving', error: null, saveProblem: null });
@@ -2037,6 +2062,9 @@ function innerForm(options, within, place, outer) {
                 scheduleDraft();
                 scheduleAutosave();
             }
+            // A save may have sent it for approval, or moved it on: its approvals asked again.
+            if (keepsApprovals)
+                void track(askApprovals());
             // The record as this save left it: a change made while it was on its way is no value of it.
             emit('save', { recordId: state.recordId, values: baseline });
             void track(moment('on.afterSave', page.on?.afterSave, chain, false));
@@ -2243,7 +2271,7 @@ function innerForm(options, within, place, outer) {
             throw new Error(`"${name}" cannot make records: its data source has no create, or it is not a link`);
         return track(source.create({ model, name: typed.trim(), ...(Object.keys(values).length ? { values } : {}) }));
     }
-    async function runSearch(def, name, ctx, query, limit, { model, ids, exact } = {}) {
+    async function runSearch(def, name, ctx, query, limit, { model, ids, exact, field } = {}) {
         // Formatted text names people and records in place (@mention, #4127): searched by the model they are of.
         const byModel = def.type === 'reference' || def.type === 'json' || def.type === 'html';
         if (def.type !== 'many2one' && def.type !== 'many2many' && !byModel) {
@@ -2256,9 +2284,11 @@ function innerForm(options, within, place, outer) {
             return [];
         // Every valueFrom, in groups too, becomes the value it names before the search goes out.
         const own = byModel || !def.filter ? undefined : (0, filter_1.resolveFilter)(def.filter, ctx);
-        const filter = ids ? [...(own ?? []), { field: 'id', op: 'in', value: ids }] : own;
+        const kept = ids ? [...(own ?? []), { field: 'id', op: 'in', value: ids }] : own;
+        // A code read by a scanner: the records whose field holds it, whatever their names.
+        const filter = field ? [...(kept ?? []), { field, op: '=', value: query }] : kept;
         const relation = byModel ? model : def.relation;
-        return track(source.search({ model: relation, query, ...(filter ? { filter } : {}), limit, ...(exact ? { exact: true } : {}) }));
+        return track(source.search({ model: relation, query: field ? '' : query, ...(filter ? { filter } : {}), limit, ...(exact ? { exact: true } : {}) }));
     }
     function lineField(field) {
         const def = fieldDef(field);
@@ -2299,6 +2329,9 @@ function innerForm(options, within, place, outer) {
             loadedOnce = true;
             if (asksLimits())
                 void track(askLimits());
+            // Its approvals: where it stands, what was decided, what this person may decide — its fields locked while it waits.
+            if (keepsApprovals)
+                void track(askApprovals());
             if (again)
                 return;
             offerDraft();
@@ -2331,7 +2364,7 @@ function innerForm(options, within, place, outer) {
         found = null;
         serverKey = null;
         draftEpoch++;
-        const fresh = { dirty: [], errors: {}, warning: null, warningField: null, error: null, draft: null, step: steps[0] ?? null, skipped: [], saveProblem: null, version: null, can: null, conflict: null, setAside: null, unsent: [], unread: {}, takenOut: {}, resume: null };
+        const fresh = { dirty: [], errors: {}, warning: null, warningField: null, error: null, draft: null, step: steps[0] ?? null, skipped: [], saveProblem: null, version: null, can: null, conflict: null, setAside: null, unsent: [], unread: {}, takenOut: {}, resume: null, approval: null };
         if (id != null) {
             set({ ...fresh, recordId: id, status: 'idle' });
             await load();
@@ -2750,7 +2783,7 @@ function innerForm(options, within, place, outer) {
             // Nothing of the record changed; what shows of it may have.
             set({});
         },
-        fieldReadonly: (name) => lockedField(fieldDef(name)) || state.can?.edit === false || state.can?.readonlyFields?.includes(name) === true || signedNow().has(name),
+        fieldReadonly: (name) => lockedField(fieldDef(name)) || state.can?.edit === false || state.can?.readonlyFields?.includes(name) === true || signedNow().has(name) || !!approvalKit?.locks(name),
         loadChoices: (field) => loadChoices(field),
         loadDefinitions,
         addDefinition,
@@ -3248,6 +3281,14 @@ function innerForm(options, within, place, outer) {
             return saved;
         },
         refreshLimits: () => askLimits(),
+        refreshApprovals: askApprovals,
+        async decide(level, decision, reason) {
+            const kit = await approvalsCode();
+            if (!kit)
+                throw new Error('No approvals on this page');
+            return track(kit.decide(level, decision, reason));
+        },
+        approvalLock: (name) => approvalKit?.lockWords(name) ?? null,
         async reloadTheirs() {
             // A save on its way first: its answer is not dropped by the load.
             const asked = shownNow();
@@ -3432,6 +3473,9 @@ function innerForm(options, within, place, outer) {
     // choice's places as the source tells them: a record's own once it is loaded, its own choices not counted against it.
     if (keepsLimits())
         void track(limitsCode());
+    // A record's approvals: their part asked for as the form is made, ready by the time its record is loaded.
+    if (keepsApprovals)
+        void track(approvalsCode());
     // A new form has its values now — a draft continued from its key once it is laid — and opens once whoever made it
     // has had the chance to listen.
     if (state.recordId == null) {
@@ -3602,7 +3646,14 @@ function indexLayout(root, functions) {
             ...(does.length ? { does } : {}),
             source,
         });
-        // A button's menu: each item a button of the record, hidden with it.
+        // A menu's built-in Archive shows while the record is active, Unarchive while it is not.
+        const builtin = source.builtin;
+        if (builtin === 'archive' || builtin === 'unarchive') {
+            const own = index.get(source.id);
+            const mine = own.invisible;
+            own.invisible = { ...mine, evaluate: (context, env) => (context['active'] === false) !== (builtin === 'unarchive') || mine.evaluate(context, env) };
+        }
+        // A button's menu, and a menu inside a menu: each item a button of the record, hidden with it.
         if (kind === 'button')
             for (const item of source.menu ?? [])
                 add(item, source.id, 'button', { invisible: item.invisible });
@@ -3711,16 +3762,10 @@ function indexLayout(root, functions) {
         walk(head?.band?.children ?? [], root.id);
         if (root.sidePanel)
             add(root.sidePanel, root.id, 'other', { invisible: root.sidePanel.invisible });
-        // The gear menu's items are buttons of the record; Archive shows while it is active, Unarchive while it is not.
-        for (const item of root.toolbar?.menu ?? []) {
+        // The gear menu's items are buttons of the record — those of a menu inside it too, hidden with the item that opens
+        // it (add's own); Archive shows while it is active, Unarchive while it is not.
+        for (const item of root.toolbar?.menu ?? [])
             add(item, root.id, 'button', { invisible: item.invisible });
-            if (item.builtin === 'archive' || item.builtin === 'unarchive') {
-                const own = index.get(item.id);
-                const mine = own.invisible;
-                const archived = item.builtin === 'unarchive';
-                own.invisible = { ...mine, evaluate: (context, env) => (context['active'] === false) !== archived || mine.evaluate(context, env) };
-            }
-        }
         if (root.attachmentPreview)
             add({ id: '#preview', ...root.attachmentPreview }, root.id, 'other', { invisible: root.attachmentPreview.invisible });
     }