@qoretechnologies/reqraft 0.10.62 → 0.10.63-pr.142.g0b675cd

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;AAOpB,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,18 @@
+import { IReqoreFormTemplates } from '@qoretechnologies/reqore/dist/components/Textarea';
+import { ILspCompletionItem } from '../../utils/lspClient.types';
+import { TCompletionInserter } from './types';
+/**
+ * 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 are its detail, its description its documentation.
+ */
+export declare const templateCompletionItems: (templates?: IReqoreFormTemplates) => 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.
+ */
+export declare const templateChipInserter: TCompletionInserter;
+//# 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;AAGzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAc9C;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,eAAgB,oBAAoB,KAAG,kBAAkB,EA2B5F,CAAC;AASF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,mBAsBlC,CAAC"}

package/dist/components/smartEditor/templateCompletions.js

@@ -0,0 +1,94 @@
+"use strict";
+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.templateChipInserter = exports.templateCompletionItems = void 0;
+var slate_1 = require("slate");
+var slate_react_1 = require("slate-react");
+/** LSP completion kinds the list draws a field and a template with (`COMPLETION_KIND_CHIPS`). */
+var FIELD_KIND = 5;
+var TEMPLATE_KIND = 6;
+/**
+ * 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 are its detail, its description its documentation.
+ */
+var templateCompletionItems = function (templates) {
+    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(' › ');
+                var type = typeof item.badge === 'string' ? item.badge : undefined;
+                items.push({
+                    label: label !== null && label !== void 0 ? label : item.value,
+                    kind: item.value.startsWith('$record:') ? FIELD_KIND : TEMPLATE_KIND,
+                    detail: [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.
+ */
+var templateChipInserter = function (item, editor, ctx) {
+    var _a;
+    var value = (_a = item.insertText) !== null && _a !== void 0 ? _a : item.label;
+    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++;
+        for (var left = ctx.cursorOffset - start; left > 0; left--) {
+            slate_1.Editor.deleteBackward(editor, { unit: 'character' });
+        }
+    }
+    slate_1.Transforms.insertNodes(editor, {
+        type: 'tag',
+        value: value,
+        label: item.label,
+        children: [{ text: '' }],
+    });
+    slate_1.Transforms.move(editor);
+    try {
+        slate_react_1.ReactEditor.focus(editor);
+    }
+    catch (_b) {
+        // the editor is not in the document
+    }
+};
+exports.templateChipInserter = templateChipInserter;
+//# 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":"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"}

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

@@ -1,4 +1,5 @@
 /// <reference types="react" />
+import { IReqoreRichTextEditorProps } from '@qoretechnologies/reqore/dist/components/RichTextEditor';
 import { IReqoreTagProps } from '@qoretechnologies/reqore/dist/components/Tag';
 import { BaseEditor } from 'slate';
 import { HistoryEditor } from 'slate-history';
@@ -127,11 +128,16 @@ export interface ISmartEditorProps {
      * for read-only display surfaces showing text that is not expected to
      * be valid in the session's language — e.g. the expression "Explain"
      * panel, which renders the server's human-readable rendering through
-     * the editor for chips + token colours but is not parseable DPQL.
+     * the editor for chips + token colors but is not parseable DPQL.
      */
     showDiagnostics?: boolean;
     /** Called when the editor loses focus. */
     onBlur?: () => void;
+    /**
+     * What the editor lists when it is clicked, tapped or tabbed into, and inserts as chips - the field's
+     * templates (see `useTemplateTags`). The language server's completion stays as it is, opened by typing.
+     */
+    tags?: IReqoreRichTextEditorProps['tags'];
     /**
      * Custom loading indicator rendered as an overlay on top of the
      * editor body while `session.isReady` is false. Defaults to a
@@ -148,6 +154,11 @@ export interface ISmartEditorProps {
      * distracting.
      */
     enableHover?: boolean;
+    /**
+     * How long the mouse rests before its hover is asked for, in ms. Default 300: a mouse passing over the
+     * text asks nothing. Only a mouse (or a pen held above the screen) hovers; a finger has "Details".
+     */
+    hoverDelayMs?: number;
     /**
      * Generic "this editor is busy" flag — when `true`, the loading
      * overlay is shown regardless of `session.isReady`. Used by wrappers

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/smartEditor/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/smartEditor/types.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,GAAG,KAAK,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IACrD,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,MAAM,CAAC;IACnD;;;;OAIG;IACH,iBAAiB,EAAE,CACjB,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,KACjB,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,EAChD,OAAO,EAAE,0BAA0B,KAChC,IAAI,CAAC;AAEV,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;OAQG;IACH,OAAO,EAAE,oBAAoB,CAAC;IAE9B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAErC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,GAAG,CAAC,OAAO,CAAC;IAE3D,4DAA4D;IAC5D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,eAAe,CAAC;IAEtD;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,CACX,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,KAC7C,IAAI,CAAC;IAEV,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEhC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IAEzC,iFAAiF;IACjF,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAE1C;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEnC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B"}

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

@@ -3,6 +3,7 @@ import { HistoryEditor } from 'slate-history';
 import { ReactEditor } from 'slate-react';
 import { ILspCompletionItem } from '../../utils/lspClient.types';
 import { ISlateConverter, ISlateElement, TCompletionInserter } from './types';
+export declare const COMPLETION_KIND_CHIPS: Record<number, string>;
 export interface ICompletionDropdownItem {
     label: string;
     value: string;
@@ -57,6 +58,37 @@ export interface IUseLspAutocompleteResult {
         top: number;
         left: number;
     };
+    /**
+     * The row whose documentation is shown under it in the list (its `value`), or null. A row's documentation
+     * is otherwise a hover, which a keyboard and a finger cannot reach: its ⓘ, or Ctrl+Space on the row the
+     * keyboard is on, shows it.
+     */
+    docsFor: string | null;
+    /** Show the documentation of the row with `value`, or put it away when it is shown; the keyboard's row when
+     *  no value is given. */
+    toggleDocs: (value?: string) => void;
 }
+/**
+ * The list's rows in groups: as ranked when the server ranked them (`sortText`), otherwise by kind - Field,
+ * Variable, Function... - when there is more than one.
+ */
+export declare const groupCompletionItems: (items: ICompletionDropdownItem[]) => ICompletionGroup[];
+/** Completion items as the list's rows. */
+export declare const toDropdownItems: (lspItems: ILspCompletionItem[]) => ICompletionDropdownItem[];
+/**
+ * The list's keys, the same wherever it is open, and as the browse list's (`TemplateBrowser`): ArrowDown and
+ * ArrowUp move through it, Enter takes the row the keyboard is on, Escape puts it away, Tab leaves it as it
+ * leaves any control. Heard before anything else on the page while the list is
+ * open - the focus stays where it is (an editor, a picker's button), the list never takes it.
+ */
+export declare const useCompletionKeys: ({ isOpen, count, setFocusedIndex, onAccept, onClose, onOtherKey, }: {
+    isOpen: boolean;
+    count: number;
+    setFocusedIndex: (update: (index: number) => number) => void;
+    onAccept: () => void;
+    onClose: () => void;
+    /** Any other key, for the list to take (true) or leave to the page. */
+    onOtherKey?: (event: KeyboardEvent) => boolean;
+}) => void;
 export declare function useLspAutocomplete(opts: IUseLspAutocompleteOptions): IUseLspAutocompleteResult;
 //# sourceMappingURL=useLspAutocomplete.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useLspAutocomplete.d.ts","sourceRoot":"","sources":["../../../src/components/smartEditor/useLspAutocomplete.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAc,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA6C9E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,kBAAkB,CAAC;IACxB,QAAQ,CAAC,EAAE;QACT,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,uBAAuB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACrF,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,+DAA+D;IAC/D,SAAS,EAAE,eAAe,CAAC;IAC3B;;;OAGG;IACH,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAGhB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa,EAAE,CACb,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,EAChD,KAAK,EAAE,aAAa,EAAE,KACnB,IAAI,CAAC;IACV,YAAY,EAAE,CACZ,IAAI,EAAE,uBAAuB,EAC7B,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,KAC7C,IAAI,CAAC;IAGV,UAAU,EAAE,CACV,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,EAChD,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KACvC,IAAI,CAAC;IAIV,mBAAmB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAG7C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,0BAA0B,GAC/B,yBAAyB,CAonB3B"}
+{"version":3,"file":"useLspAutocomplete.d.ts","sourceRoot":"","sources":["../../../src/components/smartEditor/useLspAutocomplete.ts"],"names":[],"mappings":"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"}