@cratis/scene.blueprint.default 4.38.0 → 4.40.0

package/dist/esm/foundation/WizardProgress.js

@@ -0,0 +1,183 @@
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { useMemo, useState, useEffect } from 'react';
+import { useValueOutput } from '@cratis/scene.react';
+import { readOptionalString } from '../shell/elementProperties.js';
+import { readComponentState, ComponentState } from './ComponentState.js';
+import { FoundationIcon } from './FoundationIcon.js';
+import { readFoundationStrings, formatText } from './foundationStrings.js';
+import { FoundationFrame } from './StateFrame.js';
+import { readWizardSteps, reachableStep, statusOf, canOpen, StepStatus, neighbour } from './wizardModel.js';
+import { ActionButton } from './ActionButton.js';
+import { useUrlState } from './urlState.js';
+
+const storageKey = (element, key)=>`scene.wizard.${key ?? element.id}`;
+/**
+ * The completed steps saved in the session, or none. Storage can be absent or refuse access - server rendering, a sandboxed frame, a browser in a
+ * private mode - and a wizard that cannot remember its progress is still a wizard, so every storage access is guarded and a failure only loses the memory.
+ */ function readSaved(key) {
+    try {
+        const saved = JSON.parse(window.sessionStorage.getItem(key) ?? '[]');
+        return new Set(Array.isArray(saved) ? saved.filter((id)=>typeof id === 'string') : []);
+    } catch  {
+        return new Set();
+    }
+}
+/** Saves the completed steps for the session; a refusal by the browser is ignored (see {@link readSaved}). */ function writeSaved(key, completed) {
+    try {
+        window.sessionStorage.setItem(key, JSON.stringify([
+            ...completed
+        ]));
+    } catch  {
+    // The progress is simply not remembered across a refresh.
+    }
+}
+/**
+ * The `wizardProgress` component: the steps of a linear wizard, the back/next/finish controls and the draft save, with the step's own content in
+ * the slot named by its id.
+ *
+ * `steps` (`id`, `label`, `valid`) are linear. Next is blocked while the current step is not `valid`, and says so. The final step is the review step: Finish
+ * replaces Next. Completed steps stay in a progress list and can be revisited; a step cannot be opened before the ones ahead of it are done. The current step
+ * (in the address under `urlKey`) and the completed steps (in the session) are restored on refresh, and a refresh can never land past a step that was not
+ * done. The id of the current step is the `value` output; "Save draft" runs the behaviors attached to the element and says so.
+ */ function WizardProgress({ element, interactions, slots, bindingOutputs }) {
+    const steps = useMemo(()=>readWizardSteps(element.properties.steps), [
+        element.properties.steps
+    ]);
+    const urlKey = readOptionalString(element, 'urlKey');
+    const [requested, setRequested] = useUrlState(urlKey, readOptionalString(element, 'currentStep'));
+    const key = storageKey(element, urlKey);
+    const [completed, setCompleted] = useState(()=>readSaved(key));
+    const [draftSaved, setDraftSaved] = useState(false);
+    const strings = readFoundationStrings(element);
+    const state = readComponentState(element, steps.length > 0);
+    const current = reachableStep(steps, completed, requested);
+    const index = steps.findIndex((step)=>step.id === current);
+    const step = steps[index];
+    const last = index === steps.length - 1;
+    useEffect(()=>writeSaved(key, completed), [
+        key,
+        completed
+    ]);
+    useValueOutput(bindingOutputs, current);
+    const go = (id)=>{
+        if (id === undefined) return;
+        setRequested(id);
+        setDraftSaved(false);
+        interactions?.onSelect?.();
+    };
+    const next = ()=>{
+        if (!step?.valid) return;
+        setCompleted((current_)=>new Set(current_).add(step.id));
+        go(neighbour(steps, current, 1)?.id);
+    };
+    const finish = ()=>{
+        if (!step?.valid) return;
+        setCompleted((current_)=>new Set(current_).add(step.id));
+        interactions?.onClick?.({
+            stopPropagation: ()=>undefined
+        });
+    };
+    return /*#__PURE__*/ jsx(FoundationFrame, {
+        element: element,
+        interactions: interactions,
+        name: "wizard",
+        state: state,
+        skeleton: [
+            100,
+            60,
+            100
+        ],
+        children: state !== ComponentState.Loading && step && /*#__PURE__*/ jsxs(Fragment, {
+            children: [
+                /*#__PURE__*/ jsx("nav", {
+                    "aria-label": strings.wizardProgress,
+                    children: /*#__PURE__*/ jsx("ol", {
+                        className: "foundation-wizard-steps",
+                        children: steps.map((candidate, position)=>{
+                            const status = statusOf(completed, current, candidate.id);
+                            const open = canOpen(steps, completed, candidate.id);
+                            const text = status === StepStatus.Completed ? strings.wizardComplete : status === StepStatus.Current ? strings.wizardCurrent : strings.wizardUpcoming;
+                            return /*#__PURE__*/ jsx("li", {
+                                className: "foundation-wizard-step",
+                                "data-status": status,
+                                children: /*#__PURE__*/ jsxs("button", {
+                                    type: "button",
+                                    "aria-current": status === StepStatus.Current ? 'step' : undefined,
+                                    disabled: !open,
+                                    onClick: ()=>go(candidate.id),
+                                    children: [
+                                        /*#__PURE__*/ jsx("span", {
+                                            className: "foundation-wizard-marker",
+                                            children: status === StepStatus.Completed ? /*#__PURE__*/ jsx(FoundationIcon, {
+                                                name: "check"
+                                            }) : position + 1
+                                        }),
+                                        /*#__PURE__*/ jsx("span", {
+                                            children: candidate.label
+                                        }),
+                                        /*#__PURE__*/ jsx("span", {
+                                            className: "foundation-visually-hidden",
+                                            children: `, ${formatText(strings.wizardStep, {
+                                                n: position + 1,
+                                                total: steps.length
+                                            })}, ${text}`
+                                        })
+                                    ]
+                                })
+                            }, candidate.id);
+                        })
+                    })
+                }),
+                /*#__PURE__*/ jsx("div", {
+                    className: "foundation-wizard-body",
+                    role: "group",
+                    "aria-label": `${formatText(strings.wizardStep, {
+                        n: index + 1,
+                        total: steps.length
+                    })}: ${step.label}`,
+                    children: slots?.[step.id]
+                }),
+                /*#__PURE__*/ jsxs("div", {
+                    className: "foundation-wizard-actions",
+                    children: [
+                        /*#__PURE__*/ jsx(ActionButton, {
+                            emphasis: "quiet",
+                            disabledReason: strings.disabledNoPermission,
+                            onClick: ()=>{
+                                setDraftSaved(true);
+                                interactions?.onClick?.({
+                                    stopPropagation: ()=>undefined
+                                });
+                            },
+                            children: strings.wizardSaveDraft
+                        }),
+                        /*#__PURE__*/ jsx("span", {
+                            role: "status",
+                            className: "foundation-count",
+                            children: draftSaved ? strings.wizardDraftSaved : ''
+                        }),
+                        /*#__PURE__*/ jsx("span", {
+                            className: "foundation-wizard-spacer"
+                        }),
+                        index > 0 && /*#__PURE__*/ jsx(ActionButton, {
+                            emphasis: "secondary",
+                            disabledReason: strings.disabledNoPermission,
+                            onClick: ()=>go(neighbour(steps, current, -1)?.id),
+                            children: strings.wizardBack
+                        }),
+                        /*#__PURE__*/ jsx("button", {
+                            type: "button",
+                            className: "foundation-button",
+                            "aria-disabled": !step.valid || undefined,
+                            onClick: last ? finish : next,
+                            children: last ? strings.wizardFinish : strings.wizardNext
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+
+export { WizardProgress };
+//# sourceMappingURL=WizardProgress.js.map

package/dist/esm/foundation/WizardProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WizardProgress.js","sources":["../../../foundation/WizardProgress.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useEffect, useMemo, useState } from 'react';\nimport { RegisteredComponentProps, useValueOutput } from '@cratis/scene.react';\nimport { readOptionalString } from '../shell/elementProperties';\nimport { ComponentState, readComponentState } from './ComponentState';\nimport { FoundationIcon } from './FoundationIcon';\nimport { formatText, readFoundationStrings } from './foundationStrings';\nimport { FoundationFrame } from './StateFrame';\nimport { StepStatus, canOpen, neighbour, readWizardSteps, reachableStep, statusOf } from './wizardModel';\nimport { ActionButton } from './ActionButton';\nimport { useUrlState } from './urlState';\n\nconst storageKey = (element: { id: string }, key: string | undefined) => `scene.wizard.${key ?? element.id}`;\n\n/**\n * The completed steps saved in the session, or none. Storage can be absent or refuse access - server rendering, a sandboxed frame, a browser in a\n * private mode - and a wizard that cannot remember its progress is still a wizard, so every storage access is guarded and a failure only loses the memory.\n */\nfunction readSaved(key: string): Set<string> {\n    try {\n        const saved = JSON.parse(window.sessionStorage.getItem(key) ?? '[]') as unknown;\n        return new Set(Array.isArray(saved) ? saved.filter((id): id is string => typeof id === 'string') : []);\n    } catch {\n        return new Set();\n    }\n}\n\n/** Saves the completed steps for the session; a refusal by the browser is ignored (see {@link readSaved}). */\nfunction writeSaved(key: string, completed: Set<string>): void {\n    try {\n        window.sessionStorage.setItem(key, JSON.stringify([...completed]));\n    } catch {\n        // The progress is simply not remembered across a refresh.\n    }\n}\n\n/**\n * The `wizardProgress` component: the steps of a linear wizard, the back/next/finish controls and the draft save, with the step's own content in\n * the slot named by its id.\n *\n * `steps` (`id`, `label`, `valid`) are linear. Next is blocked while the current step is not `valid`, and says so. The final step is the review step: Finish\n * replaces Next. Completed steps stay in a progress list and can be revisited; a step cannot be opened before the ones ahead of it are done. The current step\n * (in the address under `urlKey`) and the completed steps (in the session) are restored on refresh, and a refresh can never land past a step that was not\n * done. The id of the current step is the `value` output; \"Save draft\" runs the behaviors attached to the element and says so.\n */\nexport function WizardProgress({ element, interactions, slots, bindingOutputs }: RegisteredComponentProps) {\n    const steps = useMemo(() => readWizardSteps(element.properties.steps), [element.properties.steps]);\n    const urlKey = readOptionalString(element, 'urlKey');\n    const [requested, setRequested] = useUrlState(urlKey, readOptionalString(element, 'currentStep'));\n    const key = storageKey(element, urlKey);\n    const [completed, setCompleted] = useState<Set<string>>(() => readSaved(key));\n    const [draftSaved, setDraftSaved] = useState(false);\n    const strings = readFoundationStrings(element);\n    const state = readComponentState(element, steps.length > 0);\n    const current = reachableStep(steps, completed, requested);\n    const index = steps.findIndex(step => step.id === current);\n    const step = steps[index];\n    const last = index === steps.length - 1;\n\n    useEffect(() => writeSaved(key, completed), [key, completed]);\n    useValueOutput(bindingOutputs, current);\n\n    const go = (id: string | undefined) => { if (id === undefined) return; setRequested(id); setDraftSaved(false); interactions?.onSelect?.(); };\n    const next = () => {\n        if (!step?.valid) return;\n        setCompleted(current_ => new Set(current_).add(step.id));\n        go(neighbour(steps, current, 1)?.id);\n    };\n    const finish = () => { if (!step?.valid) return; setCompleted(current_ => new Set(current_).add(step.id)); interactions?.onClick?.({ stopPropagation: () => undefined }); };\n\n    return (\n        <FoundationFrame element={element} interactions={interactions} name='wizard' state={state} skeleton={[100, 60, 100]}>\n            {state !== ComponentState.Loading && step && (\n                <>\n                    <nav aria-label={strings.wizardProgress}>\n                        <ol className='foundation-wizard-steps'>\n                            {steps.map((candidate, position) => {\n                                const status = statusOf(completed, current, candidate.id);\n                                const open = canOpen(steps, completed, candidate.id);\n                                const text = status === StepStatus.Completed ? strings.wizardComplete : status === StepStatus.Current ? strings.wizardCurrent : strings.wizardUpcoming;\n                                return (\n                                    <li key={candidate.id} className='foundation-wizard-step' data-status={status}>\n                                        <button type='button' aria-current={status === StepStatus.Current ? 'step' : undefined} disabled={!open} onClick={() => go(candidate.id)}>\n                                            <span className='foundation-wizard-marker'>{status === StepStatus.Completed ? <FoundationIcon name='check' /> : position + 1}</span>\n                                            <span>{candidate.label}</span>\n                                            <span className='foundation-visually-hidden'>{`, ${formatText(strings.wizardStep, { n: position + 1, total: steps.length })}, ${text}`}</span>\n                                        </button>\n                                    </li>\n                                );\n                            })}\n                        </ol>\n                    </nav>\n                    <div className='foundation-wizard-body' role='group' aria-label={`${formatText(strings.wizardStep, { n: index + 1, total: steps.length })}: ${step.label}`}>\n                        {slots?.[step.id]}\n                    </div>\n                    <div className='foundation-wizard-actions'>\n                        <ActionButton emphasis='quiet' disabledReason={strings.disabledNoPermission} onClick={() => { setDraftSaved(true); interactions?.onClick?.({ stopPropagation: () => undefined }); }}>{strings.wizardSaveDraft}</ActionButton>\n                        <span role='status' className='foundation-count'>{draftSaved ? strings.wizardDraftSaved : ''}</span>\n                        <span className='foundation-wizard-spacer' />\n                        {index > 0 && <ActionButton emphasis='secondary' disabledReason={strings.disabledNoPermission} onClick={() => go(neighbour(steps, current, -1)?.id)}>{strings.wizardBack}</ActionButton>}\n                        <button type='button' className='foundation-button' aria-disabled={!step.valid || undefined} onClick={last ? finish : next}>{last ? strings.wizardFinish : strings.wizardNext}</button>\n                    </div>\n                </>\n            )}\n        </FoundationFrame>\n    );\n}\n"],"names":["storageKey","element","key","id","readSaved","saved","JSON","parse","window","sessionStorage","getItem","Set","Array","isArray","filter","writeSaved","completed","setItem","stringify","WizardProgress","interactions","slots","bindingOutputs","steps","useMemo","readWizardSteps","properties","urlKey","readOptionalString","requested","setRequested","useUrlState","setCompleted","useState","draftSaved","setDraftSaved","strings","readFoundationStrings","state","readComponentState","length","current","reachableStep","index","findIndex","step","last","useEffect","useValueOutput","go","undefined","onSelect","next","valid","current_","add","neighbour","finish","onClick","stopPropagation","_jsx","FoundationFrame","name","skeleton","ComponentState","Loading","_jsxs","_Fragment","nav","aria-label","wizardProgress","ol","className","map","candidate","position","status","statusOf","open","canOpen","text","StepStatus","Completed","wizardComplete","Current","wizardCurrent","wizardUpcoming","li","data-status","button","type","aria-current","disabled","span","FoundationIcon","label","formatText","wizardStep","n","total","div","role","ActionButton","emphasis","disabledReason","disabledNoPermission","wizardSaveDraft","wizardDraftSaved","wizardBack","aria-disabled","wizardFinish","wizardNext"],"mappings":"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"}

package/dist/esm/foundation/boardModel.d.ts

@@ -0,0 +1,22 @@
+export interface BoardColumn {
+    id: string;
+    label: string;
+    limit: number;
+}
+export interface BoardCard {
+    id: string;
+    title: string;
+    column: string;
+    assignee?: string;
+    fields: {
+        label: string;
+        value: string;
+    }[];
+    badges: string[];
+}
+export declare function readColumnsOfBoard(value: unknown): BoardColumn[];
+export declare function readCards(value: unknown): BoardCard[];
+export declare function cardsOf(columns: BoardColumn[], cards: BoardCard[], column: string): BoardCard[];
+export declare function moveCard(columns: BoardColumn[], cards: BoardCard[], id: string, to: string): BoardCard[];
+export declare const overLimit: (column: BoardColumn, count: number) => boolean;
+//# sourceMappingURL=boardModel.d.ts.map

package/dist/esm/foundation/boardModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boardModel.d.ts","sourceRoot":"","sources":["../../../foundation/boardModel.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IAEd,KAAK,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAOhE;AAGD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAAE,CAYrD;AAGD,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAG/F;AAGD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,CAIxG;AAGD,eAAO,MAAM,SAAS,WAAY,WAAW,SAAS,MAAM,KAAG,OAAmD,CAAC"}

package/dist/esm/foundation/boardModel.js

@@ -0,0 +1,61 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** One column of a board, mapped to a status or stage value. */ const records = (value)=>Array.isArray(value) ? value.filter((entry)=>typeof entry === 'object' && entry !== null && !Array.isArray(entry)) : [];
+/** Reads columns, dropping those without an id and repeated ids. */ function readColumnsOfBoard(value) {
+    const seen = new Set();
+    return records(value).flatMap((entry)=>{
+        if (typeof entry.id !== 'string' || entry.id.length === 0 || seen.has(entry.id)) return [];
+        seen.add(entry.id);
+        return [
+            {
+                id: entry.id,
+                label: typeof entry.label === 'string' && entry.label.length > 0 ? entry.label : entry.id,
+                limit: typeof entry.limit === 'number' && entry.limit > 0 ? Math.floor(entry.limit) : 0
+            }
+        ];
+    });
+}
+/** Reads cards, dropping those without an id or a title, keeping at most three key fields. */ function readCards(value) {
+    const seen = new Set();
+    return records(value).flatMap((entry)=>{
+        if (typeof entry.id !== 'string' || entry.id.length === 0 || seen.has(entry.id) || typeof entry.title !== 'string') return [];
+        seen.add(entry.id);
+        const fields = records(entry.fields).flatMap((field)=>typeof field.label === 'string' && typeof field.value === 'string' ? [
+                {
+                    label: field.label,
+                    value: field.value
+                }
+            ] : []).slice(0, 3);
+        return [
+            {
+                id: entry.id,
+                title: entry.title,
+                column: typeof entry.column === 'string' ? entry.column : '',
+                fields,
+                badges: Array.isArray(entry.badges) ? entry.badges.filter((badge)=>typeof badge === 'string') : [],
+                ...typeof entry.assignee === 'string' ? {
+                    assignee: entry.assignee
+                } : {}
+            }
+        ];
+    });
+}
+/** The cards of one column, in the order given. A card whose column does not exist is shown in the first column rather than lost. */ function cardsOf(columns, cards, column) {
+    const known = new Set(columns.map((candidate)=>candidate.id));
+    return cards.filter((card)=>card.column === column || column === columns[0]?.id && !known.has(card.column));
+}
+/** Moves a card to a column, at the end; moving to the column it is in, or to one that does not exist, changes nothing. */ function moveCard(columns, cards, id, to) {
+    const card = cards.find((candidate)=>candidate.id === id);
+    if (!card || !columns.some((column)=>column.id === to) || cardsOf(columns, cards, to).includes(card)) return cards;
+    return [
+        ...cards.filter((candidate)=>candidate.id !== id),
+        {
+            ...card,
+            column: to
+        }
+    ];
+}
+/** Whether a column holds more cards than its limit. */ const overLimit = (column, count)=>column.limit > 0 && count > column.limit;
+
+export { cardsOf, moveCard, overLimit, readCards, readColumnsOfBoard };
+//# sourceMappingURL=boardModel.js.map

package/dist/esm/foundation/boardModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boardModel.js","sources":["../../../foundation/boardModel.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/** One column of a board, mapped to a status or stage value. */\nexport interface BoardColumn {\n    id: string;\n    label: string;\n    /** The most cards the stage should hold; 0 means no limit. */\n    limit: number;\n}\n\n/** One card: the title, an assignee, a few key fields and badges. */\nexport interface BoardCard {\n    id: string;\n    title: string;\n    column: string;\n    assignee?: string;\n    fields: { label: string; value: string }[];\n    badges: string[];\n}\n\nconst records = (value: unknown): Record<string, unknown>[] =>\n    Array.isArray(value) ? value.filter((entry): entry is Record<string, unknown> => typeof entry === 'object' && entry !== null && !Array.isArray(entry)) : [];\n\n/** Reads columns, dropping those without an id and repeated ids. */\nexport function readColumnsOfBoard(value: unknown): BoardColumn[] {\n    const seen = new Set<string>();\n    return records(value).flatMap(entry => {\n        if (typeof entry.id !== 'string' || entry.id.length === 0 || seen.has(entry.id)) return [];\n        seen.add(entry.id);\n        return [{ id: entry.id, label: typeof entry.label === 'string' && entry.label.length > 0 ? entry.label : entry.id, limit: typeof entry.limit === 'number' && entry.limit > 0 ? Math.floor(entry.limit) : 0 }];\n    });\n}\n\n/** Reads cards, dropping those without an id or a title, keeping at most three key fields. */\nexport function readCards(value: unknown): BoardCard[] {\n    const seen = new Set<string>();\n    return records(value).flatMap(entry => {\n        if (typeof entry.id !== 'string' || entry.id.length === 0 || seen.has(entry.id) || typeof entry.title !== 'string') return [];\n        seen.add(entry.id);\n        const fields = records(entry.fields).flatMap(field => (typeof field.label === 'string' && typeof field.value === 'string' ? [{ label: field.label, value: field.value }] : [])).slice(0, 3);\n        return [{\n            id: entry.id, title: entry.title, column: typeof entry.column === 'string' ? entry.column : '', fields,\n            badges: Array.isArray(entry.badges) ? entry.badges.filter((badge): badge is string => typeof badge === 'string') : [],\n            ...(typeof entry.assignee === 'string' ? { assignee: entry.assignee } : {}),\n        }];\n    });\n}\n\n/** The cards of one column, in the order given. A card whose column does not exist is shown in the first column rather than lost. */\nexport function cardsOf(columns: BoardColumn[], cards: BoardCard[], column: string): BoardCard[] {\n    const known = new Set(columns.map(candidate => candidate.id));\n    return cards.filter(card => card.column === column || (column === columns[0]?.id && !known.has(card.column)));\n}\n\n/** Moves a card to a column, at the end; moving to the column it is in, or to one that does not exist, changes nothing. */\nexport function moveCard(columns: BoardColumn[], cards: BoardCard[], id: string, to: string): BoardCard[] {\n    const card = cards.find(candidate => candidate.id === id);\n    if (!card || !columns.some(column => column.id === to) || cardsOf(columns, cards, to).includes(card)) return cards;\n    return [...cards.filter(candidate => candidate.id !== id), { ...card, column: to }];\n}\n\n/** Whether a column holds more cards than its limit. */\nexport const overLimit = (column: BoardColumn, count: number): boolean => column.limit > 0 && count > column.limit;\n"],"names":["records","value","Array","isArray","filter","entry","readColumnsOfBoard","seen","Set","flatMap","id","length","has","add","label","limit","Math","floor","readCards","title","fields","field","slice","column","badges","badge","assignee","cardsOf","columns","cards","known","map","candidate","card","moveCard","to","find","some","includes","overLimit","count"],"mappings":"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"}

package/dist/esm/foundation/formModel.d.ts

@@ -0,0 +1,48 @@
+export declare enum FormFieldType {
+    Text = "text",
+    Number = "number",
+    Currency = "currency",
+    Date = "date",
+    Select = "select",
+    MultiSelect = "multiSelect",
+    Lookup = "lookup",
+    Toggle = "toggle",
+    File = "file",
+    RichText = "richText",
+    Address = "address"
+}
+export interface FormField {
+    name: string;
+    label: string;
+    type: FormFieldType;
+    required: boolean;
+    options: string[];
+    span: number;
+    placeholder?: string;
+    help?: string;
+}
+export interface FormSection {
+    id: string;
+    title: string;
+    columns: number;
+    fields: FormField[];
+}
+export type FormValues = Record<string, unknown>;
+export declare enum FormMode {
+    Create = "create",
+    Edit = "edit",
+    ReadOnly = "readOnly",
+    Settings = "settings"
+}
+export declare const addressLines: readonly ['street', 'postalCode', 'city', 'country'];
+export declare const readFormMode: (value: unknown) => FormMode;
+export declare function readFormSections(value: unknown): FormSection[];
+export declare function isFilled(field: FormField, value: unknown): boolean;
+export declare function problemOf(field: FormField, value: unknown): 'required' | 'invalid' | undefined;
+export declare function validate(sections: FormSection[], values: FormValues): Record<string, 'required' | 'invalid'>;
+export declare function sameValues(left: FormValues, right: FormValues): boolean;
+export declare function mapServerErrors(sections: FormSection[], errors: unknown): {
+    byField: Record<string, string>;
+    general: string[];
+};
+//# sourceMappingURL=formModel.d.ts.map

package/dist/esm/foundation/formModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formModel.d.ts","sourceRoot":"","sources":["../../../foundation/formModel.ts"],"names":[],"mappings":"AAIA,oBAAY,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,WAAW,gBAAgB;IAC3B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;CACtB;AAGD,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;CACvB;AAGD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGjD,oBAAY,QAAQ;IAChB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACxB;AAGD,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAMjF,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,QAAqH,CAAC;AAGpK,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAoB9D;AAGD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CASlE;AAGD,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAS9F;AAGD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,CAQ5G;AAGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAGvE;AAUD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAchI"}

package/dist/esm/foundation/formModel.js

@@ -0,0 +1,147 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The field types a form offers (Part B 2.8). */ var FormFieldType = /*#__PURE__*/ function(FormFieldType) {
+    FormFieldType["Text"] = "text";
+    FormFieldType["Number"] = "number";
+    FormFieldType["Currency"] = "currency";
+    FormFieldType["Date"] = "date";
+    FormFieldType["Select"] = "select";
+    FormFieldType["MultiSelect"] = "multiSelect";
+    FormFieldType["Lookup"] = "lookup";
+    FormFieldType["Toggle"] = "toggle";
+    FormFieldType["File"] = "file";
+    FormFieldType["RichText"] = "richText";
+    FormFieldType["Address"] = "address";
+    return FormFieldType;
+}({});
+/** The ways the one form can be used (Part B 2.8). */ var FormMode = /*#__PURE__*/ function(FormMode) {
+    FormMode["Create"] = "create";
+    FormMode["Edit"] = "edit";
+    FormMode["ReadOnly"] = "readOnly";
+    FormMode["Settings"] = "settings";
+    return FormMode;
+}({});
+/** The lines of an address, in the order they are asked. */ const addressLines = [
+    'street',
+    'postalCode',
+    'city',
+    'country'
+];
+const records = (value)=>Array.isArray(value) ? value.filter((entry)=>typeof entry === 'object' && entry !== null && !Array.isArray(entry)) : [];
+/** Reads the mode, defaulting to create. */ const readFormMode = (value)=>Object.values(FormMode).includes(value) ? value : "create";
+/** Reads sections, with their fields, dropping fields without a name and repeated names; a section grid is clamped to one to three columns. */ function readFormSections(value) {
+    const names = new Set();
+    return records(value).flatMap((section, index)=>{
+        const columns = typeof section.columns === 'number' ? Math.min(3, Math.max(1, Math.floor(section.columns))) : 1;
+        const fields = records(section.fields).flatMap((entry)=>{
+            if (typeof entry.name !== 'string' || entry.name.length === 0 || names.has(entry.name)) return [];
+            names.add(entry.name);
+            return [
+                {
+                    name: entry.name,
+                    label: typeof entry.label === 'string' && entry.label.length > 0 ? entry.label : entry.name,
+                    type: Object.values(FormFieldType).includes(entry.type) ? entry.type : "text",
+                    required: entry.required === true,
+                    options: Array.isArray(entry.options) ? entry.options.filter((option)=>typeof option === 'string') : [],
+                    span: typeof entry.span === 'number' ? Math.min(columns, Math.max(1, Math.floor(entry.span))) : 1,
+                    ...typeof entry.placeholder === 'string' ? {
+                        placeholder: entry.placeholder
+                    } : {},
+                    ...typeof entry.help === 'string' ? {
+                        help: entry.help
+                    } : {}
+                }
+            ];
+        });
+        return [
+            {
+                id: typeof section.id === 'string' && section.id.length > 0 ? section.id : `section-${index}`,
+                title: typeof section.title === 'string' ? section.title : '',
+                columns,
+                fields
+            }
+        ];
+    });
+}
+/** Whether a field holds a value: an empty or blank text, an empty list, a toggle left false (a required toggle must be on) or an address with no street and city are empty. */ function isFilled(field, value) {
+    switch(field.type){
+        case "toggle":
+            return value === true;
+        case "multiSelect":
+            return Array.isArray(value) && value.length > 0;
+        case "file":
+            return Array.isArray(value) ? value.length > 0 : typeof value === 'string' && value.trim().length > 0;
+        case "address":
+            return typeof value === 'object' && value !== null && [
+                'street',
+                'city'
+            ].every((line)=>typeof value[line] === 'string' && value[line].trim().length > 0);
+        case "number":
+        case "currency":
+            return typeof value === 'number' ? Number.isFinite(value) : typeof value === 'string' && value.trim().length > 0 && Number.isFinite(Number(value));
+        default:
+            return typeof value === 'string' ? value.trim().length > 0 : value !== undefined && value !== null && value !== '';
+    }
+}
+/** Why a field is invalid, as a kind the component words in the locale: `required`, `invalid`, or undefined when it is fine. An empty optional field is fine. */ function problemOf(field, value) {
+    if (!isFilled(field, value)) {
+        const empty = value === undefined || value === null || value === '' || typeof value === 'string' && value.trim() === '' || Array.isArray(value) && value.length === 0 || value === false;
+        return field.required ? 'required' : empty ? undefined : 'invalid';
+    }
+    if (field.type === "date" && typeof value === 'string' && Number.isNaN(new Date(value).getTime())) return 'invalid';
+    if ((field.type === "select" || field.type === "lookup") && field.options.length > 0 && typeof value === 'string' && !field.options.includes(value)) return 'invalid';
+    return undefined;
+}
+/** The problems of every field, by field name, for the fields in the given sections. */ function validate(sections, values) {
+    const problems = {};
+    for (const field of sections.flatMap((section)=>section.fields)){
+        const problem = problemOf(field, values[field.name]);
+        if (problem) problems[field.name] = problem;
+    }
+    return problems;
+}
+/** Whether two sets of values are the same, field by field and in depth, so the unsaved-changes guard compares what the person sees. */ function sameValues(left, right) {
+    const keys = new Set([
+        ...Object.keys(left),
+        ...Object.keys(right)
+    ]);
+    return [
+        ...keys
+    ].every((key)=>JSON.stringify(normalizeValue(left[key])) === JSON.stringify(normalizeValue(right[key])));
+}
+function normalizeValue(value) {
+    if (value === undefined || value === null || value === '' || value === false) return null;
+    if (Array.isArray(value)) return value.length === 0 ? null : value;
+    if (typeof value === 'object') {
+        const entries = Object.entries(value).filter(([, line])=>line !== '' && line !== undefined).sort(([a], [b])=>a.localeCompare(b));
+        return entries.length === 0 ? null : entries;
+    }
+    return value;
+}
+/** Maps a server's field errors (`{ field: message }` or `[{ field, message }]`) onto the fields of the form; an error for a field the form does not have is returned as a general one so it is never lost. */ function mapServerErrors(sections, errors) {
+    const known = new Set(sections.flatMap((section)=>section.fields.map((field)=>field.name)));
+    const pairs = Array.isArray(errors) ? records(errors).flatMap((entry)=>typeof entry.message === 'string' ? [
+            [
+                typeof entry.field === 'string' ? entry.field : '',
+                entry.message
+            ]
+        ] : []) : typeof errors === 'object' && errors !== null ? Object.entries(errors).flatMap(([field, message])=>typeof message === 'string' ? [
+            [
+                field,
+                message
+            ]
+        ] : []) : [];
+    const byField = {};
+    const general = [];
+    for (const [field, message] of pairs){
+        if (known.has(field) && byField[field] === undefined) byField[field] = message;
+        else general.push(field && !known.has(field) ? `${field}: ${message}` : message);
+    }
+    return {
+        byField,
+        general
+    };
+}
+
+export { FormFieldType, FormMode, addressLines, isFilled, mapServerErrors, problemOf, readFormMode, readFormSections, sameValues, validate };
+//# sourceMappingURL=formModel.js.map

package/dist/esm/foundation/formModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formModel.js","sources":["../../../foundation/formModel.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/** The field types a form offers (Part B 2.8). */\nexport enum FormFieldType {\n    Text = 'text',\n    Number = 'number',\n    Currency = 'currency',\n    Date = 'date',\n    Select = 'select',\n    MultiSelect = 'multiSelect',\n    Lookup = 'lookup',\n    Toggle = 'toggle',\n    File = 'file',\n    RichText = 'richText',\n    Address = 'address',\n}\n\n/** One field of a form section. */\nexport interface FormField {\n    name: string;\n    label: string;\n    type: FormFieldType;\n    required: boolean;\n    options: string[];\n    /** The columns of the section grid the field spans (1 to 3). */\n    span: number;\n    placeholder?: string;\n    help?: string;\n}\n\n/** A titled group of fields in a grid of one to three columns. */\nexport interface FormSection {\n    id: string;\n    title: string;\n    columns: number;\n    fields: FormField[];\n}\n\n/** The values of a form by field name; a multi-select is an array, a toggle a boolean, an address an object of lines. */\nexport type FormValues = Record<string, unknown>;\n\n/** The ways the one form can be used (Part B 2.8). */\nexport enum FormMode {\n    Create = 'create',\n    Edit = 'edit',\n    ReadOnly = 'readOnly',\n    Settings = 'settings',\n}\n\n/** The lines of an address, in the order they are asked. */\nexport const addressLines = ['street', 'postalCode', 'city', 'country'] as const;\n\nconst records = (value: unknown): Record<string, unknown>[] =>\n    Array.isArray(value) ? value.filter((entry): entry is Record<string, unknown> => typeof entry === 'object' && entry !== null && !Array.isArray(entry)) : [];\n\n/** Reads the mode, defaulting to create. */\nexport const readFormMode = (value: unknown): FormMode => ((Object.values(FormMode) as string[]).includes(value as string) ? (value as FormMode) : FormMode.Create);\n\n/** Reads sections, with their fields, dropping fields without a name and repeated names; a section grid is clamped to one to three columns. */\nexport function readFormSections(value: unknown): FormSection[] {\n    const names = new Set<string>();\n    return records(value).flatMap((section, index) => {\n        const columns = typeof section.columns === 'number' ? Math.min(3, Math.max(1, Math.floor(section.columns))) : 1;\n        const fields = records(section.fields).flatMap((entry): FormField[] => {\n            if (typeof entry.name !== 'string' || entry.name.length === 0 || names.has(entry.name)) return [];\n            names.add(entry.name);\n            return [{\n                name: entry.name,\n                label: typeof entry.label === 'string' && entry.label.length > 0 ? entry.label : entry.name,\n                type: (Object.values(FormFieldType) as string[]).includes(entry.type as string) ? (entry.type as FormFieldType) : FormFieldType.Text,\n                required: entry.required === true,\n                options: Array.isArray(entry.options) ? entry.options.filter((option): option is string => typeof option === 'string') : [],\n                span: typeof entry.span === 'number' ? Math.min(columns, Math.max(1, Math.floor(entry.span))) : 1,\n                ...(typeof entry.placeholder === 'string' ? { placeholder: entry.placeholder } : {}),\n                ...(typeof entry.help === 'string' ? { help: entry.help } : {}),\n            }];\n        });\n        return [{ id: typeof section.id === 'string' && section.id.length > 0 ? section.id : `section-${index}`, title: typeof section.title === 'string' ? section.title : '', columns, fields }];\n    });\n}\n\n/** Whether a field holds a value: an empty or blank text, an empty list, a toggle left false (a required toggle must be on) or an address with no street and city are empty. */\nexport function isFilled(field: FormField, value: unknown): boolean {\n    switch (field.type) {\n        case FormFieldType.Toggle: return value === true;\n        case FormFieldType.MultiSelect: return Array.isArray(value) && value.length > 0;\n        case FormFieldType.File: return Array.isArray(value) ? value.length > 0 : typeof value === 'string' && value.trim().length > 0;\n        case FormFieldType.Address: return typeof value === 'object' && value !== null && ['street', 'city'].every(line => typeof (value as Record<string, unknown>)[line] === 'string' && ((value as Record<string, unknown>)[line] as string).trim().length > 0);\n        case FormFieldType.Number: case FormFieldType.Currency: return typeof value === 'number' ? Number.isFinite(value) : typeof value === 'string' && value.trim().length > 0 && Number.isFinite(Number(value));\n        default: return typeof value === 'string' ? value.trim().length > 0 : value !== undefined && value !== null && value !== '';\n    }\n}\n\n/** Why a field is invalid, as a kind the component words in the locale: `required`, `invalid`, or undefined when it is fine. An empty optional field is fine. */\nexport function problemOf(field: FormField, value: unknown): 'required' | 'invalid' | undefined {\n    if (!isFilled(field, value)) {\n        const empty = value === undefined || value === null || value === '' || (typeof value === 'string' && value.trim() === '') || (Array.isArray(value) && value.length === 0) || value === false;\n        return field.required ? 'required' : empty ? undefined : 'invalid';\n    }\n\n    if (field.type === FormFieldType.Date && typeof value === 'string' && Number.isNaN(new Date(value).getTime())) return 'invalid';\n    if ((field.type === FormFieldType.Select || field.type === FormFieldType.Lookup) && field.options.length > 0 && typeof value === 'string' && !field.options.includes(value)) return 'invalid';\n    return undefined;\n}\n\n/** The problems of every field, by field name, for the fields in the given sections. */\nexport function validate(sections: FormSection[], values: FormValues): Record<string, 'required' | 'invalid'> {\n    const problems: Record<string, 'required' | 'invalid'> = {};\n    for (const field of sections.flatMap(section => section.fields)) {\n        const problem = problemOf(field, values[field.name]);\n        if (problem) problems[field.name] = problem;\n    }\n\n    return problems;\n}\n\n/** Whether two sets of values are the same, field by field and in depth, so the unsaved-changes guard compares what the person sees. */\nexport function sameValues(left: FormValues, right: FormValues): boolean {\n    const keys = new Set([...Object.keys(left), ...Object.keys(right)]);\n    return [...keys].every(key => JSON.stringify(normalizeValue(left[key])) === JSON.stringify(normalizeValue(right[key])));\n}\n\nfunction normalizeValue(value: unknown): unknown {\n    if (value === undefined || value === null || value === '' || value === false) return null;\n    if (Array.isArray(value)) return value.length === 0 ? null : value;\n    if (typeof value === 'object') { const entries = Object.entries(value as Record<string, unknown>).filter(([, line]) => line !== '' && line !== undefined).sort(([a], [b]) => a.localeCompare(b)); return entries.length === 0 ? null : entries; }\n    return value;\n}\n\n/** Maps a server's field errors (`{ field: message }` or `[{ field, message }]`) onto the fields of the form; an error for a field the form does not have is returned as a general one so it is never lost. */\nexport function mapServerErrors(sections: FormSection[], errors: unknown): { byField: Record<string, string>; general: string[] } {\n    const known = new Set(sections.flatMap(section => section.fields.map(field => field.name)));\n    const pairs: [string, string][] = Array.isArray(errors)\n        ? records(errors).flatMap(entry => (typeof entry.message === 'string' ? [[typeof entry.field === 'string' ? entry.field : '', entry.message] as [string, string]] : []))\n        : typeof errors === 'object' && errors !== null ? Object.entries(errors as Record<string, unknown>).flatMap(([field, message]) => (typeof message === 'string' ? [[field, message] as [string, string]] : [])) : [];\n\n    const byField: Record<string, string> = {};\n    const general: string[] = [];\n    for (const [field, message] of pairs) {\n        if (known.has(field) && byField[field] === undefined) byField[field] = message;\n        else general.push(field && !known.has(field) ? `${field}: ${message}` : message);\n    }\n\n    return { byField, general };\n}\n"],"names":["FormFieldType","FormMode","addressLines","records","value","Array","isArray","filter","entry","readFormMode","Object","values","includes","readFormSections","names","Set","flatMap","section","index","columns","Math","min","max","floor","fields","name","length","has","add","label","type","required","options","option","span","placeholder","help","id","title","isFilled","field","trim","every","line","Number","isFinite","undefined","problemOf","empty","isNaN","Date","getTime","validate","sections","problems","problem","sameValues","left","right","keys","key","JSON","stringify","normalizeValue","entries","sort","a","b","localeCompare","mapServerErrors","errors","known","map","pairs","message","byField","general","push"],"mappings":"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"}

package/dist/esm/foundation/foundationComponentMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foundationComponentMetadata.d.ts","sourceRoot":"","sources":["../../../foundation/foundationComponentMetadata.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,qBAAqB,CAAC;AAOhF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAgBzE,CAAC"}
+{"version":3,"file":"foundationComponentMetadata.d.ts","sourceRoot":"","sources":["../../../foundation/foundationComponentMetadata.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,qBAAqB,CAAC;AAOhF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAyBzE,CAAC"}

package/dist/esm/foundation/foundationComponentMetadata.js

@@ -107,6 +107,60 @@ import { ComponentName } from '../ComponentName.js';
         'access',
         'grants',
         'rbac'
+    ]),
+    [ComponentName.DataList]: componentMetadata('Data list', ComponentCategory.DataDisplay, 'table', [
+        'table',
+        'grid',
+        'records',
+        'cards',
+        'collection',
+        'list'
+    ]),
+    [ComponentName.TabSet]: componentMetadata('Tab set', ComponentCategory.Navigation, 'panel-top', [
+        'tabs',
+        'sections',
+        'panels'
+    ]),
+    [ComponentName.SubNavigation]: componentMetadata('Sub-navigation', ComponentCategory.Navigation, 'panel-left', [
+        'module',
+        'sections',
+        'rail',
+        'tabs'
+    ]),
+    [ComponentName.BulkBar]: componentMetadata('Bulk bar', ComponentCategory.Actions, 'check-check', [
+        'selection',
+        'bulk',
+        'batch',
+        'actions'
+    ]),
+    [ComponentName.GlobalSearch]: componentMetadata('Search', ComponentCategory.Input, 'search', [
+        'search',
+        'find',
+        'query'
+    ]),
+    [ComponentName.NotificationsButton]: componentMetadata('Notifications button', ComponentCategory.Actions, 'bell', [
+        'bell',
+        'alerts',
+        'unread'
+    ]),
+    [ComponentName.KanbanBoard]: componentMetadata('Kanban board', ComponentCategory.DataDisplay, 'kanban', [
+        'board',
+        'kanban',
+        'columns',
+        'pipeline',
+        'cards'
+    ]),
+    [ComponentName.WizardProgress]: componentMetadata('Wizard', ComponentCategory.Navigation, 'footprints', [
+        'wizard',
+        'steps',
+        'stepper',
+        'multi-step'
+    ]),
+    [ComponentName.FormScreenBody]: componentMetadata('Form', ComponentCategory.Forms, 'text-cursor-input', [
+        'form',
+        'fields',
+        'sections',
+        'validation'
     ])
 };