@qoretechnologies/reqraft 0.10.62-pr.141.g7591ef9 → 0.10.62-pr.141.gd67d7d6

package/dist/components/form/fields/rich-text/RichText.d.ts

@@ -2,6 +2,7 @@
 import { IReqoreRichTextEditorProps } from '@qoretechnologies/reqore/dist/components/RichTextEditor';
 import { IReqoreFormTemplates } from '@qoretechnologies/reqore/dist/components/Textarea';
 import { IQorusAllowedValue } from '@qoretechnologies/ts-toolkit';
+import { IChoiceChipBehavior } from '../../../../helpers/choiceChip';
 export interface IRichTextFormFieldProps extends Omit<IReqoreRichTextEditorProps, 'onChange' | 'value' | 'tags' | 'actions'> {
     /**
      * A form field's OWN chips — not the editor's template catalogue, which this
@@ -31,13 +32,23 @@ export interface IRichTextFormFieldProps extends Omit<IReqoreRichTextEditorProps
     singleLine?: boolean;
     /**
      * The choices the field offers, when it offers any. A value that IS one of
-     * them — the whole string, as picked from the field's suggestions — is drawn
-     * as one chip named from the choice (`general` rather than `C07ERBFS0P6`),
-     * and is still emitted as that value: the chip's own value is the choice's,
-     * and a document that is nothing but the chip reads back as it. A field
-     * spreads its schema here, so this is the schema's own key.
+     * them — the whole string, as picked from the field's suggestions, or a
+     * document of nothing but that string, as an edit of it stores — is drawn as
+     * one chip named from the choice (`general` rather than `C07ERBFS0P6`), and
+     * is still emitted as that value: the chip's own value is the choice's, and a
+     * document that is nothing but the chip reads back as it. A field spreads
+     * its schema here, so this is the schema's own key.
      */
     allowed_values?: IQorusAllowedValue[];
+    /**
+     * What a choice chip does when the author acts on it — Backspace right after
+     * it, a click on it. By default each opens the chip into its value as plain
+     * text, the cursor at the end, so one letter of what was chosen can be
+     * changed; see `IChoiceChipBehavior` for the alternatives. Text that is again
+     * exactly one of the choices becomes its chip when the author leaves the
+     * field — not while typing, where a choice can be the start of a longer value.
+     */
+    choiceChip?: IChoiceChipBehavior;
     /**
      * With `valueFormat: 'text'`: the token grammar the value's references are
      * WRITTEN in, when the host speaks one of its own.
@@ -62,5 +73,5 @@ export interface IRichTextFormFieldProps extends Omit<IReqoreRichTextEditorProps
  * Exported so the mapping is assertable without rendering a Slate editor.
  */
 export declare const getChipTooltipDescriptions: (templates?: IReqoreFormTemplates) => Record<string, string>;
-export declare const RichTextFormField: import("react").MemoExoticComponent<({ value, onChange, allowTemplates, templates, valueFormat, singleLine, templateToken, allowed_values, ...rest }: IRichTextFormFieldProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const RichTextFormField: import("react").MemoExoticComponent<({ value, onChange, allowTemplates, templates, valueFormat, singleLine, templateToken, allowed_values, choiceChip, ...rest }: IRichTextFormFieldProps) => import("react/jsx-runtime").JSX.Element>;
 //# sourceMappingURL=RichText.d.ts.map

package/dist/components/form/fields/rich-text/RichText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RichText.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/rich-text/RichText.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,0BAA0B,EAE3B,MAAM,yDAAyD,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAGzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAwBlE,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,0BAA0B,EAC1B,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAC1C;IACC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACrD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAClC,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACtC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,eACzB,oBAAoB,KAC/B,OAAO,MAAM,EAAE,MAAM,CA0BvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,wJAU3B,uBAAuB,6CA6RxB,CAAC"}
+{"version":3,"file":"RichText.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/rich-text/RichText.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,0BAA0B,EAG3B,MAAM,yDAAyD,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAGzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAOlE,OAAO,EAOL,mBAAmB,EAGpB,MAAM,gCAAgC,CAAC;AAmBxC,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,0BAA0B,EAC1B,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAC1C;IACC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACrD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAClC,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACtC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,eACzB,oBAAoB,KAC/B,OAAO,MAAM,EAAE,MAAM,CA0BvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,oKAW3B,uBAAuB,6CA0XxB,CAAC"}

package/dist/components/form/fields/rich-text/RichText.js

@@ -28,6 +28,7 @@ var RichTextEditor_1 = require("@qoretechnologies/reqore/dist/components/RichTex
 var lodash_1 = require("lodash");
 var react_1 = require("react");
 var react_use_1 = require("react-use");
+var slate_react_1 = require("slate-react");
 var emittedValues_1 = require("../emittedValues");
 var choiceChip_1 = require("../../../../helpers/choiceChip");
 var singleLineString_1 = require("../../../../helpers/singleLineString");
@@ -73,8 +74,12 @@ var getChipTooltipDescriptions = function (templates) {
 exports.getChipTooltipDescriptions = getChipTooltipDescriptions;
 exports.RichTextFormField = (0, react_1.memo)(function (_a) {
     var _b, _c;
-    var value = _a.value, onChange = _a.onChange, allowTemplates = _a.allowTemplates, templates = _a.templates, _d = _a.valueFormat, valueFormat = _d === void 0 ? 'richtext' : _d, singleLine = _a.singleLine, templateToken = _a.templateToken, allowed_values = _a.allowed_values, rest = __rest(_a, ["value", "onChange", "allowTemplates", "templates", "valueFormat", "singleLine", "templateToken", "allowed_values"]);
+    var value = _a.value, onChange = _a.onChange, allowTemplates = _a.allowTemplates, templates = _a.templates, _d = _a.valueFormat, valueFormat = _d === void 0 ? 'richtext' : _d, singleLine = _a.singleLine, templateToken = _a.templateToken, allowed_values = _a.allowed_values, choiceChip = _a.choiceChip, rest = __rest(_a, ["value", "onChange", "allowTemplates", "templates", "valueFormat", "singleLine", "templateToken", "allowed_values", "choiceChip"]);
     var isText = valueFormat === 'text';
+    /* The Slate editor behind Reqore's, for the two chip actions below: both
+       rewrite the document in place, which the editor's props cannot. */
+    var editorRef = (0, react_1.useRef)(null);
+    var chipBehavior = __assign(__assign({}, choiceChip_1.DEFAULT_CHOICE_CHIP_BEHAVIOR), choiceChip);
     /* The document the editor shows for a value: a choice by its chip, a text
        with its references as chips, a document as it is. */
     var toLocal = function (next) {
@@ -87,6 +92,18 @@ exports.RichTextFormField = (0, react_1.memo)(function (_a) {
         return choice ? (0, choiceChip_1.choiceToNodes)(choice) : next;
     };
     var _e = (0, react_1.useState)(function () { return toLocal(value); }), localValue = _e[0], setLocalValue = _e[1];
+    /* What a value stands for: the choice's value when the value is that choice
+       by any spelling — the plain string, the chip, a document of just the text —
+       else the value itself. Values are compared by this, so opening a chip, or
+       typing its id back, is not a change to the value. */
+    var standsFor = function (next) {
+        var chip = (0, choiceChip_1.choiceValueOfNodes)(next);
+        if (chip !== undefined) {
+            return chip;
+        }
+        var choice = (0, choiceChip_1.choiceForValue)(next, allowed_values);
+        return choice ? (0, choiceChip_1.choiceValue)(choice) : next;
+    };
     /* In text mode, the string the editor's document stands for. The value that
        comes back from the parent is usually that same string, and rebuilding the
        document from it would hand the editor a new tree on every keystroke —
@@ -97,7 +114,6 @@ exports.RichTextFormField = (0, react_1.memo)(function (_a) {
        them away. See `EmittedValues`. */
     var emitted = (0, emittedValues_1.useEmittedValues)(lodash_1.isEqual);
     (0, react_1.useEffect)(function () {
-        var _a;
         if (emitted.isEcho(isText ? String(value !== null && value !== void 0 ? value : '') : value)) {
             return;
         }
@@ -109,9 +125,9 @@ exports.RichTextFormField = (0, react_1.memo)(function (_a) {
             }
             return;
         }
-        // Compared as what the document stands for: a lone choice chip IS the
-        // value it draws, so the value coming back is not a change to it.
-        if (JSON.stringify(value) !== JSON.stringify((_a = (0, choiceChip_1.choiceValueOfNodes)(localValue)) !== null && _a !== void 0 ? _a : localValue)) {
+        // Compared as what each stands for: a lone choice chip IS the value it
+        // draws, so the value coming back is not a change to it.
+        if (!(0, lodash_1.isEqual)(standsFor(value), standsFor(localValue))) {
             setLocalValue(toLocal(value));
         }
     }, [JSON.stringify(value)]);
@@ -143,7 +159,7 @@ exports.RichTextFormField = (0, react_1.memo)(function (_a) {
         // A document that is nothing but one choice chip is emitted as the
         // choice's value — what was stored and what the server resolves.
         var next = (_a = (0, choiceChip_1.choiceValueOfNodes)(localValue)) !== null && _a !== void 0 ? _a : localValue;
-        if (!(0, lodash_1.isEqual)(next, value)) {
+        if (!(0, lodash_1.isEqual)(standsFor(next), standsFor(value))) {
             emitted.record(next);
             onChange === null || onChange === void 0 ? void 0 : onChange(next);
         }
@@ -180,6 +196,39 @@ exports.RichTextFormField = (0, react_1.memo)(function (_a) {
     var descriptionByValue = (0, react_1.useMemo)(function () { return (0, exports.getChipTooltipDescriptions)(templates); }, [
         JSON.stringify(templates),
     ]);
+    /* Opens a choice chip into its value as text and puts the cursor there.
+       A click on the chip — a non-editable node — need not have given the
+       editor focus, so focus is asked of Slate, which places the DOM caret where
+       the selection is and focuses after; but only once the text the chip became
+       is rendered (the effect below), since Slate resolves the caret through the
+       rendered DOM. Asked any earlier it lost: a DOM `focus()` before the
+       transform let the browser put the caret at the editor's start and the
+       `selectionchange` it raised beat the render, so the next key typed landed
+       there; asked on the next frame, the frame came before React's commit
+       often enough. An editor that already has focus (Backspace came from it)
+       is returned at once, and its own render puts the caret where the
+       selection is. */
+    var focusOnceRendered = (0, react_1.useRef)(false);
+    var openChoiceChip = (0, react_1.useCallback)(function (path) {
+        var editor = editorRef.current;
+        if (editor && path && (0, choiceChip_1.unwrapChoiceChip)(editor, path)) {
+            focusOnceRendered.current = true;
+        }
+    }, []);
+    (0, react_1.useEffect)(function () {
+        var editor = editorRef.current;
+        if (!focusOnceRendered.current || !editor) {
+            return;
+        }
+        focusOnceRendered.current = false;
+        try {
+            slate_react_1.ReactEditor.toDOMNode(editor, editor);
+            slate_react_1.ReactEditor.focus(editor);
+        }
+        catch (_a) {
+            // Not mounted in a document — nothing to focus.
+        }
+    }, [localValue]);
     var handleGetTagProps = (0, react_1.useCallback)(function (tag) {
         var _a, _b, _c, _d, _e, _f;
         var tagValue = (_a = tag.value) === null || _a === void 0 ? void 0 : _a.toString();
@@ -189,11 +238,9 @@ exports.RichTextFormField = (0, react_1.memo)(function (_a) {
         /* One of the field's own choices, drawn by the name it was picked by;
            what it stands for on hover. */
         if ((_b = tag.metadata) === null || _b === void 0 ? void 0 : _b.allowedValue) {
-            return {
-                icon: 'ListCheck',
-                label: (_c = tag.label) !== null && _c !== void 0 ? _c : tagValue,
-                tooltip: (_d = tag.metadata) === null || _d === void 0 ? void 0 : _d.description,
-            };
+            return __assign({ icon: 'ListCheck', label: (_c = tag.label) !== null && _c !== void 0 ? _c : tagValue, tooltip: (_d = tag.metadata) === null || _d === void 0 ? void 0 : _d.description }, (chipBehavior.click === 'unwrap' ?
+                { onClick: function () { return openChoiceChip(editorRef.current ? (0, choiceChip_1.pathOfNode)(editorRef.current, tag) : undefined); } }
+                : {}));
         }
         /* A reference in a string is drawn exactly as the collapsed row draws the
            same value (`ReadOnlyTemplateTag`): named from the catalogue, its
@@ -237,14 +284,42 @@ exports.RichTextFormField = (0, react_1.memo)(function (_a) {
                     : undefined }, (0, templates_1.getTemplateTagStyle)(tag.metadata));
         }
         return {};
-    }, [descriptionByValue, renderMarkdown, isText, templates]);
+    }, [descriptionByValue, renderMarkdown, isText, templates, chipBehavior.click, openChoiceChip]);
+    /* Leaving the field: text that is exactly one of the choices becomes its
+       chip again, as the picker would have drawn it. Only here, never while
+       typing — a choice can be the start of a longer value, and a chip drawn
+       under the cursor would swallow it. */
+    var handleBlur = (0, react_1.useCallback)(function (event) {
+        var _a, _b;
+        var shown = isText ? lastTextRef.current : localValue;
+        if ((0, choiceChip_1.choiceForValue)(shown, allowed_values)) {
+            setLocalValue(toLocal(shown));
+        }
+        (_b = (_a = rest).onBlur) === null || _b === void 0 ? void 0 : _b.call(_a, event);
+    }, [isText, localValue, choiceKey, rest.onBlur]);
     var handleKeyDown = (0, react_1.useCallback)(function (event) {
         var _a, _b;
         if (isText && singleLine && event.key === 'Enter') {
             event.preventDefault();
         }
+        /* Backspace right after a choice chip opens it rather than deleting it,
+           when so configured. Stopped here, at keydown, so the browser raises no
+           `beforeinput` for the editor to delete the chip by. */
+        if (event.key === 'Backspace' && chipBehavior.backspace === 'unwrap' && editorRef.current) {
+            var path = (0, choiceChip_1.choiceChipAtCursor)(editorRef.current);
+            if (path) {
+                event.preventDefault();
+                openChoiceChip(path);
+            }
+        }
         (_b = (_a = rest).onKeyDown) === null || _b === void 0 ? void 0 : _b.call(_a, event);
-    }, [isText, singleLine, rest.onKeyDown]);
+    }, [
+        isText,
+        singleLine,
+        chipBehavior.backspace,
+        openChoiceChip,
+        rest.onKeyDown,
+    ]);
     var tags = (0, react_1.useMemo)(function () {
         var _tags = {};
         if ((0, lodash_1.size)(templates === null || templates === void 0 ? void 0 : templates.items) && allowTemplates) {
@@ -282,9 +357,9 @@ exports.RichTextFormField = (0, react_1.memo)(function (_a) {
        editor's `tags` is the template catalogue this component computes. */
     var editorProps = __assign({}, rest);
     delete editorProps.tags;
-    return ((0, jsx_runtime_1.jsx)(RichTextEditor_1.ReqoreRichTextEditor, __assign({ value: formattedValue, onChange: handleChange }, editorProps, { tagsListProps: __assign({ useTargetWidth: true, minWidth: '300px', maxWidth: '600px', listCustomTheme: {
+    return ((0, jsx_runtime_1.jsx)(RichTextEditor_1.ReqoreRichTextEditor, __assign({ ref: editorRef, value: formattedValue, onChange: handleChange }, editorProps, { tagsListProps: __assign({ useTargetWidth: true, minWidth: '300px', maxWidth: '600px', listCustomTheme: {
                 main: '#1b151f',
-            } }, (rest.tagsListProps || {})), getTagProps: handleGetTagProps, tags: tags, panelProps: { fluid: true, style: __assign({ minWidth: '150px' }, (_c = rest.panelProps) === null || _c === void 0 ? void 0 : _c.style) }, readOnly: readOnly, onKeyDown: handleKeyDown, 
+            } }, (rest.tagsListProps || {})), getTagProps: handleGetTagProps, tags: tags, panelProps: { fluid: true, style: __assign({ minWidth: '150px' }, (_c = rest.panelProps) === null || _c === void 0 ? void 0 : _c.style) }, readOnly: readOnly, onKeyDown: handleKeyDown, onBlur: handleBlur, 
         /* A form field carries no document toolbar. Styling was already off, so
            the bar held only undo and redo — drawn by Reqore as a panel as wide as
            the tag list, which under a field reads as an empty 600px menu with two

package/dist/components/form/fields/rich-text/RichText.js.map

@@ -1 +1 @@
-{"version":3,"file":"RichText.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/rich-text/RichText.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0FAGiE;AAKjE,iCAAuC;AACvC,+BAA+F;AAC/F,uCAAwC;AACxC,kDAAoD;AACpD,6DAAmG;AACnG,yEAAyF;AACzF,mEAG2C;AAC3C,iEAI0C;AAC1C,2DAKuC;AACvC,wFAAmF;AAuDnF;;;;;;;;;GASG;AACI,IAAM,0BAA0B,GAAG,UACxC,SAAgC;IAEhC,IAAM,GAAG,GAA2B,EAAE,CAAC;IAEvC;;;;;;;;oEAQgE;IAChE,IAAM,OAAO,GAAG,UAAC,KAAwB;QACvC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,CAAC,UAAC,IAAS;;YACvB,IAAM,KAAK,GAAG,OAAO,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAAA,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,0CAAE,KAAK,CAAC,CAAC,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAAC;YACjF,IAAM,WAAW,GAAG,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,WAAW,mCAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,UAAU,CAAC;YAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,EAAE,CAAC;gBAChF,GAAG,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC;YAC3B,CAAC;YACD,OAAO,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,CAAE,SAAiB,aAAjB,SAAS,uBAAT,SAAS,CAAU,KAAK,CAAC,CAAC;IAEnC,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AA5BW,QAAA,0BAA0B,8BA4BrC;AAEW,QAAA,iBAAiB,GAAG,IAAA,YAAI,EAAC,UAAC,EAUb;;IATxB,IAAA,KAAK,WAAA,EACL,QAAQ,cAAA,EACR,cAAc,oBAAA,EACd,SAAS,eAAA,EACT,mBAAwB,EAAxB,WAAW,mBAAG,UAAU,KAAA,EACxB,UAAU,gBAAA,EACV,aAAa,mBAAA,EACb,cAAc,oBAAA,EACX,IAAI,cAT8B,oHAUtC,CADQ;IAEP,IAAM,MAAM,GAAG,WAAW,KAAK,MAAM,CAAC;IACtC;4DACwD;IACxD,IAAM,OAAO,GAAG,UAAC,IAAa;QAC5B,IAAI,MAAM,EAAE,CAAC;YACX,IAAM,IAAI,GAAG,MAAM,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,CAAC,CAAC;YAChC,IAAM,QAAM,GAAG,IAAA,2BAAc,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACpD,OAAO,QAAM,CAAC,CAAC,CAAC,IAAA,0BAAa,EAAC,QAAM,CAAC,CAAC,CAAC,CAAC,IAAA,kCAAmB,EAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAC9F,CAAC;QACD,IAAM,MAAM,GAAG,IAAA,2BAAc,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,CAAC,CAAC,IAAA,0BAAa,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC,CAAC;IACI,IAAA,KAA8B,IAAA,gBAAQ,EAAM,cAAM,OAAA,OAAO,CAAC,KAAK,CAAC,EAAd,CAAc,CAAC,EAAhE,UAAU,QAAA,EAAE,aAAa,QAAuC,CAAC;IACxE;;;qFAGiF;IACjF,IAAM,WAAW,GAAG,IAAA,cAAM,EAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D;;yCAEqC;IACrC,IAAM,OAAO,GAAG,IAAA,gCAAgB,EAAU,gBAAO,CAAC,CAAC;IAEnD,IAAA,iBAAS,EAAC;;QACR,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO;QACT,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,IAAM,IAAI,GAAG,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;gBACjC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC3B,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO;QACT,CAAC;QACD,sEAAsE;QACtE,kEAAkE;QAClE,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAA,IAAA,+BAAkB,EAAC,UAAU,CAAC,mCAAI,UAAU,CAAC,EAAE,CAAC;YAC3F,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE5B;;;8CAG0C;IAC1C,IAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAC9B,MAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,EAAnC,CAAmC,CAAC,mCAAI,IAAI,CAC7E,CAAC;IACF,IAAA,iBAAS,EAAC;;QACR,IAAI,CAAC,CAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,MAAM,CAAA,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,IAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,kCAAmB,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAA,IAAA,+BAAkB,EAAC,UAAU,CAAC,mCAAI,UAAU,CAAC,CAAC;QACxG,IAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACpD,IAAI,IAAA,gBAAO,EAAC,KAAK,EAAE,MAAM,CAAC,IAAI,IAAA,2BAAc,EAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;YACrE,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,IAAA,uBAAW,EACT;;QACE,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,WAAW,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACpC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;YACD,OAAO;QACT,CAAC;QACD,mEAAmE;QACnE,iEAAiE;QACjE,IAAM,IAAI,GAAG,MAAA,IAAA,+BAAkB,EAAC,UAAU,CAAC,mCAAI,UAAU,CAAC;QAC1D,IAAI,CAAC,IAAA,gBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrB,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,EACD,GAAG;IACH,2EAA2E;IAC3E,2EAA2E;IAC3E,yEAAyE;IACzE,oEAAoE;IACpE,kEAAkE;IAClE,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,IAAM,YAAY,GAAG,UAAC,GAAQ;QAC5B,IAAI,MAAM,EAAE,CAAC;YACX,IAAM,IAAI,GAAG,IAAA,kCAAmB,EAAC,GAAG,CAAC,CAAC;YACtC,0EAA0E;YAC1E,oEAAoE;YACpE,IAAI,UAAU,IAAI,IAAA,+BAAY,EAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,WAAW,CAAC,OAAO,GAAG,IAAA,sCAAmB,EAAC,IAAI,CAAC,CAAC;gBAChD,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YACD,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,aAAa,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,iDAAiD,EAAE,CAAC;YAC9E,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,8EAA8E;IAC9E,6DAA6D;IAC7D,IAAM,cAAc,GAAG,IAAA,6CAAmB,GAAE,CAAC;IAE7C,IAAM,kBAAkB,GAAG,IAAA,eAAO,EAAC,cAAM,OAAA,IAAA,kCAA0B,EAAC,SAAS,CAAC,EAArC,CAAqC,EAAE;QAC9E,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;KAC1B,CAAC,CAAC;IAEH,IAAM,iBAAiB,GAAG,IAAA,mBAAW,EACnC,UAAC,GAAQ;;QACP,IAAM,QAAQ,GAAG,MAAA,GAAG,CAAC,KAAK,0CAAE,QAAQ,EAAE,CAAC;QAEvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC;QAED;0CACkC;QAClC,IAAI,MAAA,GAAG,CAAC,QAAQ,0CAAE,YAAY,EAAE,CAAC;YAC/B,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,MAAA,GAAG,CAAC,KAAK,mCAAI,QAAQ;gBAC5B,OAAO,EAAE,MAAA,GAAG,CAAC,QAAQ,0CAAE,WAAW;aACnC,CAAC;QACJ,CAAC;QAED;;;6CAGqC;QACrC,IAAI,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAA,IAAI,GAAK,IAAA,qCAAyB,EAAC,SAAS,EAAE,QAAQ,CAAC,KAAnD,CAAoD;YAChE,IAAM,QAAQ,GAAG,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAqC,CAAC;YAC7D,kBACE,IAAI,EAAE,oBAAoB,EAC1B,aAAa,EAAE,EAAE,KAAK,EAAE,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,KAAK,EAAE,EACzC,KAAK,EAAE,IAAA,gCAAiB,EAAC,SAAS,EAAE,QAAQ,CAAC,EAC7C,OAAO,EAAE,IAAA,2BAAe,EAAC,SAAS,EAAE,QAAQ,CAAC,IAC1C,IAAA,+BAAmB,EAAC,QAAQ,CAAC,EAChC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,kBACE,IAAI,EAAE,oBAAoB,EAC1B,aAAa,EAAE;oBACb,KAAK,EAAE,MAAA,GAAG,CAAC,QAAQ,0CAAE,KAAK;iBAC3B,EACD,QAAQ,EAAE,MAAA,GAAG,CAAC,QAAQ,0CAAE,WAAW;gBACnC;;;;;iFAKiE;gBACjE;;;;2CAI2B;gBAC3B;;;;;4EAK4D;gBAC5D,OAAO,EACL,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAC5B,cAAc,CAAC,CAAC;wBACd;4BACE,OAAO,EAAE,cAAc,CAAC;gCACtB,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC;gCACnC,OAAO,EAAE,IAAI;6BACd,CAA8B;yBAChC;wBACH,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC;oBAChC,CAAC,CAAC,SAAS,IACV,IAAA,+BAAmB,EAAC,GAAG,CAAC,QAAQ,CAAC,EACpC;QACJ,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC,EACD,CAAC,kBAAkB,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,CACxD,CAAC;IAEF,IAAM,aAAa,GAAG,IAAA,mBAAW,EAC/B,UAAC,KAAyC;;QACxC,IAAI,MAAM,IAAI,UAAU,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YAClD,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,CAAC;QACD,MAAA,MAAC,IAA4E,EAAC,SAAS,mDAAG,KAAK,CAAC,CAAC;IACnG,CAAC,EACD,CAAC,MAAM,EAAE,UAAU,EAAG,IAAgC,CAAC,SAAS,CAAC,CAClE,CAAC;IAEF,IAAM,IAAI,GAAG,IAAA,eAAO,EAAqC;QACvD,IAAM,KAAK,GAAuC,EAAE,CAAC;QAErD,IAAI,IAAA,aAAI,EAAC,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;YAC7C,KAAK,CAAC,SAAS,GAAG;gBAChB,IAAI,EAAE,oBAAoB;gBAC1B,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,sDAAsD;gBACnE;;yDAEyC;gBACzC;;;;kDAIkC;gBAClC,KAAK,EAAE,IAAA,8CAA8B,EAAC,IAAA,mCAAmB,EAAC,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,KAAK,CAAC,EAAE,cAAc,CAAC;aAC7F,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;IAEhD,IAAM,cAAc,GAClB,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACxG,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS;YACjC,CAAC,CAAC,UAAU,CAAC;IAEf,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,8EAA8E;IAC9E,+BAA+B;IAC/B,IAAM,QAAQ,GAAG,CAAC,CAAC,CAChB,IAA+B,CAAC,QAAQ;QACxC,IAA+B,CAAC,QAAQ;QACxC,IAA+B,CAAC,QAAQ,CAC1C,CAAC;IAEF;;4EAEwE;IACxE,IAAM,WAAW,gBAAQ,IAAI,CAAE,CAAC;IAChC,OAAQ,WAAkC,CAAC,IAAI,CAAC;IAEhD,OAAO,CACL,uBAAC,qCAAoB,aACnB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,YAAY,IASlB,WAAW,IACf,aAAa,aACX,cAAc,EAAE,IAAI,EACpB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,EACjB,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;aAChB,IACE,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,GAE/B,WAAW,EAAE,iBAAiB,EAC9B,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,aAAI,QAAQ,EAAE,OAAO,IAAK,MAAA,IAAI,CAAC,UAAU,0CAAE,KAAK,CAAE,EAAE,EACpF,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,aAAa;QACxB;;;;mFAI2E;QAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IACrD,CACH,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"RichText.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/rich-text/RichText.tsx"],"names":[],"mappings":"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"}

package/dist/helpers/choiceChip.d.ts

@@ -1,4 +1,5 @@
 import { IQorusAllowedValue } from '@qoretechnologies/ts-toolkit';
+import { Editor, Path } from 'slate';
 /**
  * A value that IS one of the field's own choices, drawn as that choice.
  *
@@ -25,10 +26,18 @@ export interface IChoiceChipNode {
         text: '';
     }];
 }
+/** The choice's value as the plain string it is; it arrives in the form engine's `{type, value}` envelope. */
+export declare const choiceValue: (choice: IQorusAllowedValue) => string;
 /**
- * The choice a value is, when the value is a whole plain string the field
- * offers. A document, or a string holding more than the choice, is the
- * author's own text and is never a choice.
+ * The text a document is, when it is one paragraph of plain text and nothing
+ * else; `undefined` for anything more — a chip, a mark, a second paragraph.
+ */
+export declare const plainTextOfNodes: (nodes: unknown) => string | undefined;
+/**
+ * The choice a value is: a whole plain string the field offers, or a document
+ * that is one paragraph of exactly that text — which is what an edit of the
+ * chip stores, so an id typed back is the choice it was. A string or document
+ * holding anything more is the author's own text and is never a choice.
  */
 export declare const choiceForValue: (value: unknown, choices?: IQorusAllowedValue[]) => IQorusAllowedValue | undefined;
 /** The one-chip document that draws a choice by its name. */
@@ -38,10 +47,52 @@ export declare const choiceToNodes: (choice: IQorusAllowedValue) => {
         text: string;
     } | IChoiceChipNode)[];
 }[];
+export declare const isChoiceChip: (node: unknown) => node is IChoiceChipNode;
 /**
  * The value a document is, when the document is one choice chip and nothing
  * else; `undefined` when the author has written anything around it, in which
  * case the document itself is the value.
  */
 export declare const choiceValueOfNodes: (nodes: unknown) => string | undefined;
+/**
+ * What a choice chip does when the author acts on it, by action.
+ *
+ * The chip is a void: it holds no text of its own, so a key or a click on it
+ * has nothing to land in, and an author who wants to change one letter of the
+ * value it draws (`C07ERBFS0P6` to `C07ERBFS0P7`) has no way in unless the
+ * chip opens. Each action is configurable, and the default is the one that
+ * opens it: a creatable choice is the author's to edit.
+ */
+export interface IChoiceChipBehavior {
+    /**
+     * Backspace with the cursor right after the chip. `unwrap` (the default)
+     * turns the chip into its value as plain text, the cursor at the end of it,
+     * for the author to edit; `remove` deletes it whole, as the editor deletes
+     * any other chip.
+     */
+    backspace?: 'unwrap' | 'remove';
+    /**
+     * A click on the chip's body. `unwrap` (the default) turns the chip into its
+     * value as plain text, the cursor at the end of it; `cursor` only places the
+     * cursor after it, as a click on a template chip does.
+     */
+    click?: 'unwrap' | 'cursor';
+}
+export declare const DEFAULT_CHOICE_CHIP_BEHAVIOR: Required<IChoiceChipBehavior>;
+/** Where the node is in the document, by identity; the editor renders the document's own nodes, so a chip handed to a click handler is one of them. */
+export declare const pathOfNode: (editor: Editor, node: unknown) => Path | undefined;
+/**
+ * The chip the cursor is on: right after it with nothing between, where
+ * Backspace would take it, or inside it, where the arrow keys can leave the
+ * cursor. Nothing when the selection spans text or sits anywhere else.
+ */
+export declare const choiceChipAtCursor: (editor: Editor) => Path | undefined;
+/**
+ * Opens the chip at `path` into its value as plain text, the cursor at the
+ * end of the text: what the author read is what they chose, now editable
+ * letter by letter. The document is text from here on, and is stored as the
+ * field stores anything typed; it is drawn as a chip again only when it is
+ * read back as exactly one of the choices.
+ */
+export declare const unwrapChoiceChip: (editor: Editor, path: Path) => boolean;
 //# sourceMappingURL=choiceChip.d.ts.map

package/dist/helpers/choiceChip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"choiceChip.d.ts","sourceRoot":"","sources":["../../src/helpers/choiceChip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAyB,MAAM,8BAA8B,CAAC;AAIzF;;;;;;;;;;;GAWG;AAEH,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,QAAQ,EAAE,CAAC;QAAE,IAAI,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAClB,OAAO,YACJ,kBAAkB,EAAE,KAC7B,kBAAkB,GAAG,SAQvB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,aAAa,WAChB,kBAAkB,KACzB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC,EAAE,CAAA;CAAE,EAqBzE,CAAC;AAQF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,UAAW,OAAO,KAAG,MAAM,GAAG,SAa5D,CAAC"}
+{"version":3,"file":"choiceChip.d.ts","sourceRoot":"","sources":["../../src/helpers/choiceChip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAyB,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,MAAM,EAAQ,IAAI,EAAqB,MAAM,OAAO,CAAC;AAI9D;;;;;;;;;;;GAWG;AAEH,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,QAAQ,EAAE,CAAC;QAAE,IAAI,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC;CAC1B;AAED,8GAA8G;AAC9G,eAAO,MAAM,WAAW,WAAY,kBAAkB,KAAG,MACR,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,MAAM,GAAG,SAqB1D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,UAClB,OAAO,YACJ,kBAAkB,EAAE,KAC7B,kBAAkB,GAAG,SAUvB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,aAAa,WAChB,kBAAkB,KACzB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC,EAAE,CAAA;CAAE,EAoBzE,CAAC;AAEF,eAAO,MAAM,YAAY,SAAU,OAAO,4BAIuC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,UAAW,OAAO,KAAG,MAAM,GAAG,SAa5D,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B;AAED,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,mBAAmB,CAGtE,CAAC;AAEF,uJAAuJ;AACvJ,eAAO,MAAM,UAAU,WAAY,MAAM,QAAQ,OAAO,KAAG,IAAI,GAAG,SAWjE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,WAAY,MAAM,KAAG,IAAI,GAAG,SAqB1D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,WAAY,MAAM,iBAAe,OAc7D,CAAC"}

package/dist/helpers/choiceChip.js

@@ -11,7 +11,8 @@ var __assign = (this && this.__assign) || function () {
     return __assign.apply(this, arguments);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.choiceValueOfNodes = exports.choiceToNodes = exports.choiceForValue = exports.CHOICE_CHIP_META = void 0;
+exports.unwrapChoiceChip = exports.choiceChipAtCursor = exports.pathOfNode = exports.DEFAULT_CHOICE_CHIP_BEHAVIOR = exports.choiceValueOfNodes = exports.isChoiceChip = exports.choiceToNodes = exports.choiceForValue = exports.plainTextOfNodes = exports.choiceValue = exports.CHOICE_CHIP_META = void 0;
+var slate_1 = require("slate");
 var allowedValues_1 = require("./allowedValues");
 var options_1 = require("./options");
 /**
@@ -28,25 +29,52 @@ var options_1 = require("./options");
  */
 /** The marker a choice chip carries, so it is told apart from a template reference. */
 exports.CHOICE_CHIP_META = 'allowedValue';
+/** The choice's value as the plain string it is; it arrives in the form engine's `{type, value}` envelope. */
+var choiceValue = function (choice) { var _a; return String((_a = (0, options_1.getListElementValue)(choice.value)) !== null && _a !== void 0 ? _a : ''); };
+exports.choiceValue = choiceValue;
 /**
- * The choice a value is, when the value is a whole plain string the field
- * offers. A document, or a string holding more than the choice, is the
- * author's own text and is never a choice.
+ * The text a document is, when it is one paragraph of plain text and nothing
+ * else; `undefined` for anything more — a chip, a mark, a second paragraph.
+ */
+var plainTextOfNodes = function (nodes) {
+    if (!Array.isArray(nodes) || nodes.length !== 1) {
+        return undefined;
+    }
+    var paragraph = nodes[0];
+    if ((paragraph === null || paragraph === void 0 ? void 0 : paragraph.type) !== 'paragraph' || !Array.isArray(paragraph.children)) {
+        return undefined;
+    }
+    var text = '';
+    for (var _i = 0, _a = paragraph.children; _i < _a.length; _i++) {
+        var child = _a[_i];
+        if (typeof (child === null || child === void 0 ? void 0 : child.text) !== 'string' || Object.keys(child).some(function (key) { return key !== 'text'; })) {
+            return undefined;
+        }
+        text += child.text;
+    }
+    return text;
+};
+exports.plainTextOfNodes = plainTextOfNodes;
+/**
+ * The choice a value is: a whole plain string the field offers, or a document
+ * that is one paragraph of exactly that text — which is what an edit of the
+ * chip stores, so an id typed back is the choice it was. A string or document
+ * holding anything more is the author's own text and is never a choice.
  */
 var choiceForValue = function (value, choices) {
-    if (typeof value !== 'string' || !value || !(choices === null || choices === void 0 ? void 0 : choices.length)) {
+    var text = typeof value === 'string' ? value : (0, exports.plainTextOfNodes)(value);
+    if (!text || !(choices === null || choices === void 0 ? void 0 : choices.length)) {
         return undefined;
     }
-    return (0, allowedValues_1.findAllowedValueOption)(value, { allowed_values: choices });
+    return (0, allowedValues_1.findAllowedValueOption)(text, { allowed_values: choices });
 };
 exports.choiceForValue = choiceForValue;
 /** The one-chip document that draws a choice by its name. */
 var choiceToNodes = function (choice) {
     var _a;
-    var _b, _c, _d;
-    // The choice's value arrives in the form engine's `{type, value}` envelope.
-    var value = String((_b = (0, options_1.getListElementValue)(choice.value)) !== null && _b !== void 0 ? _b : '');
-    var description = (_c = choice.short_desc) !== null && _c !== void 0 ? _c : choice.desc;
+    var _b, _c;
+    var value = (0, exports.choiceValue)(choice);
+    var description = (_b = choice.short_desc) !== null && _b !== void 0 ? _b : choice.desc;
     return [
         {
             type: 'paragraph',
@@ -55,7 +83,7 @@ var choiceToNodes = function (choice) {
                 {
                     type: 'tag',
                     value: value,
-                    label: (_d = choice.display_name) !== null && _d !== void 0 ? _d : value,
+                    label: (_c = choice.display_name) !== null && _c !== void 0 ? _c : value,
                     metadata: __assign((_a = {}, _a[exports.CHOICE_CHIP_META] = true, _a), (description ? { description: description } : {})),
                     children: [{ text: '' }],
                 },
@@ -72,6 +100,7 @@ var isChoiceChip = function (node) {
         node.type === 'tag' &&
         !!((_a = node.metadata) === null || _a === void 0 ? void 0 : _a[exports.CHOICE_CHIP_META]);
 };
+exports.isChoiceChip = isChoiceChip;
 /**
  * The value a document is, when the document is one choice chip and nothing
  * else; `undefined` when the author has written anything around it, in which
@@ -83,12 +112,70 @@ var choiceValueOfNodes = function (nodes) {
         return undefined;
     }
     var children = (_b = (_a = nodes[0]) === null || _a === void 0 ? void 0 : _a.children) !== null && _b !== void 0 ? _b : [];
-    var chips = children.filter(isChoiceChip);
+    var chips = children.filter(exports.isChoiceChip);
     var text = children
-        .filter(function (node) { return !isChoiceChip(node); })
+        .filter(function (node) { return !(0, exports.isChoiceChip)(node); })
         .map(function (node) { return (typeof (node === null || node === void 0 ? void 0 : node.text) === 'string' ? node.text : '\u0000'); })
         .join('');
     return chips.length === 1 && text === '' ? chips[0].value : undefined;
 };
 exports.choiceValueOfNodes = choiceValueOfNodes;
+exports.DEFAULT_CHOICE_CHIP_BEHAVIOR = {
+    backspace: 'unwrap',
+    click: 'unwrap',
+};
+/** Where the node is in the document, by identity; the editor renders the document's own nodes, so a chip handed to a click handler is one of them. */
+var pathOfNode = function (editor, node) {
+    // Stepped by hand: the build target cannot iterate a generator (TS2802).
+    var nodes = slate_1.Node.nodes(editor);
+    for (var entry = nodes.next(); !entry.done; entry = nodes.next()) {
+        if (entry.value[0] === node) {
+            return entry.value[1];
+        }
+    }
+    return undefined;
+};
+exports.pathOfNode = pathOfNode;
+/**
+ * The chip the cursor is on: right after it with nothing between, where
+ * Backspace would take it, or inside it, where the arrow keys can leave the
+ * cursor. Nothing when the selection spans text or sits anywhere else.
+ */
+var choiceChipAtCursor = function (editor) {
+    var selection = editor.selection;
+    if (!selection || !slate_1.Range.isCollapsed(selection)) {
+        return undefined;
+    }
+    var _a = selection.anchor, path = _a.path, offset = _a.offset;
+    var inside = slate_1.Editor.above(editor, { at: path, match: exports.isChoiceChip, voids: true });
+    if (inside) {
+        return inside[1];
+    }
+    if (offset !== 0 || !slate_1.Path.hasPrevious(path)) {
+        return undefined;
+    }
+    var previous = slate_1.Path.previous(path);
+    return (0, exports.isChoiceChip)(slate_1.Node.get(editor, previous)) ? previous : undefined;
+};
+exports.choiceChipAtCursor = choiceChipAtCursor;
+/**
+ * Opens the chip at `path` into its value as plain text, the cursor at the
+ * end of the text: what the author read is what they chose, now editable
+ * letter by letter. The document is text from here on, and is stored as the
+ * field stores anything typed; it is drawn as a chip again only when it is
+ * read back as exactly one of the choices.
+ */
+var unwrapChoiceChip = function (editor, path) {
+    var chip = slate_1.Node.get(editor, path);
+    if (!(0, exports.isChoiceChip)(chip)) {
+        return false;
+    }
+    slate_1.Editor.withoutNormalizing(editor, function () {
+        slate_1.Transforms.removeNodes(editor, { at: path });
+        slate_1.Transforms.insertNodes(editor, [{ text: chip.value }], { at: path });
+        slate_1.Transforms.select(editor, slate_1.Editor.end(editor, path));
+    });
+    return true;
+};
+exports.unwrapChoiceChip = unwrapChoiceChip;
 //# sourceMappingURL=choiceChip.js.map

package/dist/helpers/choiceChip.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoretechnologies/reqraft",
-  "version": "0.10.62-pr.141.g7591ef9",
+  "version": "0.10.62-pr.141.gd67d7d6",
   "description": "ReQraft is a collection of React components and hooks that are used across Qore Technologies' products made using the ReQore component library from Qore.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/components/form/engine/FormEngine.stories.tsx

@@ -9815,3 +9815,100 @@ export const PickingARichTextChoiceShowsItsName: Story = {
     await expectChannelChip(canvasElement);
   },
 };
+
+export const ARichTextChoiceRetypedReturnsToItsChip: Story = {
+  parameters: {
+    docs: {
+      description: {
+        story:
+          'Renders a compact form whose rich-text Channel option shows its stored choice as the chip "general". A click opens the chip into C07ERBFS0P6 as text; Backspace makes the form emit C07ERBFS0P and a typed 6 makes it emit C07ERBFS0P6 again, each as a document and still shown as text while the author types; Tab out of the editor draws the chip "general" again and emits nothing further, since that document already stands for the choice.',
+      },
+    },
+  },
+  args: {
+    compact: true,
+    minColumnWidth: '360px',
+    initialExpandedOptions: ['channel'],
+    value: { channel: { type: 'richtext', value: 'C07ERBFS0P6' } },
+    options: RICH_TEXT_CHOICE_OPTIONS,
+  },
+  play: async ({ args, canvasElement }) => {
+    await expectChannelChip(canvasElement);
+    const row = canvasElement.querySelector('[data-field="channel"]') as HTMLElement;
+    const editor = row.querySelector('[contenteditable="true"]') as HTMLElement;
+
+    await userEvent.click(within(row).getByText('general'));
+    await waitFor(() => {
+      expect(editor.querySelector('.reqore-tag')).toBeNull();
+      expect(editor.contains(document.activeElement)).toBe(true);
+    });
+
+    const channelValue = (text: string) =>
+      expect.objectContaining({
+        channel: expect.objectContaining({ value: [{ type: 'paragraph', children: [{ text }] }] }),
+      });
+
+    // One key at a time, each emitted before the next: typed within the
+    // field's debounce, the two would settle as the value the field started
+    // with, and nothing would be emitted at all.
+    await userEvent.keyboard('{Backspace}');
+    await waitFor(() =>
+      expect(args.onChange).toHaveBeenLastCalledWith('test', channelValue('C07ERBFS0P'), undefined)
+    );
+    await userEvent.keyboard('6');
+    await waitFor(() =>
+      expect(args.onChange).toHaveBeenLastCalledWith('test', channelValue('C07ERBFS0P6'), undefined)
+    );
+    await expect(editor.querySelector('.reqore-tag')).toBeNull();
+
+    await userEvent.tab();
+    await expectChannelChip(canvasElement);
+    // Leaving the row changed nothing: the chip stands for what was emitted.
+    await expect(args.onChange).toHaveBeenLastCalledWith('test', channelValue('C07ERBFS0P6'), undefined);
+  },
+};
+
+export const ClickingARichTextChoiceEditsItsValue: Story = {
+  parameters: {
+    docs: {
+      description: {
+        story:
+          'Renders a compact form whose rich-text Channel option shows its stored choice as the chip "general". A click on the chip opens it into its value as editable text: the row shows C07ERBFS0P6 and no chip, with the cursor at the end, so Backspace and a typed 7 make it C07ERBFS0P7 — the value the form then emits for the option.',
+      },
+    },
+  },
+  args: {
+    compact: true,
+    minColumnWidth: '360px',
+    initialExpandedOptions: ['channel'],
+    value: { channel: { type: 'richtext', value: 'C07ERBFS0P6' } },
+    options: RICH_TEXT_CHOICE_OPTIONS,
+  },
+  play: async ({ args, canvasElement }) => {
+    await expectChannelChip(canvasElement);
+    const row = canvasElement.querySelector('[data-field="channel"]') as HTMLElement;
+    const editor = row.querySelector('[contenteditable="true"]') as HTMLElement;
+
+    // The chip's label: a tag binds its click to its content, not its frame.
+    await userEvent.click(within(row).getByText('general'));
+    await waitFor(() => {
+      expect(editor.querySelector('.reqore-tag')).toBeNull();
+      expect(editor.textContent).toBe('C07ERBFS0P6');
+      expect(editor.contains(document.activeElement)).toBe(true);
+    });
+
+    await userEvent.keyboard('{Backspace}7');
+    await waitFor(() => expect(editor.textContent).toBe('C07ERBFS0P7'));
+    await waitFor(() =>
+      expect(args.onChange).toHaveBeenLastCalledWith(
+        'test',
+        expect.objectContaining({
+          channel: expect.objectContaining({
+            value: [{ type: 'paragraph', children: [{ text: 'C07ERBFS0P7' }] }],
+          }),
+        }),
+        undefined
+      )
+    );
+  },
+};

package/src/components/form/fields/rich-text/RichText.stories.tsx

@@ -1,5 +1,5 @@
 import { StoryObj } from '@storybook/react-vite';
-import { expect, fn, within } from 'storybook/test';
+import { expect, fn, userEvent, waitFor, within } from 'storybook/test';
 import { useState } from 'react';
 
 import { StoryMeta } from '../../../../types';
@@ -76,6 +76,144 @@ export const WithChoiceValue: Story = {
   },
 };
 
+export const WithChoiceValueAsDocument: Story = {
+  args: {
+    ...WithChoiceValue.args,
+    value: [{ type: 'paragraph', children: [{ text: 'C07ERBFS0P6' }] }] as never,
+  },
+  parameters: {
+    docs: {
+      description: {
+        story:
+          'Renders the RichText field holding a document that is nothing but the id of one of its choices — what an edit of the chip stores — drawn as the chip "general"; the id is not shown, and nothing is emitted for it, since the document already stands for the choice.',
+      },
+    },
+  },
+  async play({ args, canvasElement }) {
+    const canvas = within(canvasElement);
+    await expect(canvas.getByText('general')).toBeInTheDocument();
+    await expect(canvas.queryByText('C07ERBFS0P6')).not.toBeInTheDocument();
+    await new Promise((resolve) => setTimeout(resolve, 400));
+    await expect(args.onChange).not.toHaveBeenCalled();
+  },
+};
+
+export const RetypingTheChoiceReturnsItsChip: Story = {
+  args: WithChoiceValue.args,
+  parameters: {
+    docs: {
+      description: {
+        story:
+          'Renders the RichText field holding a choice drawn as the chip "general". A click opens it into C07ERBFS0P6 as text; Backspace emits C07ERBFS0P, and a typed 6 emits C07ERBFS0P6 again, each as a document and still shown as text while the author types; leaving the field with Tab draws it as the chip "general" once more and emits nothing further, since that document already stands for the choice.',
+      },
+    },
+  },
+  async play({ args, canvasElement }) {
+    const canvas = within(canvasElement);
+    const editor = canvas.getByRole('textbox');
+
+    await userEvent.click(canvas.getByText('general'));
+    await waitFor(() => {
+      expect(editor.querySelector('.reqore-tag')).toBeNull();
+      expect(editor.contains(document.activeElement)).toBe(true);
+    });
+
+    // One key at a time, each emitted before the next: typed within the
+    // field's debounce, the two would settle as the value the field started
+    // with, and nothing would be emitted at all.
+    await userEvent.keyboard('{Backspace}');
+    await waitFor(() =>
+      expect(args.onChange).toHaveBeenLastCalledWith([
+        { type: 'paragraph', children: [{ text: 'C07ERBFS0P' }] },
+      ])
+    );
+    await userEvent.keyboard('6');
+    await waitFor(() =>
+      expect(args.onChange).toHaveBeenLastCalledWith([
+        { type: 'paragraph', children: [{ text: 'C07ERBFS0P6' }] },
+      ])
+    );
+    await expect(editor.querySelector('.reqore-tag')).toBeNull();
+
+    await userEvent.tab();
+    await waitFor(() => {
+      expect(editor.querySelector('.reqore-tag')?.textContent).toContain('general');
+      expect(editor.textContent).not.toContain('C07ERBFS0P6');
+    });
+    // Leaving the field changed nothing: the chip stands for what was emitted.
+    await expect(args.onChange).toHaveBeenLastCalledWith([
+      { type: 'paragraph', children: [{ text: 'C07ERBFS0P6' }] },
+    ]);
+  },
+};
+
+export const ClickOpensTheChoiceChip: Story = {
+  args: WithChoiceValue.args,
+  parameters: {
+    docs: {
+      description: {
+        story:
+          'Renders the RichText field holding a choice drawn as the chip "general", with the default chip behaviour. A click on the chip opens it into its value as editable text: the editor shows C07ERBFS0P6 and no chip, the cursor at its end, so Backspace and a typed 7 make it C07ERBFS0P7, which is what the field emits.',
+      },
+    },
+  },
+  async play({ args, canvasElement }) {
+    const canvas = within(canvasElement);
+    const editor = canvas.getByRole('textbox');
+
+    await userEvent.click(canvas.getByText('general'));
+    await waitFor(() => {
+      expect(editor.querySelector('.reqore-tag')).toBeNull();
+      expect(editor.textContent).toBe('C07ERBFS0P6');
+      expect(editor.contains(document.activeElement)).toBe(true);
+    });
+
+    await userEvent.keyboard('{Backspace}7');
+    await waitFor(() => expect(editor.textContent).toBe('C07ERBFS0P7'));
+    await waitFor(() =>
+      expect(args.onChange).toHaveBeenLastCalledWith([
+        { type: 'paragraph', children: [{ text: 'C07ERBFS0P7' }] },
+      ])
+    );
+  },
+};
+
+export const BackspaceOpensTheChoiceChip: Story = {
+  args: {
+    ...WithChoiceValue.args,
+    choiceChip: { click: 'cursor' },
+  },
+  parameters: {
+    docs: {
+      description: {
+        story:
+          'Renders the RichText field holding a choice drawn as the chip "general", configured so that a click on the chip only places the cursor after it. Backspace then opens the chip into its value as editable text: the editor shows C07ERBFS0P6 and no chip, the cursor at its end, so one more Backspace and a typed 7 make it C07ERBFS0P7, which is what the field emits.',
+      },
+    },
+  },
+  async play({ args, canvasElement }) {
+    const canvas = within(canvasElement);
+    const editor = canvas.getByRole('textbox');
+
+    await userEvent.click(canvas.getByText('general'));
+    await waitFor(() => expect(editor.contains(document.activeElement)).toBe(true));
+
+    await userEvent.keyboard('{Backspace}');
+    await waitFor(() => {
+      expect(editor.querySelector('.reqore-tag')).toBeNull();
+      expect(editor.textContent).toBe('C07ERBFS0P6');
+    });
+
+    await userEvent.keyboard('{Backspace}7');
+    await waitFor(() => expect(editor.textContent).toBe('C07ERBFS0P7'));
+    await waitFor(() =>
+      expect(args.onChange).toHaveBeenLastCalledWith([
+        { type: 'paragraph', children: [{ text: 'C07ERBFS0P7' }] },
+      ])
+    );
+  },
+};
+
 export const Empty: Story = {
   parameters: {
     docs: {

package/src/components/form/fields/rich-text/RichText.tsx

@@ -1,16 +1,29 @@
 import {
   IReqoreRichTextEditorProps,
   ReqoreRichTextEditor,
+  TReqoreRichTextEditorRef,
 } from '@qoretechnologies/reqore/dist/components/RichTextEditor';
 import { IReqoreFormTemplates } from '@qoretechnologies/reqore/dist/components/Textarea';
 import { IReqoreTagProps } from '@qoretechnologies/reqore/dist/components/Tag';
 import { IReqoreTooltip } from '@qoretechnologies/reqore/dist/types/global';
 import { IQorusAllowedValue } from '@qoretechnologies/ts-toolkit';
 import { isEqual, size } from 'lodash';
-import { KeyboardEvent, memo, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { FocusEvent, KeyboardEvent, memo, useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useDebounce } from 'react-use';
+import { Path } from 'slate';
+import { ReactEditor } from 'slate-react';
 import { useEmittedValues } from '../emittedValues';
-import { choiceForValue, choiceToNodes, choiceValueOfNodes } from '../../../../helpers/choiceChip';
+import {
+  choiceChipAtCursor,
+  choiceForValue,
+  choiceToNodes,
+  choiceValue,
+  choiceValueOfNodes,
+  DEFAULT_CHOICE_CHIP_BEHAVIOR,
+  IChoiceChipBehavior,
+  pathOfNode,
+  unwrapChoiceChip,
+} from '../../../../helpers/choiceChip';
 import { flattenToSingleLine, hasLineBreak } from '../../../../helpers/singleLineString';
 import {
   renderTemplateItemDescriptions,
@@ -61,13 +74,23 @@ export interface IRichTextFormFieldProps extends Omit<
   singleLine?: boolean;
   /**
    * The choices the field offers, when it offers any. A value that IS one of
-   * them — the whole string, as picked from the field's suggestions — is drawn
-   * as one chip named from the choice (`general` rather than `C07ERBFS0P6`),
-   * and is still emitted as that value: the chip's own value is the choice's,
-   * and a document that is nothing but the chip reads back as it. A field
-   * spreads its schema here, so this is the schema's own key.
+   * them — the whole string, as picked from the field's suggestions, or a
+   * document of nothing but that string, as an edit of it stores — is drawn as
+   * one chip named from the choice (`general` rather than `C07ERBFS0P6`), and
+   * is still emitted as that value: the chip's own value is the choice's, and a
+   * document that is nothing but the chip reads back as it. A field spreads
+   * its schema here, so this is the schema's own key.
    */
   allowed_values?: IQorusAllowedValue[];
+  /**
+   * What a choice chip does when the author acts on it — Backspace right after
+   * it, a click on it. By default each opens the chip into its value as plain
+   * text, the cursor at the end, so one letter of what was chosen can be
+   * changed; see `IChoiceChipBehavior` for the alternatives. Text that is again
+   * exactly one of the choices becomes its chip when the author leaves the
+   * field — not while typing, where a choice can be the start of a longer value.
+   */
+  choiceChip?: IChoiceChipBehavior;
   /**
    * With `valueFormat: 'text'`: the token grammar the value's references are
    * WRITTEN in, when the host speaks one of its own.
@@ -131,9 +154,14 @@ export const RichTextFormField = memo(({
   singleLine,
   templateToken,
   allowed_values,
+  choiceChip,
   ...rest
 }: IRichTextFormFieldProps) => {
   const isText = valueFormat === 'text';
+  /* The Slate editor behind Reqore's, for the two chip actions below: both
+     rewrite the document in place, which the editor's props cannot. */
+  const editorRef = useRef<TReqoreRichTextEditorRef>(null);
+  const chipBehavior = { ...DEFAULT_CHOICE_CHIP_BEHAVIOR, ...choiceChip };
   /* The document the editor shows for a value: a choice by its chip, a text
      with its references as chips, a document as it is. */
   const toLocal = (next: unknown): any => {
@@ -146,6 +174,18 @@ export const RichTextFormField = memo(({
     return choice ? choiceToNodes(choice) : next;
   };
   const [localValue, setLocalValue] = useState<any>(() => toLocal(value));
+  /* What a value stands for: the choice's value when the value is that choice
+     by any spelling — the plain string, the chip, a document of just the text —
+     else the value itself. Values are compared by this, so opening a chip, or
+     typing its id back, is not a change to the value. */
+  const standsFor = (next: unknown): unknown => {
+    const chip = choiceValueOfNodes(next);
+    if (chip !== undefined) {
+      return chip;
+    }
+    const choice = choiceForValue(next, allowed_values);
+    return choice ? choiceValue(choice) : next;
+  };
   /* In text mode, the string the editor's document stands for. The value that
      comes back from the parent is usually that same string, and rebuilding the
      document from it would hand the editor a new tree on every keystroke —
@@ -168,9 +208,9 @@ export const RichTextFormField = memo(({
       }
       return;
     }
-    // Compared as what the document stands for: a lone choice chip IS the
-    // value it draws, so the value coming back is not a change to it.
-    if (JSON.stringify(value) !== JSON.stringify(choiceValueOfNodes(localValue) ?? localValue)) {
+    // Compared as what each stands for: a lone choice chip IS the value it
+    // draws, so the value coming back is not a change to it.
+    if (!isEqual(standsFor(value), standsFor(localValue))) {
       setLocalValue(toLocal(value));
     }
   }, [JSON.stringify(value)]);
@@ -205,7 +245,7 @@ export const RichTextFormField = memo(({
       // A document that is nothing but one choice chip is emitted as the
       // choice's value — what was stored and what the server resolves.
       const next = choiceValueOfNodes(localValue) ?? localValue;
-      if (!isEqual(next, value)) {
+      if (!isEqual(standsFor(next), standsFor(value))) {
         emitted.record(next);
         onChange?.(next);
       }
@@ -248,6 +288,43 @@ export const RichTextFormField = memo(({
     JSON.stringify(templates),
   ]);
 
+  /* Opens a choice chip into its value as text and puts the cursor there.
+     A click on the chip — a non-editable node — need not have given the
+     editor focus, so focus is asked of Slate, which places the DOM caret where
+     the selection is and focuses after; but only once the text the chip became
+     is rendered (the effect below), since Slate resolves the caret through the
+     rendered DOM. Asked any earlier it lost: a DOM `focus()` before the
+     transform let the browser put the caret at the editor's start and the
+     `selectionchange` it raised beat the render, so the next key typed landed
+     there; asked on the next frame, the frame came before React's commit
+     often enough. An editor that already has focus (Backspace came from it)
+     is returned at once, and its own render puts the caret where the
+     selection is. */
+  const focusOnceRendered = useRef(false);
+  const openChoiceChip = useCallback((path: Path | undefined): void => {
+    const editor = editorRef.current;
+
+    if (editor && path && unwrapChoiceChip(editor, path)) {
+      focusOnceRendered.current = true;
+    }
+  }, []);
+
+  useEffect(() => {
+    const editor = editorRef.current;
+
+    if (!focusOnceRendered.current || !editor) {
+      return;
+    }
+    focusOnceRendered.current = false;
+
+    try {
+      ReactEditor.toDOMNode(editor, editor);
+      ReactEditor.focus(editor);
+    } catch {
+      // Not mounted in a document — nothing to focus.
+    }
+  }, [localValue]);
+
   const handleGetTagProps = useCallback(
     (tag: any): IReqoreTagProps => {
       const tagValue = tag.value?.toString();
@@ -263,6 +340,11 @@ export const RichTextFormField = memo(({
           icon: 'ListCheck',
           label: tag.label ?? tagValue,
           tooltip: tag.metadata?.description,
+          /* The editor hands the document's own node here, so the chip is
+             found by identity; a chip already gone is a click on nothing. */
+          ...(chipBehavior.click === 'unwrap' ?
+            { onClick: () => openChoiceChip(editorRef.current ? pathOfNode(editorRef.current, tag) : undefined) }
+          : {}),
         };
       }
 
@@ -323,7 +405,23 @@ export const RichTextFormField = memo(({
 
       return {};
     },
-    [descriptionByValue, renderMarkdown, isText, templates]
+    [descriptionByValue, renderMarkdown, isText, templates, chipBehavior.click, openChoiceChip]
+  );
+
+  /* Leaving the field: text that is exactly one of the choices becomes its
+     chip again, as the picker would have drawn it. Only here, never while
+     typing — a choice can be the start of a longer value, and a chip drawn
+     under the cursor would swallow it. */
+  const handleBlur = useCallback(
+    (event: FocusEvent<HTMLTextAreaElement>): void => {
+      const shown = isText ? lastTextRef.current : localValue;
+
+      if (choiceForValue(shown, allowed_values)) {
+        setLocalValue(toLocal(shown));
+      }
+      (rest as { onBlur?: (event: FocusEvent<HTMLTextAreaElement>) => void }).onBlur?.(event);
+    },
+    [isText, localValue, choiceKey, (rest as { onBlur?: unknown }).onBlur]
   );
 
   const handleKeyDown = useCallback(
@@ -331,9 +429,26 @@ export const RichTextFormField = memo(({
       if (isText && singleLine && event.key === 'Enter') {
         event.preventDefault();
       }
+      /* Backspace right after a choice chip opens it rather than deleting it,
+         when so configured. Stopped here, at keydown, so the browser raises no
+         `beforeinput` for the editor to delete the chip by. */
+      if (event.key === 'Backspace' && chipBehavior.backspace === 'unwrap' && editorRef.current) {
+        const path = choiceChipAtCursor(editorRef.current);
+
+        if (path) {
+          event.preventDefault();
+          openChoiceChip(path);
+        }
+      }
       (rest as { onKeyDown?: (event: KeyboardEvent<HTMLTextAreaElement>) => void }).onKeyDown?.(event);
     },
-    [isText, singleLine, (rest as { onKeyDown?: unknown }).onKeyDown]
+    [
+      isText,
+      singleLine,
+      chipBehavior.backspace,
+      openChoiceChip,
+      (rest as { onKeyDown?: unknown }).onKeyDown,
+    ]
   );
 
   const tags = useMemo<IReqoreRichTextEditorProps['tags']>((): IReqoreRichTextEditorProps['tags'] => {
@@ -384,6 +499,7 @@ export const RichTextFormField = memo(({
 
   return (
     <ReqoreRichTextEditor
+      ref={editorRef}
       value={formattedValue}
       onChange={handleChange}
       /* `rest` is spread BEFORE everything this component computes. It used to
@@ -409,6 +525,7 @@ export const RichTextFormField = memo(({
       panelProps={{ fluid: true, style: { minWidth: '150px', ...rest.panelProps?.style } }}
       readOnly={readOnly}
       onKeyDown={handleKeyDown}
+      onBlur={handleBlur}
       /* A form field carries no document toolbar. Styling was already off, so
          the bar held only undo and redo — drawn by Reqore as a panel as wide as
          the tag list, which under a field reads as an empty 600px menu with two

package/src/helpers/choiceChip.ts

@@ -1,5 +1,6 @@
 // Copyright 2026 Qore Technologies, s.r.o.
 import { IQorusAllowedValue, TQorusFormFieldSchema } from '@qoretechnologies/ts-toolkit';
+import { Editor, Node, Path, Range, Transforms } from 'slate';
 import { findAllowedValueOption } from './allowedValues';
 import { getListElementValue } from './options';
 
@@ -27,20 +28,54 @@ export interface IChoiceChipNode {
   children: [{ text: '' }];
 }
 
+/** The choice's value as the plain string it is; it arrives in the form engine's `{type, value}` envelope. */
+export const choiceValue = (choice: IQorusAllowedValue): string =>
+  String(getListElementValue(choice.value) ?? '');
+
+/**
+ * The text a document is, when it is one paragraph of plain text and nothing
+ * else; `undefined` for anything more — a chip, a mark, a second paragraph.
+ */
+export const plainTextOfNodes = (nodes: unknown): string | undefined => {
+  if (!Array.isArray(nodes) || nodes.length !== 1) {
+    return undefined;
+  }
+
+  const paragraph = nodes[0] as { type?: unknown; children?: unknown[] } | undefined;
+
+  if (paragraph?.type !== 'paragraph' || !Array.isArray(paragraph.children)) {
+    return undefined;
+  }
+
+  let text = '';
+
+  for (const child of paragraph.children as { text?: unknown }[]) {
+    if (typeof child?.text !== 'string' || Object.keys(child).some((key) => key !== 'text')) {
+      return undefined;
+    }
+    text += child.text;
+  }
+
+  return text;
+};
+
 /**
- * The choice a value is, when the value is a whole plain string the field
- * offers. A document, or a string holding more than the choice, is the
- * author's own text and is never a choice.
+ * The choice a value is: a whole plain string the field offers, or a document
+ * that is one paragraph of exactly that text — which is what an edit of the
+ * chip stores, so an id typed back is the choice it was. A string or document
+ * holding anything more is the author's own text and is never a choice.
  */
 export const choiceForValue = (
   value: unknown,
   choices?: IQorusAllowedValue[]
 ): IQorusAllowedValue | undefined => {
-  if (typeof value !== 'string' || !value || !choices?.length) {
+  const text = typeof value === 'string' ? value : plainTextOfNodes(value);
+
+  if (!text || !choices?.length) {
     return undefined;
   }
 
-  return findAllowedValueOption(value, { allowed_values: choices } as TQorusFormFieldSchema) as
+  return findAllowedValueOption(text, { allowed_values: choices } as TQorusFormFieldSchema) as
     | IQorusAllowedValue
     | undefined;
 };
@@ -49,8 +84,7 @@ export const choiceForValue = (
 export const choiceToNodes = (
   choice: IQorusAllowedValue
 ): { type: 'paragraph'; children: ({ text: string } | IChoiceChipNode)[] }[] => {
-  // The choice's value arrives in the form engine's `{type, value}` envelope.
-  const value = String(getListElementValue(choice.value) ?? '');
+  const value = choiceValue(choice);
   const description = (choice as { desc?: string; short_desc?: string }).short_desc ?? choice.desc;
 
   return [
@@ -71,7 +105,7 @@ export const choiceToNodes = (
   ];
 };
 
-const isChoiceChip = (node: unknown): node is IChoiceChipNode =>
+export const isChoiceChip = (node: unknown): node is IChoiceChipNode =>
   !!node &&
   typeof node === 'object' &&
   (node as { type?: unknown }).type === 'tag' &&
@@ -96,3 +130,98 @@ export const choiceValueOfNodes = (nodes: unknown): string | undefined => {
 
   return chips.length === 1 && text === '' ? chips[0].value : undefined;
 };
+
+/**
+ * What a choice chip does when the author acts on it, by action.
+ *
+ * The chip is a void: it holds no text of its own, so a key or a click on it
+ * has nothing to land in, and an author who wants to change one letter of the
+ * value it draws (`C07ERBFS0P6` to `C07ERBFS0P7`) has no way in unless the
+ * chip opens. Each action is configurable, and the default is the one that
+ * opens it: a creatable choice is the author's to edit.
+ */
+export interface IChoiceChipBehavior {
+  /**
+   * Backspace with the cursor right after the chip. `unwrap` (the default)
+   * turns the chip into its value as plain text, the cursor at the end of it,
+   * for the author to edit; `remove` deletes it whole, as the editor deletes
+   * any other chip.
+   */
+  backspace?: 'unwrap' | 'remove';
+  /**
+   * A click on the chip's body. `unwrap` (the default) turns the chip into its
+   * value as plain text, the cursor at the end of it; `cursor` only places the
+   * cursor after it, as a click on a template chip does.
+   */
+  click?: 'unwrap' | 'cursor';
+}
+
+export const DEFAULT_CHOICE_CHIP_BEHAVIOR: Required<IChoiceChipBehavior> = {
+  backspace: 'unwrap',
+  click: 'unwrap',
+};
+
+/** Where the node is in the document, by identity; the editor renders the document's own nodes, so a chip handed to a click handler is one of them. */
+export const pathOfNode = (editor: Editor, node: unknown): Path | undefined => {
+  // Stepped by hand: the build target cannot iterate a generator (TS2802).
+  const nodes = Node.nodes(editor);
+
+  for (let entry = nodes.next(); !entry.done; entry = nodes.next()) {
+    if (entry.value[0] === node) {
+      return entry.value[1];
+    }
+  }
+
+  return undefined;
+};
+
+/**
+ * The chip the cursor is on: right after it with nothing between, where
+ * Backspace would take it, or inside it, where the arrow keys can leave the
+ * cursor. Nothing when the selection spans text or sits anywhere else.
+ */
+export const choiceChipAtCursor = (editor: Editor): Path | undefined => {
+  const { selection } = editor;
+
+  if (!selection || !Range.isCollapsed(selection)) {
+    return undefined;
+  }
+
+  const { path, offset } = selection.anchor;
+  const inside = Editor.above(editor, { at: path, match: isChoiceChip, voids: true });
+
+  if (inside) {
+    return inside[1];
+  }
+
+  if (offset !== 0 || !Path.hasPrevious(path)) {
+    return undefined;
+  }
+
+  const previous = Path.previous(path);
+
+  return isChoiceChip(Node.get(editor, previous)) ? previous : undefined;
+};
+
+/**
+ * Opens the chip at `path` into its value as plain text, the cursor at the
+ * end of the text: what the author read is what they chose, now editable
+ * letter by letter. The document is text from here on, and is stored as the
+ * field stores anything typed; it is drawn as a chip again only when it is
+ * read back as exactly one of the choices.
+ */
+export const unwrapChoiceChip = (editor: Editor, path: Path): boolean => {
+  const chip = Node.get(editor, path);
+
+  if (!isChoiceChip(chip)) {
+    return false;
+  }
+
+  Editor.withoutNormalizing(editor, () => {
+    Transforms.removeNodes(editor, { at: path });
+    Transforms.insertNodes(editor, [{ text: chip.value }], { at: path });
+    Transforms.select(editor, Editor.end(editor, path));
+  });
+
+  return true;
+};