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

package/dist/helpers/templateText.d.ts

@@ -30,6 +30,7 @@ export interface ITemplateTextParagraph {
  * floor `describeTemplateReference` documents.
  */
 export declare const templateChipLabel: (templates: IReqoreFormTemplates | undefined, value: string) => string;
+export declare const catalogueValues: (templates?: IReqoreFormTemplates) => string[];
 /**
  * `text` as paragraphs, one per line, with each template reference a chip.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"templateText.d.ts","sourceRoot":"","sources":["../../src/helpers/templateText.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAEzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAO5C,qBAAqB;AACrB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,8BAA8B;AAC9B,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,CAAC;CACvD;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,cAAe,oBAAoB,GAAG,SAAS,SAAS,MAAM,KAAG,MAM9F,CAAC;AAqKF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,SACxB,MAAM,cACA,oBAAoB,iBACjB,MAAM,GAAG,MAAM,KAC7B,sBAAsB,EAmBrB,CAAC;AAEL,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,WAAY,cAAc;IAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,KAAG,MAWvE,CAAC;AAMhB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,SACzB,MAAM,cACA,oBAAoB,iBACjB,MAAM,GAAG,MAAM,KAC7B,gBAAgB,EAmClB,CAAC;AAEF;;gEAEgE;AAChE,eAAO,MAAM,eAAe,SACpB,MAAM,cACA,oBAAoB,iBACjB,MAAM,GAAG,MAAM,KAC7B,OAC4F,CAAC"}
+{"version":3,"file":"templateText.d.ts","sourceRoot":"","sources":["../../src/helpers/templateText.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAEzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAO5C,qBAAqB;AACrB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,8BAA8B;AAC9B,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,CAAC;CACvD;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,cAAe,oBAAoB,GAAG,SAAS,SAAS,MAAM,KAAG,MAM9F,CAAC;AA4BF,eAAO,MAAM,eAAe,eAAgB,oBAAoB,KAAG,MAAM,EAgCxE,CAAC;AAyGF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,SACxB,MAAM,cACA,oBAAoB,iBACjB,MAAM,GAAG,MAAM,KAC7B,sBAAsB,EAmBrB,CAAC;AAEL,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,WAAY,cAAc;IAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,KAAG,MAWvE,CAAC;AAMhB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,SACzB,MAAM,cACA,oBAAoB,iBACjB,MAAM,GAAG,MAAM,KAC7B,gBAAgB,EAmClB,CAAC;AAEF;;gEAEgE;AAChE,eAAO,MAAM,eAAe,SACpB,MAAM,cACA,oBAAoB,iBACjB,MAAM,GAAG,MAAM,KAC7B,OAC4F,CAAC"}

package/dist/helpers/templateText.js

@@ -9,7 +9,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasTemplateText = exports.templateTextSegments = exports.templateNodesToText = exports.templateTextToNodes = exports.templateChipLabel = void 0;
+exports.hasTemplateText = exports.templateTextSegments = exports.templateNodesToText = exports.templateTextToNodes = exports.catalogueValues = exports.templateChipLabel = void 0;
 var dpqlHelpers_1 = require("../components/dpqlEditor/dpqlHelpers");
 var templates_1 = require("./templates");
 /**
@@ -42,7 +42,7 @@ exports.templateChipLabel = templateChipLabel;
  * Every value the catalogue offers, longest first.
  *
  * A host may write its references in a grammar reqraft has never seen — a Qorus
- * test spells one `$._case.mode`, which `TEMPLATE_TOKEN_SOURCE` cannot match
+ * test spells one `$._case.mode`, which `templateTokenSpans` cannot match
  * because it has no `$key:` at all. Asking the field's own list which strings
  * it NAMES settles that without reqraft guessing at anybody's syntax, and it is
  * the same question the whole-value branch of the read row already asks
@@ -86,6 +86,7 @@ var catalogueValues = function (templates) {
     catalogueValueCache.set(templates, sorted);
     return sorted;
 };
+exports.catalogueValues = catalogueValues;
 /**
  * Where a literal catalogue value occurs in `line`, as whole references only.
  *
@@ -152,7 +153,10 @@ var grammarSource = function (grammar) {
  */
 var lineReferenceSpans = function (line, templates, tokenGrammar) {
     var declared = grammarSource(tokenGrammar);
-    var candidates = __spreadArray(__spreadArray(__spreadArray([], (declared ? patternSpans(line, declared) : []), true), patternSpans(line, templates_1.TEMPLATE_TOKEN_SOURCE), true), catalogueValues(templates).flatMap(function (literal) { return literalSpans(line, literal); }), true).sort(function (a, b) { return a.start - b.start || b.end - a.end; });
+    var candidates = __spreadArray(__spreadArray(__spreadArray([], (declared ? patternSpans(line, declared) : []), true), (0, templates_1.templateTokenSpans)(line).map(function (_a) {
+        var start = _a[0], end = _a[1];
+        return ({ start: start, end: end });
+    }), true), (0, exports.catalogueValues)(templates).flatMap(function (literal) { return literalSpans(line, literal); }), true).sort(function (a, b) { return a.start - b.start || b.end - a.end; });
     var spans = [];
     var cursor = 0;
     candidates.forEach(function (span) {

package/dist/helpers/templateText.js.map

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

package/dist/helpers/templateTree.d.ts

@@ -0,0 +1,248 @@
+/**
+ * The one model of what a field can refer to (qorus#646, David: templates are offered as a Qog's are, as a
+ * hierarchy, in one picker for a rich-text field and a DPQL field alike): its templates (`$…`) and, in a DPQL
+ * field, the record's fields (`@…`), as a tree of nodes. Every list that offers them reads this model - the picker
+ * browsed level by level (`TemplatePicker`), and the rows typing offers at the caret (`templateSearchItems`) - so
+ * a template is found, named and drawn the same wherever it is offered.
+ *
+ * A node is a group (it has members: a Qog state, a record) or a template; a group whose members all go on from
+ * one reference (`$data:receive_order.…`) stands for that reference (`reference`), which is what typing reaches it
+ * by. A node with members may be a value as well (a record taken whole): it then has a `value` too.
+ */
+import type { IReqoreFormTemplates } from '@qoretechnologies/reqore/dist/components/Textarea';
+import type { ITemplateCatalogueContext } from './templateCatalogue';
+/** What a node is, as its row says it: the badge a row carries and the icon it is drawn with. */
+export type TTemplateNodeKind = 'group' | 'state' | 'context' | 'config' | 'variable' | 'field' | 'template' | 'function' | 'keyword';
+/** What a row says a node is, in words. A group says nothing: its members do. */
+export declare const TEMPLATE_NODE_KIND_LABELS: Record<TTemplateNodeKind, string | undefined>;
+/** A catalogue row, as far as the tree reads it: a reqore dropdown item with a host's extras. */
+export interface ITemplateCatalogueRow {
+    label?: unknown;
+    value?: unknown;
+    badge?: unknown;
+    description?: unknown;
+    /** Where it comes from, as the host says (`withTemplateSources`). */
+    source?: unknown;
+    disabled?: boolean;
+    metadata?: Record<string, unknown>;
+    items?: ITemplateCatalogueRow[];
+    /** Members a host gives only when they are asked for - a Qog state's data, fetched when the state is opened. */
+    loadItems?: () => Promise<ITemplateCatalogueRow[]>;
+}
+export interface ITemplateNode {
+    /** Unique in its tree: the indexes of its path. */
+    id: string;
+    label: string;
+    /** What is written for it, where it is a value: a template (`$data:{a.b}`) or a field (`@name`). */
+    value?: string;
+    /**
+     * The reference it stands for, without braces: a template's value (`$data:a.b`), or the reference all of a
+     * group's members go on from (`$data:a`). Typing reaches a node by it. None for a group of unrelated members
+     * (Context Data).
+     */
+    reference?: string;
+    kind: TTemplateNodeKind;
+    /** Its type and the base type of its values (`templateType`), for a template. */
+    type?: string;
+    baseType?: string;
+    /** What it is, in its own words. */
+    description?: string;
+    /** Where it comes from, as its host says. */
+    source?: string;
+    /** The names of the groups it is in, outermost first. */
+    trail: string[];
+    /** The ids of the groups it is in, outermost first. */
+    trailIds: string[];
+    /**
+     * Taken, it is written as text and what is in it is completed next, as typing goes on into it: a template context
+     * the language server offers (`$timestamp:`), whose values only the server knows.
+     */
+    continues?: boolean;
+    children?: ITemplateNode[];
+    /** Its members, asked for when it is opened or searched into, where its host gives them only then. */
+    loadChildren?: () => Promise<ITemplateNode[]>;
+    /**
+     * A template that stands for a hash of any keys (`$dynamic:*`): what it holds is known only when it runs, so a
+     * key is written for it (`$dynamic:order.id`) rather than chosen.
+     */
+    writesKey?: boolean;
+    /**
+     * A group that is a value of its own - a record, a Qog state's data - and can be taken whole where the field it is
+     * picked for takes one (a field of any type, a hash): its "Use". Never a scalar field's: its catalogue marks the
+     * groups whose value does not fit it (`filterTemplatesByType` takes their "select whole" away).
+     */
+    takesWhole?: boolean;
+    disabled?: boolean;
+    /** The catalogue row it was read from, for a host that needs its own metadata back. */
+    row?: ITemplateCatalogueRow;
+    /** The context of the field's template catalogue it is (`withTemplateCatalogue`): what Qorus says of it. */
+    catalogue?: ITemplateCatalogueContext;
+}
+/** A reference as it reads without its braces: `$data:{a.b}` and `$data:a.b` are one reference. */
+export declare const unbracedReference: (reference: string) => string;
+/** What a reference is, by its context: `$data:` a Qog state's data, `$config:` a config item, `@` a field. */
+export declare const templateNodeKindOf: (reference: string | undefined) => TTemplateNodeKind;
+/** A record's field, as a DPQL session describes it (`dpql/setContext`). */
+export interface ITemplateTreeField {
+    display_name?: string;
+    short_desc?: string;
+    desc?: string;
+    type?: {
+        name?: string;
+        fields?: Record<string, ITemplateTreeField>;
+    } | string | string[];
+    /** The fields of a field that is a record of its own (`@customer.name`), as its type's or its own. */
+    fields?: Record<string, ITemplateTreeField>;
+}
+/** The name of the group a DPQL field's record fields are listed under. */
+export declare const RECORD_FIELDS_LABEL = "Record fields";
+export interface ITemplateTreeOptions {
+    /** The record's fields, written as `@<name>`: listed as a group of their own, beside the templates. */
+    fields?: Record<string, ITemplateTreeField>;
+    /**
+     * Whether the field takes a record whole (a field of any type, a hash, an expression): a record and a Qog state's
+     * data are offered whole ("Use") as well as opened. `false` for a scalar field: they are only opened. Not given:
+     * a record is offered whole where its catalogue keeps its "select whole", and a state is not.
+     */
+    wholeRecords?: boolean;
+    /** A lone group kept whole, for a host that adds groups of its own and opens it after (`openLoneGroup`). */
+    keepLoneGroup?: boolean;
+}
+/**
+ * A record field's key as DPQL writes it (`DpqlSerializer::fieldReferenceForKey`): bare where the tokenizer reads it
+ * bare and it has no dot (`@name`); else quoted, its dots escaped (`AbstractDataProvider::escapeFieldPathKey`), then
+ * its quotes and its backslashes but those before a dot (`DpqlSerializer::escapeFieldPath`): `@"order-id"`,
+ * `@"Unit\\.Price"`.
+ */
+export declare const fieldReference: (key: string) => string;
+/**
+ * The tree of what a field can refer to: its templates as their catalogue nests them, and the record's fields as
+ * a group of their own. A catalogue of one group is opened for the author: its members are the tree's top
+ * (`templateItemsToShow`).
+ */
+export declare const templateTree: (templates?: IReqoreFormTemplates | {
+    items?: unknown[];
+}, { fields, wholeRecords, keepLoneGroup }?: ITemplateTreeOptions) => ITemplateNode[];
+/**
+ * A lone group opened: where it is the only one, its members are what there is to choose from. Where there are
+ * others - the record's fields, what the language server completes - it is kept whole, under its name (qorus#646,
+ * David's review: "Order data"'s templates stood loose beside Record fields), so a host that adds groups opens it
+ * only once they are added (`keepLoneGroup`).
+ */
+export declare const openLoneGroup: (roots: ITemplateNode[]) => ITemplateNode[];
+/** Every node of the tree, depth first, as far as it is loaded. */
+export declare const allTemplateNodes: (roots: ITemplateNode[]) => ITemplateNode[];
+/** The node with `id`, if the tree has it loaded. */
+export declare const templateNodeById: (roots: ITemplateNode[], id: string | undefined) => ITemplateNode | undefined;
+/**
+ * The node a written reference is: its value in either spelling (`$data:{a.b}`, `$data:a.b`), or one of the other
+ * spellings its catalogue row answers to (`metadata.aliasValues`).
+ */
+export declare const templateNodeFor: (roots: ITemplateNode[], written: string) => ITemplateNode | undefined;
+/**
+ * The nodes a reference being typed reaches (`$`, `$d`, `$data:`, `$data:receive_order.`, `@na`), as typing
+ * narrows them: each node whose reference starts with what is typed, and not the members of one that does - the
+ * group is offered, and opened for its members. `$d` and `$data` offer the states; `$data:` offers them too;
+ * `$data:receive_order.` offers that state's data. Nothing that does not go on from what is typed is offered.
+ */
+export declare const searchTemplateReferences: (roots: ITemplateNode[], typed: string) => ITemplateNode[];
+/**
+ * The nodes a search box's words find, at any depth under `within` (the tree's top when not given): a reference
+ * (`$`, `@`) as typing finds it, anything else by the names of the node and the groups it is in, its value, its
+ * type and its description. Its members are not listed beside a group that is found: it is opened for them.
+ */
+export declare const searchTemplateTree: (roots: ITemplateNode[], query: string, within?: ITemplateNode) => ITemplateNode[];
+/**
+ * A reference's name as a chip says it: the outermost group, the last two steps, and "…" for the steps between
+ * (`Receive order › … › address › city`); up to three steps are said whole. Its whole path is the chip's hover.
+ */
+export declare const chipPathLabel: (trail: string[], label: string) => string;
+/** The steps a reference no catalogue lists is written in (`$data:{a.b.c}` → `a`, `b`, `c`), for its chip's name. */
+export declare const referenceSteps: (written: string) => string[];
+/** The members of `node`, asking its host for them where they come only when asked; its members as loaded. */
+export declare const loadTemplateChildren: (node: ITemplateNode) => Promise<ITemplateNode[]>;
+/**
+ * Where a catalogue row is, for its chip and its hover: the names of the groups it is in that are data it is part
+ * of (`data`: a Qog state, a record - what a chip says before its name), and of every group it is in (`all`: with
+ * the groups that only gather templates, such as Context Data - what its hover says).
+ */
+export declare const catalogueRowTrail: (templates: IReqoreFormTemplates | {
+    items?: unknown[];
+} | undefined, row: unknown) => {
+    data: string[];
+    all: string[];
+};
+/** What a template's color says (`getTemplateTagStyle`), the same on its chip, its row's badge and its hover. */
+export type TTemplateIntent = 'success' | 'custom1' | 'info';
+/**
+ * What each color a template is drawn in means, as its hover says it (qorus#646, David: "what is the significance
+ * of the colors?"): green is the data of the event that starts the Qog, purple a value Qorus gives, blue any other
+ * template (which its hover does not need to say).
+ */
+export declare const TEMPLATE_INTENT_MEANINGS: Record<TTemplateIntent, string>;
+/** The color a catalogue row's template is drawn in: its own metadata's, else its first member's. */
+export declare const templateRowIntent: (metadata: Record<string, unknown> | undefined) => TTemplateIntent;
+/** The color a node is drawn in: its row's, or for a group, that of the first of its members that has one. */
+export declare const templateNodeIntent: (node: ITemplateNode) => TTemplateIntent;
+/**
+ * The group a reference stands for whole, where no row of the catalogue is it: a Qog state's data taken whole
+ * (`$data:{receive_order}`) is named by its state ("Receive order"), its whole path its hover's.
+ */
+export declare const catalogueGroupFor: (templates: IReqoreFormTemplates | {
+    items?: unknown[];
+} | undefined, written: string) => {
+    label: string;
+    path: string;
+    row?: ITemplateCatalogueRow;
+} | undefined;
+/**
+ * Whether a reference names nothing the field is given (qorus#646, David's review: a half-typed reference was left
+ * standing as if it were one): a reference into a context whose templates the catalogue lists, every one, which
+ * none of them is. A context the catalogue lists nothing of, or one whose keys are written freely (`$dynamic:*`),
+ * or a part of the catalogue not loaded yet, says nothing either way.
+ */
+export declare const referenceNamesNothing: (roots: ITemplateNode[], written: string) => boolean;
+/** What a diagnostic says of a reference that names nothing here. */
+export declare const referenceNamesNothingMessage: (written: string) => string;
+/** The context a reference is in, with its `$` and `:` (`$data:` of `$data:receive_order.event_type`). */
+export declare const templateContextOf: (reference: string | undefined) => string | undefined;
+/**
+ * The template contexts of the tree a `$` and what follows it start (qorus#646, David: "`$` → contexts"): each
+ * context its nodes are in (`$data:`, `$local:`, ...), as a node of its own whose members are its first nodes, in
+ * the order the tree lists them. Taking one writes it and goes on to what is in it.
+ */
+/**
+ * The template contexts Qorus reads as a hash, `*` the whole of it (UserApi `expandOneVariable()`: the contexts read
+ * with `getHashDotValue()`, which gives the whole hash for `*`, and those with a `"*"` case of their own; an argument
+ * `*` is read by `_priv_get_template_arg()`: `\*|\w+[\w.]*`). A context of these is a container: used whole as
+ * `$<context>:*` where the field takes a record (qorus#646, David's review).
+ */
+export declare const WHOLE_TEMPLATE_CONTEXTS: Set<string>;
+/** The whole of a context, as Qorus writes it: `$data:*`. */
+export declare const wholeContextValue: (context: string) => string;
+export declare const templateContextsOf: (roots: ITemplateNode[], partial?: string, wholeRecords?: boolean) => ITemplateNode[];
+/** An LSP completion item, as far as the picker reads one. */
+interface IServerCompletion {
+    label: string;
+    kind?: number;
+    insertText?: string;
+    textEdit?: {
+        newText?: string;
+    };
+    detail?: string;
+    documentation?: string | {
+        value?: string;
+    };
+}
+/** The name of the picker's group of template contexts. */
+export declare const TEMPLATE_CONTEXTS_LABEL = "Template contexts";
+/**
+ * The picker's roots with the template contexts of the field's own templates as a group of their own (qorus#646,
+ * David's review: every container that can be used has Use, and the picker offers what typing offers): each
+ * context - `$local:`, `$data:`, `$dynamic:` - a container of what is in it, used whole as `$<context>:*` where the
+ * value takes a record. Where there is more than one context; one alone is the field's group already.
+ */
+export declare const withTemplateContexts: (roots: ITemplateNode[], wholeRecords?: boolean) => ITemplateNode[];
+export declare const withServerCompletions: (roots: ITemplateNode[], items: IServerCompletion[] | undefined, wholeRecords?: boolean) => ITemplateNode[];
+export {};
+//# sourceMappingURL=templateTree.d.ts.map

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

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