@fieldia/designer 0.0.0-stage → 0.11.0

package/src/lib/templates.d.ts

@@ -0,0 +1,35 @@
+import { type Page } from '@fieldia/core';
+import { type DesignerLocale, type DesignerWords } from './designer-words';
+/**
+ * Pages to start from: a blank survey or screen offers a few sensible ones,
+ * and the app adds its own. Each is a whole page, made of the designer's own
+ * kinds, so every part of it is edited as if it had been added by hand.
+ * Picking one puts it in place of the blank page, as one edit: the page
+ * keeps its id and where its answers go, and takes the rest.
+ */
+export interface PageTemplate {
+    id: string;
+    title: string;
+    /** One line saying what it is for. */
+    description: string;
+    page: Page;
+}
+/** Fieldia's surveys to start from, in the designer's language. */
+export declare function surveyTemplates(locale?: DesignerLocale): PageTemplate[];
+/** Fieldia's screens to start from, in the designer's language. */
+export declare function screenTemplates(locale?: DesignerLocale): PageTemplate[];
+/** Fieldia's templates in English, as they always were. */
+export declare const SURVEY_TEMPLATES: readonly PageTemplate[];
+export declare const SCREEN_TEMPLATES: readonly PageTemplate[];
+/** The templates for a page: Fieldia's for a survey or a screen, then the app's that are made the same way. */
+export declare function templatesFor(page: Page, app?: readonly PageTemplate[], locale?: DesignerLocale): PageTemplate[];
+/** Whether a page has nothing of its own yet: a survey's empty pages, or a screen's empty sections. A sheet and a list start with a field, so they never are. */
+export declare function isBlank(page: Page): boolean;
+/**
+ * Make `draft` the page `next`, keeping its id and where its answers go: a
+ * survey takes only a survey, a screen only a screen. Refused, saying why,
+ * for what is not a page the designer can open.
+ */
+export declare function replaceWith(draft: Page, next: unknown): void;
+/** Why `next` cannot take the place of `page`, in words, or null when it can: it must be a page, made the way `page` is. */
+export declare function pageProblem(page: Page, next: unknown, words?: DesignerWords): string | null;

package/src/lib/templates.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCREEN_TEMPLATES = exports.SURVEY_TEMPLATES = void 0;
+exports.surveyTemplates = surveyTemplates;
+exports.screenTemplates = screenTemplates;
+exports.templatesFor = templatesFor;
+exports.isBlank = isBlank;
+exports.replaceWith = replaceWith;
+exports.pageProblem = pageProblem;
+const core_1 = require("@fieldia/core");
+const kinds_1 = require("./kinds");
+const designer_words_1 = require("./designer-words");
+const en_1 = require("./locales/en");
+const refusal_1 = require("./refusal");
+const ask = (name, kind, label, more = {}) => ({ name, kind, label, ...more });
+const valueOf = (words) => words.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+/** Options in the designer's words, valued by the English ones: a template's answers are stored the same in every language. */
+const choices = (english, said) => english.map((label, i) => ({ value: valueOf(label), label: said[i] ?? label }));
+/** A template's page: its groups — a survey's pages, a screen's sections — and their questions, each made as its kind makes it. */
+function made(kind, id, title, description, groups, words, language) {
+    const fields = {};
+    const nodes = (asks) => asks.map((a) => {
+        const k = (0, kinds_1.kindById)(a.kind);
+        const field = { ...k.field(a.label, words), ...(a.field ?? {}) };
+        if (a.required)
+            field.required = true;
+        if (a.help)
+            field.help = a.help;
+        if (a.choices && field.type === 'selection')
+            field.options = a.choices;
+        fields[a.name] = field;
+        return { type: 'field', id: `q-${a.name.replace(/_/g, '-')}`, field: a.name, ...(k.widget ? { widget: k.widget } : {}), ...(a.look ? { options: a.look } : {}), ...(a.colspan ? { colspan: a.colspan } : {}) };
+    });
+    const layout = kind === 'survey'
+        ? { type: 'wizard', id: 'steps', children: groups.map(([label, asks], i) => ({ type: 'step', id: `step-${i + 1}`, label, children: nodes(asks) })) }
+        : { type: 'sections', id: 'sections', children: groups.map(([label, asks], i) => ({ type: 'section', id: `section-${i + 1}`, title: label, columns: 2, children: nodes(asks) })) };
+    const data = kind === 'survey' ? { kind: 'responses' } : { kind: 'record', model: id.replace(/-/g, '.') };
+    // Written in another language than English: the page says so, and its form speaks it.
+    return { id, title, description, page: { fieldia: '0.1', id, title, description, ...(language ? { language } : {}), data, fields, layout } };
+}
+/** Fieldia's surveys to start from, in the designer's language. */
+function surveyTemplates(locale = 'en') {
+    const words = designer_words_1.DESIGNER_WORDS[locale];
+    const language = locale === 'en' ? undefined : locale;
+    const { feedback, event, job } = words.templates;
+    const english = en_1.en.templates;
+    return [
+        made('survey', 'feedback', feedback.title, feedback.description, [
+            [
+                feedback.page,
+                [
+                    ask('overall', 'rating', feedback.overall, { required: true }),
+                    ask('liked', 'paragraph', feedback.liked),
+                    ask('better', 'paragraph', feedback.better),
+                    ask('recommend', 'scale', feedback.recommend, { look: { startLabel: feedback.notLikely, endLabel: feedback.veryLikely } }),
+                    ask('email', 'email', feedback.email, { help: feedback.emailHelp }),
+                ],
+            ],
+        ], words, language),
+        made('survey', 'event-registration', event.title, event.description, [
+            [
+                event.aboutYou,
+                [
+                    ask('full_name', 'short-answer', event.fullName, { required: true }),
+                    ask('email', 'email', event.email, { required: true }),
+                    ask('phone', 'phone', event.phone),
+                    ask('organisation', 'short-answer', event.organisation),
+                ],
+            ],
+            [
+                event.yourPlace,
+                [
+                    ask('sessions', 'checkboxes', event.sessions, { required: true, choices: choices(english.event.sessionChoices, event.sessionChoices) }),
+                    ask('diet', 'dropdown', event.diet, { choices: choices(english.event.dietChoices, event.dietChoices) }),
+                    ask('notes', 'paragraph', event.notes),
+                ],
+            ],
+        ], words, language),
+        made('survey', 'job-application', job.title, job.description, [
+            [
+                job.theRole,
+                [
+                    ask('role', 'dropdown', job.role, { required: true, choices: choices(english.job.roleChoices, job.roleChoices) }),
+                    ask('cv', 'file', job.cv, { required: true }),
+                    ask('experience', 'number', job.experience),
+                    ask('start', 'date', job.start),
+                    ask('why', 'paragraph', job.why),
+                ],
+            ],
+            [
+                job.aboutYou,
+                [
+                    ask('full_name', 'short-answer', job.fullName, { required: true }),
+                    ask('email', 'email', job.email, { required: true }),
+                    ask('phone', 'phone', job.phone),
+                    ask('profile', 'short-answer', job.profile),
+                ],
+            ],
+        ], words, language),
+    ];
+}
+/** Fieldia's screens to start from, in the designer's language. */
+function screenTemplates(locale = 'en') {
+    const words = designer_words_1.DESIGNER_WORDS[locale];
+    const language = locale === 'en' ? undefined : locale;
+    const { contact, order } = words.templates;
+    return [
+        made('screen', 'contact', contact.title, contact.description, [
+            [
+                contact.contact,
+                [
+                    ask('name', 'short-answer', contact.name, { required: true }),
+                    ask('company', 'short-answer', contact.company),
+                    ask('email', 'email', contact.email),
+                    ask('phone', 'phone', contact.phone),
+                    ask('website', 'website', contact.website),
+                ],
+            ],
+            [contact.notes, [ask('notes', 'paragraph', contact.notes, { colspan: 2 })]],
+        ], words, language),
+        made('screen', 'order-request', order.title, order.description, [
+            [
+                order.order,
+                [
+                    ask('customer', 'short-answer', order.customer, { required: true }),
+                    ask('status', 'status', order.status),
+                    ask('ordered_on', 'date', order.orderedOn, { required: true }),
+                    ask('deliver_by', 'date', order.deliverBy),
+                ],
+            ],
+            [
+                order.lines,
+                [
+                    ask('lines', 'lines', order.items, {
+                        colspan: 2,
+                        field: { fields: { name: { type: 'char', label: order.lineDescription }, quantity: { type: 'float', label: order.quantity }, price: { type: 'float', label: order.unitPrice } } },
+                    }),
+                    ask('total', 'amount', order.total),
+                    ask('notes', 'paragraph', order.notes),
+                ],
+            ],
+        ], words, language),
+    ];
+}
+/** Fieldia's templates in English, as they always were. */
+exports.SURVEY_TEMPLATES = surveyTemplates('en');
+exports.SCREEN_TEMPLATES = screenTemplates('en');
+/** The templates for a page: Fieldia's for a survey or a screen, then the app's that are made the same way. */
+function templatesFor(page, app = [], locale = 'en') {
+    const survey = page.layout.type === 'wizard';
+    const own = locale === 'en' ? (survey ? exports.SURVEY_TEMPLATES : exports.SCREEN_TEMPLATES) : survey ? surveyTemplates(locale) : screenTemplates(locale);
+    return [...own, ...app.filter((t) => (t.page.layout.type === 'wizard') === survey)];
+}
+/** Whether a page has nothing of its own yet: a survey's empty pages, or a screen's empty sections. A sheet and a list start with a field, so they never are. */
+function isBlank(page) {
+    const layout = page.layout;
+    if (layout.type !== 'wizard' && layout.type !== 'sections')
+        return false;
+    if (Object.keys(page.fields).length)
+        return false;
+    return layout.children.every((c) => (c.type === 'step' || c.type === 'section') && !c.children?.length);
+}
+/**
+ * Make `draft` the page `next`, keeping its id and where its answers go: a
+ * survey takes only a survey, a screen only a screen. Refused, saying why,
+ * for what is not a page the designer can open.
+ */
+function replaceWith(draft, next) {
+    if (pageProblem(draft, next))
+        throw new refusal_1.Refusal((w) => pageProblem(draft, next, w));
+    const checked = (0, core_1.checkPage)(next);
+    const { id, data } = draft;
+    for (const key of Object.keys(draft))
+        delete draft[key];
+    Object.assign(draft, JSON.parse(JSON.stringify(checked.page)), { id, data });
+}
+/** Why `next` cannot take the place of `page`, in words, or null when it can: it must be a page, made the way `page` is. */
+function pageProblem(page, next, words = en_1.en) {
+    const w = words.templates;
+    // The format's own words (from @fieldia/core): as it writes them.
+    const issues = (found) => found.map((i) => `${i.path}: ${i.message}`).join('; ');
+    const checked = (0, core_1.checkPage)(next);
+    if (!checked.ok)
+        return w.notAPage(issues(checked.issues));
+    const full = (0, core_1.validatePage)(next);
+    if (!full.ok)
+        return w.notAPage(issues(full.issues));
+    const survey = page.layout.type === 'wizard';
+    if (survey && checked.page.layout.type !== 'wizard')
+        return w.surveyNotScreen;
+    if (!survey && checked.page.layout.type === 'wizard')
+        return w.screenNotSurvey;
+    return null;
+}
+//# sourceMappingURL=templates.js.map

package/src/lib/templates.js.map

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

package/src/lib/templates.mjs

@@ -0,0 +1,186 @@
+import { checkPage, validatePage } from '@fieldia/core';
+import { kindById } from './kinds.mjs';
+import { DESIGNER_WORDS } from './designer-words.mjs';
+import { en } from './locales/en/index.mjs';
+import { Refusal } from './refusal.mjs';
+const ask = (name, kind, label, more = {}) => ({ name, kind, label, ...more });
+const valueOf = (words) => words.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+/** Options in the designer's words, valued by the English ones: a template's answers are stored the same in every language. */
+const choices = (english, said) => english.map((label, i) => ({ value: valueOf(label), label: said[i] ?? label }));
+/** A template's page: its groups — a survey's pages, a screen's sections — and their questions, each made as its kind makes it. */
+function made(kind, id, title, description, groups, words, language) {
+    const fields = {};
+    const nodes = (asks) => asks.map((a) => {
+        const k = kindById(a.kind);
+        const field = { ...k.field(a.label, words), ...(a.field ?? {}) };
+        if (a.required)
+            field.required = true;
+        if (a.help)
+            field.help = a.help;
+        if (a.choices && field.type === 'selection')
+            field.options = a.choices;
+        fields[a.name] = field;
+        return { type: 'field', id: `q-${a.name.replace(/_/g, '-')}`, field: a.name, ...(k.widget ? { widget: k.widget } : {}), ...(a.look ? { options: a.look } : {}), ...(a.colspan ? { colspan: a.colspan } : {}) };
+    });
+    const layout = kind === 'survey'
+        ? { type: 'wizard', id: 'steps', children: groups.map(([label, asks], i) => ({ type: 'step', id: `step-${i + 1}`, label, children: nodes(asks) })) }
+        : { type: 'sections', id: 'sections', children: groups.map(([label, asks], i) => ({ type: 'section', id: `section-${i + 1}`, title: label, columns: 2, children: nodes(asks) })) };
+    const data = kind === 'survey' ? { kind: 'responses' } : { kind: 'record', model: id.replace(/-/g, '.') };
+    // Written in another language than English: the page says so, and its form speaks it.
+    return { id, title, description, page: { fieldia: '0.1', id, title, description, ...(language ? { language } : {}), data, fields, layout } };
+}
+/** Fieldia's surveys to start from, in the designer's language. */
+export function surveyTemplates(locale = 'en') {
+    const words = DESIGNER_WORDS[locale];
+    const language = locale === 'en' ? undefined : locale;
+    const { feedback, event, job } = words.templates;
+    const english = en.templates;
+    return [
+        made('survey', 'feedback', feedback.title, feedback.description, [
+            [
+                feedback.page,
+                [
+                    ask('overall', 'rating', feedback.overall, { required: true }),
+                    ask('liked', 'paragraph', feedback.liked),
+                    ask('better', 'paragraph', feedback.better),
+                    ask('recommend', 'scale', feedback.recommend, { look: { startLabel: feedback.notLikely, endLabel: feedback.veryLikely } }),
+                    ask('email', 'email', feedback.email, { help: feedback.emailHelp }),
+                ],
+            ],
+        ], words, language),
+        made('survey', 'event-registration', event.title, event.description, [
+            [
+                event.aboutYou,
+                [
+                    ask('full_name', 'short-answer', event.fullName, { required: true }),
+                    ask('email', 'email', event.email, { required: true }),
+                    ask('phone', 'phone', event.phone),
+                    ask('organisation', 'short-answer', event.organisation),
+                ],
+            ],
+            [
+                event.yourPlace,
+                [
+                    ask('sessions', 'checkboxes', event.sessions, { required: true, choices: choices(english.event.sessionChoices, event.sessionChoices) }),
+                    ask('diet', 'dropdown', event.diet, { choices: choices(english.event.dietChoices, event.dietChoices) }),
+                    ask('notes', 'paragraph', event.notes),
+                ],
+            ],
+        ], words, language),
+        made('survey', 'job-application', job.title, job.description, [
+            [
+                job.theRole,
+                [
+                    ask('role', 'dropdown', job.role, { required: true, choices: choices(english.job.roleChoices, job.roleChoices) }),
+                    ask('cv', 'file', job.cv, { required: true }),
+                    ask('experience', 'number', job.experience),
+                    ask('start', 'date', job.start),
+                    ask('why', 'paragraph', job.why),
+                ],
+            ],
+            [
+                job.aboutYou,
+                [
+                    ask('full_name', 'short-answer', job.fullName, { required: true }),
+                    ask('email', 'email', job.email, { required: true }),
+                    ask('phone', 'phone', job.phone),
+                    ask('profile', 'short-answer', job.profile),
+                ],
+            ],
+        ], words, language),
+    ];
+}
+/** Fieldia's screens to start from, in the designer's language. */
+export function screenTemplates(locale = 'en') {
+    const words = DESIGNER_WORDS[locale];
+    const language = locale === 'en' ? undefined : locale;
+    const { contact, order } = words.templates;
+    return [
+        made('screen', 'contact', contact.title, contact.description, [
+            [
+                contact.contact,
+                [
+                    ask('name', 'short-answer', contact.name, { required: true }),
+                    ask('company', 'short-answer', contact.company),
+                    ask('email', 'email', contact.email),
+                    ask('phone', 'phone', contact.phone),
+                    ask('website', 'website', contact.website),
+                ],
+            ],
+            [contact.notes, [ask('notes', 'paragraph', contact.notes, { colspan: 2 })]],
+        ], words, language),
+        made('screen', 'order-request', order.title, order.description, [
+            [
+                order.order,
+                [
+                    ask('customer', 'short-answer', order.customer, { required: true }),
+                    ask('status', 'status', order.status),
+                    ask('ordered_on', 'date', order.orderedOn, { required: true }),
+                    ask('deliver_by', 'date', order.deliverBy),
+                ],
+            ],
+            [
+                order.lines,
+                [
+                    ask('lines', 'lines', order.items, {
+                        colspan: 2,
+                        field: { fields: { name: { type: 'char', label: order.lineDescription }, quantity: { type: 'float', label: order.quantity }, price: { type: 'float', label: order.unitPrice } } },
+                    }),
+                    ask('total', 'amount', order.total),
+                    ask('notes', 'paragraph', order.notes),
+                ],
+            ],
+        ], words, language),
+    ];
+}
+/** Fieldia's templates in English, as they always were. */
+export const SURVEY_TEMPLATES = surveyTemplates('en');
+export const SCREEN_TEMPLATES = screenTemplates('en');
+/** The templates for a page: Fieldia's for a survey or a screen, then the app's that are made the same way. */
+export function templatesFor(page, app = [], locale = 'en') {
+    const survey = page.layout.type === 'wizard';
+    const own = locale === 'en' ? (survey ? SURVEY_TEMPLATES : SCREEN_TEMPLATES) : survey ? surveyTemplates(locale) : screenTemplates(locale);
+    return [...own, ...app.filter((t) => (t.page.layout.type === 'wizard') === survey)];
+}
+/** Whether a page has nothing of its own yet: a survey's empty pages, or a screen's empty sections. A sheet and a list start with a field, so they never are. */
+export function isBlank(page) {
+    const layout = page.layout;
+    if (layout.type !== 'wizard' && layout.type !== 'sections')
+        return false;
+    if (Object.keys(page.fields).length)
+        return false;
+    return layout.children.every((c) => (c.type === 'step' || c.type === 'section') && !c.children?.length);
+}
+/**
+ * Make `draft` the page `next`, keeping its id and where its answers go: a
+ * survey takes only a survey, a screen only a screen. Refused, saying why,
+ * for what is not a page the designer can open.
+ */
+export function replaceWith(draft, next) {
+    if (pageProblem(draft, next))
+        throw new Refusal((w) => pageProblem(draft, next, w));
+    const checked = checkPage(next);
+    const { id, data } = draft;
+    for (const key of Object.keys(draft))
+        delete draft[key];
+    Object.assign(draft, JSON.parse(JSON.stringify(checked.page)), { id, data });
+}
+/** Why `next` cannot take the place of `page`, in words, or null when it can: it must be a page, made the way `page` is. */
+export function pageProblem(page, next, words = en) {
+    const w = words.templates;
+    // The format's own words (from @fieldia/core): as it writes them.
+    const issues = (found) => found.map((i) => `${i.path}: ${i.message}`).join('; ');
+    const checked = checkPage(next);
+    if (!checked.ok)
+        return w.notAPage(issues(checked.issues));
+    const full = validatePage(next);
+    if (!full.ok)
+        return w.notAPage(issues(full.issues));
+    const survey = page.layout.type === 'wizard';
+    if (survey && checked.page.layout.type !== 'wizard')
+        return w.surveyNotScreen;
+    if (!survey && checked.page.layout.type === 'wizard')
+        return w.screenNotSurvey;
+    return null;
+}
+//# sourceMappingURL=templates.mjs.map

package/src/lib/templates.mjs.map

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

package/src/lib/toolbox.d.mts

@@ -0,0 +1,49 @@
+import type { ElementFactory } from './chrome.mjs';
+import type { ModelField, QuestionKind } from './designer.mjs';
+import type { DesignerWords } from './designer-words.mjs';
+/**
+ * The toolbox: every kind of field as an icon and a short name, in groups
+ * that fold, with a search — Quantia's toolbox, for forms. The model's fields
+ * come first when there is a model. A tile clicked is added; a tile pressed
+ * is handed to the canvas, which carries it if the pointer moves.
+ *
+ * A tile names what it adds: `kind:<id>`, `model:<field name>` or `layout:section` / `layout:tabs`;
+ * in Advanced, the layout tiles are `block:<kind>` — groups, tabs and the blocks between fields.
+ * `form:saved`, under More, places one of the app's saved forms: the editor asks which.
+ */
+export interface ToolboxOptions {
+    el: ElementFactory;
+    doc: Document;
+    /** The kinds it offers: a survey's, or a screen's. */
+    kinds: readonly QuestionKind[];
+    /** Sections and tabs, for a screen. */
+    layout?: boolean;
+    /** The designer's words. */
+    words: DesignerWords;
+    /** “A saved form”, for a screen: shown while the designer can place one (`update`'s `forms`). */
+    forms?: boolean;
+    onPick(spec: string): void;
+    onPress?(spec: string, event: PointerEvent, tile: HTMLElement): void;
+}
+export interface ToolboxHandle {
+    element: HTMLElement;
+    /** The model's fields still to place, whether tabs can be added, whether new fields can be — a list shows only what the model has — and whether it is Advanced. */
+    update(state: {
+        modelFields: ModelField[];
+        tabs: boolean;
+        kinds?: boolean;
+        advanced?: boolean;
+        forms?: boolean;
+    }): void;
+}
+/** The kinds in the order and groups the toolbox shows them. */
+export declare const TOOLBOX_GROUPS: readonly [string, readonly string[]][];
+/**
+ * The groups for these kinds: Fieldia's, then the app's own — each of its
+ * kinds under the group it names, "Your kinds" unless it names one; a group
+ * Fieldia has takes it at its end.
+ */
+export declare function toolboxGroups(kinds: readonly QuestionKind[]): [string, string[]][];
+/** A toolbox group's title in the designer's words: Fieldia's by their key, an app's as the app named it. */
+export declare function groupName(words: DesignerWords, key: string): string;
+export declare function toolbox(options: ToolboxOptions): ToolboxHandle;

package/src/lib/toolbox.d.ts

@@ -0,0 +1,49 @@
+import type { ElementFactory } from './chrome';
+import type { ModelField, QuestionKind } from './designer';
+import type { DesignerWords } from './designer-words';
+/**
+ * The toolbox: every kind of field as an icon and a short name, in groups
+ * that fold, with a search — Quantia's toolbox, for forms. The model's fields
+ * come first when there is a model. A tile clicked is added; a tile pressed
+ * is handed to the canvas, which carries it if the pointer moves.
+ *
+ * A tile names what it adds: `kind:<id>`, `model:<field name>` or `layout:section` / `layout:tabs`;
+ * in Advanced, the layout tiles are `block:<kind>` — groups, tabs and the blocks between fields.
+ * `form:saved`, under More, places one of the app's saved forms: the editor asks which.
+ */
+export interface ToolboxOptions {
+    el: ElementFactory;
+    doc: Document;
+    /** The kinds it offers: a survey's, or a screen's. */
+    kinds: readonly QuestionKind[];
+    /** Sections and tabs, for a screen. */
+    layout?: boolean;
+    /** The designer's words. */
+    words: DesignerWords;
+    /** “A saved form”, for a screen: shown while the designer can place one (`update`'s `forms`). */
+    forms?: boolean;
+    onPick(spec: string): void;
+    onPress?(spec: string, event: PointerEvent, tile: HTMLElement): void;
+}
+export interface ToolboxHandle {
+    element: HTMLElement;
+    /** The model's fields still to place, whether tabs can be added, whether new fields can be — a list shows only what the model has — and whether it is Advanced. */
+    update(state: {
+        modelFields: ModelField[];
+        tabs: boolean;
+        kinds?: boolean;
+        advanced?: boolean;
+        forms?: boolean;
+    }): void;
+}
+/** The kinds in the order and groups the toolbox shows them. */
+export declare const TOOLBOX_GROUPS: readonly [string, readonly string[]][];
+/**
+ * The groups for these kinds: Fieldia's, then the app's own — each of its
+ * kinds under the group it names, "Your kinds" unless it names one; a group
+ * Fieldia has takes it at its end.
+ */
+export declare function toolboxGroups(kinds: readonly QuestionKind[]): [string, string[]][];
+/** A toolbox group's title in the designer's words: Fieldia's by their key, an app's as the app named it. */
+export declare function groupName(words: DesignerWords, key: string): string;
+export declare function toolbox(options: ToolboxOptions): ToolboxHandle;