@fieldia/designer 0.0.0-stage → 0.11.0

package/src/lib/steps-places.mjs

@@ -0,0 +1,261 @@
+import { findHeaderPart } from './header-commands.mjs';
+import { locate } from './layout-tree.mjs';
+import { containers, tabsNodes } from './page-tree.mjs';
+import { Refusal } from './refusal.mjs';
+import { fieldsReadBy } from './rules-formula.mjs';
+export const MOMENTS = ['open', 'beforeSave', 'afterSave'];
+export function placeKey(place) {
+    if ('press' in place)
+        return `press:${place.press}`;
+    if ('change' in place)
+        return `change:${place.change}`;
+    if ('moment' in place)
+        return `moment:${place.moment}`;
+    return `show:${place.show}`;
+}
+export const samePlace = (a, b) => placeKey(a) === placeKey(b);
+/** A button anywhere on the page, by its id: in the body, a record's header (a button or a counter), or a list's. */
+export function pressOf(page, id) {
+    const node = locate(page, id)?.node;
+    if (node?.type === 'button')
+        return node;
+    const header = findHeaderPart(page, id);
+    if (header && header.kind !== 'badge')
+        return header.part;
+    const root = page.layout;
+    if (root.type === 'list')
+        return root.actions?.find((a) => a.id === id) ?? null;
+    return null;
+}
+/** A press's app action, as the `call` step it is run as. */
+function actionStep(press) {
+    if (press.action === undefined)
+        return null;
+    const params = press.params;
+    return { do: 'call', action: press.action, ...(params ? { params } : {}) };
+}
+/** The steps kept at a place, as the editor shows them; none where there are none, or no such place. */
+export function stepsAt(page, place) {
+    if ('press' in place) {
+        const press = pressOf(page, place.press);
+        if (!press)
+            return [];
+        const call = actionStep(press);
+        return [...(press.steps ?? []), ...(call ? [call] : [])];
+    }
+    const on = page.on;
+    if (!on)
+        return [];
+    if ('change' in place)
+        return on.change?.[place.change] ?? [];
+    if ('moment' in place)
+        return on[place.moment] ?? [];
+    return on.show?.[place.show] ?? [];
+}
+/** Whether the place is on the page: a press that is there, a field it has, a tab or step it has. */
+export function placeIsThere(page, place) {
+    if ('press' in place)
+        return pressOf(page, place.press) !== null;
+    if ('change' in place)
+        return !!page.fields[place.change];
+    if ('show' in place)
+        return showTargets(page).some((t) => t.id === place.show);
+    return true;
+}
+/**
+ * Keep a list at its place. A press needs something to do: a list left empty
+ * is refused; one plain `call` is its action, as a button that only names an
+ * action is; anything else its steps. A moment left with none goes, and `on`
+ * with it once it holds nothing.
+ */
+export function writeSteps(draft, place, steps) {
+    if ('press' in place) {
+        const press = pressOf(draft, place.press);
+        if (!press)
+            throw new Refusal((w) => w.steps.noPlace);
+        if (!steps.length)
+            throw new Refusal((w) => w.steps.needsSomething(press.label));
+        // A counter takes no params with its action: a call with some stays a step.
+        const only = steps.length === 1 && steps[0].do === 'call' && steps[0].when === undefined && (!steps[0].params || 'type' in press) ? steps[0] : null;
+        // Each key that stays keeps its place in the button, as the JSON shows it.
+        if (only) {
+            delete press.steps;
+            press.action = only.action;
+            if (only.params)
+                press.params = only.params;
+            else
+                delete press.params;
+        }
+        else {
+            delete press.action;
+            delete press.params;
+            press.steps = steps;
+        }
+        return;
+    }
+    // A place gone may still lose its steps: a field's change once the field has gone.
+    if (steps.length && !placeIsThere(draft, place))
+        throw new Refusal((w) => w.steps.noPlace);
+    const on = draft.on ?? {};
+    if ('moment' in place) {
+        if (steps.length)
+            on[place.moment] = steps;
+        else
+            delete on[place.moment];
+    }
+    else {
+        const key = 'change' in place ? 'change' : 'show';
+        const name = 'change' in place ? place.change : place.show;
+        const map = { ...(on[key] ?? {}) };
+        if (steps.length)
+            map[name] = steps;
+        else
+            delete map[name];
+        if (Object.keys(map).length)
+            on[key] = map;
+        else
+            delete on[key];
+    }
+    if (Object.keys(on).length)
+        draft.on = on;
+    else
+        delete draft.on;
+}
+/** The step at a path, or none. */
+export function stepAt(list, path) {
+    let step = list[path[0]];
+    for (const i of path.slice(1))
+        step = step?.do === 'open' ? step.then?.[i] : undefined;
+    return step;
+}
+/** The list a path's step sits in, as a copy of the whole to change: the list itself is changed in place. */
+export function holderOf(list, path) {
+    let holder = list;
+    for (const i of path.slice(0, -1)) {
+        const step = holder[i];
+        if (step?.do !== 'open')
+            return null;
+        step.then = step.then ?? [];
+        holder = step.then;
+    }
+    return holder;
+}
+/** An open step whose `then` was emptied loses it: the format takes no empty list. */
+export function tidyThen(list) {
+    for (const step of list) {
+        if (step.do !== 'open' || !step.then)
+            continue;
+        if (step.then.length)
+            tidyThen(step.then);
+        else
+            delete step.then;
+    }
+    return list;
+}
+/** Every step of a list, at any depth, with its path. */
+export function eachStep(list, path = []) {
+    return list.flatMap((step, i) => [{ step, path: [...path, i] }, ...(step.do === 'open' && step.then ? eachStep(step.then, [...path, i]) : [])]);
+}
+/** The tabs and wizard steps a step can go to, or show steps for, in reading order, with their words. */
+export function showTargets(page) {
+    const root = page.layout;
+    if (root.type === 'wizard')
+        return root.children.map((step) => ({ id: step.id, label: step.label }));
+    if (root.type === 'tabs')
+        return root.children.map((tab) => ({ id: tab.id, label: tab.label }));
+    if (root.type === 'list')
+        return [];
+    return tabsNodes(page).flatMap((tabs) => tabs.children.map((tab) => ({ id: tab.id, label: tab.label })));
+}
+/** Every list of steps on the page, where it is, in reading order: the presses, then the changes, then the moments. */
+export function everyPlace(page) {
+    const out = [];
+    const press = (part) => {
+        if (part.steps?.length)
+            out.push({ place: { press: part.id }, steps: stepsAt(page, { press: part.id }) });
+    };
+    const root = page.layout;
+    if (root.type === 'sheet')
+        [...(root.buttons ?? []), ...(root.statButtons ?? [])].forEach(press);
+    if (root.type === 'list')
+        (root.actions ?? []).forEach(press);
+    for (const c of containers(page))
+        for (const node of c.children)
+            if (node.type === 'button')
+                press(node);
+    const on = page.on ?? {};
+    for (const [field, steps] of Object.entries(on.change ?? {}))
+        out.push({ place: { change: field }, steps });
+    for (const moment of MOMENTS)
+        if (on[moment]?.length)
+            out.push({ place: { moment }, steps: on[moment] });
+    for (const [show, steps] of Object.entries(on.show ?? {}))
+        out.push({ place: { show }, steps });
+    return out;
+}
+/** The fields of this page a step names: the field it sets, empties or adds a line to, those it checks, those it puts answers in. */
+export function fieldsNamed(step) {
+    switch (step.do) {
+        case 'set':
+        case 'clear':
+        case 'addLine':
+            return [step.field];
+        case 'check':
+            return step.fields ?? [];
+        case 'open':
+            return Object.keys(step.into ?? {});
+        default:
+            return [];
+    }
+}
+/** The fields of this page a step's expressions read: when it runs, the value it sets, what an opened page starts with. Not its answers: those are the opened page's. */
+export function fieldsRead(step) {
+    const sources = [step.when];
+    if (step.do === 'set')
+        sources.push(step.value);
+    if (step.do === 'addLine')
+        sources.push(...Object.values(step.values ?? {}));
+    if (step.do === 'open')
+        sources.push(step.record, ...Object.values(step.values ?? {}));
+    return [...new Set(sources.flatMap((s) => fieldsReadBy(s)))];
+}
+/** Every field the page's steps need to have a definition: named, read, or changed. */
+export function fieldsStepsNeed(page) {
+    const need = new Set(Object.keys(page.on?.change ?? {}));
+    for (const { steps } of everyPlace(page)) {
+        for (const { step } of eachStep(steps))
+            for (const name of [...fieldsNamed(step), ...fieldsRead(step)])
+                need.add(name);
+    }
+    return need;
+}
+/** Steps going to a tab or step no longer there, and a tab's or step's own steps once it is gone: taken away. */
+export function forgetGoneTargets(page) {
+    const there = new Set(showTargets(page).map((t) => t.id));
+    const on = page.on;
+    if (on?.show) {
+        for (const id of Object.keys(on.show))
+            if (!there.has(id))
+                delete on.show[id];
+        if (!Object.keys(on.show).length)
+            delete on.show;
+        if (!Object.keys(on).length)
+            delete page.on;
+    }
+    const keep = (list) => list.filter((step) => step.do !== 'goTo' || there.has(step.target)).map((step) => (step.do === 'open' && step.then ? { ...step, then: keep(step.then) } : step));
+    for (const { place, steps } of everyPlace(page)) {
+        const kept = tidyThen(keep(steps));
+        if (JSON.stringify(kept) === JSON.stringify(steps))
+            continue;
+        // A press left with nothing to do keeps its steps: the page's own check says where they go.
+        if ('press' in place && !kept.length)
+            continue;
+        try {
+            writeSteps(page, place, kept);
+        }
+        catch {
+            // A place no longer there: the page's own check says so.
+        }
+    }
+}
+//# sourceMappingURL=steps-places.mjs.map

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

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

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

@@ -0,0 +1,31 @@
+import type { ActionStep, Page } from '@fieldia/core';
+import type { ElementFactory } from './chrome.mjs';
+import type { DesignerWords } from './designer-words.mjs';
+import type { SavedFormRef } from './saved-forms.mjs';
+import { type StepPatch } from './steps-commands.mjs';
+/**
+ * A step's settings, opened in place under its sentence: for each kind only
+ * what it takes — the page it opens and how (a panel, from which side), what that page starts with and
+ * where its answers go; the field a value is set in and the value; what is
+ * said or asked; the app's action — and, for every kind, "Only when…". The
+ * page's fields are picked by their labels; formulas are typed in the rules'
+ * formula box, the fields they read suggested.
+ */
+export interface StepContext {
+    words: DesignerWords;
+    page(): Page;
+    /** Change the step: kept when it can be, else said why under it. With `typing`, a run in one box is one undo step. */
+    change(patch: StepPatch, typing?: boolean): void;
+    /** A saved page by its id, when the app's saved pages have it. */
+    saved(id: string): Page | null | undefined;
+    /** The app's saved pages to open; null without a store that lists them, or while they load. */
+    listed(): SavedFormRef[] | null;
+}
+export interface StepSettings {
+    element: HTMLElement;
+    update(step: ActionStep): void;
+    focusFirst(): void;
+}
+export declare function stepSettings(el: ElementFactory, kind: ActionStep['do'], ctx: StepContext): StepSettings;
+/** A new step of a kind, as "Add a step" begins it: what can be picked first is; what must be written waits for it. */
+export declare function newStep(page: Page, kind: ActionStep['do']): ActionStep;

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

@@ -0,0 +1,31 @@
+import type { ActionStep, Page } from '@fieldia/core';
+import type { ElementFactory } from './chrome';
+import type { DesignerWords } from './designer-words';
+import type { SavedFormRef } from './saved-forms';
+import { type StepPatch } from './steps-commands';
+/**
+ * A step's settings, opened in place under its sentence: for each kind only
+ * what it takes — the page it opens and how (a panel, from which side), what that page starts with and
+ * where its answers go; the field a value is set in and the value; what is
+ * said or asked; the app's action — and, for every kind, "Only when…". The
+ * page's fields are picked by their labels; formulas are typed in the rules'
+ * formula box, the fields they read suggested.
+ */
+export interface StepContext {
+    words: DesignerWords;
+    page(): Page;
+    /** Change the step: kept when it can be, else said why under it. With `typing`, a run in one box is one undo step. */
+    change(patch: StepPatch, typing?: boolean): void;
+    /** A saved page by its id, when the app's saved pages have it. */
+    saved(id: string): Page | null | undefined;
+    /** The app's saved pages to open; null without a store that lists them, or while they load. */
+    listed(): SavedFormRef[] | null;
+}
+export interface StepSettings {
+    element: HTMLElement;
+    update(step: ActionStep): void;
+    focusFirst(): void;
+}
+export declare function stepSettings(el: ElementFactory, kind: ActionStep['do'], ctx: StepContext): StepSettings;
+/** A new step of a kind, as "Add a step" begins it: what can be picked first is; what must be written waits for it. */
+export declare function newStep(page: Page, kind: ActionStep['do']): ActionStep;