@fieldia/designer 0.0.0-stage → 0.11.0

package/src/lib/outline-drop.mjs

@@ -0,0 +1,50 @@
+/** The share of a row's height, from the top and from the bottom, that puts a part before or after a row that holds parts. */
+const EDGE = 0.3;
+/**
+ * Where a part goes, let go over the row at `over` of the rows on show, at
+ * `fraction` of its height, the pointer `wanted` levels in. `root` is the
+ * page's own list; `takes` says whether a parent takes what is moved.
+ */
+export function dropSpot(rows, root, over, fraction, wanted, folded, takes) {
+    const row = rows[over];
+    if (!row)
+        return null;
+    if (row.holds && fraction >= EDGE && fraction <= 1 - EDGE && takes(row.id)) {
+        return { parent: row.id, index: row.children, level: row.level + 1, gap: -1, into: row.id };
+    }
+    // Its top half puts it before the row, its bottom half after.
+    return inGap(rows, root, over + (fraction >= 0.5 ? 1 : 0), wanted, folded, takes);
+}
+/** A part let go in the gap before the row at `gap`, at the depth nearest `wanted` that takes it. */
+function inGap(rows, root, gap, wanted, folded, takes) {
+    const prev = rows[gap - 1];
+    const next = rows[gap];
+    // Under a row that holds parts, open (or holding none yet), it can go in as its first part.
+    const deepest = prev ? prev.level + (prev.holds && (prev.children === 0 || !folded.has(prev.id)) ? 1 : 0) : 0;
+    const shallowest = Math.min(next ? next.level : 0, deepest);
+    const asked = Math.max(shallowest, Math.min(deepest, wanted));
+    const spot = (level) => {
+        let parent = root;
+        for (let at = gap - 1; level > 0 && at >= 0; at--) {
+            if (rows[at].level === level - 1) {
+                parent = rows[at].id;
+                break;
+            }
+        }
+        const own = level === 0 ? null : parent;
+        const index = rows.slice(0, Math.max(0, gap)).filter((r) => r.parent === own && r.movable).length;
+        return { parent, index, level, gap };
+    };
+    // The depth asked for, then the ones next to it, nearer first.
+    for (let step = 0; step <= deepest - shallowest; step++) {
+        for (const level of [asked - step, asked + step]) {
+            if (level < shallowest || level > deepest)
+                continue;
+            const found = spot(level);
+            if (takes(found.parent))
+                return found;
+        }
+    }
+    return spot(asked);
+}
+//# sourceMappingURL=outline-drop.mjs.map

package/src/lib/outline-drop.mjs.map

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

package/src/lib/outline-key-moves.d.mts

@@ -0,0 +1,26 @@
+import type { Page } from '@fieldia/core';
+import type { DesignerWords } from './designer-words.mjs';
+/**
+ * Moving the rows picked in the outline from the keyboard, in reading order:
+ *
+ *  Alt+↑ / Alt+↓   before the part above them, or after the part below, in
+ *                  their own list — out of an arrangement at its edge, and on
+ *                  to the page before or after for a survey's question;
+ *  Alt+←           out of their group, after it (out of a tab, after its tabs);
+ *  Alt+→           into the group just before them, at its end (into the
+ *                  last tab of tabs);
+ *
+ * mirrored right to left. No DOM, and no edit: it says where they would go,
+ * as a place for `moveParts`, or in words why they cannot.
+ */
+export type KeyPlace = {
+    parent: string;
+    index: number;
+} | {
+    said: string;
+};
+/** Where Alt and an arrow would take the parts; null when the key is not one of these. */
+export declare function outlineKeyMove(page: Page, ids: string[], key: {
+    key: string;
+    altKey: boolean;
+}, rtl: boolean, words?: DesignerWords): KeyPlace | null;

package/src/lib/outline-key-moves.d.ts

@@ -0,0 +1,26 @@
+import type { Page } from '@fieldia/core';
+import type { DesignerWords } from './designer-words';
+/**
+ * Moving the rows picked in the outline from the keyboard, in reading order:
+ *
+ *  Alt+↑ / Alt+↓   before the part above them, or after the part below, in
+ *                  their own list — out of an arrangement at its edge, and on
+ *                  to the page before or after for a survey's question;
+ *  Alt+←           out of their group, after it (out of a tab, after its tabs);
+ *  Alt+→           into the group just before them, at its end (into the
+ *                  last tab of tabs);
+ *
+ * mirrored right to left. No DOM, and no edit: it says where they would go,
+ * as a place for `moveParts`, or in words why they cannot.
+ */
+export type KeyPlace = {
+    parent: string;
+    index: number;
+} | {
+    said: string;
+};
+/** Where Alt and an arrow would take the parts; null when the key is not one of these. */
+export declare function outlineKeyMove(page: Page, ids: string[], key: {
+    key: string;
+    altKey: boolean;
+}, rtl: boolean, words?: DesignerWords): KeyPlace | null;

package/src/lib/outline-key-moves.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.outlineKeyMove = outlineKeyMove;
+const layout_tree_1 = require("./layout-tree");
+const en_1 = require("./locales/en");
+const outline_moves_1 = require("./outline-moves");
+/** Where Alt and an arrow would take the parts; null when the key is not one of these. */
+function outlineKeyMove(page, ids, key, rtl, words = en_1.en) {
+    const w = words.outline;
+    if (!key.altKey || !ids.length || !['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'].includes(key.key))
+        return null;
+    // A part picked inside another part picked goes with it.
+    const outer = (0, outline_moves_1.partsInOrder)(page, ids);
+    if (!outer.length)
+        return null;
+    if (outer.some((s) => s.list !== outer[0].list))
+        return { said: w.sameGroup };
+    const { parent, list } = outer[0];
+    const indexes = outer.map((s) => s.index);
+    const first = Math.min(...indexes);
+    const last = Math.max(...indexes);
+    const one = outer.length === 1;
+    const root = page.layout;
+    const wizard = root.type === 'wizard';
+    const name = (holder) => (0, outline_moves_1.quoted)(page, holder, words);
+    const holderOf = (holder) => (0, layout_tree_1.locate)(page, holder.id);
+    if (key.key === 'ArrowUp' || key.key === 'ArrowDown') {
+        const down = key.key === 'ArrowDown';
+        if (down ? last < list.length - 1 : first > 0)
+            return { parent: parent.id, index: down ? last + 2 : first - 1 };
+        // At the edge of an arrangement — there only to lay parts out — they step out of it.
+        const around = (0, layout_tree_1.isWrapper)(parent) ? holderOf(parent) : null;
+        if (around)
+            return { parent: around.parent.id, index: around.index + (down ? 1 : 0) };
+        // A survey's question goes on to the next page, or back to the page before.
+        if (wizard && parent.id !== root.id) {
+            const steps = root.children;
+            const step = steps.findIndex((s) => s.id === parent.id);
+            const next = steps[step + (down ? 1 : -1)];
+            if (next)
+                return { parent: next.id, index: down ? 0 : next.children.length };
+            return { said: w.atEdgeOfSurvey(one, down ? 'bottom' : 'top') };
+        }
+        if (parent.id === root.id)
+            return { said: w.atEdgeOfPage(one, down ? 'bottom' : 'top') };
+        return { said: w.atEdgeOf(one, down ? 'bottom' : 'top', name(parent), rtl ? '→' : '←') };
+    }
+    const outward = (key.key === 'ArrowLeft') !== rtl;
+    if (outward) {
+        if (parent.id === root.id)
+            return { said: w.onPageItself(one) };
+        if (wizard && root.children.some((s) => s.id === parent.id))
+            return { said: w.questionOnPage };
+        if (parent.type === 'tabs')
+            return { said: w.tabAmongItsTabs };
+        // Out of a tab: after its tabs.
+        const from = parent.type === 'tab' ? (0, layout_tree_1.locate)(page, parent.id)?.parent : parent;
+        const around = holderOf(from);
+        if (!around)
+            return { said: w.onPageItself(one) };
+        return { parent: around.parent.id, index: around.index + 1 };
+    }
+    const before = list[first - 1];
+    const into = before?.type === 'tabs' ? before.children[before.children.length - 1] : before;
+    const inner = into ? (0, layout_tree_1.listOf)(into) : null;
+    if (!into || !inner)
+        return { said: w.noGroupBefore(one) };
+    return { parent: into.id, index: inner.length };
+}
+//# sourceMappingURL=outline-key-moves.js.map

package/src/lib/outline-key-moves.js.map

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

package/src/lib/outline-key-moves.mjs

@@ -0,0 +1,67 @@
+import { isWrapper, listOf, locate } from './layout-tree.mjs';
+import { en } from './locales/en/index.mjs';
+import { partsInOrder, quoted } from './outline-moves.mjs';
+/** Where Alt and an arrow would take the parts; null when the key is not one of these. */
+export function outlineKeyMove(page, ids, key, rtl, words = en) {
+    const w = words.outline;
+    if (!key.altKey || !ids.length || !['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'].includes(key.key))
+        return null;
+    // A part picked inside another part picked goes with it.
+    const outer = partsInOrder(page, ids);
+    if (!outer.length)
+        return null;
+    if (outer.some((s) => s.list !== outer[0].list))
+        return { said: w.sameGroup };
+    const { parent, list } = outer[0];
+    const indexes = outer.map((s) => s.index);
+    const first = Math.min(...indexes);
+    const last = Math.max(...indexes);
+    const one = outer.length === 1;
+    const root = page.layout;
+    const wizard = root.type === 'wizard';
+    const name = (holder) => quoted(page, holder, words);
+    const holderOf = (holder) => locate(page, holder.id);
+    if (key.key === 'ArrowUp' || key.key === 'ArrowDown') {
+        const down = key.key === 'ArrowDown';
+        if (down ? last < list.length - 1 : first > 0)
+            return { parent: parent.id, index: down ? last + 2 : first - 1 };
+        // At the edge of an arrangement — there only to lay parts out — they step out of it.
+        const around = isWrapper(parent) ? holderOf(parent) : null;
+        if (around)
+            return { parent: around.parent.id, index: around.index + (down ? 1 : 0) };
+        // A survey's question goes on to the next page, or back to the page before.
+        if (wizard && parent.id !== root.id) {
+            const steps = root.children;
+            const step = steps.findIndex((s) => s.id === parent.id);
+            const next = steps[step + (down ? 1 : -1)];
+            if (next)
+                return { parent: next.id, index: down ? 0 : next.children.length };
+            return { said: w.atEdgeOfSurvey(one, down ? 'bottom' : 'top') };
+        }
+        if (parent.id === root.id)
+            return { said: w.atEdgeOfPage(one, down ? 'bottom' : 'top') };
+        return { said: w.atEdgeOf(one, down ? 'bottom' : 'top', name(parent), rtl ? '→' : '←') };
+    }
+    const outward = (key.key === 'ArrowLeft') !== rtl;
+    if (outward) {
+        if (parent.id === root.id)
+            return { said: w.onPageItself(one) };
+        if (wizard && root.children.some((s) => s.id === parent.id))
+            return { said: w.questionOnPage };
+        if (parent.type === 'tabs')
+            return { said: w.tabAmongItsTabs };
+        // Out of a tab: after its tabs.
+        const from = parent.type === 'tab' ? locate(page, parent.id)?.parent : parent;
+        const around = holderOf(from);
+        if (!around)
+            return { said: w.onPageItself(one) };
+        return { parent: around.parent.id, index: around.index + 1 };
+    }
+    const before = list[first - 1];
+    const into = before?.type === 'tabs' ? before.children[before.children.length - 1] : before;
+    const inner = into ? listOf(into) : null;
+    if (!into || !inner)
+        return { said: w.noGroupBefore(one) };
+    return { parent: into.id, index: inner.length };
+}
+//# sourceMappingURL=outline-key-moves.mjs.map

package/src/lib/outline-key-moves.mjs.map

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

package/src/lib/outline-keys.d.mts

@@ -0,0 +1,49 @@
+/**
+ * The outline's keys, as a tree's (the WAI-ARIA tree pattern): ↑ and ↓ go
+ * from row to row, → unfolds a row and then goes to its first part, ← folds
+ * it and then goes to the row it sits in (mirrored right to left), Home and
+ * End go to the ends, and the first letters of a name go to it. Enter picks
+ * the row and shows it on the page; Space picks it, or with ⌘ or Ctrl adds
+ * it to what is picked. No DOM: the outline does what these say.
+ */
+/** What a key needs to know of a row on show. */
+export interface TreeRow {
+    id: string;
+    label: string;
+    level: number;
+    parent: string | null;
+    holds: boolean;
+    children: number;
+}
+export type TreeStep = 
+/** Go to the row at `to`; with `extend`, the pick reaches from where it began to there. */
+{
+    to: number;
+    extend: boolean;
+} | {
+    fold: string;
+} | {
+    unfold: string;
+}
+/** Pick the row on: alone, or added to (or let go from) what is picked; `reveal` shows it on the page. */
+ | {
+    pick: 'one' | 'toggle';
+    reveal: boolean;
+}
+/** A tree's key, with nowhere to go. */
+ | {
+    none: true;
+};
+type Keys = Pick<KeyboardEvent, 'key' | 'shiftKey' | 'ctrlKey' | 'metaKey' | 'altKey'>;
+/** What a key does on the row at `at` of the rows on show; null when it is not the tree's to answer. */
+export declare function treeKey(rows: readonly TreeRow[], at: number, event: Keys, rtl: boolean, folded: ReadonlySet<string>): TreeStep | null;
+/**
+ * The row the letters typed so far go to: the next whose name starts with
+ * them, from the one after the row on (round to the top) for a first letter,
+ * from the row on itself for more — so a name typed on stays where it is —
+ * and the same letter again goes round the rows starting with it. -1 for none.
+ */
+export declare function typeAhead(rows: readonly TreeRow[], at: number, typed: string): number;
+/** The outline's keys, as the sheet of shortcuts lists them (in the designer's words: `words.outline.keys`). */
+export declare const OUTLINE_KEYS: [string, string][];
+export {};

package/src/lib/outline-keys.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The outline's keys, as a tree's (the WAI-ARIA tree pattern): ↑ and ↓ go
+ * from row to row, → unfolds a row and then goes to its first part, ← folds
+ * it and then goes to the row it sits in (mirrored right to left), Home and
+ * End go to the ends, and the first letters of a name go to it. Enter picks
+ * the row and shows it on the page; Space picks it, or with ⌘ or Ctrl adds
+ * it to what is picked. No DOM: the outline does what these say.
+ */
+/** What a key needs to know of a row on show. */
+export interface TreeRow {
+    id: string;
+    label: string;
+    level: number;
+    parent: string | null;
+    holds: boolean;
+    children: number;
+}
+export type TreeStep = 
+/** Go to the row at `to`; with `extend`, the pick reaches from where it began to there. */
+{
+    to: number;
+    extend: boolean;
+} | {
+    fold: string;
+} | {
+    unfold: string;
+}
+/** Pick the row on: alone, or added to (or let go from) what is picked; `reveal` shows it on the page. */
+ | {
+    pick: 'one' | 'toggle';
+    reveal: boolean;
+}
+/** A tree's key, with nowhere to go. */
+ | {
+    none: true;
+};
+type Keys = Pick<KeyboardEvent, 'key' | 'shiftKey' | 'ctrlKey' | 'metaKey' | 'altKey'>;
+/** What a key does on the row at `at` of the rows on show; null when it is not the tree's to answer. */
+export declare function treeKey(rows: readonly TreeRow[], at: number, event: Keys, rtl: boolean, folded: ReadonlySet<string>): TreeStep | null;
+/**
+ * The row the letters typed so far go to: the next whose name starts with
+ * them, from the one after the row on (round to the top) for a first letter,
+ * from the row on itself for more — so a name typed on stays where it is —
+ * and the same letter again goes round the rows starting with it. -1 for none.
+ */
+export declare function typeAhead(rows: readonly TreeRow[], at: number, typed: string): number;
+/** The outline's keys, as the sheet of shortcuts lists them (in the designer's words: `words.outline.keys`). */
+export declare const OUTLINE_KEYS: [string, string][];
+export {};

package/src/lib/outline-keys.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OUTLINE_KEYS = void 0;
+exports.treeKey = treeKey;
+exports.typeAhead = typeAhead;
+const en_1 = require("./locales/en");
+/** What a key does on the row at `at` of the rows on show; null when it is not the tree's to answer. */
+function treeKey(rows, at, event, rtl, folded) {
+    if (event.altKey)
+        return null;
+    const mod = event.ctrlKey || event.metaKey;
+    if (event.key === ' ')
+        return { pick: mod ? 'toggle' : 'one', reveal: false };
+    if (mod)
+        return null;
+    const go = (to) => (to < 0 || to >= rows.length ? { none: true } : { to, extend: event.shiftKey });
+    const row = rows[at];
+    const opens = !!row && row.holds && row.children > 0;
+    switch (event.key) {
+        case 'ArrowDown':
+            return go(at + 1);
+        case 'ArrowUp':
+            return go(at - 1);
+        case 'Home':
+            return go(0);
+        case 'End':
+            return go(rows.length - 1);
+        case 'Enter':
+            return { pick: 'one', reveal: true };
+        case 'ArrowLeft':
+        case 'ArrowRight': {
+            if (!row)
+                return { none: true };
+            const inward = (event.key === 'ArrowRight') !== rtl;
+            if (inward)
+                return !opens ? { none: true } : folded.has(row.id) ? { unfold: row.id } : go(at + 1);
+            if (opens && !folded.has(row.id))
+                return { fold: row.id };
+            const parent = row.parent === null ? -1 : rows.findIndex((r) => r.id === row.parent);
+            return parent === -1 ? { none: true } : go(parent);
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * The row the letters typed so far go to: the next whose name starts with
+ * them, from the one after the row on (round to the top) for a first letter,
+ * from the row on itself for more — so a name typed on stays where it is —
+ * and the same letter again goes round the rows starting with it. -1 for none.
+ */
+function typeAhead(rows, at, typed) {
+    const letters = typed.toLowerCase();
+    if (!letters)
+        return -1;
+    const again = [...letters].every((c) => c === letters[0]);
+    const words = again ? letters[0] : letters;
+    const from = again ? at + 1 : at;
+    for (let step = 0; step < rows.length; step++) {
+        const index = (from + step) % rows.length;
+        if (rows[index].label.toLowerCase().startsWith(words))
+            return index;
+    }
+    return -1;
+}
+/** The outline's keys, as the sheet of shortcuts lists them (in the designer's words: `words.outline.keys`). */
+exports.OUTLINE_KEYS = en_1.en.outline.keys;
+//# sourceMappingURL=outline-keys.js.map

package/src/lib/outline-keys.js.map

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

package/src/lib/outline-keys.mjs

@@ -0,0 +1,63 @@
+import { en } from './locales/en/index.mjs';
+/** What a key does on the row at `at` of the rows on show; null when it is not the tree's to answer. */
+export function treeKey(rows, at, event, rtl, folded) {
+    if (event.altKey)
+        return null;
+    const mod = event.ctrlKey || event.metaKey;
+    if (event.key === ' ')
+        return { pick: mod ? 'toggle' : 'one', reveal: false };
+    if (mod)
+        return null;
+    const go = (to) => (to < 0 || to >= rows.length ? { none: true } : { to, extend: event.shiftKey });
+    const row = rows[at];
+    const opens = !!row && row.holds && row.children > 0;
+    switch (event.key) {
+        case 'ArrowDown':
+            return go(at + 1);
+        case 'ArrowUp':
+            return go(at - 1);
+        case 'Home':
+            return go(0);
+        case 'End':
+            return go(rows.length - 1);
+        case 'Enter':
+            return { pick: 'one', reveal: true };
+        case 'ArrowLeft':
+        case 'ArrowRight': {
+            if (!row)
+                return { none: true };
+            const inward = (event.key === 'ArrowRight') !== rtl;
+            if (inward)
+                return !opens ? { none: true } : folded.has(row.id) ? { unfold: row.id } : go(at + 1);
+            if (opens && !folded.has(row.id))
+                return { fold: row.id };
+            const parent = row.parent === null ? -1 : rows.findIndex((r) => r.id === row.parent);
+            return parent === -1 ? { none: true } : go(parent);
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * The row the letters typed so far go to: the next whose name starts with
+ * them, from the one after the row on (round to the top) for a first letter,
+ * from the row on itself for more — so a name typed on stays where it is —
+ * and the same letter again goes round the rows starting with it. -1 for none.
+ */
+export function typeAhead(rows, at, typed) {
+    const letters = typed.toLowerCase();
+    if (!letters)
+        return -1;
+    const again = [...letters].every((c) => c === letters[0]);
+    const words = again ? letters[0] : letters;
+    const from = again ? at + 1 : at;
+    for (let step = 0; step < rows.length; step++) {
+        const index = (from + step) % rows.length;
+        if (rows[index].label.toLowerCase().startsWith(words))
+            return index;
+    }
+    return -1;
+}
+/** The outline's keys, as the sheet of shortcuts lists them (in the designer's words: `words.outline.keys`). */
+export const OUTLINE_KEYS = en.outline.keys;
+//# sourceMappingURL=outline-keys.mjs.map

package/src/lib/outline-keys.mjs.map

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

package/src/lib/outline-moves.d.mts

@@ -0,0 +1,27 @@
+import type { Page } from '@fieldia/core';
+import { type Holder, type Part, type Spot } from './layout-tree.mjs';
+import type { DesignerWords } from './designer-words.mjs';
+/**
+ * Moving parts in reading order, as the outline moves them: into a group, a
+ * tab, tabs (a tab among its tabs) or a survey's page, at a place in its
+ * list — the place counted in the list as it is, the parts moved still in
+ * it, as a drop line between two rows says. Nothing is put side by side on
+ * the way: a part lands in the list as it is, no wider than the columns
+ * there; a row of parts on the page takes one more column (four at most)
+ * and closes up when one leaves; in a group in twelfths that keeps its rows
+ * full, a part is a row of its own (layout-twelfths.ts); an arrangement left
+ * holding one part folds away (layout-ops.ts's `tidy`). A part picked inside
+ * another part picked goes along with it.
+ */
+/** A part's name as a person reads it — a survey's page by its title — in quotes. */
+export declare function quoted(page: Page, part: Part | Holder, words?: DesignerWords): string;
+/** The parts named that are on the page, in reading order: none inside another of them, none twice. */
+export declare function partsInOrder(page: Page, ids: string[]): Spot[];
+/** Why these parts cannot go into `parentId`, or null when they can. */
+export declare function moveRefusal(page: Page, ids: string[], parentId: string, words?: DesignerWords): string | null;
+/** Move the parts into `parentId` before the part now at `index` (or at its end). Returns them, in reading order. */
+export declare function moveParts(page: Page, ids: string[], parentId: string, index: number): string[];
+/** New parts (pasted) into `parentId`, before the part at `index` (or at its end), as a move puts them. Returns them. */
+export declare function putNewParts(page: Page, nodes: Part[], parentId: string, index: number): string[];
+/** Where the parts would go, in the words the drag chip says: “into “Home address”, before “City””. */
+export declare function describeMove(page: Page, ids: string[], parentId: string, index: number, words?: DesignerWords): string;

package/src/lib/outline-moves.d.ts

@@ -0,0 +1,27 @@
+import type { Page } from '@fieldia/core';
+import { type Holder, type Part, type Spot } from './layout-tree';
+import type { DesignerWords } from './designer-words';
+/**
+ * Moving parts in reading order, as the outline moves them: into a group, a
+ * tab, tabs (a tab among its tabs) or a survey's page, at a place in its
+ * list — the place counted in the list as it is, the parts moved still in
+ * it, as a drop line between two rows says. Nothing is put side by side on
+ * the way: a part lands in the list as it is, no wider than the columns
+ * there; a row of parts on the page takes one more column (four at most)
+ * and closes up when one leaves; in a group in twelfths that keeps its rows
+ * full, a part is a row of its own (layout-twelfths.ts); an arrangement left
+ * holding one part folds away (layout-ops.ts's `tidy`). A part picked inside
+ * another part picked goes along with it.
+ */
+/** A part's name as a person reads it — a survey's page by its title — in quotes. */
+export declare function quoted(page: Page, part: Part | Holder, words?: DesignerWords): string;
+/** The parts named that are on the page, in reading order: none inside another of them, none twice. */
+export declare function partsInOrder(page: Page, ids: string[]): Spot[];
+/** Why these parts cannot go into `parentId`, or null when they can. */
+export declare function moveRefusal(page: Page, ids: string[], parentId: string, words?: DesignerWords): string | null;
+/** Move the parts into `parentId` before the part now at `index` (or at its end). Returns them, in reading order. */
+export declare function moveParts(page: Page, ids: string[], parentId: string, index: number): string[];
+/** New parts (pasted) into `parentId`, before the part at `index` (or at its end), as a move puts them. Returns them. */
+export declare function putNewParts(page: Page, nodes: Part[], parentId: string, index: number): string[];
+/** Where the parts would go, in the words the drag chip says: “into “Home address”, before “City””. */
+export declare function describeMove(page: Page, ids: string[], parentId: string, index: number, words?: DesignerWords): string;