@fieldia/viewer 0.19.1 → 0.20.0

package/src/lib/section-tools.mjs

@@ -0,0 +1,121 @@
+import { drawIcon } from '@fieldia/widgets';
+import { installGroupStyles } from './group-styles.mjs';
+/**
+ * A group's heading as a work item draws it, with its tools at its end: ⤢ that
+ * shows the group alone over the record's body, ^ and ⌄ that fold it, and the
+ * tools of a field it holds alone. The head part's (head-part.ts).
+ */
+const fill = (template, values) => template.replace(/\{(\w+)\}/g, (_, key) => values[key] ?? '');
+/**
+ * The heading of a group with tools at its end. `show` folds and unfolds it;
+ * the section is marked folded (`fd-section-folded`) and maximised
+ * (`data-maximised`) for the stylesheet.
+ */
+export function sectionHeading(kit, node, section, content, description, own) {
+    const { el, doc, labels } = kit;
+    installGroupStyles(doc);
+    const title = node.title ?? '';
+    const tools = el('span', { class: 'fd-section-tools' });
+    const legend = el('legend', { class: 'fd-section-title fd-section-head' }, el('span', { class: 'fd-section-name' }, ...kit.withIcon(node.icon, title)), tools);
+    section.setAttribute('data-head', '');
+    const icon = (name) => drawIcon(doc, name, kit.icons) ?? '';
+    const tool = (name, words) => {
+        const button = el('button', { type: 'button', class: 'fd-section-tool', 'data-tool': name, 'aria-label': words, title: words });
+        return button;
+    };
+    // ⤢: the group alone over the record's body, until pressed again or Escape.
+    let undo = null;
+    const big = node.maximise ? tool('maximise', fill(labels.maximiseNamed, { name: title })) : null;
+    const restore = () => {
+        undo?.();
+        undo = null;
+        if (!big)
+            return;
+        big.setAttribute('aria-pressed', 'false');
+        big.replaceChildren(icon('maximise'));
+    };
+    if (big) {
+        big.setAttribute('aria-pressed', 'false');
+        big.append(icon('maximise'));
+        big.addEventListener('click', () => {
+            if (undo)
+                return restore();
+            undo = maximise(section);
+            big.setAttribute('aria-pressed', 'true');
+            big.replaceChildren(icon('restore'));
+            big.focus();
+        });
+        section.addEventListener('keydown', (event) => {
+            if (event.key !== 'Escape' || !undo || event.defaultPrevented)
+                return;
+            event.preventDefault();
+            event.stopPropagation();
+            restore();
+            big.focus();
+        });
+        tools.append(big);
+    }
+    // ^ and ⌄: the group folded and unfolded from its heading's end.
+    let open = node.collapsed !== true;
+    const fold = node.collapsible ? tool('fold', '') : null;
+    const show = (next) => {
+        open = next;
+        if (fold) {
+            const words = fill(open ? labels.foldNamed : labels.unfoldNamed, { name: title });
+            fold.setAttribute('aria-label', words);
+            fold.title = words;
+            fold.setAttribute('aria-expanded', String(open));
+            fold.replaceChildren(icon(open ? 'chevron-up' : 'chevron-down'));
+        }
+        content.hidden = !open;
+        if (description)
+            description.hidden = !open;
+        section.classList.toggle('fd-section-folded', !open);
+        if (!open && undo)
+            restore();
+    };
+    if (fold) {
+        fold.setAttribute('aria-controls', content.id);
+        fold.addEventListener('click', () => show(!open));
+        tools.append(fold);
+    }
+    // The tools of the field it holds alone, last.
+    tools.append(...own);
+    show(open);
+    return { legend, show, isOpen: () => open };
+}
+/**
+ * The group alone over the record's body: every part beside it, and beside
+ * each part round it up to the body, out of sight; the grids round it give it
+ * their whole width. Returns how to put it all back.
+ */
+function maximise(section) {
+    const host = section.closest('.fd-tabpanel') ?? section.closest('.fd-content') ?? section.closest('.fd-form');
+    const unshown = [];
+    const grids = [];
+    let at = section;
+    while (at !== host && at.parentElement) {
+        const parent = at.parentElement;
+        for (const sibling of [...parent.children]) {
+            if (sibling === at || sibling.tagName === 'LEGEND' || sibling.hasAttribute('data-unshown'))
+                continue;
+            sibling.setAttribute('data-unshown', '');
+            unshown.push(sibling);
+        }
+        if (parent.classList.contains('fd-grid')) {
+            parent.setAttribute('data-maximising', '');
+            grids.push(parent);
+        }
+        at = parent;
+    }
+    section.setAttribute('data-maximised', '');
+    section.scrollIntoView?.({ block: 'nearest' });
+    return () => {
+        for (const part of unshown)
+            part.removeAttribute('data-unshown');
+        for (const grid of grids)
+            grid.removeAttribute('data-maximising');
+        section.removeAttribute('data-maximised');
+    };
+}
+//# sourceMappingURL=section-tools.mjs.map

package/src/lib/section-tools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-tools.mjs","sourceRoot":"","sources":["../../../../../libs/viewer/src/lib/section-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;;GAIG;AAEH,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAE,MAA8B,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAEzI;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY,EAAE,IAAiB,EAAE,OAAoB,EAAE,OAAoB,EAAE,WAA+B,EAAE,GAAkB;IAC7J,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAChC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/J,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACpE,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChI,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,4EAA4E;IAC5E,IAAI,IAAI,GAAwB,IAAI,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjG,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,EAAE,EAAE,CAAC;QACT,IAAI,GAAG,IAAI,CAAC;QACZ,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC1C,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;IACF,IAAI,GAAG,EAAE,CAAC;QACR,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC1C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7B,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACjC,IAAI,IAAI;gBAAE,OAAO,OAAO,EAAE,CAAC;YAC3B,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YACzB,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;YACzC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YACrC,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5C,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,gBAAgB;gBAAE,OAAO;YACtE,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;YACV,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,iEAAiE;IACjE,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,EAAE;QAC7B,IAAI,GAAG,IAAI,CAAC;QACZ,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAClF,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACjD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC;QACvB,IAAI,WAAW;YAAE,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC;QAC5C,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,IAAI,IAAI;YAAE,OAAO,EAAE,CAAC;IAC/B,CAAC,CAAC;IACF,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,+CAA+C;IAC/C,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,OAAoB;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAc,cAAc,CAAC,IAAI,OAAO,CAAC,OAAO,CAAc,aAAa,CAAC,IAAI,OAAO,CAAC,OAAO,CAAc,UAAU,CAAC,CAAC;IACrJ,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,EAAE,GAAgB,OAAO,CAAC;IAC9B,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,MAAM,GAAgB,EAAE,CAAC,aAAa,CAAC;QAC7C,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAkB,EAAE,CAAC;YAC5D,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC;gBAAE,SAAS;YACrG,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QACD,EAAE,GAAG,MAAM,CAAC;IACd,CAAC;IACD,OAAO,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/C,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,IAAI,IAAI,OAAO;YAAE,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;QACjE,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAClE,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/viewer-parts.d.mts

@@ -0,0 +1,33 @@
+import type { Page } from '@fieldia/core';
+import { type Part, type WidgetFactory } from '@fieldia/widgets';
+import type * as FiltersModule from './filters-part.mjs';
+import type * as HeadModule from './head-part.mjs';
+/** The head part: a record's head, split and toggled buttons, a group's work heading, the inset dialog's window tools. */
+export type HeadPart = typeof HeadModule;
+/** The filters part: a list's filter bar. */
+export type FiltersPart = typeof FiltersModule;
+/** A work item's record and its window, loaded the first time a page draws a head, a split button, a work heading or the inset dialog. */
+export declare const headPart: Part<HeadPart>;
+/** A list's filter bar, loaded the first time a list draws one. */
+export declare const filtersPart: Part<FiltersPart>;
+/**
+ * The parts a page draws from (parts.ts in @fieldia/widgets): the head part for
+ * a record's head, a button split, toggled or shown by its icon alone, or a
+ * group's work heading; the filters part for a list's filter bar; and the
+ * widgets' own for the fields that need them (a work item's text, a links box,
+ * a path picker, a choice in Fieldia's own list) — unless the app's `widgets` draw those fields; and those the
+ * app's `slots` name for the slots the page has (a Discussion's).
+ */
+export declare function partsFor(page: Page, widgets?: Record<string, WidgetFactory>, slots?: Record<string, {
+    readonly parts?: readonly Part[];
+}>): Part[];
+/**
+ * The parts a page draws from, loaded — or, with no page, every part. The
+ * viewer and its dialogs wait for a page's parts themselves before they draw
+ * it; this is for an app that wants them in before it mounts, so the page is
+ * drawn whole the moment it is mounted. Rejects when one could not come (the
+ * viewer then draws plainly what it would have drawn from it).
+ */
+export declare function loadParts(page?: Page, widgets?: Record<string, WidgetFactory>, slots?: Record<string, {
+    readonly parts?: readonly Part[];
+}>): Promise<void>;

package/src/lib/viewer-parts.d.ts

@@ -0,0 +1,33 @@
+import type { Page } from '@fieldia/core';
+import { type Part, type WidgetFactory } from '@fieldia/widgets';
+import type * as FiltersModule from './filters-part';
+import type * as HeadModule from './head-part';
+/** The head part: a record's head, split and toggled buttons, a group's work heading, the inset dialog's window tools. */
+export type HeadPart = typeof HeadModule;
+/** The filters part: a list's filter bar. */
+export type FiltersPart = typeof FiltersModule;
+/** A work item's record and its window, loaded the first time a page draws a head, a split button, a work heading or the inset dialog. */
+export declare const headPart: Part<HeadPart>;
+/** A list's filter bar, loaded the first time a list draws one. */
+export declare const filtersPart: Part<FiltersPart>;
+/**
+ * The parts a page draws from (parts.ts in @fieldia/widgets): the head part for
+ * a record's head, a button split, toggled or shown by its icon alone, or a
+ * group's work heading; the filters part for a list's filter bar; and the
+ * widgets' own for the fields that need them (a work item's text, a links box,
+ * a path picker, a choice in Fieldia's own list) — unless the app's `widgets` draw those fields; and those the
+ * app's `slots` name for the slots the page has (a Discussion's).
+ */
+export declare function partsFor(page: Page, widgets?: Record<string, WidgetFactory>, slots?: Record<string, {
+    readonly parts?: readonly Part[];
+}>): Part[];
+/**
+ * The parts a page draws from, loaded — or, with no page, every part. The
+ * viewer and its dialogs wait for a page's parts themselves before they draw
+ * it; this is for an app that wants them in before it mounts, so the page is
+ * drawn whole the moment it is mounted. Rejects when one could not come (the
+ * viewer then draws plainly what it would have drawn from it).
+ */
+export declare function loadParts(page?: Page, widgets?: Record<string, WidgetFactory>, slots?: Record<string, {
+    readonly parts?: readonly Part[];
+}>): Promise<void>;

package/src/lib/viewer-parts.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filtersPart = exports.headPart = void 0;
+exports.partsFor = partsFor;
+exports.loadParts = loadParts;
+const widgets_1 = require("@fieldia/widgets");
+const button_parts_1 = require("./button-parts");
+const section_head_1 = require("./section-head");
+/** A work item's record and its window, loaded the first time a page draws a head, a split button, a work heading or the inset dialog. */
+exports.headPart = (0, widgets_1.lazyPart)('head', () => Promise.resolve().then(() => require('./head-part')));
+/** A list's filter bar, loaded the first time a list draws one. */
+exports.filtersPart = (0, widgets_1.lazyPart)('filters', () => Promise.resolve().then(() => require('./filters-part')));
+/** Every part the viewer can draw from, its own and its widgets'. */
+const EVERY_PART = [exports.headPart, exports.filtersPart, widgets_1.textPart, widgets_1.pathPart, widgets_1.choicePart];
+/** A group holding a Markdown text alone, whose Edit and Done its heading takes: drawn with the work heading's tools. */
+const markdownAlone = (node) => {
+    const only = node.children.length === 1 ? node.children[0] : undefined;
+    return !!node.title && only?.type === 'field' && only.options?.['editor'] === 'markdown';
+};
+/**
+ * The parts a page draws from (parts.ts in @fieldia/widgets): the head part for
+ * a record's head, a button split, toggled or shown by its icon alone, or a
+ * group's work heading; the filters part for a list's filter bar; and the
+ * widgets' own for the fields that need them (a work item's text, a links box,
+ * a path picker, a choice in Fieldia's own list) — unless the app's `widgets` draw those fields; and those the
+ * app's `slots` name for the slots the page has (a Discussion's).
+ */
+function partsFor(page, widgets = {}, slots = {}) {
+    const found = new Set();
+    const visit = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                visit(item);
+            return;
+        }
+        if (!value || typeof value !== 'object')
+            return;
+        const node = value;
+        if (node.type === 'sheet' && node['head'])
+            found.add(exports.headPart);
+        else if (node.type === 'button' && (0, button_parts_1.isRichButton)(node))
+            found.add(exports.headPart);
+        else if (node.type === 'section' && Array.isArray(node['children']) && ((0, section_head_1.workHeading)(node) || markdownAlone(node)))
+            found.add(exports.headPart);
+        else if (node.type === 'list' && node['search'] === 'fields')
+            found.add(exports.filtersPart);
+        else if (node.type === 'slot' && typeof node['name'] === 'string')
+            for (const part of slots[node['name']]?.parts ?? [])
+                found.add(part);
+        else if (node.type === 'field' && typeof node['field'] === 'string') {
+            const field = page.fields[node['field']];
+            const part = field ? (0, widgets_1.widgetPart)(field, node, widgets) : undefined;
+            if (part)
+                found.add(part);
+        }
+        for (const key of Object.keys(node)) {
+            const child = node[key];
+            if (child && typeof child === 'object')
+                visit(child);
+        }
+    };
+    visit(page.layout);
+    return [...found];
+}
+/**
+ * The parts a page draws from, loaded — or, with no page, every part. The
+ * viewer and its dialogs wait for a page's parts themselves before they draw
+ * it; this is for an app that wants them in before it mounts, so the page is
+ * drawn whole the moment it is mounted. Rejects when one could not come (the
+ * viewer then draws plainly what it would have drawn from it).
+ */
+async function loadParts(page, widgets, slots) {
+    await Promise.all((page ? partsFor(page, widgets, slots) : EVERY_PART).map((part) => part.load()));
+}
+//# sourceMappingURL=viewer-parts.js.map

package/src/lib/viewer-parts.js.map

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

package/src/lib/viewer-parts.mjs

@@ -0,0 +1,70 @@
+import { choicePart, lazyPart, pathPart, textPart, widgetPart } from '@fieldia/widgets';
+import { isRichButton } from './button-parts.mjs';
+import { workHeading } from './section-head.mjs';
+/** A work item's record and its window, loaded the first time a page draws a head, a split button, a work heading or the inset dialog. */
+export const headPart = lazyPart('head', () => import('./head-part.mjs'));
+/** A list's filter bar, loaded the first time a list draws one. */
+export const filtersPart = lazyPart('filters', () => import('./filters-part.mjs'));
+/** Every part the viewer can draw from, its own and its widgets'. */
+const EVERY_PART = [headPart, filtersPart, textPart, pathPart, choicePart];
+/** A group holding a Markdown text alone, whose Edit and Done its heading takes: drawn with the work heading's tools. */
+const markdownAlone = (node) => {
+    const only = node.children.length === 1 ? node.children[0] : undefined;
+    return !!node.title && only?.type === 'field' && only.options?.['editor'] === 'markdown';
+};
+/**
+ * The parts a page draws from (parts.ts in @fieldia/widgets): the head part for
+ * a record's head, a button split, toggled or shown by its icon alone, or a
+ * group's work heading; the filters part for a list's filter bar; and the
+ * widgets' own for the fields that need them (a work item's text, a links box,
+ * a path picker, a choice in Fieldia's own list) — unless the app's `widgets` draw those fields; and those the
+ * app's `slots` name for the slots the page has (a Discussion's).
+ */
+export function partsFor(page, widgets = {}, slots = {}) {
+    const found = new Set();
+    const visit = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                visit(item);
+            return;
+        }
+        if (!value || typeof value !== 'object')
+            return;
+        const node = value;
+        if (node.type === 'sheet' && node['head'])
+            found.add(headPart);
+        else if (node.type === 'button' && isRichButton(node))
+            found.add(headPart);
+        else if (node.type === 'section' && Array.isArray(node['children']) && (workHeading(node) || markdownAlone(node)))
+            found.add(headPart);
+        else if (node.type === 'list' && node['search'] === 'fields')
+            found.add(filtersPart);
+        else if (node.type === 'slot' && typeof node['name'] === 'string')
+            for (const part of slots[node['name']]?.parts ?? [])
+                found.add(part);
+        else if (node.type === 'field' && typeof node['field'] === 'string') {
+            const field = page.fields[node['field']];
+            const part = field ? widgetPart(field, node, widgets) : undefined;
+            if (part)
+                found.add(part);
+        }
+        for (const key of Object.keys(node)) {
+            const child = node[key];
+            if (child && typeof child === 'object')
+                visit(child);
+        }
+    };
+    visit(page.layout);
+    return [...found];
+}
+/**
+ * The parts a page draws from, loaded — or, with no page, every part. The
+ * viewer and its dialogs wait for a page's parts themselves before they draw
+ * it; this is for an app that wants them in before it mounts, so the page is
+ * drawn whole the moment it is mounted. Rejects when one could not come (the
+ * viewer then draws plainly what it would have drawn from it).
+ */
+export async function loadParts(page, widgets, slots) {
+    await Promise.all((page ? partsFor(page, widgets, slots) : EVERY_PART).map((part) => part.load()));
+}
+//# sourceMappingURL=viewer-parts.mjs.map

package/src/lib/viewer-parts.mjs.map

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

package/src/lib/viewer.d.mts

@@ -1,7 +1,7 @@
 import { type ActionHost, type ActionStep, type FormEvents, type Form, type FormOptions, type LayoutNode, type Page, type Skin, type Theme, type RecordId, type ResolvedFilter, type Locale, type OpenRequest, type OpenResult, type RunContext, type RunResult, type Values } from '@fieldia/core';
-import { type IconSet, type PreferenceStore, type WidgetFactory } from '@fieldia/widgets';
+import { type IconSet, type Part, type PreferenceStore, type WidgetFactory } from '@fieldia/widgets';
 import { type PageFinder } from './related.mjs';
-import { type ListViewFactory } from './list.mjs';
+import { type ListViewFactory, type OpenRowOptions } from './list.mjs';
 import type { MapPartFactory } from './map-part.mjs';
 import { type Tokens } from './look.mjs';
 import { type Breadcrumb, type RecordPager } from './record-bar.mjs';
@@ -11,11 +11,16 @@ export type { Skin };
 import { type ViewerLabels } from './labels.mjs';
 export { VIEWER_LABELS, DEFAULT_LABELS, type ViewerLabels } from './labels.mjs';
 export type { PageFinder, PageRequest } from './related.mjs';
-/** Fill a slot with the app's own content. Return a function to clean up. */
-export type SlotRenderer = (element: HTMLElement, context: {
+/**
+ * Fill a slot with the app's own content. Return a function to clean up. A slot drawn from parts loaded on first use
+ * (a work item's Discussion: parts.ts in @fieldia/widgets) names them in `parts`: the page is drawn once they are in.
+ */
+export type SlotRenderer = ((element: HTMLElement, context: {
     form: Form;
     name: string;
-}) => void | (() => void);
+}) => void | (() => void)) & {
+    readonly parts?: readonly Part[];
+};
 export interface ViewerOptions extends Omit<FormOptions, 'page' | 'host'> {
     page: Page;
     /** A form made elsewhere, to share one record between two views. */
@@ -101,8 +106,13 @@ export interface ViewerOptions extends Omit<FormOptions, 'page' | 'host'> {
      * key: every word of the page goes through it. Record data never does.
      */
     translate?: (text: string) => string;
-    /** A list page: a row was opened, by a click or by Enter. The app shows the record. */
-    onOpenRecord?: (id: RecordId) => void;
+    /**
+     * A list page: a row was opened, by a click or by Enter. The app shows the
+     * record. When it answers with a promise — the record in a dialog, closed —
+     * the list asks for its records again once it settles, and puts the focus
+     * back on the row. Anything else it answers is let be.
+     */
+    onOpenRecord?: (id: RecordId) => unknown;
     /** A list page: only the records these conditions let through, whatever is searched — the invoices of one order, opened from it. */
     listFilter?: ResolvedFilter[];
     /**
@@ -150,12 +160,25 @@ export interface ViewerHandle {
     /** Lock or unlock the whole form. */
     setReadonly(readonly: boolean): void;
     isReadonly(): boolean;
+    /** Ask the data source again: a list page's records, keeping its page, order and search; else the record, as a reload step does. */
+    reload(): Promise<void>;
+    /**
+     * A list page: open a record as its row's press does — the app's onOpenRecord, the row marked open (aria-current) while
+     * it is, then the records again and the focus back on its row — as when the app opens one from its address; there
+     * `{ lit: false }` leaves its row unmarked, as no row was pressed. A record page has no rows: nothing happens.
+     */
+    openRecord(id: RecordId, options?: OpenRowOptions): Promise<void>;
     /** Listen to one of the form's events — change, save, send, action, run, step, open; returns what stops listening. */
     on<E extends keyof FormEvents>(event: E, listener: (event: FormEvents[E]) => void): () => void;
     /** Write several fields at once, as the app: the page's change steps do not run for it. */
     setValues(values: Values): void;
     /** Run steps on the form, as a button would. */
     run(steps: readonly ActionStep[], context?: RunContext): Promise<RunResult>;
+    /**
+     * Settled once the page is drawn: at once, unless it draws from a part not loaded yet (a record's head, a filter bar, a
+     * work item's text, a path picker: parts.ts), which it waits for — its element empty and busy meanwhile.
+     */
+    readonly drawn: Promise<void>;
     destroy(): void;
 }
 /**

package/src/lib/viewer.d.ts

@@ -1,7 +1,7 @@
 import { type ActionHost, type ActionStep, type FormEvents, type Form, type FormOptions, type LayoutNode, type Page, type Skin, type Theme, type RecordId, type ResolvedFilter, type Locale, type OpenRequest, type OpenResult, type RunContext, type RunResult, type Values } from '@fieldia/core';
-import { type IconSet, type PreferenceStore, type WidgetFactory } from '@fieldia/widgets';
+import { type IconSet, type Part, type PreferenceStore, type WidgetFactory } from '@fieldia/widgets';
 import { type PageFinder } from './related';
-import { type ListViewFactory } from './list';
+import { type ListViewFactory, type OpenRowOptions } from './list';
 import type { MapPartFactory } from './map-part';
 import { type Tokens } from './look';
 import { type Breadcrumb, type RecordPager } from './record-bar';
@@ -11,11 +11,16 @@ export type { Skin };
 import { type ViewerLabels } from './labels';
 export { VIEWER_LABELS, DEFAULT_LABELS, type ViewerLabels } from './labels';
 export type { PageFinder, PageRequest } from './related';
-/** Fill a slot with the app's own content. Return a function to clean up. */
-export type SlotRenderer = (element: HTMLElement, context: {
+/**
+ * Fill a slot with the app's own content. Return a function to clean up. A slot drawn from parts loaded on first use
+ * (a work item's Discussion: parts.ts in @fieldia/widgets) names them in `parts`: the page is drawn once they are in.
+ */
+export type SlotRenderer = ((element: HTMLElement, context: {
     form: Form;
     name: string;
-}) => void | (() => void);
+}) => void | (() => void)) & {
+    readonly parts?: readonly Part[];
+};
 export interface ViewerOptions extends Omit<FormOptions, 'page' | 'host'> {
     page: Page;
     /** A form made elsewhere, to share one record between two views. */
@@ -101,8 +106,13 @@ export interface ViewerOptions extends Omit<FormOptions, 'page' | 'host'> {
      * key: every word of the page goes through it. Record data never does.
      */
     translate?: (text: string) => string;
-    /** A list page: a row was opened, by a click or by Enter. The app shows the record. */
-    onOpenRecord?: (id: RecordId) => void;
+    /**
+     * A list page: a row was opened, by a click or by Enter. The app shows the
+     * record. When it answers with a promise — the record in a dialog, closed —
+     * the list asks for its records again once it settles, and puts the focus
+     * back on the row. Anything else it answers is let be.
+     */
+    onOpenRecord?: (id: RecordId) => unknown;
     /** A list page: only the records these conditions let through, whatever is searched — the invoices of one order, opened from it. */
     listFilter?: ResolvedFilter[];
     /**
@@ -150,12 +160,25 @@ export interface ViewerHandle {
     /** Lock or unlock the whole form. */
     setReadonly(readonly: boolean): void;
     isReadonly(): boolean;
+    /** Ask the data source again: a list page's records, keeping its page, order and search; else the record, as a reload step does. */
+    reload(): Promise<void>;
+    /**
+     * A list page: open a record as its row's press does — the app's onOpenRecord, the row marked open (aria-current) while
+     * it is, then the records again and the focus back on its row — as when the app opens one from its address; there
+     * `{ lit: false }` leaves its row unmarked, as no row was pressed. A record page has no rows: nothing happens.
+     */
+    openRecord(id: RecordId, options?: OpenRowOptions): Promise<void>;
     /** Listen to one of the form's events — change, save, send, action, run, step, open; returns what stops listening. */
     on<E extends keyof FormEvents>(event: E, listener: (event: FormEvents[E]) => void): () => void;
     /** Write several fields at once, as the app: the page's change steps do not run for it. */
     setValues(values: Values): void;
     /** Run steps on the form, as a button would. */
     run(steps: readonly ActionStep[], context?: RunContext): Promise<RunResult>;
+    /**
+     * Settled once the page is drawn: at once, unless it draws from a part not loaded yet (a record's head, a filter bar, a
+     * work item's text, a path picker: parts.ts), which it waits for — its element empty and busy meanwhile.
+     */
+    readonly drawn: Promise<void>;
     destroy(): void;
 }
 /**