@fieldia/designer 0.0.0-stage → 0.12.0

package/src/lib/assistant-box.mjs

@@ -0,0 +1,106 @@
+import { askAssistant } from './assistant.mjs';
+import { isBlank } from './templates.mjs';
+let made = 0;
+export function assistantBox(options) {
+    const { el, designer, assistant } = options;
+    const w = designer.words.assistant;
+    const id = `fd-assist-${++made}`;
+    const area = el('textarea', { id, class: 'fd-input fd-assist-prompt', rows: '3', placeholder: options.placeholder, spellcheck: 'true' });
+    const label = el('label', { class: 'fd-assist-label', for: id }, options.label);
+    const name = assistant.name ? el('span', { class: 'fd-assist-name' }, assistant.name) : null;
+    const note = assistant.note ? el('p', { class: 'fd-assist-note', id: `${id}-note` }, el('bdi', {}, assistant.note)) : null;
+    if (note)
+        area.setAttribute('aria-describedby', note.id);
+    const submit = el('button', { type: 'submit', class: 'fd-button fd-button-primary fd-assist-ask' }, options.ask);
+    const cancelButton = el('button', { type: 'button', class: 'fd-button fd-assist-cancel', hidden: '' }, w.cancel);
+    const waiting = el('span', { class: 'fd-assist-busy', role: 'status', hidden: '' }, el('span', { class: 'fd-assist-spinner', 'aria-hidden': 'true' }), options.busy);
+    const said = el('p', { class: 'fd-assist-said', role: 'status' });
+    const problem = el('p', { class: 'fd-assist-problem', role: 'alert', hidden: '' });
+    const element = el('form', { class: 'fd-assist', 'aria-busy': 'false', novalidate: '' }, el('div', { class: 'fd-assist-head' }, label, ...(name ? [name] : [])), area, ...(note ? [note] : []), el('div', { class: 'fd-assist-actions' }, submit, waiting, cancelButton, said), problem);
+    let run = null;
+    function setBusy(busy) {
+        element.setAttribute('aria-busy', String(busy));
+        area.readOnly = busy;
+        submit.hidden = busy;
+        waiting.hidden = !busy;
+        cancelButton.hidden = !busy;
+    }
+    /** Said under the box, each in its own direction: the assistant's words may be English on a page right to left. */
+    function tell(words, wrong) {
+        problem.replaceChildren(...(wrong ? [el('bdi', {}, words)] : []));
+        problem.hidden = !wrong;
+        said.replaceChildren(...(!wrong && words ? [el('bdi', {}, words)] : []));
+    }
+    async function ask() {
+        if (run)
+            return;
+        tell('', false);
+        if (!area.value.trim()) {
+            tell(w.askForWords, true);
+            area.focus();
+            return;
+        }
+        const wasBlank = isBlank(designer.getPage());
+        // Asked from in here: the button pressed is hidden while it waits, so the cursor waits on Cancel.
+        const here = element.contains(element.ownerDocument.activeElement);
+        const current = askAssistant(designer, assistant, area.value);
+        run = current;
+        setBusy(true);
+        if (here)
+            cancelButton.focus();
+        const result = await current.done;
+        if (run !== current)
+            return;
+        run = null;
+        setBusy(false);
+        options.onSettled?.();
+        if (result.status === 'applied') {
+            options.onApplied(result.changes, wasBlank);
+            return;
+        }
+        if (result.status === 'unchanged')
+            tell(w.leftAsItWas, false);
+        else if (result.status !== 'cancelled')
+            tell(result.problem, true);
+        area.focus();
+    }
+    element.addEventListener('submit', (event) => {
+        event.preventDefault();
+        void ask();
+    });
+    area.addEventListener('keydown', (event) => {
+        if (event.key === 'Enter' && (event.ctrlKey || event.metaKey)) {
+            event.preventDefault();
+            void ask();
+        }
+    });
+    /** Stopped at once: the assistant is told, and the box is back to the words. */
+    function cancel() {
+        const current = run;
+        if (!current)
+            return;
+        run = null;
+        current.cancel();
+        setBusy(false);
+        options.onSettled?.();
+        tell(w.cancelled, false);
+        area.focus();
+    }
+    cancelButton.addEventListener('click', cancel);
+    element.addEventListener('keydown', (event) => {
+        // Escape stops the wait; with nothing to wait for, it is the place's own, a dialog's to close.
+        if (event.key === 'Escape' && run) {
+            event.preventDefault();
+            cancel();
+        }
+    });
+    return {
+        element,
+        get busy() {
+            return run !== null;
+        },
+        focus: () => area.focus(),
+        cancel,
+    };
+}
+//# sourceMappingURL=assistant-box.mjs.map

package/src/lib/assistant-box.mjs.map

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

package/src/lib/assistant-dialog.d.mts

@@ -0,0 +1,20 @@
+import type { DesignerAssistant } from './assistant.mjs';
+import type { ElementFactory } from './chrome.mjs';
+import type { Designer } from './designer.mjs';
+/**
+ * "Ask the assistant…", for a page that has parts: the assistant's box in a
+ * dialog, saying what should change. Its form in place, the dialog closes and
+ * `onApplied` says what changed. Escape, the × or a click outside close it,
+ * cancelling a wait; the keyboard stays inside while it is open, and goes
+ * back where it was when it closes without an answer.
+ */
+export interface AssistantDialogOptions {
+    el: ElementFactory;
+    root: HTMLElement;
+    designer: Designer;
+    assistant: DesignerAssistant;
+    onApplied(changes: string[]): void;
+}
+export declare function openAssistantDialog(options: AssistantDialogOptions): {
+    close(): void;
+};

package/src/lib/assistant-dialog.d.ts

@@ -0,0 +1,20 @@
+import type { DesignerAssistant } from './assistant';
+import type { ElementFactory } from './chrome';
+import type { Designer } from './designer';
+/**
+ * "Ask the assistant…", for a page that has parts: the assistant's box in a
+ * dialog, saying what should change. Its form in place, the dialog closes and
+ * `onApplied` says what changed. Escape, the × or a click outside close it,
+ * cancelling a wait; the keyboard stays inside while it is open, and goes
+ * back where it was when it closes without an answer.
+ */
+export interface AssistantDialogOptions {
+    el: ElementFactory;
+    root: HTMLElement;
+    designer: Designer;
+    assistant: DesignerAssistant;
+    onApplied(changes: string[]): void;
+}
+export declare function openAssistantDialog(options: AssistantDialogOptions): {
+    close(): void;
+};

package/src/lib/assistant-dialog.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAssistantDialog = openAssistantDialog;
+const assistant_box_1 = require("./assistant-box");
+let made = 0;
+function openAssistantDialog(options) {
+    const { el, root, designer, assistant } = options;
+    const doc = root.ownerDocument;
+    const opener = doc.activeElement;
+    const id = `fd-assist-dialog-${++made}`;
+    const w = designer.words.assistant;
+    const box = (0, assistant_box_1.assistantBox)({
+        el,
+        designer,
+        assistant,
+        label: w.whatShouldChange,
+        placeholder: w.changeExample,
+        ask: w.ask,
+        busy: w.changing,
+        onApplied(changes) {
+            close(false);
+            options.onApplied(changes);
+        },
+    });
+    const closeX = el('button', { type: 'button', class: 'fd-dialog-close', 'aria-label': w.close }, '×');
+    const dialog = el('div', { class: 'fd-form-dialog fd-size-small fd-assist-dialog', role: 'dialog', 'aria-modal': 'true', 'aria-labelledby': `${id}-title`, tabindex: '-1' }, el('div', { class: 'fd-form-dialog-head' }, el('h2', { class: 'fd-form-dialog-title', id: `${id}-title` }, w.askTitle), closeX), el('div', { class: 'fd-assist-dialog-body' }, box.element));
+    const backdrop = el('div', { class: 'fd-dialog-backdrop fd-assist-backdrop' }, dialog);
+    function close(refocus = true) {
+        if (!backdrop.isConnected)
+            return;
+        box.cancel();
+        backdrop.remove();
+        if (refocus)
+            opener?.focus?.();
+    }
+    closeX.addEventListener('click', () => close());
+    backdrop.addEventListener('pointerdown', (event) => event.target === backdrop && close());
+    dialog.addEventListener('keydown', (event) => {
+        if (event.key === 'Escape') {
+            event.preventDefault();
+            event.stopPropagation();
+            close();
+        }
+        else if (event.key === 'Tab') {
+            // The keyboard stays in the dialog.
+            const stops = [...dialog.querySelectorAll('button, textarea')].filter((e) => !e.closest('[hidden]') && !e.disabled);
+            const first = stops[0];
+            const last = stops[stops.length - 1];
+            if (event.shiftKey && doc.activeElement === first) {
+                event.preventDefault();
+                last?.focus();
+            }
+            else if (!event.shiftKey && doc.activeElement === last) {
+                event.preventDefault();
+                first?.focus();
+            }
+        }
+    });
+    root.append(backdrop);
+    box.focus();
+    return { close: () => close() };
+}
+//# sourceMappingURL=assistant-dialog.js.map

package/src/lib/assistant-dialog.js.map

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

package/src/lib/assistant-dialog.mjs

@@ -0,0 +1,60 @@
+import { assistantBox } from './assistant-box.mjs';
+let made = 0;
+export function openAssistantDialog(options) {
+    const { el, root, designer, assistant } = options;
+    const doc = root.ownerDocument;
+    const opener = doc.activeElement;
+    const id = `fd-assist-dialog-${++made}`;
+    const w = designer.words.assistant;
+    const box = assistantBox({
+        el,
+        designer,
+        assistant,
+        label: w.whatShouldChange,
+        placeholder: w.changeExample,
+        ask: w.ask,
+        busy: w.changing,
+        onApplied(changes) {
+            close(false);
+            options.onApplied(changes);
+        },
+    });
+    const closeX = el('button', { type: 'button', class: 'fd-dialog-close', 'aria-label': w.close }, '×');
+    const dialog = el('div', { class: 'fd-form-dialog fd-size-small fd-assist-dialog', role: 'dialog', 'aria-modal': 'true', 'aria-labelledby': `${id}-title`, tabindex: '-1' }, el('div', { class: 'fd-form-dialog-head' }, el('h2', { class: 'fd-form-dialog-title', id: `${id}-title` }, w.askTitle), closeX), el('div', { class: 'fd-assist-dialog-body' }, box.element));
+    const backdrop = el('div', { class: 'fd-dialog-backdrop fd-assist-backdrop' }, dialog);
+    function close(refocus = true) {
+        if (!backdrop.isConnected)
+            return;
+        box.cancel();
+        backdrop.remove();
+        if (refocus)
+            opener?.focus?.();
+    }
+    closeX.addEventListener('click', () => close());
+    backdrop.addEventListener('pointerdown', (event) => event.target === backdrop && close());
+    dialog.addEventListener('keydown', (event) => {
+        if (event.key === 'Escape') {
+            event.preventDefault();
+            event.stopPropagation();
+            close();
+        }
+        else if (event.key === 'Tab') {
+            // The keyboard stays in the dialog.
+            const stops = [...dialog.querySelectorAll('button, textarea')].filter((e) => !e.closest('[hidden]') && !e.disabled);
+            const first = stops[0];
+            const last = stops[stops.length - 1];
+            if (event.shiftKey && doc.activeElement === first) {
+                event.preventDefault();
+                last?.focus();
+            }
+            else if (!event.shiftKey && doc.activeElement === last) {
+                event.preventDefault();
+                first?.focus();
+            }
+        }
+    });
+    root.append(backdrop);
+    box.focus();
+    return { close: () => close() };
+}
+//# sourceMappingURL=assistant-dialog.mjs.map

package/src/lib/assistant-dialog.mjs.map

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

package/src/lib/assistant.d.mts

@@ -0,0 +1,44 @@
+import type { Page } from '@fieldia/core';
+import type { Designer } from './designer.mjs';
+/**
+ * The app's own assistant: given what a person asks and the page as it is,
+ * it answers with a page. Fieldia ships no AI of its own; an app that has
+ * one hands it to the designer. Its answer is checked as any page is, put
+ * in place as one edit, and said back as the changes it made — or refused,
+ * or reported, in words. Cancelled, it is told to stop, and an answer that
+ * comes after is let go.
+ */
+export interface DesignerAssistant {
+    /** A page for what was asked: a new one for a blank page, or the page changed. `signal` says when the person has cancelled. */
+    describe(request: {
+        prompt: string;
+        page: Page;
+        signal?: AbortSignal;
+    }): Promise<Page>;
+    /** What the editor calls it, beside its box: such as "Demo assistant". */
+    name?: string;
+    /** A line under its box saying what it is and does. */
+    note?: string;
+}
+export type AssistantResult = {
+    status: 'applied';
+    changes: string[];
+} | {
+    status: 'unchanged';
+} | {
+    status: 'refused';
+    problem: string;
+} | {
+    status: 'failed';
+    problem: string;
+} | {
+    status: 'cancelled';
+};
+export interface AssistantRun {
+    /** Stop: the assistant is told, and what it answers after is let go. */
+    cancel(): void;
+    done: Promise<AssistantResult>;
+}
+/** What is said when nothing is written for the assistant (in the designer's words: `words.assistant.askForWords`). */
+export declare const ASK_FOR_WORDS: string;
+export declare function askAssistant(designer: Designer, assistant: DesignerAssistant, prompt: string): AssistantRun;

package/src/lib/assistant.d.ts

@@ -0,0 +1,44 @@
+import type { Page } from '@fieldia/core';
+import type { Designer } from './designer';
+/**
+ * The app's own assistant: given what a person asks and the page as it is,
+ * it answers with a page. Fieldia ships no AI of its own; an app that has
+ * one hands it to the designer. Its answer is checked as any page is, put
+ * in place as one edit, and said back as the changes it made — or refused,
+ * or reported, in words. Cancelled, it is told to stop, and an answer that
+ * comes after is let go.
+ */
+export interface DesignerAssistant {
+    /** A page for what was asked: a new one for a blank page, or the page changed. `signal` says when the person has cancelled. */
+    describe(request: {
+        prompt: string;
+        page: Page;
+        signal?: AbortSignal;
+    }): Promise<Page>;
+    /** What the editor calls it, beside its box: such as "Demo assistant". */
+    name?: string;
+    /** A line under its box saying what it is and does. */
+    note?: string;
+}
+export type AssistantResult = {
+    status: 'applied';
+    changes: string[];
+} | {
+    status: 'unchanged';
+} | {
+    status: 'refused';
+    problem: string;
+} | {
+    status: 'failed';
+    problem: string;
+} | {
+    status: 'cancelled';
+};
+export interface AssistantRun {
+    /** Stop: the assistant is told, and what it answers after is let go. */
+    cancel(): void;
+    done: Promise<AssistantResult>;
+}
+/** What is said when nothing is written for the assistant (in the designer's words: `words.assistant.askForWords`). */
+export declare const ASK_FOR_WORDS: string;
+export declare function askAssistant(designer: Designer, assistant: DesignerAssistant, prompt: string): AssistantRun;

package/src/lib/assistant.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASK_FOR_WORDS = void 0;
+exports.askAssistant = askAssistant;
+const page_checks_1 = require("./page-checks");
+const templates_1 = require("./templates");
+const en_1 = require("./locales/en");
+/** What is said when nothing is written for the assistant (in the designer's words: `words.assistant.askForWords`). */
+exports.ASK_FOR_WORDS = en_1.en.assistant.askForWords;
+function askAssistant(designer, assistant, prompt) {
+    const words = prompt.trim();
+    const w = designer.words.assistant;
+    const stop = new AbortController();
+    let settle = () => undefined;
+    let settled = false;
+    const done = new Promise((resolve) => (settle = resolve));
+    const finish = (result) => {
+        if (settled)
+            return;
+        settled = true;
+        settle(result);
+    };
+    const cancel = () => {
+        if (settled)
+            return;
+        stop.abort();
+        finish({ status: 'cancelled' });
+    };
+    if (!words) {
+        finish({ status: 'refused', problem: w.askForWords });
+        return { cancel, done };
+    }
+    const asked = designer.getPage();
+    let answer;
+    try {
+        answer = Promise.resolve(assistant.describe({ prompt: words, page: JSON.parse(JSON.stringify(asked)), signal: stop.signal }));
+    }
+    catch (error) {
+        answer = Promise.reject(error);
+    }
+    answer.then((page) => {
+        if (settled)
+            return;
+        const before = designer.getPage();
+        const problem = (0, templates_1.pageProblem)(before, page, designer.words);
+        if (problem)
+            return finish({ status: 'refused', problem: w.cannotBeUsed(problem) });
+        if (JSON.stringify({ ...page, id: before.id, data: before.data }) === JSON.stringify(before))
+            return finish({ status: 'unchanged' });
+        if (!designer.replacePage(page))
+            return finish({ status: 'refused', problem: w.cannotBeUsed(designer.getState().issues.join('; ')) });
+        finish({ status: 'applied', changes: (0, page_checks_1.pageChanges)(before, designer.getPage(), designer.words) });
+    }, (error) => {
+        finish({ status: 'failed', problem: w.couldNot(error instanceof Error && error.message ? error.message : null) });
+    });
+    return { cancel, done };
+}
+//# sourceMappingURL=assistant.js.map

package/src/lib/assistant.js.map

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

package/src/lib/assistant.mjs

@@ -0,0 +1,54 @@
+import { pageChanges } from './page-checks.mjs';
+import { pageProblem } from './templates.mjs';
+import { en } from './locales/en/index.mjs';
+/** What is said when nothing is written for the assistant (in the designer's words: `words.assistant.askForWords`). */
+export const ASK_FOR_WORDS = en.assistant.askForWords;
+export function askAssistant(designer, assistant, prompt) {
+    const words = prompt.trim();
+    const w = designer.words.assistant;
+    const stop = new AbortController();
+    let settle = () => undefined;
+    let settled = false;
+    const done = new Promise((resolve) => (settle = resolve));
+    const finish = (result) => {
+        if (settled)
+            return;
+        settled = true;
+        settle(result);
+    };
+    const cancel = () => {
+        if (settled)
+            return;
+        stop.abort();
+        finish({ status: 'cancelled' });
+    };
+    if (!words) {
+        finish({ status: 'refused', problem: w.askForWords });
+        return { cancel, done };
+    }
+    const asked = designer.getPage();
+    let answer;
+    try {
+        answer = Promise.resolve(assistant.describe({ prompt: words, page: JSON.parse(JSON.stringify(asked)), signal: stop.signal }));
+    }
+    catch (error) {
+        answer = Promise.reject(error);
+    }
+    answer.then((page) => {
+        if (settled)
+            return;
+        const before = designer.getPage();
+        const problem = pageProblem(before, page, designer.words);
+        if (problem)
+            return finish({ status: 'refused', problem: w.cannotBeUsed(problem) });
+        if (JSON.stringify({ ...page, id: before.id, data: before.data }) === JSON.stringify(before))
+            return finish({ status: 'unchanged' });
+        if (!designer.replacePage(page))
+            return finish({ status: 'refused', problem: w.cannotBeUsed(designer.getState().issues.join('; ')) });
+        finish({ status: 'applied', changes: pageChanges(before, designer.getPage(), designer.words) });
+    }, (error) => {
+        finish({ status: 'failed', problem: w.couldNot(error instanceof Error && error.message ? error.message : null) });
+    });
+    return { cancel, done };
+}
+//# sourceMappingURL=assistant.mjs.map

package/src/lib/assistant.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.mjs","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/assistant.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAiClC,uHAAuH;AACvH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC;AAEtD,MAAM,UAAU,YAAY,CAAC,QAAkB,EAAE,SAA4B,EAAE,MAAc;IAC3F,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,IAAI,MAAM,GAAsC,GAAG,EAAE,CAAC,SAAS,CAAC;IAChE,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,CAAC,MAAuB,EAAE,EAAE;QACzC,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,OAAO;YAAE,OAAO;QACpB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,IAAI,MAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxI,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE;QACP,IAAI,OAAO;YAAE,OAAO;QACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,OAAO;YAAE,OAAO,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpF,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACrI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACtI,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpH,CAAC,CACF,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/src/lib/branch-map.d.mts

@@ -0,0 +1,26 @@
+import type { Page } from '@fieldia/core';
+import type { DesignerWords } from './designer-words.mjs';
+/**
+ * A survey's pages and where each answer leads. People go through the pages
+ * in order, and a page with a rule only when its rule holds — so every page
+ * sits in its own column on one line, and a page shown only for some answers
+ * branches off the line, labelled with those answers, and back onto it. The
+ * line running past it is everyone else.
+ */
+export interface BranchNode {
+    id: string;
+    label: string;
+    column: number;
+    /** 0 on the line; 1 off it, shown only for some answers. */
+    lane: 0 | 1;
+    /** For whom, in words: "Do you use it? is Yes". */
+    when?: string;
+    /** The same, short enough for the branch: "Yes", "not Manager", "2 rules". */
+    answer?: string;
+}
+export interface BranchMap {
+    nodes: BranchNode[];
+}
+export declare function branchMap(page: Page, words?: DesignerWords): BranchMap;
+/** The map as an SVG, each page a group to pick. */
+export declare function drawBranchMap(doc: Document, map: BranchMap, picked: string | null, onPick: (id: string) => void, words?: DesignerWords): SVGSVGElement;

package/src/lib/branch-map.d.ts

@@ -0,0 +1,26 @@
+import type { Page } from '@fieldia/core';
+import type { DesignerWords } from './designer-words';
+/**
+ * A survey's pages and where each answer leads. People go through the pages
+ * in order, and a page with a rule only when its rule holds — so every page
+ * sits in its own column on one line, and a page shown only for some answers
+ * branches off the line, labelled with those answers, and back onto it. The
+ * line running past it is everyone else.
+ */
+export interface BranchNode {
+    id: string;
+    label: string;
+    column: number;
+    /** 0 on the line; 1 off it, shown only for some answers. */
+    lane: 0 | 1;
+    /** For whom, in words: "Do you use it? is Yes". */
+    when?: string;
+    /** The same, short enough for the branch: "Yes", "not Manager", "2 rules". */
+    answer?: string;
+}
+export interface BranchMap {
+    nodes: BranchNode[];
+}
+export declare function branchMap(page: Page, words?: DesignerWords): BranchMap;
+/** The map as an SVG, each page a group to pick. */
+export declare function drawBranchMap(doc: Document, map: BranchMap, picked: string | null, onPick: (id: string) => void, words?: DesignerWords): SVGSVGElement;