@qoretechnologies/reqraft 0.10.66-pr.145.gcb1e59d → 0.10.66

package/dist/components/smartEditor/index.js

@@ -2,11 +2,29 @@
 // Copyright 2026 Qore Technologies, s.r.o.
 // Public surface of the SmartEditor primitive.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.offsetToLspPosition = exports.mapCompletionKindToIcon = exports.lspPositionToOffset = exports.defaultToSlateNodes = exports.defaultSlateConverter = exports.defaultSelectionToOffset = exports.defaultFromSlateNodes = exports.useLspSession = exports.useLspAutocomplete = exports.SmartEditor = void 0;
+exports.offsetToLspPosition = exports.mapCompletionKindToIcon = exports.lspPositionToOffset = exports.defaultToSlateNodes = exports.defaultSlateConverter = exports.defaultSelectionToOffset = exports.defaultFromSlateNodes = exports.useLspSession = exports.templateCompletionItems = exports.templateChipInserter = exports.templateKind = exports.TEMPLATE_KIND = exports.styleTemplateItems = exports.kindBadge = exports.FIELD_KIND = exports.COMPLETION_LIST_THEME = exports.COMPLETION_ITEM_STYLE = exports.CompletionMenu = exports.CompletionList = exports.useLspAutocomplete = exports.useCompletionKeys = exports.toDropdownItems = exports.groupCompletionItems = exports.SmartEditor = void 0;
 var SmartEditor_1 = require("./SmartEditor");
 Object.defineProperty(exports, "SmartEditor", { enumerable: true, get: function () { return SmartEditor_1.SmartEditor; } });
 var useLspAutocomplete_1 = require("./useLspAutocomplete");
+Object.defineProperty(exports, "groupCompletionItems", { enumerable: true, get: function () { return useLspAutocomplete_1.groupCompletionItems; } });
+Object.defineProperty(exports, "toDropdownItems", { enumerable: true, get: function () { return useLspAutocomplete_1.toDropdownItems; } });
+Object.defineProperty(exports, "useCompletionKeys", { enumerable: true, get: function () { return useLspAutocomplete_1.useCompletionKeys; } });
 Object.defineProperty(exports, "useLspAutocomplete", { enumerable: true, get: function () { return useLspAutocomplete_1.useLspAutocomplete; } });
+// the one look and the two lists a field offers what can be written in (qorus#646)
+var CompletionMenu_1 = require("./CompletionMenu");
+Object.defineProperty(exports, "CompletionList", { enumerable: true, get: function () { return CompletionMenu_1.CompletionList; } });
+Object.defineProperty(exports, "CompletionMenu", { enumerable: true, get: function () { return CompletionMenu_1.CompletionMenu; } });
+var completionStyle_1 = require("./completionStyle");
+Object.defineProperty(exports, "COMPLETION_ITEM_STYLE", { enumerable: true, get: function () { return completionStyle_1.COMPLETION_ITEM_STYLE; } });
+Object.defineProperty(exports, "COMPLETION_LIST_THEME", { enumerable: true, get: function () { return completionStyle_1.COMPLETION_LIST_THEME; } });
+Object.defineProperty(exports, "FIELD_KIND", { enumerable: true, get: function () { return completionStyle_1.FIELD_KIND; } });
+Object.defineProperty(exports, "kindBadge", { enumerable: true, get: function () { return completionStyle_1.kindBadge; } });
+Object.defineProperty(exports, "styleTemplateItems", { enumerable: true, get: function () { return completionStyle_1.styleTemplateItems; } });
+Object.defineProperty(exports, "TEMPLATE_KIND", { enumerable: true, get: function () { return completionStyle_1.TEMPLATE_KIND; } });
+Object.defineProperty(exports, "templateKind", { enumerable: true, get: function () { return completionStyle_1.templateKind; } });
+var templateCompletions_1 = require("./templateCompletions");
+Object.defineProperty(exports, "templateChipInserter", { enumerable: true, get: function () { return templateCompletions_1.templateChipInserter; } });
+Object.defineProperty(exports, "templateCompletionItems", { enumerable: true, get: function () { return templateCompletions_1.templateCompletionItems; } });
 var useLspSession_1 = require("./useLspSession");
 Object.defineProperty(exports, "useLspSession", { enumerable: true, get: function () { return useLspSession_1.useLspSession; } });
 var helpers_1 = require("./helpers");

package/dist/components/smartEditor/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/smartEditor/index.ts"],"names":[],"mappings":";AAAA,2CAA2C;AAC3C,+CAA+C;;;AAE/C,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAOpB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAK3B,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,qCAQmB;AAPjB,gHAAA,qBAAqB,OAAA;AACrB,mHAAA,wBAAwB,OAAA;AACxB,gHAAA,qBAAqB,OAAA;AACrB,8GAAA,mBAAmB,OAAA;AACnB,8GAAA,mBAAmB,OAAA;AACnB,kHAAA,uBAAuB,OAAA;AACvB,8GAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/smartEditor/index.ts"],"names":[],"mappings":";AAAA,2CAA2C;AAC3C,+CAA+C;;;AAE/C,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAQpB,2DAK8B;AAJ5B,0HAAA,oBAAoB,OAAA;AACpB,qHAAA,eAAe,OAAA;AACf,uHAAA,iBAAiB,OAAA;AACjB,wHAAA,kBAAkB,OAAA;AAEpB,mFAAmF;AACnF,mDAAkE;AAAzD,gHAAA,cAAc,OAAA;AAAE,gHAAA,cAAc,OAAA;AAEvC,qDAQ2B;AAPzB,wHAAA,qBAAqB,OAAA;AACrB,wHAAA,qBAAqB,OAAA;AACrB,6GAAA,UAAU,OAAA;AACV,4GAAA,SAAS,OAAA;AACT,qHAAA,kBAAkB,OAAA;AAClB,gHAAA,aAAa,OAAA;AACb,+GAAA,YAAY,OAAA;AAEd,6DAAsF;AAA7E,2HAAA,oBAAoB,OAAA;AAAE,8HAAA,uBAAuB,OAAA;AAKtD,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,qCAQmB;AAPjB,gHAAA,qBAAqB,OAAA;AACrB,mHAAA,wBAAwB,OAAA;AACxB,gHAAA,qBAAqB,OAAA;AACrB,8GAAA,mBAAmB,OAAA;AACnB,8GAAA,mBAAmB,OAAA;AACnB,kHAAA,uBAAuB,OAAA;AACvB,8GAAA,mBAAmB,OAAA"}

package/dist/components/smartEditor/templateCompletions.d.ts

@@ -0,0 +1,98 @@
+import { IReqoreFormTemplates } from '@qoretechnologies/reqore/dist/components/Textarea';
+import { BaseEditor, Path } from 'slate';
+import { TTypeLabel } from '../../helpers/qorusTypeCatalogue';
+import { ITemplateNode, TTemplateIntent } from '../../helpers/templateTree';
+import { ILspCompletionItem } from '../../utils/lspClient.types';
+import { TCompletionInserter } from './types';
+type TTemplateItem = {
+    label?: unknown;
+    value?: unknown;
+    badge?: unknown;
+    /** The template's type and base type (`templateType`). */
+    metadata?: Record<string, unknown>;
+    description?: unknown;
+    /** Where it comes from, as the host says (`withTemplateSources`): the first thing its row's detail says. */
+    source?: unknown;
+    items?: TTemplateItem[];
+};
+/**
+ * The catalogue with each template marked with where it comes from, as the host says (the IDE: the app action
+ * that captures it): the template picker showed it beside the template held, and every list of templates shows it
+ * in the template's row (qorus#646). `sourceOf` answers for a template, not a group; nothing is changed where it
+ * says nothing.
+ */
+export declare const withTemplateSources: <T extends {
+    items?: unknown[];
+}>(templates: T, sourceOf?: (template: TTemplateItem) => string | undefined) => T;
+/**
+ * A field's templates as completion items, for `$` typed in a value's text (qorus#646): every template that can
+ * be written, wherever it sits in the catalogue - found by what is typed after the `$`, in the one completion
+ * list typing opens (`CompletionMenu`). Browsing the catalogue as a tree is the browse list's
+ * (`TemplateBrowser`). A record's field (`$record:{name}`) is a Field, anything else a Variable; the groups it
+ * is in and its type's name (`typeLabel`) are its detail (after where it comes from, when the host says), its
+ * description its documentation.
+ */
+export declare const templateCompletionItems: (templates?: IReqoreFormTemplates, typeLabel?: TTypeLabel) => ILspCompletionItem[];
+/**
+ * Inserts a template chosen from the completion list as the chip it is, in place of what was typed for it: the `$`
+ * or `@` that opened the list and the word after it. The `@` stayed in front of the chip (qorus#646, David's
+ * review): only a `$` was taken away.
+ */
+/**
+ * Writes a completion as text in the place of what is typed of it (or of the chip it replaces): the reference of
+ * a context, a state or a record taken to go on into (`$data:`, `$data:receive_order.`), which is completed on.
+ */
+export declare const templateTextInserter: TCompletionInserter;
+export declare const templateChipInserter: TCompletionInserter;
+/** What is typed before the caret in the text it is in: never anything across a chip. */
+export declare const typedInTheText: (editor: BaseEditor) => string;
+/**
+ * The chip a pick goes on from, where what is typed after it continues its reference (qorus#646, David's review):
+ * a state's chip (`$data:receive_order`) and `.` typed after it, then Event type picked, is the one reference
+ * `$data:{receive_order.event_type}` - the pick takes the chip's place as well as the `.`. It was put in after the
+ * chip, and the text read `$data:receive_order$data:{receive_order.event_type}`. Undefined where nothing but a
+ * `.` or `[` and a name is typed straight after a chip whose reference the pick's starts with.
+ */
+export declare const chipExtendedBy: (editor: BaseEditor, typedBefore: string, value: string) => Path | undefined;
+/** What a template row carries for the list (`ILspCompletionItem.data`): the node it is and how it is drawn. */
+export interface ITemplateRowData {
+    /** The node it is (`ITemplateNode.id`). */
+    templateNodeId?: string;
+    /** Taking it opens the picker at its members rather than writing it: a group no reference names. */
+    opens?: boolean;
+    /**
+     * Taking it writes its reference as text and lists what is in it, as typing goes on into it: a context
+     * (`$data:`), a state or a record (`$data:receive_order.`). Never a chip: a chip is a whole reference.
+     */
+    continues?: boolean;
+    /** What "Use" writes for a group taken whole: its value (`$data:{receive_order}`). */
+    wholeValue?: string;
+    /** A group that can also be taken whole (a record, a Qog state's data): its row's "Use" writes it. */
+    takesWhole?: boolean;
+    /** The row that opens the picker at the top of the field's templates. */
+    browseAll?: boolean;
+    /** The section of the list it is listed in. */
+    section?: string;
+    /** What it is (State data, Context...) and its type, named: its badges; its kind's badge in its chip's color. */
+    kindLabel?: string;
+    kindIntent?: TTemplateIntent;
+    typeLabel?: string;
+}
+/** The label of the row that opens the picker at the top of the field's templates. */
+export declare const BROWSE_ALL_TEMPLATES = "Browse all templates";
+/**
+ * The rows typing a reference offers (`$`, `$data:`, `$data:receive_order.`, `@na`): the nodes of the field's
+ * templates and fields it reaches (`searchTemplateReferences`) - a group is a row that opens the picker at its
+ * members - each saying where it is ("in Receive order"), not what group it is in as if that were what it is.
+ * Nothing that does not go on from what is typed is listed (qorus#646, David's review).
+ */
+export declare const templateSearchItems: (roots: ITemplateNode[], typed: string, typeLabel?: TTypeLabel, wholeRecords?: boolean) => ILspCompletionItem[];
+/** The row that opens the picker at the top of the field's templates: every template, browsed as they nest. */
+export declare const browseAllTemplatesItem: () => ILspCompletionItem;
+/**
+ * What the list says where a template context is written and nothing is listed in it (qorus#646, David's review:
+ * a context picked was left as an unfinished template, the list gone): what to write next, the list held open.
+ */
+export declare const unlistedContextMessage: (before: string) => string | undefined;
+export {};
+//# sourceMappingURL=templateCompletions.d.ts.map

package/dist/components/smartEditor/templateCompletions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateCompletions.d.ts","sourceRoot":"","sources":["../../../src/components/smartEditor/templateCompletions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AACzF,OAAO,EAAE,UAAU,EAAU,IAAI,EAAc,MAAM,OAAO,CAAC;AAE7D,OAAO,EAAoB,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEhF,OAAO,EACL,aAAa,EAUb,eAAe,EAEhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAM9C,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4GAA4G;IAC5G,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;YAAwB,OAAO,EAAE;cACpD,CAAC,aACD,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,KACzD,CAaF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,eACtB,oBAAoB,cACrB,UAAU,KACpB,kBAAkB,EA+BpB,CAAC;AASF;;;;GAIG;AACH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,mBA0BlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAyClC,CAAC;AAUF,yFAAyF;AACzF,eAAO,MAAM,cAAc,WAAY,UAAU,KAAG,MAcnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,WACjB,UAAU,eACL,MAAM,SACZ,MAAM,KACZ,IAAI,GAAG,SAsBT,CAAC;AAEF,gHAAgH;AAChH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oGAAoG;IACpG,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iHAAiH;IACjH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,UACvB,aAAa,EAAE,SACf,MAAM,cACF,UAAU,iBAEN,OAAO,KACrB,kBAAkB,EAyDpB,CAAC;AAyEF,+GAA+G;AAC/G,eAAO,MAAM,sBAAsB,QAAO,kBAUxC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,WAAY,MAAM,KAAG,MAAM,GAAG,SAMhE,CAAC"}

package/dist/components/smartEditor/templateCompletions.js

@@ -0,0 +1,380 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unlistedContextMessage = exports.browseAllTemplatesItem = exports.templateSearchItems = exports.BROWSE_ALL_TEMPLATES = exports.chipExtendedBy = exports.typedInTheText = exports.templateChipInserter = exports.templateTextInserter = exports.templateCompletionItems = exports.withTemplateSources = void 0;
+var slate_1 = require("slate");
+var slate_react_1 = require("slate-react");
+var qorusTypeCatalogue_1 = require("../../helpers/qorusTypeCatalogue");
+var templateType_1 = require("../../helpers/templateType");
+var templateTree_1 = require("../../helpers/templateTree");
+/** LSP completion kinds the list draws a field and a template with (`COMPLETION_KIND_CHIPS`). */
+var FIELD_KIND = 5;
+var TEMPLATE_KIND = 6;
+/**
+ * The catalogue with each template marked with where it comes from, as the host says (the IDE: the app action
+ * that captures it): the template picker showed it beside the template held, and every list of templates shows it
+ * in the template's row (qorus#646). `sourceOf` answers for a template, not a group; nothing is changed where it
+ * says nothing.
+ */
+var withTemplateSources = function (templates, sourceOf) {
+    if (!templates || !sourceOf)
+        return templates;
+    var mark = function (list) {
+        return list === null || list === void 0 ? void 0 : list.map(function (item) {
+            var source = typeof item.value === 'string' && item.value ? sourceOf(item) : undefined;
+            // `items` only on a group: a list draws a row with an `items` key and no members as disabled
+            return __assign(__assign(__assign({}, item), (Array.isArray(item.items) ? { items: mark(item.items) } : {})), (source ? { source: source } : {}));
+        });
+    };
+    return __assign(__assign({}, templates), { items: mark(templates.items) });
+};
+exports.withTemplateSources = withTemplateSources;
+/**
+ * A field's templates as completion items, for `$` typed in a value's text (qorus#646): every template that can
+ * be written, wherever it sits in the catalogue - found by what is typed after the `$`, in the one completion
+ * list typing opens (`CompletionMenu`). Browsing the catalogue as a tree is the browse list's
+ * (`TemplateBrowser`). A record's field (`$record:{name}`) is a Field, anything else a Variable; the groups it
+ * is in and its type's name (`typeLabel`) are its detail (after where it comes from, when the host says), its
+ * description its documentation.
+ */
+var templateCompletionItems = function (templates, typeLabel) {
+    if (typeLabel === void 0) { typeLabel = qorusTypeCatalogue_1.builtInTypeLabel; }
+    var items = [];
+    var seen = new Set();
+    var walk = function (list, trail) {
+        for (var _i = 0, _a = list !== null && list !== void 0 ? list : []; _i < _a.length; _i++) {
+            var item = _a[_i];
+            var label = typeof item.label === 'string' && item.label ? item.label : undefined;
+            if (typeof item.value === 'string' && item.value && !seen.has(item.value)) {
+                seen.add(item.value);
+                var where = trail.join(' › ');
+                // the template's type, named: never its code (qorus#646)
+                var templateTypeName = (0, templateType_1.templateType)(item);
+                var type = templateTypeName ? typeLabel(templateTypeName, (0, templateType_1.templateBaseType)(item)) : undefined;
+                var source = typeof item.source === 'string' ? item.source : undefined;
+                items.push({
+                    label: label !== null && label !== void 0 ? label : item.value,
+                    kind: item.value.startsWith('$record:') ? FIELD_KIND : TEMPLATE_KIND,
+                    detail: [source, where, type].filter(Boolean).join(' · ') || undefined,
+                    documentation: typeof item.description === 'string' && item.description.trim() ?
+                        { kind: 'markdown', value: item.description }
+                        : undefined,
+                    insertText: item.value,
+                    filterText: "".concat(item.value, " ").concat(label !== null && label !== void 0 ? label : ''),
+                });
+            }
+            if (Array.isArray(item.items))
+                walk(item.items, label ? __spreadArray(__spreadArray([], trail, true), [label], false) : trail);
+        }
+    };
+    walk(templates === null || templates === void 0 ? void 0 : templates.items, []);
+    return items;
+};
+exports.templateCompletionItems = templateCompletionItems;
+/**
+ * The signs a template is asked for by, as it is typed: `$`, as a template is written, and `@`, as a field is
+ * named in an expression - the list opens on either (`useLspAutocomplete`'s sigil tokens), so the template chosen
+ * takes either's place.
+ */
+var TEMPLATE_SIGILS = new Set(['$', '@']);
+/**
+ * Inserts a template chosen from the completion list as the chip it is, in place of what was typed for it: the `$`
+ * or `@` that opened the list and the word after it. The `@` stayed in front of the chip (qorus#646, David's
+ * review): only a `$` was taken away.
+ */
+/**
+ * Writes a completion as text in the place of what is typed of it (or of the chip it replaces): the reference of
+ * a context, a state or a record taken to go on into (`$data:`, `$data:receive_order.`), which is completed on.
+ */
+var templateTextInserter = function (item, editor, ctx) {
+    var _a, _b, _c;
+    var value = (_a = item.insertText) !== null && _a !== void 0 ? _a : item.label;
+    if (ctx.replacementPath) {
+        slate_1.Editor.withoutNormalizing(editor, function () {
+            slate_1.Transforms.removeNodes(editor, { at: ctx.replacementPath });
+            slate_1.Transforms.insertNodes(editor, { text: value }, {
+                at: ctx.replacementPath,
+                select: true,
+            });
+        });
+        focusEditor(editor);
+        return;
+    }
+    if (editor.selection) {
+        var typed = (0, exports.typedInTheText)(editor);
+        var written = (_c = (_b = /[$@][\w.:{}[\]*-]*$/.exec(typed)) === null || _b === void 0 ? void 0 : _b[0]) !== null && _c !== void 0 ? _c : '';
+        var extended = (0, exports.chipExtendedBy)(editor, typed, value);
+        for (var left = extended ? typed.length : written.length; left > 0; left--) {
+            slate_1.Editor.deleteBackward(editor, { unit: 'character' });
+        }
+        if (extended) {
+            slate_1.Transforms.removeNodes(editor, { at: extended });
+        }
+    }
+    slate_1.Transforms.insertText(editor, value);
+    focusEditor(editor);
+};
+exports.templateTextInserter = templateTextInserter;
+var templateChipInserter = function (item, editor, ctx) {
+    var _a;
+    var value = (_a = item.insertText) !== null && _a !== void 0 ? _a : item.label;
+    if (ctx.replacementPath) {
+        // a chip clicked and replaced: the pick takes its place
+        slate_1.Editor.withoutNormalizing(editor, function () {
+            slate_1.Transforms.removeNodes(editor, { at: ctx.replacementPath });
+            slate_1.Transforms.insertNodes(editor, { type: 'tag', value: value, label: item.label, children: [{ text: '' }] }, { at: ctx.replacementPath, select: true });
+        });
+        slate_1.Transforms.move(editor);
+        focusEditor(editor);
+        return;
+    }
+    if (editor.selection) {
+        var start = ctx.cursorOffset - 1;
+        while (start >= 0 && /[\w.:{}-]/.test(ctx.plainText[start]))
+            start--;
+        if (!(start >= 0 && TEMPLATE_SIGILS.has(ctx.plainText[start])))
+            start++;
+        var typed = (0, exports.typedInTheText)(editor);
+        var extended = (0, exports.chipExtendedBy)(editor, typed, value);
+        for (var left = Math.min(ctx.cursorOffset - start, extended ? typed.length : Infinity); left > 0; left--) {
+            slate_1.Editor.deleteBackward(editor, { unit: 'character' });
+        }
+        if (extended) {
+            slate_1.Transforms.removeNodes(editor, { at: extended });
+        }
+    }
+    slate_1.Transforms.insertNodes(editor, {
+        type: 'tag',
+        value: value,
+        label: item.label,
+        children: [{ text: '' }],
+    });
+    slate_1.Transforms.move(editor);
+    focusEditor(editor);
+};
+exports.templateChipInserter = templateChipInserter;
+var focusEditor = function (editor) {
+    try {
+        slate_react_1.ReactEditor.focus(editor);
+    }
+    catch (_a) {
+        // the editor is not in the document
+    }
+};
+/** What is typed before the caret in the text it is in: never anything across a chip. */
+var typedInTheText = function (editor) {
+    var _a;
+    var at = (_a = editor.selection) === null || _a === void 0 ? void 0 : _a.anchor;
+    if (!at) {
+        return '';
+    }
+    try {
+        var node = slate_1.Editor.node(editor, at.path)[0];
+        return typeof node.text === 'string' ?
+            node.text.slice(0, at.offset)
+            : '';
+    }
+    catch (_b) {
+        // a path the editor no longer has: nothing was typed there
+        return '';
+    }
+};
+exports.typedInTheText = typedInTheText;
+/**
+ * The chip a pick goes on from, where what is typed after it continues its reference (qorus#646, David's review):
+ * a state's chip (`$data:receive_order`) and `.` typed after it, then Event type picked, is the one reference
+ * `$data:{receive_order.event_type}` - the pick takes the chip's place as well as the `.`. It was put in after the
+ * chip, and the text read `$data:receive_order$data:{receive_order.event_type}`. Undefined where nothing but a
+ * `.` or `[` and a name is typed straight after a chip whose reference the pick's starts with.
+ */
+var chipExtendedBy = function (editor, typedBefore, value) {
+    var _a, _b;
+    var at = (_a = editor.selection) === null || _a === void 0 ? void 0 : _a.anchor;
+    var continuation = (_b = /^[.[][^\s]*$/.exec(typedBefore)) === null || _b === void 0 ? void 0 : _b[0];
+    if (!at || !continuation || at.path.length < 2 || at.path[at.path.length - 1] === 0) {
+        return undefined;
+    }
+    var chipPath = __spreadArray(__spreadArray([], at.path.slice(0, -1), true), [at.path[at.path.length - 1] - 1], false);
+    try {
+        var chip = slate_1.Editor.node(editor, chipPath)[0];
+        var chipValue = chip.type === 'tag' ?
+            chip.value
+            : undefined;
+        if (typeof chipValue !== 'string') {
+            return undefined;
+        }
+        var goesOn = (0, templateTree_1.unbracedReference)("".concat(chipValue).concat(continuation)).toLowerCase();
+        return (0, templateTree_1.unbracedReference)(value).toLowerCase().startsWith(goesOn) ? chipPath : undefined;
+    }
+    catch (_c) {
+        // no node before the text: nothing is gone on from
+        return undefined;
+    }
+};
+exports.chipExtendedBy = chipExtendedBy;
+/** The label of the row that opens the picker at the top of the field's templates. */
+exports.BROWSE_ALL_TEMPLATES = 'Browse all templates';
+/**
+ * The rows typing a reference offers (`$`, `$data:`, `$data:receive_order.`, `@na`): the nodes of the field's
+ * templates and fields it reaches (`searchTemplateReferences`) - a group is a row that opens the picker at its
+ * members - each saying where it is ("in Receive order"), not what group it is in as if that were what it is.
+ * Nothing that does not go on from what is typed is listed (qorus#646, David's review).
+ */
+var templateSearchItems = function (roots, typed, typeLabel, 
+/** Whether the value takes a record: a context, a state or a record is then offered whole too (`Use`). */
+wholeRecords) {
+    if (typeLabel === void 0) { typeLabel = qorusTypeCatalogue_1.builtInTypeLabel; }
+    /* A `$` and a context's name being written: the contexts it starts, each written and gone on from - then, from
+       two letters on, the templates named so (qorus#646, David: "`$` → contexts", each level filtered by what is
+       typed of it). */
+    var context = /^\$([\w-]*)$/.exec(typed);
+    if (context) {
+        var partial = context[1];
+        var wanted_1 = partial.toLowerCase();
+        var named = partial.length >= 2 ?
+            (0, templateTree_1.allTemplateNodes)(roots).filter(function (node) {
+                var _a;
+                return !!node.value &&
+                    !((_a = node.children) === null || _a === void 0 ? void 0 : _a.length) &&
+                    // a context of free keys is its context's row, above
+                    !node.writesKey &&
+                    node.label
+                        .toLowerCase()
+                        .split(/[^\p{L}\p{N}]+/u)
+                        .some(function (word) { return word.startsWith(wanted_1); });
+            })
+            : [];
+        return onceEach(__spreadArray(__spreadArray([], (0, templateTree_1.templateContextsOf)(roots, partial, wholeRecords).map(function (node) {
+            return templateRow(node, typeLabel);
+        }), true), named.map(function (node) { return templateRow(node, typeLabel); }), true));
+    }
+    /* A context of free keys (`$dynamic:*`) is completed by writing its key: no row stands for its keys once its
+       context is written - the list says to write the key (`unlistedContextMessage`). A context Qorus reads whole
+       is offered whole first, `$data:*`, where the value takes a record (qorus#646, David's review). */
+    var inContext = /^(\$[\w-]+:)(\*?)$/.exec(typed);
+    var known = roots.length > 0 &&
+        (0, templateTree_1.allTemplateNodes)(roots).some(function (node) { return (0, templateTree_1.templateContextOf)(node.reference) === (inContext === null || inContext === void 0 ? void 0 : inContext[1]); });
+    // what the field's catalogue says of the context, where it has one (`withTemplateCatalogue`); else as Qorus reads it
+    var catalogued = inContext ?
+        (0, templateTree_1.templateContextsOf)(roots, inContext[1].slice(1, -1)).find(function (node) { return node.reference === inContext[1] && node.catalogue; })
+        : undefined;
+    var readWhole = catalogued ?
+        !!catalogued.catalogue.use_whole
+        : !!inContext && templateTree_1.WHOLE_TEMPLATE_CONTEXTS.has(inContext[1].slice(1, -1));
+    var whole = inContext && known && wholeRecords !== false && readWhole ?
+        [wholeContextRow(inContext[1])]
+        : [];
+    return onceEach(__spreadArray(__spreadArray([], whole, true), (0, templateTree_1.searchTemplateReferences)(roots, typed)
+        .filter(function (node) { return !node.writesKey; })
+        .map(function (node) { return templateRow(node, typeLabel); }), true));
+};
+exports.templateSearchItems = templateSearchItems;
+/* Each reference once: a template a field lists in a group of its own (Context Data) and its catalogue lists in its
+   context is one row, the first. */
+var onceEach = function (rows) {
+    var seen = new Set();
+    return rows.filter(function (row) {
+        var _a;
+        var written = (0, templateTree_1.unbracedReference)((_a = row.insertText) !== null && _a !== void 0 ? _a : row.label);
+        if (seen.has(written)) {
+            return false;
+        }
+        seen.add(written);
+        return true;
+    });
+};
+/** The row for the whole of a context, `$data:*`: written as its chip. */
+var wholeContextRow = function (context) { return ({
+    label: (0, templateTree_1.wholeContextValue)(context),
+    kind: TEMPLATE_KIND,
+    detail: "all of ".concat(context),
+    insertText: (0, templateTree_1.wholeContextValue)(context),
+    filterText: (0, templateTree_1.wholeContextValue)(context),
+    data: { whole: true, section: 'Templates', kindLabel: 'Template context' },
+}); };
+/** A node's row in the completion list. */
+var templateRow = function (node, typeLabel) {
+    var _a, _b, _c, _d, _e;
+    var group = !!((_a = node.children) === null || _a === void 0 ? void 0 : _a.length) || !!node.loadChildren;
+    // a context written to go on into it (`$local:`): of the field's own templates, or of its catalogue
+    var isContext = node.id.startsWith('context:') || (!!node.catalogue && /^\$[\w-]+:$/.test((_b = node.reference) !== null && _b !== void 0 ? _b : ''));
+    /* A group that a reference names - a context, a state, a record - is gone on into as it is typed: taken, its
+       reference is written and what is in it is listed (qorus#646, David: "accepting an intermediate level continues
+       to the next level"). A group no reference names (Context Data) opens the picker at its members. */
+    var continuation = isContext ? node.reference
+        : group && node.reference && /^(?:\$[^:]*:.|@.)/.test(node.reference) ? "".concat(node.reference, ".")
+            : undefined;
+    var kindLabel = isContext ? 'Template context' : templateTree_1.TEMPLATE_NODE_KIND_LABELS[node.kind];
+    var type = node.type ? typeLabel(node.type, node.baseType) : undefined;
+    var where = node.trail.length ? "in ".concat(node.trail.join(' › ')) : undefined;
+    var data = {
+        templateNodeId: node.id,
+        opens: group && !continuation,
+        continues: !!continuation,
+        // a context of keys written freely has none listed, and is taken whole all the same (`$dynamic:*`)
+        takesWhole: (group || isContext) && !!node.takesWhole,
+        wholeValue: (group || isContext) && node.takesWhole ? node.value : undefined,
+        section: node.kind === 'field' ? templateTree_1.RECORD_FIELDS_LABEL : 'Templates',
+        kindLabel: kindLabel,
+        kindIntent: (0, templateTree_1.templateNodeIntent)(node),
+        typeLabel: type,
+    };
+    /* Under its name: where it is, what it is and where it comes from - in the row, never a hover over its edge
+       (qorus#646, David's review). */
+    var said = [where, node.description, node.source ? "from ".concat(node.source) : undefined].filter(Boolean);
+    return {
+        label: node.label,
+        kind: node.kind === 'field' ? FIELD_KIND : TEMPLATE_KIND,
+        detail: said.length ? said.join(' · ') : undefined,
+        insertText: (_d = (_c = continuation !== null && continuation !== void 0 ? continuation : node.value) !== null && _c !== void 0 ? _c : node.reference) !== null && _d !== void 0 ? _d : node.label,
+        // narrowed as it is typed by its reference: `$data:receive_order.ev` keeps Event type
+        filterText: (_e = node.reference) !== null && _e !== void 0 ? _e : node.label,
+        data: data,
+    };
+};
+/** The row that opens the picker at the top of the field's templates: every template, browsed as they nest. */
+var browseAllTemplatesItem = function () { return ({
+    label: exports.BROWSE_ALL_TEMPLATES,
+    kind: 19,
+    insertText: '',
+    filterText: '',
+    documentation: {
+        kind: 'markdown',
+        value: 'Every template and field this value can use, by group.',
+    },
+    data: { browseAll: true, section: '' },
+}); };
+exports.browseAllTemplatesItem = browseAllTemplatesItem;
+/**
+ * What the list says where a template context is written and nothing is listed in it (qorus#646, David's review:
+ * a context picked was left as an unfinished template, the list gone): what to write next, the list held open.
+ */
+var unlistedContextMessage = function (before) {
+    var _a;
+    var context = (_a = /(\$[\w-]+:)[\w.]*$/.exec(before)) === null || _a === void 0 ? void 0 : _a[1];
+    // said with the rows there are (the whole of it, Browse all templates) or in their place: true either way
+    return context ?
+        "Write what ".concat(context, " refers to after the ':', or pick from the list")
+        : undefined;
+};
+exports.unlistedContextMessage = unlistedContextMessage;
+//# sourceMappingURL=templateCompletions.js.map

package/dist/components/smartEditor/templateCompletions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateCompletions.js","sourceRoot":"","sources":["../../../src/components/smartEditor/templateCompletions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAEA,+BAA6D;AAC7D,2CAA0C;AAC1C,uEAAgF;AAChF,2DAA4E;AAC5E,2DAaoC;AAIpC,iGAAiG;AACjG,IAAM,UAAU,GAAG,CAAC,CAAC;AACrB,IAAM,aAAa,GAAG,CAAC,CAAC;AAcxB;;;;;GAKG;AACI,IAAM,mBAAmB,GAAG,UACjC,SAAY,EACZ,QAA0D;IAE1D,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAM,IAAI,GAAG,UAAC,IAAiC;QAC7C,OAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,CAAC,UAAC,IAAI;YACb,IAAM,MAAM,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACzF,6FAA6F;YAC7F,sCACK,IAAI,GACJ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAC9D,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,QAAA,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC7B;QACJ,CAAC,CAAC;IARF,CAQE,CAAC;IACL,6BAAY,SAAS,KAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAoC,CAAC,IAAG;AACvF,CAAC,CAAC;AAhBW,QAAA,mBAAmB,uBAgB9B;AAEF;;;;;;;GAOG;AACI,IAAM,uBAAuB,GAAG,UACrC,SAAgC,EAChC,SAAwC;IAAxC,0BAAA,EAAA,YAAwB,qCAAgB;IAExC,IAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,IAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAM,IAAI,GAAG,UAAC,IAAiC,EAAE,KAAe;QAC9D,KAAmB,UAAU,EAAV,KAAA,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,EAAV,cAAU,EAAV,IAAU,EAAE,CAAC;YAA3B,IAAM,IAAI,SAAA;YACb,IAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACpF,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1E,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrB,IAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAChC,yDAAyD;gBACzD,IAAM,gBAAgB,GAAG,IAAA,2BAAY,EAAC,IAAI,CAAC,CAAC;gBAC5C,IAAM,IAAI,GACR,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAA,+BAAgB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACrF,IAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzE,KAAK,CAAC,IAAI,CAAC;oBACT,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,IAAI,CAAC,KAAK;oBAC1B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;oBACpE,MAAM,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS;oBACtE,aAAa,EACX,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;wBAC/D,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE;wBAC/C,CAAC,CAAC,SAAS;oBACb,UAAU,EAAE,IAAI,CAAC,KAAK;oBACtB,UAAU,EAAE,UAAG,IAAI,CAAC,KAAK,cAAI,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAE;iBAC3C,CAAC,CAAC;YACL,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,iCAAK,KAAK,UAAE,KAAK,UAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACrF,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,KAAoC,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAlCW,QAAA,uBAAuB,2BAkClC;AAEF;;;;GAIG;AACH,IAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE5C;;;;GAIG;AACH;;;GAGG;AACI,IAAM,oBAAoB,GAAwB,UAAC,IAAI,EAAE,MAAM,EAAE,GAAG;;IACzE,IAAM,KAAK,GAAG,MAAA,IAAI,CAAC,UAAU,mCAAI,IAAI,CAAC,KAAK,CAAC;IAC5C,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxB,cAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE;YAChC,kBAAU,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;YAC5D,kBAAU,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAS,EAAE;gBACrD,EAAE,EAAE,GAAG,CAAC,eAAe;gBACvB,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,WAAW,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,IAAM,KAAK,GAAG,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;QACrC,IAAM,OAAO,GAAG,MAAA,MAAA,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,0CAAG,CAAC,CAAC,mCAAI,EAAE,CAAC;QAC7D,IAAM,QAAQ,GAAG,IAAA,sBAAc,EAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,KAAK,IAAI,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;YAC3E,cAAM,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,kBAAU,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,kBAAU,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,WAAW,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC,CAAC;AA1BW,QAAA,oBAAoB,wBA0B/B;AAEK,IAAM,oBAAoB,GAAwB,UAAC,IAAI,EAAE,MAAM,EAAE,GAAG;;IACzE,IAAM,KAAK,GAAG,MAAA,IAAI,CAAC,UAAU,mCAAI,IAAI,CAAC,KAAK,CAAC;IAC5C,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxB,wDAAwD;QACxD,cAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE;YAChC,kBAAU,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;YAC5D,kBAAU,CAAC,WAAW,CACpB,MAAM,EACN,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,OAAA,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAS,EAC1E,EAAE,EAAE,EAAE,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,CAC1C,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,kBAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,WAAW,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,IAAI,KAAK,GAAG,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC;QACjC,OAAO,KAAK,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAAE,KAAK,EAAE,CAAC;QACrE,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,KAAK,EAAE,CAAC;QACxE,IAAM,KAAK,GAAG,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;QACrC,IAAM,QAAQ,GAAG,IAAA,sBAAc,EAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,KACE,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,GAAG,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjF,IAAI,GAAG,CAAC,EACR,IAAI,EAAE,EACN,CAAC;YACD,cAAM,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,kBAAU,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,kBAAU,CAAC,WAAW,CAAC,MAAM,EAAE;QAC7B,IAAI,EAAE,KAAK;QACX,KAAK,OAAA;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;KAClB,CAAC,CAAC;IACV,kBAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,WAAW,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC,CAAC;AAzCW,QAAA,oBAAoB,wBAyC/B;AAEF,IAAM,WAAW,GAAG,UAAC,MAAkB;IACrC,IAAI,CAAC;QACH,yBAAW,CAAC,KAAK,CAAC,MAAqB,CAAC,CAAC;IAC3C,CAAC;IAAC,WAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;AACH,CAAC,CAAC;AAEF,yFAAyF;AAClF,IAAM,cAAc,GAAG,UAAC,MAAkB;;IAC/C,IAAM,EAAE,GAAG,MAAA,MAAM,CAAC,SAAS,0CAAE,MAAM,CAAC;IACpC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACI,IAAA,IAAI,GAAI,cAAM,CAAC,IAAI,CAAC,MAA2B,EAAE,EAAE,CAAC,IAAI,CAAC,GAArD,CAAsD;QACjE,OAAO,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YACzD,IAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC;YACrD,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAAC,WAAM,CAAC;QACP,2DAA2D;QAC3D,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAdW,QAAA,cAAc,kBAczB;AAEF;;;;;;GAMG;AACI,IAAM,cAAc,GAAG,UAC5B,MAAkB,EAClB,WAAmB,EACnB,KAAa;;IAEb,IAAM,EAAE,GAAG,MAAA,MAAM,CAAC,SAAS,0CAAE,MAAM,CAAC;IACpC,IAAM,YAAY,GAAG,MAAA,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,0CAAG,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACpF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAM,QAAQ,mCAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,SAAC,CAAC;IAC5E,IAAI,CAAC;QACI,IAAA,IAAI,GAAI,cAAM,CAAC,IAAI,CAAC,MAA2B,EAAE,QAAQ,CAAC,GAAtD,CAAuD;QAClE,IAAM,SAAS,GACZ,IAA2C,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;YAC1D,IAA4B,CAAC,KAAK;YACrC,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAM,MAAM,GAAG,IAAA,gCAAiB,EAAC,UAAG,SAAS,SAAG,YAAY,CAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9E,OAAO,IAAA,gCAAiB,EAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,CAAC;IAAC,WAAM,CAAC;QACP,mDAAmD;QACnD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AA1BW,QAAA,cAAc,kBA0BzB;AA2BF,sFAAsF;AACzE,QAAA,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACI,IAAM,mBAAmB,GAAG,UACjC,KAAsB,EACtB,KAAa,EACb,SAAwC;AACxC,0GAA0G;AAC1G,YAAsB;IAFtB,0BAAA,EAAA,YAAwB,qCAAgB;IAIxC;;uBAEmB;IACnB,IAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,OAAO,EAAE,CAAC;QACZ,IAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAM,QAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACrC,IAAM,KAAK,GACT,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YACnB,IAAA,+BAAgB,EAAC,KAAK,CAAC,CAAC,MAAM,CAC5B,UAAC,IAAI;;gBACH,OAAA,CAAC,CAAC,IAAI,CAAC,KAAK;oBACZ,CAAC,CAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,MAAM,CAAA;oBACtB,qDAAqD;oBACrD,CAAC,IAAI,CAAC,SAAS;oBACf,IAAI,CAAC,KAAK;yBACP,WAAW,EAAE;yBACb,KAAK,CAAC,iBAAiB,CAAC;yBACxB,IAAI,CAAC,UAAC,IAAI,IAAK,OAAA,IAAI,CAAC,UAAU,CAAC,QAAM,CAAC,EAAvB,CAAuB,CAAC,CAAA;aAAA,CAC7C;YACH,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,QAAQ,iCACV,IAAA,iCAAkB,EAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,UAAC,IAAI;YAC3D,OAAA,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;QAA5B,CAA4B,CAC7B,SACE,KAAK,CAAC,GAAG,CAAC,UAAC,IAAI,IAAK,OAAA,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,EAA5B,CAA4B,CAAC,QACpD,CAAC;IACL,CAAC;IACD;;wGAEoG;IACpG,IAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,IAAM,KAAK,GACT,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,IAAA,+BAAgB,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAC,IAAI,IAAK,OAAA,IAAA,gCAAiB,EAAC,IAAI,CAAC,SAAS,CAAC,MAAK,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAG,CAAC,CAAC,CAAA,EAApD,CAAoD,CAAC,CAAC;IAC/F,qHAAqH;IACrH,IAAM,UAAU,GACd,SAAS,CAAC,CAAC;QACT,IAAA,iCAAkB,EAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CACvD,UAAC,IAAI,IAAK,OAAA,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,EAAjD,CAAiD,CAC5D;QACH,CAAC,CAAC,SAAS,CAAC;IACd,IAAM,SAAS,GACb,UAAU,CAAC,CAAC;QACV,CAAC,CAAC,UAAU,CAAC,SAAU,CAAC,SAAS;QACnC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,sCAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,IAAM,KAAK,GACT,SAAS,IAAI,KAAK,IAAI,YAAY,KAAK,KAAK,IAAI,SAAS,CAAC,CAAC;QACzD,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,QAAQ,iCACV,KAAK,SACL,IAAA,uCAAwB,EAAC,KAAK,EAAE,KAAK,CAAC;SACtC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,CAAC,IAAI,CAAC,SAAS,EAAf,CAAe,CAAC;SACjC,GAAG,CAAC,UAAC,IAAI,IAAK,OAAA,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,EAA5B,CAA4B,CAAC,QAC9C,CAAC;AACL,CAAC,CAAC;AA/DW,QAAA,mBAAmB,uBA+D9B;AAEF;oCACoC;AACpC,IAAM,QAAQ,GAAG,UAAC,IAA0B;IAC1C,IAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAC,GAAG;;QACrB,IAAM,OAAO,GAAG,IAAA,gCAAiB,EAAC,MAAA,GAAG,CAAC,UAAU,mCAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,0EAA0E;AAC1E,IAAM,eAAe,GAAG,UAAC,OAAe,IAAyB,OAAA,CAAC;IAChE,KAAK,EAAE,IAAA,gCAAiB,EAAC,OAAO,CAAC;IACjC,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,iBAAU,OAAO,CAAE;IAC3B,UAAU,EAAE,IAAA,gCAAiB,EAAC,OAAO,CAAC;IACtC,UAAU,EAAE,IAAA,gCAAiB,EAAC,OAAO,CAAC;IACtC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAGvE;CACF,CAAC,EAV+D,CAU/D,CAAC;AAEH,2CAA2C;AAC3C,IAAM,WAAW,GAAG,UAAC,IAAmB,EAAE,SAAqB;;IAC7D,IAAM,KAAK,GAAG,CAAC,CAAC,CAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,MAAM,CAAA,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;IAC7D,oGAAoG;IACpG,IAAM,SAAS,GACb,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,aAAa,CAAC,IAAI,CAAC,MAAA,IAAI,CAAC,SAAS,mCAAI,EAAE,CAAC,CAAC,CAAC;IACnG;;yGAEqG;IACrG,IAAM,YAAY,GAChB,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS;QAC1B,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAG,IAAI,CAAC,SAAS,MAAG;YAC5F,CAAC,CAAC,SAAS,CAAC;IACd,IAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,wCAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxF,IAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,IAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,IAAM,IAAI,GAAqB;QAC7B,cAAc,EAAE,IAAI,CAAC,EAAE;QACvB,KAAK,EAAE,KAAK,IAAI,CAAC,YAAY;QAC7B,SAAS,EAAE,CAAC,CAAC,YAAY;QACzB,mGAAmG;QACnG,UAAU,EAAE,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU;QACrD,UAAU,EAAE,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC5E,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,kCAAmB,CAAC,CAAC,CAAC,WAAW;QAClE,SAAS,WAAA;QACT,UAAU,EAAE,IAAA,iCAAkB,EAAC,IAAI,CAAC;QACpC,SAAS,EAAE,IAAI;KAChB,CAAC;IACF;sCACkC;IAClC,IAAM,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAQ,IAAI,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAC5F,OAAO,CACR,CAAC;IACF,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;QACxD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAClD,UAAU,EAAE,MAAA,MAAA,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,IAAI,CAAC,KAAK,mCAAI,IAAI,CAAC,SAAS,mCAAI,IAAI,CAAC,KAAK;QACtE,sFAAsF;QACtF,UAAU,EAAE,MAAA,IAAI,CAAC,SAAS,mCAAI,IAAI,CAAC,KAAK;QACxC,IAAI,EAAE,IAA+B;KACtC,CAAC;AACJ,CAAC,CAAC;AAEF,+GAA+G;AACxG,IAAM,sBAAsB,GAAG,cAA0B,OAAA,CAAC;IAC/D,KAAK,EAAE,4BAAoB;IAC3B,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,aAAa,EAAE;QACb,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,wDAAwD;KAChE;IACD,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAA6B;CAClE,CAAC,EAV8D,CAU9D,CAAC;AAVU,QAAA,sBAAsB,0BAUhC;AAEH;;;GAGG;AACI,IAAM,sBAAsB,GAAG,UAAC,MAAc;;IACnD,IAAM,OAAO,GAAG,MAAA,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,0CAAG,CAAC,CAAC,CAAC;IACvD,0GAA0G;IAC1G,OAAO,OAAO,CAAC,CAAC;QACZ,qBAAc,OAAO,oDAAiD;QACxE,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AANW,QAAA,sBAAsB,0BAMjC"}

package/dist/components/smartEditor/typedReferences.d.ts

@@ -0,0 +1,34 @@
+import { Editor } from 'slate';
+import { ISlateConverter, ISlateElement, TSlateNode } from './types';
+export interface IRechippedParagraph {
+    /** The paragraph's children, with the references typed in it drawn as chips. */
+    children: TSlateNode[];
+    /** Where the caret goes in them: the same place in the text. */
+    caret?: {
+        path: number[];
+        offset: number;
+    };
+}
+/**
+ * The paragraph at `index`, its typed references drawn as chips - or `undefined` when there is none to draw.
+ *
+ * A reference is typed out in full when the converter reads one where the paragraph has plain text. With a
+ * `caret` (the plain-text offset of the caret in the paragraph), only a reference the caret has left is drawn:
+ * the converter says the character typed right after it ends it (`endsReference`) - a space or an operator, not
+ * a `.` that goes on to a sub-field. One still being typed is left as text; drawn as a chip mid-word, the rest of
+ * the word could not be typed into it. Without a caret (the editor has been left) every one is drawn.
+ */
+export declare const rechipTypedReferences: (converter: ISlateConverter, paragraph: ISlateElement, index: number, caret?: number, keepAsText?: (reference: string) => boolean) => IRechippedParagraph | undefined;
+/**
+ * Draws the paragraph at `index` as `rechipped` has it: its typed references as chips, the text the same, the caret
+ * where `rechipped` puts it.
+ */
+export declare const drawRechipped: (editor: Editor, index: number, rechipped: IRechippedParagraph) => void;
+/**
+ * Draws every reference typed out in full in the editor as its chip - those that name nothing the field is given
+ * stay text (`keepAsText`) - as leaving the field does, and as Enter or Tab does where the list has nothing more to
+ * offer (a context of free keys and its key, `$static:order.id`: qorus#646). With `caretParagraph`, only that
+ * paragraph, the caret put at its end. Whether anything was drawn.
+ */
+export declare const commitTypedReferences: (editor: Editor, converter: ISlateConverter, keepAsText?: (reference: string) => boolean, caretParagraph?: number) => boolean;
+//# sourceMappingURL=typedReferences.d.ts.map

package/dist/components/smartEditor/typedReferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedReferences.d.ts","sourceRoot":"","sources":["../../../src/components/smartEditor/typedReferences.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAc,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAc,UAAU,EAAE,MAAM,SAAS,CAAC;AA+EjF,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,gEAAgE;IAChE,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,cACrB,eAAe,aACf,aAAa,SACjB,MAAM,UACL,MAAM,eACD,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,KAC1C,mBAAmB,GAAG,SA6BxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,WAAY,MAAM,SAAS,MAAM,aAAa,mBAAmB,SAa1F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,WACxB,MAAM,aACH,eAAe,eACb,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,mBAC1B,MAAM,KACtB,OAcF,CAAC"}