@fieldia/designer 0.0.0-stage → 0.12.0

package/src/lib/layout-settings.mjs

@@ -0,0 +1,279 @@
+import { PART_LOOKS } from '@fieldia/core';
+import { columnsValue, setSpan, SPANNED } from './layout-ops.mjs';
+import { across, isSection, locate, nodeOf, rowsOf, spanOf } from './layout-tree.mjs';
+import { fill, fromTwelfths, inTwelfths, isGroup, keepsFull, laidInTwelfths, resize, toTwelfths, TWELVE, twelfthsAhead } from './layout-twelfths.mjs';
+import { settingWords } from './look-parts-words.mjs';
+import { Refusal } from './refusal.mjs';
+import { hotkeyFrom } from './hotkey-setting.mjs';
+const COUNTS = [1, 2, 3, 4, TWELVE];
+/** A part wider than a section's columns is narrowed to them. */
+function narrowTo(section, wide) {
+    for (const child of section.children)
+        if (SPANNED.has(child.type) && spanOf(child) > wide)
+            child.colspan = wide;
+}
+/** A group's columns: one count, or a count for a desktop, a tablet and a phone (a plain number when only a desktop's is given). */
+export function setColumns(page, id, columns) {
+    const section = nodeOf(page, id);
+    if (!isSection(section))
+        throw new Refusal((w) => w.refusals.noSection(id));
+    const { wide, medium, narrow } = typeof columns === 'object' ? columns : { wide: columns, medium: undefined, narrow: undefined };
+    if ([wide, medium, narrow].some((n) => n !== undefined && !COUNTS.includes(n)))
+        throw new Refusal((w) => w.layout.groupColumns);
+    // Into twelfths or out of them, each part as wide as it was, as near as the columns allow.
+    if (isGroup(section) && (wide === TWELVE) !== inTwelfths(section)) {
+        if (wide === TWELVE)
+            toTwelfths(section);
+        else
+            fromTwelfths(section, wide);
+        if (typeof columns === 'number')
+            return;
+    }
+    if (typeof columns === 'number') {
+        // Columns given per width keep their narrower counts, never more than the wide one.
+        const given = section.columns;
+        section.columns =
+            typeof given === 'object'
+                ? { wide, ...(given.medium ? { medium: Math.min(given.medium, wide) } : {}), ...(given.narrow ? { narrow: Math.min(given.narrow, wide) } : {}) }
+                : wide;
+    }
+    else {
+        if ((medium ?? 0) > wide || (narrow ?? 0) > wide)
+            throw new Refusal((w) => w.layout.smallerScreens);
+        if ((narrow ?? 0) > (medium ?? 4))
+            throw new Refusal((w) => w.layout.phoneScreen);
+        section.columns = columnsValue(wide, medium, narrow);
+    }
+    narrowTo(section, wide);
+}
+/** The part, checked: one that takes a width, no wider than where it sits. */
+function widthOf(page, id, span) {
+    const at = locate(page, id);
+    if (!at)
+        throw new Refusal((w) => w.layout.noPart(id));
+    if (at.node.type === 'tab')
+        throw new Refusal((w) => w.layout.tabWidth);
+    if (!SPANNED.has(at.node.type))
+        throw new Refusal((w) => w.layout.runsAcross(at.node.type));
+    const cols = across(page, at.parent);
+    if (span > cols)
+        throw new Refusal((w) => (inTwelfths(at.parent) ? w.layout.noWiderThanRow(w.layout.nouns[at.node.type]) : w.layout.noWiderThanSection(w.layout.nouns[at.node.type], cols)));
+    return at;
+}
+/**
+ * How many columns a part spans, no more than where it sits has. In a group
+ * that keeps its rows full, the rest of its row gives it the room, or takes
+ * what it leaves, as they shared it; made the whole row, the parts before it
+ * and after it are each a row of their own.
+ */
+export function setColspan(page, id, span) {
+    const at = widthOf(page, id, span);
+    const group = at.parent;
+    if (!inTwelfths(group) || !keepsFull(group))
+        return sized(page, at, span);
+    const row = rowsOf(page, group).find((r) => r.items.includes(at.node))?.items ?? [at.node];
+    const rest = row.filter((p) => p !== at.node);
+    if (span === TWELVE) {
+        resize(at.node, span);
+        fill(row.slice(0, row.indexOf(at.node)));
+        fill(row.slice(row.indexOf(at.node) + 1));
+    }
+    else if (!rest.length)
+        throw new Refusal((w) => w.layout.aloneInRow);
+    else if (TWELVE - span < rest.length)
+        throw new Refusal((w) => w.layout.restNeedsRoom);
+    else {
+        resize(at.node, span);
+        fill(rest, TWELVE - span);
+    }
+}
+const labelWidthOk = (width) => width === null || width === undefined || (Number.isInteger(width) && width >= 60 && width <= 320);
+/** Set or take back each setting given: `null` takes it back, and so does a card, which a group is unless it says otherwise. */
+function patch(target, settings, defaults = {}) {
+    for (const [key, value] of Object.entries(settings)) {
+        if (value === undefined)
+            continue;
+        if (value === null || defaults[key] === value)
+            delete target[key];
+        else
+            target[key] = value;
+    }
+}
+/** How a group looks, and where its fields' labels sit. */
+export function setSectionLook(page, id, look) {
+    const section = nodeOf(page, id);
+    if (!isSection(section))
+        throw new Refusal((w) => w.layout.noGroup(id));
+    if (!labelWidthOk(look.labelWidth))
+        throw new Refusal((w) => w.layout.labelWidth);
+    if (look.rows !== undefined && !isGroup(section))
+        throw new Refusal((w) => w.layout.onlyGroupRows);
+    // On one line: fields, words and buttons only, as wide as they need — no columns, rows or folding.
+    if (look.style === 'inline') {
+        if (section.children.some((child) => !['field', 'text', 'button', 'spacer'].includes(child.type)))
+            throw new Refusal((w) => w.layout.lineHoldsParts);
+        for (const key of ['columns', 'rows', 'collapsible', 'collapsed'])
+            delete section[key];
+    }
+    patch(section, { style: look.style, labels: look.labels, labelWidth: look.labelWidth, rows: look.rows }, { style: 'card', rows: 'full' });
+}
+/** Where one field's label sits; `null` for where its group or the page puts labels. */
+export function setFieldLabels(page, id, place) {
+    const at = locate(page, id);
+    if (at?.node.type !== 'field')
+        throw new Refusal((w) => w.layout.noField(id));
+    if (place)
+        at.node.labels = place;
+    else
+        delete at.node.labels;
+}
+/** Where one field's help shows; `null` for where the page shows help. */
+export function setFieldHelpShown(page, id, shown) {
+    const at = locate(page, id);
+    if (at?.node.type !== 'field')
+        throw new Refusal((w) => w.layout.noField(id));
+    if (shown)
+        at.node.helpShown = shown;
+    else
+        delete at.node.helpShown;
+}
+/** The page's look: its colour, font, spacing, corners, labels and scheme. */
+export function setLook(page, change) {
+    if (change.accent && !/^#[0-9a-fA-F]{6}$/.test(change.accent))
+        throw new Refusal((w) => w.layout.colour);
+    if (!labelWidthOk(change.labelWidth))
+        throw new Refusal((w) => w.layout.labelWidth);
+    const look = { ...page.look };
+    patch(look, change);
+    if (Object.keys(look).length)
+        page.look = look;
+    else
+        delete page.look;
+}
+const COLOUR = /^#[0-9a-fA-F]{6}$/;
+/** What each setting of a kind of part may be. */
+export const PART_VALUES = {
+    background: (value) => typeof value === 'string' && COLOUR.test(value),
+    border: (value) => typeof value === 'string' && COLOUR.test(value),
+    corners: (value) => value === 'square' || value === 'soft' || value === 'round',
+    textSize: (value) => value === 'small' || value === 'large',
+    accent: (value) => typeof value === 'string' && COLOUR.test(value),
+};
+/** One kind of part's look: each setting given set, or taken back with `null`; `null` for the whole gives the kind back to the page's look. */
+export function setPartLook(page, kind, change) {
+    const settings = PART_LOOKS[kind];
+    if (!settings)
+        throw new Refusal((w) => w.partLooks.noKind(kind));
+    const parts = { ...page.look?.parts };
+    const part = { ...parts[kind] };
+    for (const [key, value] of Object.entries(change ?? {})) {
+        if (value === undefined)
+            continue;
+        const setting = key;
+        if (!settings.includes(setting))
+            throw new Refusal((w) => w.partLooks.noSetting(w.partLooks.kinds[kind], settingWords(kind, setting, w)));
+        if (value !== null && !PART_VALUES[setting](value))
+            throw new Refusal((w) => (setting === 'corners' ? w.partLooks.corners : setting === 'textSize' ? w.partLooks.textSize : w.partLooks.colour));
+    }
+    patch(part, change ?? Object.fromEntries(Object.keys(part).map((key) => [key, null])));
+    if (Object.keys(part).length)
+        parts[kind] = part;
+    else
+        delete parts[kind];
+    setLook(page, { parts: Object.keys(parts).length ? parts : null });
+}
+export function updateBlock(page, id, patch) {
+    const node = locate(page, id)?.node;
+    if (!node)
+        throw new Refusal((w) => w.layout.noPart(id));
+    if (node.type === 'text') {
+        if (patch.label !== undefined || patch.src !== undefined || patch.alt !== undefined || patch.caption !== undefined || patch.confirm !== undefined || patch.hotkey !== undefined)
+            throw new Refusal((w) => w.layout.wordsNotLabel);
+        if (patch.text !== undefined)
+            node.text = patch.text;
+        if (patch.style !== undefined)
+            node.style = patch.style;
+        // A colour is an alert's: words that are no longer one lose it.
+        if (patch.tone !== undefined) {
+            if (node.style !== 'alert')
+                throw new Refusal((w) => w.layout.onlyAlertColour);
+            node.tone = patch.tone;
+        }
+        if (node.style !== 'alert')
+            delete node.tone;
+    }
+    else if (node.type === 'button') {
+        if (patch.text !== undefined || patch.src !== undefined || patch.alt !== undefined)
+            throw new Refusal((w) => w.layout.buttonNotText);
+        if (patch.label !== undefined)
+            node.label = patch.label;
+        if (patch.style !== undefined)
+            node.style = patch.style;
+        if (patch.confirm !== undefined) {
+            if (patch.confirm.trim())
+                node.confirm = patch.confirm;
+            else
+                delete node.confirm;
+        }
+        if (patch.hotkey !== undefined) {
+            const key = hotkeyFrom(patch.hotkey);
+            if (key)
+                node.hotkey = key;
+            else
+                delete node.hotkey;
+        }
+    }
+    else if (node.type === 'image') {
+        if (patch.text !== undefined || patch.label !== undefined || patch.confirm !== undefined || patch.hotkey !== undefined)
+            throw new Refusal((w) => w.layout.pictureWords);
+        if (patch.src !== undefined) {
+            if (!patch.src.trim())
+                throw new Refusal((w) => w.layout.pictureAddress);
+            node.src = patch.src.trim();
+        }
+        if (patch.alt !== undefined)
+            node.alt = patch.alt;
+        pictureLook(node, patch);
+    }
+    else
+        throw new Refusal((w) => w.layout.onlyBlocks);
+}
+/** A picture's width, place, link and caption, each checked; `null` or empty takes one away. */
+function pictureLook(node, patch) {
+    const { width, align, href, caption } = patch;
+    if (width !== undefined && width !== null && typeof width === 'number' && !(Number.isInteger(width) && width >= 16 && width <= 4000))
+        throw new Refusal((w) => w.layout.pictureWidth);
+    const link = href?.trim();
+    if (link && !/^(https?:\/\/|mailto:)\S+$/i.test(link))
+        throw new Refusal((w) => w.layout.link);
+    const set = (key, value) => {
+        if (value === undefined)
+            return;
+        if (value === null || value === '')
+            delete node[key];
+        else
+            node[key] = value;
+    };
+    set('width', width);
+    set('align', align);
+    set('href', link === undefined ? undefined : link);
+    set('caption', caption);
+}
+/**
+ * Several widths as one edit, such as two parts trading width across the
+ * gutter between them; refused whole if any one is. With `twelfths`, the
+ * widths are twelfths of the row, and a group of one to four columns is
+ * divided in twelfths first.
+ */
+export function setWidths(page, widths, twelfths = false) {
+    for (const { id } of widths) {
+        const group = locate(page, id)?.parent;
+        if (twelfths && twelfthsAhead(group))
+            toTwelfths(group);
+    }
+    for (const { id, span } of widths)
+        sized(page, widthOf(page, id, span), span);
+}
+/** A part's width set; in twelfths, an arrangement lays its own parts on its new columns. */
+const sized = (page, at, span) => (laidInTwelfths(page, at.parent) ? resize(at.node, span) : setSpan(at.node, span));
+//# sourceMappingURL=layout-settings.mjs.map

package/src/lib/layout-settings.mjs.map

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

package/src/lib/layout-several.d.mts

@@ -0,0 +1,15 @@
+import type { LabelPlace, Page } from '@fieldia/core';
+/**
+ * Several parts picked, changed at once as one edit: how wide each is where
+ * it sits, where each one's labels sit, and whether fields are required.
+ * When one of them cannot take the change, none of them changes, and the
+ * refusal says why.
+ */
+/** A change for every part picked; `labels: null` gives them back to what is round them. */
+export interface EachChange {
+    span?: number;
+    labels?: LabelPlace | null;
+    /** Required always, or not: a rule for when each is required goes. A field the model requires stays required. */
+    required?: boolean;
+}
+export declare function setEach(page: Page, ids: readonly string[], change: EachChange, fromModel?: (name: string) => boolean): void;

package/src/lib/layout-several.d.ts

@@ -0,0 +1,15 @@
+import type { LabelPlace, Page } from '@fieldia/core';
+/**
+ * Several parts picked, changed at once as one edit: how wide each is where
+ * it sits, where each one's labels sit, and whether fields are required.
+ * When one of them cannot take the change, none of them changes, and the
+ * refusal says why.
+ */
+/** A change for every part picked; `labels: null` gives them back to what is round them. */
+export interface EachChange {
+    span?: number;
+    labels?: LabelPlace | null;
+    /** Required always, or not: a rule for when each is required goes. A field the model requires stays required. */
+    required?: boolean;
+}
+export declare function setEach(page: Page, ids: readonly string[], change: EachChange, fromModel?: (name: string) => boolean): void;

package/src/lib/layout-several.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEach = setEach;
+const layout_tree_1 = require("./layout-tree");
+const layout_settings_1 = require("./layout-settings");
+const refusal_1 = require("./refusal");
+/**
+ * A field required always, or not, as its own Required does: a rule for when
+ * it is required goes; a field of the model is required on its place on the
+ * page, and one the model requires stays so.
+ */
+function setRequired(page, node, on, fromModel) {
+    delete node.required;
+    if (fromModel(node.field)) {
+        if (on)
+            node.required = true;
+        return;
+    }
+    const field = page.fields[node.field];
+    if (on)
+        field.required = true;
+    else
+        delete field.required;
+}
+function setEach(page, ids, change, fromModel = () => false) {
+    if (!ids.length)
+        throw new refusal_1.Refusal((w) => w.layout.pickFirst);
+    const noun = (type) => (w) => (type === 'field' ? w.layout.it : (w.layout.nouns[type] ?? w.layout.it));
+    for (const id of ids) {
+        const at = (0, layout_tree_1.locate)(page, id);
+        if (!at)
+            throw new refusal_1.Refusal((w) => w.layout.noPart(id));
+        if (change.span !== undefined)
+            (0, layout_settings_1.setColspan)(page, id, change.span);
+        if (change.required !== undefined) {
+            if (at.node.type !== 'field')
+                throw new refusal_1.Refusal((w) => w.layout.notAnswered(noun(at.node.type)(w)));
+            setRequired(page, at.node, change.required, fromModel);
+        }
+        if (change.labels === undefined)
+            continue;
+        if (at.node.type === 'field')
+            (0, layout_settings_1.setFieldLabels)(page, id, change.labels);
+        else if ((0, layout_tree_1.isSection)(at.node))
+            (0, layout_settings_1.setSectionLook)(page, id, { labels: change.labels });
+        else
+            throw new refusal_1.Refusal((w) => w.layout.noLabels(noun(at.node.type)(w)));
+    }
+}
+//# sourceMappingURL=layout-several.js.map

package/src/lib/layout-several.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-several.js","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/layout-several.ts"],"names":[],"mappings":";;AAsCA,0BAgBC;AApDD,+CAAkD;AAClD,uDAA+E;AAC/E,uCAAoC;AAkBpC;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAU,EAAE,IAAe,EAAE,EAAW,EAAE,SAAoC;IACjG,OAAO,IAAI,CAAC,QAAQ,CAAC;IACrB,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,IAAI,EAAE;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAmC,CAAC;IACxE,IAAI,EAAE;QAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;;QACzB,OAAO,KAAK,CAAC,QAAQ,CAAC;AAC7B,CAAC;AAED,SAAgB,OAAO,CAAC,IAAU,EAAE,GAAsB,EAAE,MAAkB,EAAE,YAAuC,GAAG,EAAE,CAAC,KAAK;IAChI,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,MAAM,IAAI,iBAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9H,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,EAAE,GAAG,IAAA,oBAAM,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,iBAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,IAAA,4BAAU,EAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;gBAAE,MAAM,IAAI,iBAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,SAAS;QAC1C,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,IAAA,gCAAc,EAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;aACjE,IAAI,IAAA,uBAAS,EAAC,EAAE,CAAC,IAAI,CAAC;YAAE,IAAA,gCAAc,EAAC,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;;YAC5E,MAAM,IAAI,iBAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/src/lib/layout-several.mjs

@@ -0,0 +1,47 @@
+import { isSection, locate } from './layout-tree.mjs';
+import { setColspan, setFieldLabels, setSectionLook } from './layout-settings.mjs';
+import { Refusal } from './refusal.mjs';
+/**
+ * A field required always, or not, as its own Required does: a rule for when
+ * it is required goes; a field of the model is required on its place on the
+ * page, and one the model requires stays so.
+ */
+function setRequired(page, node, on, fromModel) {
+    delete node.required;
+    if (fromModel(node.field)) {
+        if (on)
+            node.required = true;
+        return;
+    }
+    const field = page.fields[node.field];
+    if (on)
+        field.required = true;
+    else
+        delete field.required;
+}
+export function setEach(page, ids, change, fromModel = () => false) {
+    if (!ids.length)
+        throw new Refusal((w) => w.layout.pickFirst);
+    const noun = (type) => (w) => (type === 'field' ? w.layout.it : (w.layout.nouns[type] ?? w.layout.it));
+    for (const id of ids) {
+        const at = locate(page, id);
+        if (!at)
+            throw new Refusal((w) => w.layout.noPart(id));
+        if (change.span !== undefined)
+            setColspan(page, id, change.span);
+        if (change.required !== undefined) {
+            if (at.node.type !== 'field')
+                throw new Refusal((w) => w.layout.notAnswered(noun(at.node.type)(w)));
+            setRequired(page, at.node, change.required, fromModel);
+        }
+        if (change.labels === undefined)
+            continue;
+        if (at.node.type === 'field')
+            setFieldLabels(page, id, change.labels);
+        else if (isSection(at.node))
+            setSectionLook(page, id, { labels: change.labels });
+        else
+            throw new Refusal((w) => w.layout.noLabels(noun(at.node.type)(w)));
+    }
+}
+//# sourceMappingURL=layout-several.mjs.map

package/src/lib/layout-several.mjs.map

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

package/src/lib/layout-tree.d.mts

@@ -0,0 +1,75 @@
+import { type LayoutNode, type Page, type SectionNode, type TabNode } from '@fieldia/core';
+import type { DesignerWords } from './designer-words.mjs';
+/**
+ * Reading a page's layout as the designer lays it out: where a part sits,
+ * how many columns a group has, the rows its parts fall into, and what a
+ * person calls each part.
+ *
+ * An *arrangement* is a section with no title in the plain style: it is there
+ * only to hold parts side by side, or one under another. In a section with
+ * columns, an arrangement lays its parts on the columns it covers there, so
+ * they line up with everything above and below — unless it is one column wide
+ * with columns of its own, when its parts share that one cell.
+ */
+/** Anything in a list of parts; a tab sits in its tabs' list. */
+export type Part = LayoutNode | TabNode;
+/** Anything with a list of parts: a section, a tab, tabs, a step, or the page's own layout. */
+export type Holder = {
+    id: string;
+    type: string;
+    children: Part[];
+};
+export interface Spot {
+    node: Part;
+    parent: Holder;
+    list: Part[];
+    index: number;
+}
+export declare const listOf: (node: {
+    type: string;
+} | undefined) => Part[] | null;
+/** A part inside a holder, the list it is in, and its place there, however deep. */
+export declare function find(holder: Holder, id: string): Spot | null;
+/** A part, the list it is in, and its place there, wherever it sits on the page. */
+export declare const locate: (page: Page, id: string) => Spot | null;
+/** The part, or the page's own layout, by id. */
+export declare function nodeOf(page: Page, id: string): Part | Holder | null;
+/** Whether `inner` is `outer` or sits somewhere inside it. */
+export declare function contains(page: Page, outer: string, inner: string): boolean;
+export declare const isSection: (node: unknown) => node is SectionNode;
+/** An arrangement: a section with no title in the plain style, there only to hold parts side by side or one under another. */
+export declare const isWrapper: (node: unknown) => node is SectionNode;
+export declare const spanOf: (node: Part) => number;
+/** The parts that take a width; a divider runs across the whole row. */
+export declare const SPANNED: Set<string>;
+/** Set how many columns a part spans; one is the default, and a part that spans nothing (a divider) is left as it is. */
+export declare function setSpan(node: Part, span: number): void;
+/** The columns a section has: its own, or — an arrangement in a grid — the ones it covers there. */
+export declare function colsOf(page: Page, section: SectionNode): number;
+/** How many places a list has across: a section's columns, or one for the page, a step and a tab. */
+export declare const across: (page: Page, holder: Holder | Part) => number;
+/** Whether a part sits in a grid with columns (not on the page, in a tab or in one column). */
+export declare function inGrid(page: Page, node: Part): boolean;
+/** One column wide with columns of its own: parts sharing one cell, side by side. */
+export declare const sharesOneCell: (section: SectionNode) => boolean;
+/** An arrangement in a section with columns lays its parts on the columns it covers there. */
+export declare function onTracks(page: Page, section: SectionNode): boolean;
+/** A row of parts on the page or in a tab: an arrangement with as many columns as parts. */
+export declare function isRow(page: Page, node: Part | Holder | null): node is SectionNode;
+export interface Row {
+    items: Part[];
+    used: number;
+}
+/**
+ * The rows a list's parts fall into, in reading order as the grid places them:
+ * a part too wide for what is left of a row starts the next. A divider is a
+ * line across the whole row.
+ */
+export declare const rowsOf: (page: Page, holder: Holder, skip?: string) => Row[];
+/** The rows of a list of parts on a grid of `cols` columns. */
+export declare function rowsIn(list: Part[], cols: number, skip?: string): Row[];
+/** A part's name as a person reads it. */
+export declare function nameOf(page: Page, node: Part | Holder | null, words?: DesignerWords): string;
+export declare const andList: (words: string[]) => string;
+/** A part as people see it, quoted: an arrangement is named by what it holds. */
+export declare function seenAs(page: Page, node: Part | Holder, words?: DesignerWords): string;

package/src/lib/layout-tree.d.ts

@@ -0,0 +1,75 @@
+import { type LayoutNode, type Page, type SectionNode, type TabNode } from '@fieldia/core';
+import type { DesignerWords } from './designer-words';
+/**
+ * Reading a page's layout as the designer lays it out: where a part sits,
+ * how many columns a group has, the rows its parts fall into, and what a
+ * person calls each part.
+ *
+ * An *arrangement* is a section with no title in the plain style: it is there
+ * only to hold parts side by side, or one under another. In a section with
+ * columns, an arrangement lays its parts on the columns it covers there, so
+ * they line up with everything above and below — unless it is one column wide
+ * with columns of its own, when its parts share that one cell.
+ */
+/** Anything in a list of parts; a tab sits in its tabs' list. */
+export type Part = LayoutNode | TabNode;
+/** Anything with a list of parts: a section, a tab, tabs, a step, or the page's own layout. */
+export type Holder = {
+    id: string;
+    type: string;
+    children: Part[];
+};
+export interface Spot {
+    node: Part;
+    parent: Holder;
+    list: Part[];
+    index: number;
+}
+export declare const listOf: (node: {
+    type: string;
+} | undefined) => Part[] | null;
+/** A part inside a holder, the list it is in, and its place there, however deep. */
+export declare function find(holder: Holder, id: string): Spot | null;
+/** A part, the list it is in, and its place there, wherever it sits on the page. */
+export declare const locate: (page: Page, id: string) => Spot | null;
+/** The part, or the page's own layout, by id. */
+export declare function nodeOf(page: Page, id: string): Part | Holder | null;
+/** Whether `inner` is `outer` or sits somewhere inside it. */
+export declare function contains(page: Page, outer: string, inner: string): boolean;
+export declare const isSection: (node: unknown) => node is SectionNode;
+/** An arrangement: a section with no title in the plain style, there only to hold parts side by side or one under another. */
+export declare const isWrapper: (node: unknown) => node is SectionNode;
+export declare const spanOf: (node: Part) => number;
+/** The parts that take a width; a divider runs across the whole row. */
+export declare const SPANNED: Set<string>;
+/** Set how many columns a part spans; one is the default, and a part that spans nothing (a divider) is left as it is. */
+export declare function setSpan(node: Part, span: number): void;
+/** The columns a section has: its own, or — an arrangement in a grid — the ones it covers there. */
+export declare function colsOf(page: Page, section: SectionNode): number;
+/** How many places a list has across: a section's columns, or one for the page, a step and a tab. */
+export declare const across: (page: Page, holder: Holder | Part) => number;
+/** Whether a part sits in a grid with columns (not on the page, in a tab or in one column). */
+export declare function inGrid(page: Page, node: Part): boolean;
+/** One column wide with columns of its own: parts sharing one cell, side by side. */
+export declare const sharesOneCell: (section: SectionNode) => boolean;
+/** An arrangement in a section with columns lays its parts on the columns it covers there. */
+export declare function onTracks(page: Page, section: SectionNode): boolean;
+/** A row of parts on the page or in a tab: an arrangement with as many columns as parts. */
+export declare function isRow(page: Page, node: Part | Holder | null): node is SectionNode;
+export interface Row {
+    items: Part[];
+    used: number;
+}
+/**
+ * The rows a list's parts fall into, in reading order as the grid places them:
+ * a part too wide for what is left of a row starts the next. A divider is a
+ * line across the whole row.
+ */
+export declare const rowsOf: (page: Page, holder: Holder, skip?: string) => Row[];
+/** The rows of a list of parts on a grid of `cols` columns. */
+export declare function rowsIn(list: Part[], cols: number, skip?: string): Row[];
+/** A part's name as a person reads it. */
+export declare function nameOf(page: Page, node: Part | Holder | null, words?: DesignerWords): string;
+export declare const andList: (words: string[]) => string;
+/** A part as people see it, quoted: an arrangement is named by what it holds. */
+export declare function seenAs(page: Page, node: Part | Holder, words?: DesignerWords): string;