@fieldia/designer 0.0.0-stage → 0.12.0

package/src/lib/shortcuts-list.d.mts

@@ -0,0 +1,24 @@
+import type { DesignerWords } from './designer-words.mjs';
+/**
+ * Every key the designer answers, for the sheet of shortcuts: one list,
+ * taken from where each set of keys is documented — the canvas's in
+ * canvas-keys.ts, the outline's in outline-keys.ts, the clipboard's in
+ * clipboard-keys.ts — and the editors' own here. Written as on a Mac;
+ * `forPlatform` turns ⌘ into Ctrl elsewhere.
+ */
+export type KeyRow = [keys: string, what: string];
+export interface KeyGroup {
+    name: 'Anywhere' | 'Canvas' | 'Outline' | 'Typing';
+    /** Its name as the sheet heads it, in the designer's words. */
+    title: string;
+    /** When the group's keys work, if not always. */
+    when?: string;
+    keys: KeyRow[];
+}
+/** The groups of keys for a survey's editor, or a screen's. */
+export declare function shortcutGroups(options: {
+    survey: boolean;
+    words?: DesignerWords;
+}): KeyGroup[];
+/** Keys and words as this computer has them: ⌘ and ⌥ on a Mac, Ctrl and Alt elsewhere; the other's words dropped. */
+export declare function forPlatform(text: string, mac: boolean): string;

package/src/lib/shortcuts-list.d.ts

@@ -0,0 +1,24 @@
+import type { DesignerWords } from './designer-words';
+/**
+ * Every key the designer answers, for the sheet of shortcuts: one list,
+ * taken from where each set of keys is documented — the canvas's in
+ * canvas-keys.ts, the outline's in outline-keys.ts, the clipboard's in
+ * clipboard-keys.ts — and the editors' own here. Written as on a Mac;
+ * `forPlatform` turns ⌘ into Ctrl elsewhere.
+ */
+export type KeyRow = [keys: string, what: string];
+export interface KeyGroup {
+    name: 'Anywhere' | 'Canvas' | 'Outline' | 'Typing';
+    /** Its name as the sheet heads it, in the designer's words. */
+    title: string;
+    /** When the group's keys work, if not always. */
+    when?: string;
+    keys: KeyRow[];
+}
+/** The groups of keys for a survey's editor, or a screen's. */
+export declare function shortcutGroups(options: {
+    survey: boolean;
+    words?: DesignerWords;
+}): KeyGroup[];
+/** Keys and words as this computer has them: ⌘ and ⌥ on a Mac, Ctrl and Alt elsewhere; the other's words dropped. */
+export declare function forPlatform(text: string, mac: boolean): string;

package/src/lib/shortcuts-list.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shortcutGroups = shortcutGroups;
+exports.forPlatform = forPlatform;
+const en_1 = require("./locales/en");
+/** The groups of keys for a survey's editor, or a screen's. */
+function shortcutGroups(options) {
+    const words = options.words ?? en_1.en;
+    const w = words.shortcuts;
+    const group = (name, keys) => ({ name, title: w.groups[name], when: w.when[name], keys });
+    return [
+        group('Anywhere', [...w.anywhere.slice(0, 4), ...words.clipboard.keys, ...w.anywhere.slice(4)]),
+        ...(options.survey ? [] : [group('Canvas', words.canvas.keys)]),
+        group('Outline', words.outline.keys),
+        group('Typing', options.survey ? [...w.typing, ...w.surveyTyping] : w.typing),
+    ];
+}
+/** Keys and words as this computer has them: ⌘ and ⌥ on a Mac, Ctrl and Alt elsewhere; the other's words dropped. */
+function forPlatform(text, mac) {
+    const own = text.replace(/\s*\([^)]*(?:on Windows|في ويندوز)\)/g, '');
+    if (mac)
+        return own.replace(/Alt\+/g, '⌥').replace(/Shift\+/g, '⇧');
+    return own.replace(/⌘⇧/g, 'Ctrl+Shift+').replace(/⌘-/g, 'Ctrl-').replace(/⌘ \+/g, 'Ctrl +').replace(/⌘/g, 'Ctrl+').replace(/⇧/g, 'Shift+');
+}
+//# sourceMappingURL=shortcuts-list.js.map

package/src/lib/shortcuts-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts-list.js","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/shortcuts-list.ts"],"names":[],"mappings":";;AAuBA,wCAUC;AAGD,kCAIC;AAvCD,qCAAkC;AAqBlC,+DAA+D;AAC/D,SAAgB,cAAc,CAAC,OAAmD;IAChF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAE,CAAC;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,KAAK,GAAG,CAAC,IAAsB,EAAE,IAAc,EAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAChI,OAAO;QACL,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/F,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACpC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;KAC9E,CAAC;AACJ,CAAC;AAED,qHAAqH;AACrH,SAAgB,WAAW,CAAC,IAAY,EAAE,GAAY;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;IACtE,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7I,CAAC"}

package/src/lib/shortcuts-list.mjs

@@ -0,0 +1,21 @@
+import { en } from './locales/en/index.mjs';
+/** The groups of keys for a survey's editor, or a screen's. */
+export function shortcutGroups(options) {
+    const words = options.words ?? en;
+    const w = words.shortcuts;
+    const group = (name, keys) => ({ name, title: w.groups[name], when: w.when[name], keys });
+    return [
+        group('Anywhere', [...w.anywhere.slice(0, 4), ...words.clipboard.keys, ...w.anywhere.slice(4)]),
+        ...(options.survey ? [] : [group('Canvas', words.canvas.keys)]),
+        group('Outline', words.outline.keys),
+        group('Typing', options.survey ? [...w.typing, ...w.surveyTyping] : w.typing),
+    ];
+}
+/** Keys and words as this computer has them: ⌘ and ⌥ on a Mac, Ctrl and Alt elsewhere; the other's words dropped. */
+export function forPlatform(text, mac) {
+    const own = text.replace(/\s*\([^)]*(?:on Windows|في ويندوز)\)/g, '');
+    if (mac)
+        return own.replace(/Alt\+/g, '⌥').replace(/Shift\+/g, '⇧');
+    return own.replace(/⌘⇧/g, 'Ctrl+Shift+').replace(/⌘-/g, 'Ctrl-').replace(/⌘ \+/g, 'Ctrl +').replace(/⌘/g, 'Ctrl+').replace(/⇧/g, 'Shift+');
+}
+//# sourceMappingURL=shortcuts-list.mjs.map

package/src/lib/shortcuts-list.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts-list.mjs","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/shortcuts-list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAqBlC,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,OAAmD;IAChF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,KAAK,GAAG,CAAC,IAAsB,EAAE,IAAc,EAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAChI,OAAO;QACL,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/F,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACpC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;KAC9E,CAAC;AACJ,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAY;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;IACtE,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7I,CAAC"}

package/src/lib/shortcuts-sheet.d.mts

@@ -0,0 +1,27 @@
+import type { ElementFactory } from './chrome.mjs';
+import type { DesignerWords } from './designer-words.mjs';
+import type { FindItem } from './find-anything.mjs';
+/**
+ * The sheet of shortcuts: “?” pressed outside a box, or “Keyboard shortcuts”
+ * in Find anything, opens a dialog of every key the editor answers, in
+ * groups (shortcuts-list.ts), with a box to find one by its words. Keys show
+ * as this computer has them: ⌘ on a Mac, Ctrl elsewhere. Escape, its button
+ * or the room round it closes it, and the keyboard goes back where it was.
+ */
+export interface ShortcutKeysOptions {
+    el: ElementFactory;
+    /** The editor: the sheet opens over it, and “?” counts only in it. */
+    root: HTMLElement;
+    survey: boolean;
+    /** The designer's words: English unless given. */
+    words?: DesignerWords;
+    /** Whether the editor is designing: not while trying the form, or writing JSON. */
+    active(): boolean;
+}
+export interface ShortcutKeys {
+    /** For Find anything. */
+    items(): FindItem[];
+    open(): void;
+    destroy(): void;
+}
+export declare function shortcutKeys(options: ShortcutKeysOptions): ShortcutKeys;

package/src/lib/shortcuts-sheet.d.ts

@@ -0,0 +1,27 @@
+import type { ElementFactory } from './chrome';
+import type { DesignerWords } from './designer-words';
+import type { FindItem } from './find-anything';
+/**
+ * The sheet of shortcuts: “?” pressed outside a box, or “Keyboard shortcuts”
+ * in Find anything, opens a dialog of every key the editor answers, in
+ * groups (shortcuts-list.ts), with a box to find one by its words. Keys show
+ * as this computer has them: ⌘ on a Mac, Ctrl elsewhere. Escape, its button
+ * or the room round it closes it, and the keyboard goes back where it was.
+ */
+export interface ShortcutKeysOptions {
+    el: ElementFactory;
+    /** The editor: the sheet opens over it, and “?” counts only in it. */
+    root: HTMLElement;
+    survey: boolean;
+    /** The designer's words: English unless given. */
+    words?: DesignerWords;
+    /** Whether the editor is designing: not while trying the form, or writing JSON. */
+    active(): boolean;
+}
+export interface ShortcutKeys {
+    /** For Find anything. */
+    items(): FindItem[];
+    open(): void;
+    destroy(): void;
+}
+export declare function shortcutKeys(options: ShortcutKeysOptions): ShortcutKeys;

package/src/lib/shortcuts-sheet.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shortcutKeys = shortcutKeys;
+const en_1 = require("./locales/en");
+const icons_1 = require("./icons");
+const shortcuts_list_1 = require("./shortcuts-list");
+let count = 0;
+/** Keys as boxes to read, and the words between them (“/”, “or”, “أو”) as words. */
+function keyBoxes(el, keys) {
+    return keys.split(/( \/ | or | أو )/).map((part) => (/^( \/ | or | أو )$/.test(part) || / /.test(part) ? part : el('kbd', {}, part)));
+}
+function shortcutKeys(options) {
+    const { el, root } = options;
+    const words = options.words ?? en_1.en;
+    const w = words.shortcuts;
+    const doc = root.ownerDocument;
+    const mac = /Mac|iPhone|iPad/.test(doc.defaultView?.navigator.platform ?? '');
+    let close = null;
+    function open() {
+        if (close)
+            return;
+        const opener = doc.activeElement;
+        const id = `fd-keys-${++count}`;
+        const find = el('input', { class: 'fd-keys-find', type: 'search', 'aria-label': w.findKey, placeholder: w.findPlaceholder, autocomplete: 'off', spellcheck: 'false' });
+        const shut = el('button', { type: 'button', class: 'fd-keys-close', 'aria-label': w.close, title: w.close }, (0, icons_1.designerIcon)(doc, 'plus'));
+        const rows = [];
+        const groups = (0, shortcuts_list_1.shortcutGroups)({ survey: options.survey, words }).map((group) => {
+            const heading = `${id}-${group.name.toLowerCase()}`;
+            const list = el('dl', {}, ...group.keys.map(([keys, what]) => {
+                const shown = (0, shortcuts_list_1.forPlatform)(keys, mac);
+                const said = (0, shortcuts_list_1.forPlatform)(what, mac);
+                const row = el('div', { class: 'fd-keys-row' }, el('dt', {}, ...keyBoxes(el, shown)), el('dd', {}, said));
+                rows.push({ row, words: `${shown} ${said} ${group.title}`.toLowerCase() });
+                return row;
+            }));
+            return el('section', { class: 'fd-keys-group', 'aria-labelledby': heading }, el('h3', { id: heading }, group.title), ...(group.when ? [el('p', { class: 'fd-keys-when' }, group.when)] : []), list);
+        });
+        const none = el('p', { class: 'fd-keys-none', hidden: '' }, w.none);
+        const dialog = el('div', { class: 'fd-keys', role: 'dialog', 'aria-modal': 'true', 'aria-labelledby': `${id}-title` }, el('div', { class: 'fd-keys-head' }, el('h2', { class: 'fd-keys-title', id: `${id}-title` }, w.title), shut), find, 
+        // A region the keyboard can scroll (WCAG 2.1.1): the keys are words to read, with nothing in them to focus.
+        el('div', { class: 'fd-keys-groups', role: 'region', 'aria-label': w.keys, tabindex: '0' }, ...groups), none);
+        const backdrop = el('div', { class: 'fd-dialog-backdrop fd-keys-backdrop' }, dialog);
+        find.addEventListener('input', () => {
+            const wanted = find.value.toLowerCase().split(/\s+/).filter(Boolean);
+            for (const { row, words: has } of rows)
+                row.hidden = !wanted.every((word) => has.includes(word));
+            for (const group of groups)
+                group.hidden = ![...group.querySelectorAll('.fd-keys-row')].some((row) => !row.hidden);
+            none.hidden = groups.some((group) => !group.hidden);
+        });
+        dialog.addEventListener('keydown', (event) => {
+            if (event.key === 'Escape') {
+                event.preventDefault();
+                event.stopPropagation();
+                close?.();
+            }
+            else if (event.key === 'Tab') {
+                // The keyboard stays in the sheet: its box and its button.
+                event.preventDefault();
+                (doc.activeElement === find ? shut : find).focus();
+            }
+        });
+        shut.addEventListener('click', () => close?.());
+        backdrop.addEventListener('pointerdown', (event) => event.target === backdrop && close?.());
+        close = () => {
+            backdrop.remove();
+            close = null;
+            opener?.focus?.();
+        };
+        root.append(backdrop);
+        find.focus();
+    }
+    // Before the editors' own keys: on the Advanced canvas, “?” would otherwise only show the canvas's.
+    const onKey = (event) => {
+        if (event.key !== '?' || event.ctrlKey || event.metaKey || event.altKey || close || !options.active())
+            return;
+        const target = event.target;
+        if (target !== doc.body && !root.contains(target))
+            return;
+        if (target.closest?.('input, textarea, select, [contenteditable]:not([contenteditable="false"])'))
+            return;
+        event.preventDefault();
+        open();
+    };
+    doc.addEventListener('keydown', onKey, true);
+    return {
+        items: () => [{ label: w.title, hint: '?', run: open }],
+        open,
+        destroy() {
+            close?.();
+            doc.removeEventListener('keydown', onKey, true);
+        },
+    };
+}
+//# sourceMappingURL=shortcuts-sheet.js.map

package/src/lib/shortcuts-sheet.js.map

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

package/src/lib/shortcuts-sheet.mjs

@@ -0,0 +1,92 @@
+import { en } from './locales/en/index.mjs';
+import { designerIcon } from './icons.mjs';
+import { forPlatform, shortcutGroups } from './shortcuts-list.mjs';
+let count = 0;
+/** Keys as boxes to read, and the words between them (“/”, “or”, “أو”) as words. */
+function keyBoxes(el, keys) {
+    return keys.split(/( \/ | or | أو )/).map((part) => (/^( \/ | or | أو )$/.test(part) || / /.test(part) ? part : el('kbd', {}, part)));
+}
+export function shortcutKeys(options) {
+    const { el, root } = options;
+    const words = options.words ?? en;
+    const w = words.shortcuts;
+    const doc = root.ownerDocument;
+    const mac = /Mac|iPhone|iPad/.test(doc.defaultView?.navigator.platform ?? '');
+    let close = null;
+    function open() {
+        if (close)
+            return;
+        const opener = doc.activeElement;
+        const id = `fd-keys-${++count}`;
+        const find = el('input', { class: 'fd-keys-find', type: 'search', 'aria-label': w.findKey, placeholder: w.findPlaceholder, autocomplete: 'off', spellcheck: 'false' });
+        const shut = el('button', { type: 'button', class: 'fd-keys-close', 'aria-label': w.close, title: w.close }, designerIcon(doc, 'plus'));
+        const rows = [];
+        const groups = shortcutGroups({ survey: options.survey, words }).map((group) => {
+            const heading = `${id}-${group.name.toLowerCase()}`;
+            const list = el('dl', {}, ...group.keys.map(([keys, what]) => {
+                const shown = forPlatform(keys, mac);
+                const said = forPlatform(what, mac);
+                const row = el('div', { class: 'fd-keys-row' }, el('dt', {}, ...keyBoxes(el, shown)), el('dd', {}, said));
+                rows.push({ row, words: `${shown} ${said} ${group.title}`.toLowerCase() });
+                return row;
+            }));
+            return el('section', { class: 'fd-keys-group', 'aria-labelledby': heading }, el('h3', { id: heading }, group.title), ...(group.when ? [el('p', { class: 'fd-keys-when' }, group.when)] : []), list);
+        });
+        const none = el('p', { class: 'fd-keys-none', hidden: '' }, w.none);
+        const dialog = el('div', { class: 'fd-keys', role: 'dialog', 'aria-modal': 'true', 'aria-labelledby': `${id}-title` }, el('div', { class: 'fd-keys-head' }, el('h2', { class: 'fd-keys-title', id: `${id}-title` }, w.title), shut), find, 
+        // A region the keyboard can scroll (WCAG 2.1.1): the keys are words to read, with nothing in them to focus.
+        el('div', { class: 'fd-keys-groups', role: 'region', 'aria-label': w.keys, tabindex: '0' }, ...groups), none);
+        const backdrop = el('div', { class: 'fd-dialog-backdrop fd-keys-backdrop' }, dialog);
+        find.addEventListener('input', () => {
+            const wanted = find.value.toLowerCase().split(/\s+/).filter(Boolean);
+            for (const { row, words: has } of rows)
+                row.hidden = !wanted.every((word) => has.includes(word));
+            for (const group of groups)
+                group.hidden = ![...group.querySelectorAll('.fd-keys-row')].some((row) => !row.hidden);
+            none.hidden = groups.some((group) => !group.hidden);
+        });
+        dialog.addEventListener('keydown', (event) => {
+            if (event.key === 'Escape') {
+                event.preventDefault();
+                event.stopPropagation();
+                close?.();
+            }
+            else if (event.key === 'Tab') {
+                // The keyboard stays in the sheet: its box and its button.
+                event.preventDefault();
+                (doc.activeElement === find ? shut : find).focus();
+            }
+        });
+        shut.addEventListener('click', () => close?.());
+        backdrop.addEventListener('pointerdown', (event) => event.target === backdrop && close?.());
+        close = () => {
+            backdrop.remove();
+            close = null;
+            opener?.focus?.();
+        };
+        root.append(backdrop);
+        find.focus();
+    }
+    // Before the editors' own keys: on the Advanced canvas, “?” would otherwise only show the canvas's.
+    const onKey = (event) => {
+        if (event.key !== '?' || event.ctrlKey || event.metaKey || event.altKey || close || !options.active())
+            return;
+        const target = event.target;
+        if (target !== doc.body && !root.contains(target))
+            return;
+        if (target.closest?.('input, textarea, select, [contenteditable]:not([contenteditable="false"])'))
+            return;
+        event.preventDefault();
+        open();
+    };
+    doc.addEventListener('keydown', onKey, true);
+    return {
+        items: () => [{ label: w.title, hint: '?', run: open }],
+        open,
+        destroy() {
+            close?.();
+            doc.removeEventListener('keydown', onKey, true);
+        },
+    };
+}
+//# sourceMappingURL=shortcuts-sheet.mjs.map

package/src/lib/shortcuts-sheet.mjs.map

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

package/src/lib/shown-while.d.mts

@@ -0,0 +1,16 @@
+import type { Page } from '@fieldia/core';
+import type { ElementFactory } from './chrome.mjs';
+import type { Designer } from './designer.mjs';
+import type { PanelTab } from './panel-tabs.mjs';
+/**
+ * "Shown while": a part for editing only — a button beside the name, a
+ * warning — or for reading only, as Flectra's oe_edit_only and oe_read_only;
+ * or always. A form that is always being edited shows its editing parts.
+ */
+export declare function shownWhileSetting(el: ElementFactory, designer: Designer, id: string, options?: {
+    tab?: PanelTab;
+    tabbed?: boolean;
+}): {
+    element: HTMLElement;
+    update(page: Page): void;
+};

package/src/lib/shown-while.d.ts

@@ -0,0 +1,16 @@
+import type { Page } from '@fieldia/core';
+import type { ElementFactory } from './chrome';
+import type { Designer } from './designer';
+import type { PanelTab } from './panel-tabs';
+/**
+ * "Shown while": a part for editing only — a button beside the name, a
+ * warning — or for reading only, as Flectra's oe_edit_only and oe_read_only;
+ * or always. A form that is always being edited shows its editing parts.
+ */
+export declare function shownWhileSetting(el: ElementFactory, designer: Designer, id: string, options?: {
+    tab?: PanelTab;
+    tabbed?: boolean;
+}): {
+    element: HTMLElement;
+    update(page: Page): void;
+};

package/src/lib/shown-while.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shownWhileSetting = shownWhileSetting;
+const conditions_1 = require("./conditions");
+const header_commands_1 = require("./header-commands");
+const panel_controls_1 = require("./panel-controls");
+const page_tree_1 = require("./page-tree");
+/**
+ * "Shown while": a part for editing only — a button beside the name, a
+ * warning — or for reading only, as Flectra's oe_edit_only and oe_read_only;
+ * or always. A form that is always being edited shows its editing parts.
+ */
+function shownWhileSetting(el, designer, id, options = {}) {
+    const w = designer.words.rulesUi;
+    const choice = (0, panel_controls_1.segmented)(el, w.shownWhile, ['always', 'editing', 'reading'].map((value) => ({ value, words: w.shownWhileWays[value] })), (value) => value && designer.setShownWhile(id, value));
+    const element = (0, panel_controls_1.setting)(el, options.tab ?? 'rules', 'Shown while', choice.element, { hint: w.shownWhileHint, words: w.shownWhile });
+    if (options.tabbed === false)
+        element.removeAttribute('data-tab');
+    return {
+        element,
+        update(page) {
+            const part = ((0, page_tree_1.findContainer)(page, id) ?? (0, page_tree_1.findNode)(page, id)?.node ?? (0, header_commands_1.findHeaderPart)(page, id)?.part);
+            element.hidden = !part || part.invisible === true;
+            choice.set((0, conditions_1.splitShownWhile)(part?.invisible).mode);
+        },
+    };
+}
+//# sourceMappingURL=shown-while.js.map

package/src/lib/shown-while.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shown-while.js","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/shown-while.ts"],"names":[],"mappings":";;AAcA,8CAkBC;AA9BD,6CAAgE;AAEhE,uDAAmD;AACnD,qDAAsD;AAEtD,2CAAsD;AAEtD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,EAAkB,EAAE,QAAkB,EAAE,EAAU,EAAE,UAAgD,EAAE;IACtI,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;IACjC,MAAM,MAAM,GAAG,IAAA,0BAAS,EACtB,EAAE,EACF,CAAC,CAAC,UAAU,EACX,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EACvG,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,CACtD,CAAC;IACF,MAAM,OAAO,GAAG,IAAA,wBAAO,EAAC,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACpI,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAClE,OAAO;QACL,OAAO;QACP,MAAM,CAAC,IAAI;YACT,MAAM,IAAI,GAAG,CAAC,IAAA,yBAAa,EAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAA,oBAAQ,EAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,IAAA,gCAAc,EAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAA+C,CAAC;YACnJ,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,IAAA,4BAAe,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/src/lib/shown-while.mjs

@@ -0,0 +1,25 @@
+import { splitShownWhile } from './conditions.mjs';
+import { findHeaderPart } from './header-commands.mjs';
+import { segmented, setting } from './panel-controls.mjs';
+import { findContainer, findNode } from './page-tree.mjs';
+/**
+ * "Shown while": a part for editing only — a button beside the name, a
+ * warning — or for reading only, as Flectra's oe_edit_only and oe_read_only;
+ * or always. A form that is always being edited shows its editing parts.
+ */
+export function shownWhileSetting(el, designer, id, options = {}) {
+    const w = designer.words.rulesUi;
+    const choice = segmented(el, w.shownWhile, ['always', 'editing', 'reading'].map((value) => ({ value, words: w.shownWhileWays[value] })), (value) => value && designer.setShownWhile(id, value));
+    const element = setting(el, options.tab ?? 'rules', 'Shown while', choice.element, { hint: w.shownWhileHint, words: w.shownWhile });
+    if (options.tabbed === false)
+        element.removeAttribute('data-tab');
+    return {
+        element,
+        update(page) {
+            const part = (findContainer(page, id) ?? findNode(page, id)?.node ?? findHeaderPart(page, id)?.part);
+            element.hidden = !part || part.invisible === true;
+            choice.set(splitShownWhile(part?.invisible).mode);
+        },
+    };
+}
+//# sourceMappingURL=shown-while.mjs.map

package/src/lib/shown-while.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shown-while.mjs","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/shown-while.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAmB,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAkB,EAAE,QAAkB,EAAE,EAAU,EAAE,UAAgD,EAAE;IACtI,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;IACjC,MAAM,MAAM,GAAG,SAAS,CACtB,EAAE,EACF,CAAC,CAAC,UAAU,EACX,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EACvG,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,CACtD,CAAC;IACF,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACpI,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAClE,OAAO;QACL,OAAO;QACP,MAAM,CAAC,IAAI;YACT,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAA+C,CAAC;YACnJ,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,33 @@
+import type { Page, PageIssue } from '@fieldia/core';
+import type { DesignerWords } from './designer-words.mjs';
+import type { PageCheck } from './page-checks.mjs';
+import { type StepPath, type StepsPlace } from './steps-places.mjs';
+/**
+ * What would trip people up in what the page's parts do, each with a fix
+ * where there is an obvious one: a step that names or reads a field no
+ * longer on the page, a field's change steps once the field has gone, and —
+ * on a page written by hand — each problem the page's own check finds in its
+ * steps, said by the part and the step it is in. The page's own check is not
+ * said again for what these say.
+ */
+/** Take a step away, or all of a place's. */
+export type StepFix = {
+    kind: 'remove-step';
+    place: StepsPlace;
+    path: StepPath;
+} | {
+    kind: 'remove-steps';
+    place: StepsPlace;
+};
+/** What a fix needs of the designer. */
+export interface StepFixer {
+    removeStep(place: StepsPlace, path: StepPath): boolean;
+    setSteps(place: StepsPlace, steps: []): boolean;
+}
+export declare function fixStepCheck(designer: StepFixer, fix: StepFix): boolean;
+export declare function stepChecks(page: Page, issues: readonly PageIssue[], words?: DesignerWords): {
+    checks: PageCheck[];
+    covers(path: string): boolean;
+};
+/** What changed in what the page's parts do, from one version to the next, in words: a list each, by its part. */
+export declare function stepChanges(before: Page, after: Page, words?: DesignerWords): string[];

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

@@ -0,0 +1,33 @@
+import type { Page, PageIssue } from '@fieldia/core';
+import type { DesignerWords } from './designer-words';
+import type { PageCheck } from './page-checks';
+import { type StepPath, type StepsPlace } from './steps-places';
+/**
+ * What would trip people up in what the page's parts do, each with a fix
+ * where there is an obvious one: a step that names or reads a field no
+ * longer on the page, a field's change steps once the field has gone, and —
+ * on a page written by hand — each problem the page's own check finds in its
+ * steps, said by the part and the step it is in. The page's own check is not
+ * said again for what these say.
+ */
+/** Take a step away, or all of a place's. */
+export type StepFix = {
+    kind: 'remove-step';
+    place: StepsPlace;
+    path: StepPath;
+} | {
+    kind: 'remove-steps';
+    place: StepsPlace;
+};
+/** What a fix needs of the designer. */
+export interface StepFixer {
+    removeStep(place: StepsPlace, path: StepPath): boolean;
+    setSteps(place: StepsPlace, steps: []): boolean;
+}
+export declare function fixStepCheck(designer: StepFixer, fix: StepFix): boolean;
+export declare function stepChecks(page: Page, issues: readonly PageIssue[], words?: DesignerWords): {
+    checks: PageCheck[];
+    covers(path: string): boolean;
+};
+/** What changed in what the page's parts do, from one version to the next, in words: a list each, by its part. */
+export declare function stepChanges(before: Page, after: Page, words?: DesignerWords): string[];