@fieldia/designer 0.0.0-stage → 0.12.0

package/src/lib/steps-commands.mjs

@@ -0,0 +1,186 @@
+import { en } from './locales/en/index.mjs';
+import { Refusal } from './refusal.mjs';
+import { formulaProblem, problemWords } from './rules-formula.mjs';
+import { holderOf, placeIsThere, placeKey, showTargets, stepAt, stepsAt, tidyThen, writeSteps } from './steps-places.mjs';
+const KINDS_WITH_FIELD = new Set(['set', 'clear', 'addLine']);
+/** The kinds of field a step can set from an expression, as the format allows. */
+export const SETTABLE = new Set(['char', 'text', 'html', 'integer', 'float', 'monetary', 'boolean', 'date', 'datetime', 'selection', 'json']);
+/** A step with what was taken away left out: `null`, undefined, and empty words where words are optional. */
+function withoutEmpty(step) {
+    const out = {};
+    for (const [key, value] of Object.entries(step)) {
+        if (value === null || value === undefined)
+            continue;
+        if ((key === 'title' || key === 'record') && value === '')
+            continue;
+        if ((key === 'values' || key === 'into' || key === 'params') && typeof value === 'object' && !Object.keys(value).length)
+            continue;
+        if ((key === 'then' || key === 'fields') && Array.isArray(value) && !value.length)
+            continue;
+        out[key] = value;
+    }
+    return out;
+}
+/**
+ * What is wrong with a step on this page, in words; null when it can be
+ * kept. What it opens, sets, empties or adds to must be there; what it says
+ * or asks, the app's action, must be written; its formulas must read.
+ */
+export function stepProblem(page, step, words = en) {
+    const w = words.steps;
+    const formula = (source) => {
+        if (source === undefined)
+            return null;
+        const problem = formulaProblem(page, source, words);
+        return problem ? problemWords(problem, words) : null;
+    };
+    if (typeof step.when === 'string') {
+        if (!step.when.trim())
+            return w.needsValue;
+        const wrong = formula(step.when);
+        if (wrong)
+            return wrong;
+    }
+    if (KINDS_WITH_FIELD.has(step.do)) {
+        const name = step.field;
+        if (!name || !page.fields[name])
+            return w.noField;
+    }
+    switch (step.do) {
+        case 'open':
+            if (!step.page?.trim())
+                return w.needsPage;
+            for (const value of [step.record, ...Object.values(step.values ?? {})]) {
+                if (value === undefined)
+                    continue;
+                if (!value.trim())
+                    return w.needsValue;
+                const wrong = formula(value);
+                if (wrong)
+                    return wrong;
+            }
+            for (const [name, value] of Object.entries(step.into ?? {}))
+                if (!page.fields[name] || !value.trim())
+                    return w.needsValue;
+            return null;
+        case 'set': {
+            if (!SETTABLE.has(page.fields[step.field].type))
+                return w.noField;
+            if (!step.value?.trim())
+                return w.needsValue;
+            return formula(step.value);
+        }
+        case 'addLine': {
+            const lines = page.fields[step.field];
+            if (lines.type !== 'one2many')
+                return w.noField;
+            for (const [name, value] of Object.entries(step.values ?? {})) {
+                if (!lines.fields[name] || !value.trim())
+                    return w.needsValue;
+                const wrong = formula(value);
+                if (wrong)
+                    return wrong;
+            }
+            return null;
+        }
+        case 'check':
+            return step.fields?.some((name) => !page.fields[name]) ? w.noField : null;
+        case 'goTo':
+            return showTargets(page).some((t) => t.id === step.target) ? null : w.noTabs;
+        case 'say':
+        case 'ask':
+        case 'post':
+            return step.message?.trim() ? null : w.needsWords;
+        case 'call':
+            return step.action?.trim() ? null : w.needsAction;
+        case 'openUrl':
+            return step.url?.trim() ? formula(step.url) : w.needsAddress;
+        default:
+            return null;
+    }
+}
+export function stepsCommands({ apply, getPage }) {
+    /** Change a place's list, as one edit: refused when the place is gone, a step is not one, or a button is left with nothing to do. */
+    const change = (place, edit, merge = null) => apply((draft) => {
+        const list = JSON.parse(JSON.stringify(stepsAt(draft, place)));
+        edit(list, draft);
+        tidyThen(list);
+        // A place no longer there may only lose its steps.
+        if (list.length && !placeIsThere(draft, place))
+            throw new Refusal((w) => w.steps.noPlace);
+        writeSteps(draft, place, list);
+    }, merge);
+    /** A step that cannot be kept is refused, saying why. */
+    const refuseIfWrong = (draft, step) => {
+        if (stepProblem(draft, step))
+            throw new Refusal((w) => stepProblem(draft, step, w));
+    };
+    const missing = (path) => new Refusal((w) => w.steps.noStep(path[path.length - 1] + 1));
+    return {
+        steps: (place) => stepsAt(getPage(), place),
+        setSteps(place, steps) {
+            return change(place, (list, draft) => {
+                list.splice(0, list.length, ...JSON.parse(JSON.stringify(steps)));
+                for (const step of list)
+                    refuseIfWrong(draft, step);
+            });
+        },
+        addStep(place, step, options = {}) {
+            let made = null;
+            // Finished by typing: the typing that goes on in that box is the same undo step.
+            const now = stepsAt(getPage(), place);
+            const next = [...(options.then ?? []), options.then ? (stepAt(now, options.then)?.then?.length ?? 0) : now.length];
+            const merge = options.typing ? `step:${placeKey(place)}:${next.join('.')}:${options.typing}` : null;
+            const ok = change(place, (list, draft) => {
+                const tidy = withoutEmpty(step);
+                refuseIfWrong(draft, tidy);
+                if (!options.then) {
+                    list.push(tidy);
+                    made = [list.length - 1];
+                    return;
+                }
+                const opener = stepAt(list, options.then);
+                if (opener?.do !== 'open')
+                    throw new Refusal((w) => w.steps.onlyOpenThen);
+                opener.then = [...(opener.then ?? []), tidy];
+                made = [...options.then, opener.then.length - 1];
+            }, merge);
+            return ok && made ? made : false;
+        },
+        updateStep(place, path, patch, options = {}) {
+            const merge = options.typing ? `step:${placeKey(place)}:${path.join('.')}:${Object.keys(patch).sort().join(',')}` : null;
+            return change(place, (list, draft) => {
+                const holder = holderOf(list, path);
+                const at = path[path.length - 1];
+                const step = holder?.[at];
+                if (!holder || !step)
+                    throw missing(path);
+                const next = withoutEmpty({ ...step, ...patch });
+                refuseIfWrong(draft, next);
+                holder[at] = next;
+            }, merge);
+        },
+        moveStep(place, path, to) {
+            return change(place, (list) => {
+                const holder = holderOf(list, path);
+                const from = path[path.length - 1];
+                if (!holder?.[from])
+                    throw missing(path);
+                if (to < 0 || to >= holder.length || to === from)
+                    throw new Refusal((w) => w.steps.cannotMoveFurther);
+                const [moved] = holder.splice(from, 1);
+                holder.splice(to, 0, moved);
+            });
+        },
+        removeStep(place, path) {
+            return change(place, (list) => {
+                const holder = holderOf(list, path);
+                const at = path[path.length - 1];
+                if (!holder?.[at])
+                    throw missing(path);
+                holder.splice(at, 1);
+            });
+        },
+    };
+}
+//# sourceMappingURL=steps-commands.mjs.map

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

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

package/src/lib/steps-editor.d.mts

@@ -0,0 +1,25 @@
+import type { Page } from '@fieldia/core';
+import { type ElementFactory } from './chrome.mjs';
+import type { Designer } from './designer.mjs';
+import { type StepsPlace } from './steps-places.mjs';
+/**
+ * What a press, a change or a moment does, as a list of steps a person reads
+ * as sentences — "Open Customer in a panel, then put its answer in
+ * Customer", "Ask: Send the order?" — each opening in place to its settings,
+ * one at a time. "Add a step" offers the kinds that fit the page, grouped
+ * plainly; a step that needs words or a page first waits here, begun, and is
+ * kept once it has them. A step is moved by its grip or by Alt+↑ and Alt+↓
+ * on its sentence, and removed with Undo at hand. A step that opens a page
+ * holds the steps run once that page is saved, under it, as a list of their
+ * own. The same editor serves every place: a button's When clicked, a
+ * field's When it changes, and the form's moments.
+ */
+export interface StepsEditor {
+    element: HTMLElement;
+    update(page: Page): void;
+    /** Bring it forward: its first step, or Add a step. */
+    focus(): void;
+}
+export declare function stepsEditor(el: ElementFactory, designer: Designer, place: StepsPlace, options: {
+    label: string;
+}): StepsEditor;

package/src/lib/steps-editor.d.ts

@@ -0,0 +1,25 @@
+import type { Page } from '@fieldia/core';
+import { type ElementFactory } from './chrome';
+import type { Designer } from './designer';
+import { type StepsPlace } from './steps-places';
+/**
+ * What a press, a change or a moment does, as a list of steps a person reads
+ * as sentences — "Open Customer in a panel, then put its answer in
+ * Customer", "Ask: Send the order?" — each opening in place to its settings,
+ * one at a time. "Add a step" offers the kinds that fit the page, grouped
+ * plainly; a step that needs words or a page first waits here, begun, and is
+ * kept once it has them. A step is moved by its grip or by Alt+↑ and Alt+↓
+ * on its sentence, and removed with Undo at hand. A step that opens a page
+ * holds the steps run once that page is saved, under it, as a list of their
+ * own. The same editor serves every place: a button's When clicked, a
+ * field's When it changes, and the form's moments.
+ */
+export interface StepsEditor {
+    element: HTMLElement;
+    update(page: Page): void;
+    /** Bring it forward: its first step, or Add a step. */
+    focus(): void;
+}
+export declare function stepsEditor(el: ElementFactory, designer: Designer, place: StepsPlace, options: {
+    label: string;
+}): StepsEditor;

package/src/lib/steps-editor.js

@@ -0,0 +1,390 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stepsEditor = stepsEditor;
+const chrome_1 = require("./chrome");
+const icons_1 = require("./icons");
+const menu_1 = require("./menu");
+const steps_commands_1 = require("./steps-commands");
+const steps_places_1 = require("./steps-places");
+const steps_settings_1 = require("./steps-settings");
+const steps_words_1 = require("./steps-words");
+/** "Add a step"'s groups, in order, and the kinds in each. */
+const GROUPS = [
+    { group: 'open', kinds: ['open', 'openUrl', 'goTo', 'close'] },
+    { group: 'values', kinds: ['set', 'clear', 'addLine'] },
+    { group: 'check', kinds: ['check', 'save', 'reset'] },
+    { group: 'talk', kinds: ['say', 'ask', 'post'] },
+    { group: 'record', kinds: ['archive', 'unarchive', 'duplicate', 'delete'] },
+    { group: 'app', kinds: ['call', 'reload'] },
+];
+const keyOf = (path) => (path ?? []).join('.');
+const same = (a, b) => a !== null && b !== null && keyOf(a) === keyOf(b);
+let made = 0;
+function stepsEditor(el, designer, place, options) {
+    const words = designer.words;
+    const w = words.steps;
+    const base = `fd-do-${++made}`;
+    let rowsMade = 0;
+    const statusWords = el('span', {});
+    const undo = el('button', { type: 'button', class: 'fd-button fd-button-link' }, w.undo);
+    const status = el('p', { class: 'fd-answer-rules-status fd-do-status', role: 'status', hidden: '' }, statusWords, undo);
+    const keepsOne = el('p', { class: 'fd-properties-hint fd-set-hint fd-do-keeps', hidden: '' }, w.keepsOne);
+    const doc = status.ownerDocument;
+    const top = listView(() => null);
+    const element = el('div', { class: 'fd-do', role: 'group', 'aria-label': options.label }, top.element, keepsOne, status);
+    let page = designer.getPage();
+    /** The step open, by its path; one at a time, so the list stays short in a narrow panel. */
+    let openAt = null;
+    /** A step begun with Add a step and not kept yet: under which step's then (null for the list itself), and what it is so far. */
+    let draft = null;
+    /** The page just after a step was removed: Undo stands while it is the page. */
+    let removedAt = null;
+    /** The app's saved pages to open, once asked for. */
+    let listed = null;
+    let asked = false;
+    undo.addEventListener('click', () => {
+        designer.undo();
+        status.hidden = true;
+        top.add.focus();
+    });
+    /** The app's saved pages to open: asked for once — as Add a step opens, or a step that opens one is drawn. */
+    function listPages() {
+        if (asked || !designer.canPlaceForms())
+            return;
+        asked = true;
+        void designer.savedForms().then((refs) => {
+            listed = refs;
+            draw();
+        });
+    }
+    /** A page the app lists, as saved: its title and its fields. An id typed is not looked up as it is typed. */
+    const saved = (id) => {
+        if (!listed?.some((ref) => ref.id === id))
+            return undefined;
+        const found = designer.savedForm(id);
+        return found === undefined ? undefined : (found?.page ?? null);
+    };
+    // ---- a list: the place's own, or an open step's then ------------------------------------------
+    function listView(under) {
+        const list = el('ol', { class: 'fd-do-list' });
+        const add = el('button', { type: 'button', class: 'fd-button fd-button-link fd-do-add', 'aria-haspopup': 'menu', 'aria-expanded': 'false' }, (0, icons_1.designerIcon)(doc, 'plus'), el('span', {}, w.addAStep));
+        add.addEventListener('click', () => addMenu(add, under()));
+        return { element: el('div', { class: 'fd-do-holder' }, list, add), list, add, rows: [] };
+    }
+    /** "Add a step": the kinds that fit the page, in their groups. */
+    function addMenu(anchor, under) {
+        // Asked for now, so a step that opens a page offers them as it begins.
+        listPages();
+        const fields = Object.values(page.fields);
+        const fits = {
+            set: fields.some((def) => steps_commands_1.SETTABLE.has(def.type)),
+            clear: fields.length > 0,
+            addLine: fields.some((def) => def.type === 'one2many'),
+            goTo: (0, steps_places_1.showTargets)(page).length > 0,
+            // A record is loaded again; a survey's answers are not.
+            reload: page.data.kind === 'record',
+            // A record archives, copies, deletes and has a conversation; a survey's answers do not.
+            archive: page.data.kind === 'record',
+            unarchive: page.data.kind === 'record',
+            duplicate: page.data.kind === 'record',
+            delete: page.data.kind === 'record',
+            post: page.data.kind === 'record',
+        };
+        const items = GROUPS.flatMap(({ group, kinds }) => kinds.filter((kind) => fits[kind] !== false).map((kind, i) => ({ id: kind, label: w.kinds[kind], ...(i === 0 ? { heading: w.groups[group] } : {}) })));
+        // Its groups' headings say what it holds: no title over them, and a little closer, so the whole list fits in view.
+        const menu = (0, menu_1.openMenu)({ el, anchor, actions: true, items, onPick: (kind) => begin(kind, under) }).element;
+        menu.setAttribute('aria-label', under ? w.addThen : w.addAStep);
+        menu.classList.add('fd-do-menu');
+        const r = anchor.getBoundingClientRect();
+        const room = doc.defaultView?.innerHeight ?? 800;
+        const below = r.bottom + 6;
+        const above = r.top - menu.offsetHeight - 6;
+        const top = below + menu.offsetHeight <= room - 8 || above < 8 ? below : above;
+        menu.style.top = `${Math.max(8, Math.min(top, room - menu.offsetHeight - 8))}px`;
+    }
+    /** A new step: kept at once when it needs nothing more, else begun here, open, its first box in hand. */
+    function begin(kind, under) {
+        const step = (0, steps_settings_1.newStep)(page, kind);
+        if (kind === 'open')
+            listPages();
+        status.hidden = true;
+        if (!(0, steps_commands_1.stepProblem)(page, step, words)) {
+            draft = null;
+            const at = designer.addStep(place, step, under ? { then: under } : {});
+            if (!at)
+                return;
+            openAt = at;
+            draw();
+            rowAt(at)?.focusFirst();
+            return;
+        }
+        draft = { under, step };
+        openAt = [...(under ?? []), listOf(under).length];
+        draw();
+        rowAt(openAt)?.focusFirst();
+    }
+    /** The kept steps of a list: the place's own, or an open step's then. */
+    function listOf(under) {
+        const all = (0, steps_places_1.stepsAt)(page, place);
+        if (!under)
+            return all;
+        const opener = (0, steps_places_1.stepAt)(all, under);
+        return opener?.do === 'open' ? (opener.then ?? []) : [];
+    }
+    // ---- one step ---------------------------------------------------------------------------------
+    function rowView(kind, begun) {
+        const bodyId = `${base}-${++rowsMade}`;
+        const grip = el('span', { class: 'fd-do-grip', 'aria-hidden': 'true', title: w.grip }, (0, icons_1.designerIcon)(doc, 'grip'));
+        // The sentence in one piece of its own: the arrow before it, the words wrapping as words, an action's name among them.
+        const sentence = el('span', { class: 'fd-do-words' });
+        const say = el('button', { type: 'button', class: 'fd-answer-rule-say fd-do-say', 'aria-expanded': 'false', 'aria-controls': bodyId }, sentence);
+        const remove = (0, chrome_1.iconButton)(el, w.removeNew, '×', () => removeRow(view));
+        remove.classList.add('fd-answer-rule-remove', 'fd-do-remove');
+        const problem = el('p', { class: 'fd-answer-rule-problem', role: 'alert', hidden: '' });
+        const settings = (0, steps_settings_1.stepSettings)(el, kind, {
+            words,
+            page: () => page,
+            saved,
+            listed: () => listed,
+            change: (patch, typing) => change(view, patch, typing, problem),
+        });
+        const body = el('div', { class: 'fd-answer-rule-body fd-do-body', id: bodyId, hidden: '' }, settings.element, problem);
+        const then = kind === 'open' ? listView(() => view.path) : null;
+        if (then) {
+            then.element.classList.add('fd-do-then');
+            then.list.setAttribute('aria-label', w.thenList);
+            then.add.lastElementChild.textContent = w.addThen;
+        }
+        const element = el('li', { class: 'fd-answer-rule fd-do-step', 'data-do': kind }, el('div', { class: 'fd-answer-rule-head fd-do-head' }, grip, say, remove), body, ...(then ? [then.element] : []));
+        grip.addEventListener('pointerdown', (event) => drag(view, event));
+        say.addEventListener('click', () => {
+            openAt = say.getAttribute('aria-expanded') === 'true' ? null : view.path;
+            draw();
+        });
+        say.addEventListener('keydown', (event) => {
+            if (!event.altKey || (event.key !== 'ArrowUp' && event.key !== 'ArrowDown') || view.begun)
+                return;
+            event.preventDefault();
+            move(view, view.path[view.path.length - 1] + (event.key === 'ArrowUp' ? -1 : 1), true);
+        });
+        body.addEventListener('keydown', (event) => {
+            if (event.key !== 'Escape' || event.defaultPrevented)
+                return;
+            event.preventDefault();
+            event.stopPropagation();
+            openAt = null;
+            draw();
+            say.focus();
+        });
+        const view = {
+            element,
+            kind,
+            begun,
+            path: [],
+            step: { do: kind },
+            then,
+            update(step, path, count) {
+                view.step = step;
+                view.path = path;
+                sentence.textContent = view.begun ? w.kinds[kind] : (0, steps_words_1.stepSentence)(page, step, words, saved);
+                if (!view.begun)
+                    markCode(sentence, step);
+                remove.setAttribute('aria-label', view.begun ? w.removeNew : w.removeStep(path.map((i) => i + 1).join('.')));
+                remove.title = remove.getAttribute('aria-label');
+                grip.hidden = view.begun || count < 2;
+                settings.update(step);
+                if (then) {
+                    // Its own steps once its page is saved: listed under it; more are added while it is open, and not while one is begun there.
+                    const open = same(openAt, path);
+                    const begunHere = !!draft && same(draft.under, path);
+                    then.add.hidden = view.begun || !open || begunHere;
+                    then.element.hidden = then.add.hidden && !(step.do === 'open' && step.then?.length) && !begunHere;
+                }
+            },
+            open(on) {
+                say.setAttribute('aria-expanded', String(on));
+                body.hidden = !on;
+                element.classList.toggle('fd-answer-rule-open', on);
+                if (!on)
+                    problem.hidden = true;
+            },
+            focusFirst: () => settings.focusFirst(),
+            focusSay: () => say.focus(),
+        };
+        return view;
+    }
+    /** The app's names in a sentence — an action, a page known only by its id — kept apart, as code. */
+    function markCode(say, step) {
+        const name = step.do === 'call' ? step.action : step.do === 'open' && !saved(step.page) ? step.page : '';
+        if (name)
+            say.replaceChildren(...(0, steps_words_1.withCode)(doc, say.textContent ?? '', [name]));
+    }
+    /** A step changed: kept when it can be, else what is wrong said under it. A step begun is kept once it reads. */
+    function change(view, patch, typing, problem) {
+        const next = { ...view.step, ...patch };
+        for (const key of Object.keys(next))
+            if (next[key] === null)
+                delete next[key];
+        const step = next;
+        const wrong = (0, steps_commands_1.stepProblem)(page, step, words);
+        problem.textContent = wrong ?? '';
+        problem.hidden = !wrong;
+        if (wrong) {
+            // A step begun keeps what is written so far, to be kept once the rest is there.
+            if (view.begun && draft)
+                draft.step = view.step = step;
+            return;
+        }
+        if (!view.begun) {
+            designer.updateStep(place, view.path, patch, { typing });
+            return;
+        }
+        const under = draft?.under ?? null;
+        draft = null;
+        // Kept now, and drawn from the page from here on: the box being typed in stays where it is.
+        view.begun = false;
+        const at = designer.addStep(place, step, { ...(under ? { then: under } : {}), ...(typing ? { typing: Object.keys(patch).sort().join(',') } : {}) });
+        if (!at) {
+            view.begun = true;
+            draft = { under, step };
+            return;
+        }
+        openAt = at;
+        draw();
+    }
+    function removeRow(view) {
+        if (view.begun) {
+            draft = null;
+            openAt = null;
+            draw();
+            top.add.focus();
+            return;
+        }
+        const sentence = (0, steps_words_1.stepSentence)(page, view.step, words, saved);
+        // Closed first: the step that takes its place is drawn shut.
+        const wasOpen = openAt;
+        openAt = null;
+        if (!designer.removeStep(place, view.path)) {
+            openAt = wasOpen;
+            return;
+        }
+        removedAt = designer.getPage();
+        // The app's names in it kept apart, as the sentence keeps them.
+        statusWords.replaceChildren(...(0, steps_words_1.withCode)(doc, w.removed(sentence), view.step.do === 'call' ? [view.step.action] : view.step.do === 'open' ? [view.step.page] : []));
+        status.hidden = false;
+        undo.focus();
+    }
+    /** A step to another place among its own list; by keys, the cursor goes with it. */
+    function move(view, to, keys) {
+        const path = [...view.path.slice(0, -1), to];
+        const wasOpen = same(openAt, view.path);
+        if (!designer.moveStep(place, view.path, to)) {
+            draw();
+            return;
+        }
+        openAt = wasOpen ? path : null;
+        draw();
+        if (keys)
+            rowAt(path)?.focusSay();
+    }
+    /** Dragged by its grip: the row follows the pointer among its own list, and the move is kept when it is let go. */
+    function drag(view, event) {
+        if (event.button !== 0 || view.begun)
+            return;
+        event.preventDefault();
+        const row = view.element;
+        const list = row.parentElement;
+        const rows = () => [...list.children].filter((r) => !r.classList.contains('fd-do-begun'));
+        const from = rows().indexOf(row);
+        row.classList.add('fd-do-lifted');
+        const onMove = (e) => {
+            const others = rows().filter((r) => r !== row);
+            const at = others.filter((r) => {
+                const box = r.getBoundingClientRect();
+                return box.top + box.height / 2 < e.clientY;
+            }).length;
+            if (rows().indexOf(row) !== at)
+                list.insertBefore(row, others[at] ?? null);
+        };
+        const onEnd = () => {
+            doc.removeEventListener('pointermove', onMove);
+            doc.removeEventListener('pointerup', onEnd);
+            doc.removeEventListener('pointercancel', onEnd);
+            row.classList.remove('fd-do-lifted');
+            const to = rows().indexOf(row);
+            if (to !== from)
+                move(view, to, false);
+            else
+                draw();
+        };
+        doc.addEventListener('pointermove', onMove);
+        doc.addEventListener('pointerup', onEnd);
+        doc.addEventListener('pointercancel', onEnd);
+    }
+    // ---- drawing ------------------------------------------------------------------------------------
+    /** Every row on show, to find one again by its path. */
+    let shown = [];
+    const rowAt = (path) => shown.find((view) => same(view.path, path)) ?? null;
+    /** A list's rows: its kept steps, then a step begun in it; each row patched in place while its kind stays. */
+    function drawList(view, steps, under) {
+        const begun = draft && keyOf(draft.under) === keyOf(under) ? draft.step : null;
+        const all = [...steps, ...(begun ? [begun] : [])];
+        const rows = all.map((step, i) => {
+            const isBegun = !!begun && i === steps.length;
+            const was = view.rows[i];
+            const row = was && was.kind === step.do && was.begun === isBegun ? was : rowView(step.do, isBegun);
+            const path = [...(under ?? []), i];
+            if (row.then)
+                drawList(row.then, step.do === 'open' ? (step.then ?? []) : [], path);
+            row.update(step, path, steps.length);
+            row.element.classList.toggle('fd-do-begun', isBegun);
+            row.open(same(openAt, path));
+            shown.push(row);
+            return row;
+        });
+        view.rows = rows;
+        // Moved only where out of place: a box taken out of the page loses its cursor.
+        rows.forEach((row, i) => {
+            if (view.list.children[i] !== row.element)
+                view.list.insertBefore(row.element, view.list.children[i] ?? null);
+        });
+        while (view.list.children.length > rows.length)
+            view.list.lastElementChild?.remove();
+        view.list.hidden = !rows.length;
+    }
+    function draw() {
+        shown = [];
+        const steps = (0, steps_places_1.stepsAt)(page, place);
+        // The app's pages, asked for once a step opens one: a list with none never asks.
+        if (steps.some((step) => step.do === 'open') || draft?.step.do === 'open')
+            listPages();
+        drawList(top, steps, null);
+        // One step begun at a time: Add a step waits while one is.
+        top.add.hidden = !!draft && draft.under === null;
+        // A button does at least one thing: its only step stays, and says why.
+        const only = 'press' in place && steps.length === 1;
+        const first = top.rows[0];
+        if (first && !first.begun)
+            first.element.querySelector(':scope > .fd-do-head > .fd-do-remove').hidden = only;
+        keepsOne.hidden = !only;
+        if (removedAt && page !== removedAt) {
+            removedAt = null;
+            status.hidden = true;
+        }
+    }
+    return {
+        element,
+        update(next) {
+            page = next;
+            draw();
+        },
+        focus() {
+            const first = top.rows[0];
+            if (first)
+                first.focusSay();
+            else
+                top.add.focus();
+        },
+    };
+}
+//# sourceMappingURL=steps-editor.js.map