@qoretechnologies/reqraft 0.10.64 → 0.10.65-pr.137.g62fcecc

package/dist/helpers/qorusTypeCatalogue.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qorusTypeSentenceForm = exports.qorusTypeDisplayName = exports.catalogueTypeName = exports.getQorusTypes = exports.defaultQorusTypes = exports.compactTypesList = void 0;
+exports.compactTypesList = ['richtext', 'float', 'hash', 'list', 'bool', 'date', 'binary'];
+/**
+ * reqraft's copy of the server's type catalogue (GET /system/qorus-type-info), used until the server answers: the
+ * same types, in the same order, with the same fields. __tests__/qorusTypeCatalogue.test.ts compares it with a
+ * recorded response (__tests__/fixtures/qorusTypeInfo.json), so a copy that drifts from the server fails.
+ */
+exports.defaultQorusTypes = [
+    {
+        name: 'any',
+        display_name: 'Any',
+        sentence_form: 'any value',
+        short_desc: 'Any data type',
+        desc: 'Any data type',
+        types_accepted: ['any'],
+        exact_match: ['any'],
+    },
+    {
+        name: 'context',
+        display_name: 'Context',
+        sentence_form: "a value of the context's type",
+        short_desc: 'The data type is determined by the context value chosen',
+        desc: 'The data type is determined by the context value chosen',
+        types_accepted: ['any'],
+        exact_match: ['any'],
+    },
+    {
+        name: 'string',
+        display_name: 'Text',
+        sentence_form: 'text',
+        short_desc: 'Text',
+        desc: 'Text',
+        types_accepted: ['any'],
+        exact_match: ['string', 'richtext'],
+    },
+    {
+        name: 'richtext',
+        display_name: 'Rich text',
+        sentence_form: 'formatted text',
+        short_desc: 'Text with formatting',
+        desc: 'Text with formatting',
+        types_accepted: ['any'],
+        exact_match: ['string', 'richtext'],
+    },
+    {
+        name: 'int',
+        display_name: 'Whole number',
+        sentence_form: 'a whole number',
+        short_desc: 'A whole number (64-bit)',
+        desc: 'A whole number (64-bit)',
+        types_accepted: ['int', 'float', 'number'],
+        exact_match: ['int', 'float', 'number'],
+    },
+    {
+        name: 'float',
+        display_name: 'Number',
+        sentence_form: 'a number',
+        short_desc: 'A number with a fractional part (double precision)',
+        desc: 'A number with a fractional part (double precision)',
+        types_accepted: ['float', 'int', 'number'],
+        exact_match: ['float', 'int', 'number'],
+    },
+    {
+        name: 'number',
+        display_name: 'Exact number',
+        sentence_form: 'an exact number',
+        short_desc: 'A decimal number kept exactly',
+        desc: 'A decimal number kept exactly',
+        types_accepted: ['number', 'float', 'int'],
+        exact_match: ['number', 'float', 'int'],
+    },
+    {
+        name: 'bool',
+        display_name: 'True or false',
+        sentence_form: 'true or false',
+        short_desc: 'True or false',
+        desc: 'True or false',
+        types_accepted: ['bool'],
+        exact_match: ['bool'],
+    },
+    {
+        name: 'date',
+        display_name: 'Date',
+        sentence_form: 'a date and time',
+        short_desc: 'A date and time',
+        desc: 'A date and time',
+        types_accepted: ['date'],
+        exact_match: ['date'],
+    },
+    {
+        name: 'time',
+        display_name: 'Time',
+        sentence_form: 'a time of day',
+        short_desc: 'A time of day',
+        desc: 'A time of day',
+        types_accepted: ['date'],
+        exact_match: ['date'],
+    },
+    {
+        name: 'binary',
+        display_name: 'Binary data',
+        sentence_form: 'binary data',
+        short_desc: 'Binary data',
+        desc: 'Binary data',
+        types_accepted: ['binary'],
+        exact_match: ['binary'],
+    },
+    {
+        name: 'data',
+        display_name: 'Text or binary data',
+        sentence_form: 'text or binary data',
+        short_desc: 'Text or binary data',
+        desc: 'Text or binary data',
+        types_accepted: ['string', 'richtext', 'binary', 'data'],
+        exact_match: ['string', 'richtext', 'binary', 'data'],
+    },
+    {
+        name: 'hash',
+        display_name: 'Key-value pairs (hash)',
+        sentence_form: 'key-value pairs (a hash)',
+        short_desc: 'Key-value pairs (hash)',
+        desc: 'Key-value pairs (a hash): each value is stored under a named key',
+        types_accepted: ['hash'],
+        exact_match: ['hash'],
+    },
+    {
+        name: 'list',
+        display_name: 'List',
+        sentence_form: 'a list',
+        short_desc: 'List',
+        desc: 'List',
+        types_accepted: ['list'],
+        exact_match: ['list'],
+    },
+    {
+        name: 'rgbcolor',
+        display_name: 'Color',
+        sentence_form: 'a color',
+        short_desc: 'A color: red, green and blue from 0 to 255 and an opacity from 0 to 1',
+        desc: 'A color, stored as a hash: r, g and b are integers from 0 to 255, and a is the opacity, from 0 (transparent) to 1 (opaque); a missing or null a is opaque. A hex code such as #ff0000 is not a stored color.',
+        types_accepted: ['rgbcolor'],
+        exact_match: ['rgbcolor'],
+    },
+    {
+        name: 'workflow',
+        display_name: 'Workflow',
+        sentence_form: 'a workflow',
+        short_desc: 'Qorus workflow',
+        desc: 'Qorus workflow',
+        types_accepted: ['workflow', 'string', 'richtext'],
+        exact_match: ['workflow', 'string', 'richtext'],
+    },
+    {
+        name: 'service',
+        display_name: 'Service',
+        sentence_form: 'a service',
+        short_desc: 'Qorus service',
+        desc: 'Qorus service',
+        types_accepted: ['service', 'string', 'richtext'],
+        exact_match: ['service', 'string', 'richtext'],
+    },
+    {
+        name: 'job',
+        display_name: 'Job',
+        sentence_form: 'a job',
+        short_desc: 'Qorus job',
+        desc: 'Qorus job',
+        types_accepted: ['job', 'string', 'richtext'],
+        exact_match: ['job', 'string', 'richtext'],
+    },
+    {
+        name: 'mapper',
+        display_name: 'Mapper',
+        sentence_form: 'a mapper',
+        short_desc: 'Qorus mapper',
+        desc: 'Qorus mapper',
+        types_accepted: ['mapper', 'string', 'richtext'],
+        exact_match: ['mapper', 'string', 'richtext'],
+    },
+    {
+        name: 'data-provider',
+        display_name: 'Data provider',
+        sentence_form: 'a data provider',
+        short_desc: 'Qorus data provider',
+        desc: 'Qorus data provider',
+        types_accepted: ['data-provider'],
+        exact_match: ['data-provider'],
+    },
+    {
+        name: 'connection',
+        display_name: 'Connection',
+        sentence_form: 'a connection',
+        short_desc: 'Qorus connection',
+        desc: 'Qorus connection',
+        types_accepted: ['connection', 'string', 'richtext'],
+        exact_match: ['connection', 'string', 'richtext'],
+    },
+];
+var getQorusTypes = function () { return exports.defaultQorusTypes; };
+exports.getQorusTypes = getQorusTypes;
+/** Qore's other names for a type the catalogue lists under its own (qorus#646). */
+var QORE_TYPE_ALIASES = { boolean: 'bool', integer: 'int' };
+/**
+ * A type's name as the catalogue lists it: Qore's other name for a type (`integer`, `boolean`) is the type it names
+ * (`int`, `bool`). The server's catalogue knows each type by one name only, and says which it converts by that name.
+ */
+var catalogueTypeName = function (typeName) { var _a; return (_a = QORE_TYPE_ALIASES[typeName]) !== null && _a !== void 0 ? _a : typeName; };
+exports.catalogueTypeName = catalogueTypeName;
+/**
+ * The catalogue's entry for a type (the server's catalogue, or reqraft's copy until it answers).
+ *
+ * The catalogue lists each type once, by its own name, and the catalogue's own entry for a name always wins. A type
+ * named another way is the type it is, as the server names it (qorus c6b3fb97c): `boolean` and `integer` are `bool`
+ * and `int`; an optional type (`*string`) and a soft one (`softint`, a declaration that converts a value to its base
+ * type) are their base type; a complex one (`hash<auto>`, `list<string>`) is its kind. Undefined for a type the
+ * catalogue lists under no name.
+ */
+var qorusTypeEntry = function (types, typeName) {
+    var _a, _b, _c, _d, _e, _f;
+    // a place with no type yet is named by nothing
+    if (!typeName) {
+        return undefined;
+    }
+    var listed = function (name) { return types === null || types === void 0 ? void 0 : types.find(function (type) { return type.name === name; }); };
+    var base = typeName.replace(/^\*/, '').replace(/<.*$/, '');
+    var unsoft = /^soft[a-z]/.test(base) ? base.slice(4) : base;
+    return ((_e = (_d = (_b = (_a = listed(typeName)) !== null && _a !== void 0 ? _a : listed(base)) !== null && _b !== void 0 ? _b : listed((_c = QORE_TYPE_ALIASES[base]) !== null && _c !== void 0 ? _c : '')) !== null && _d !== void 0 ? _d : listed(unsoft)) !== null && _e !== void 0 ? _e : listed((_f = QORE_TYPE_ALIASES[unsoft]) !== null && _f !== void 0 ? _f : ''));
+};
+/**
+ * What a type is called as a label ("Whole number"), by the type catalogue; a type it lists under no name keeps its
+ * name. See `qorusTypeEntry` for the names a type goes by.
+ *
+ * No type (`undefined` or an empty name: a place whose type is not known yet) has no name: `undefined`, and the
+ * caller draws or words its text without one (qorus#646).
+ */
+var qorusTypeDisplayName = function (types, typeName) { var _a, _b; return typeName ? ((_b = (_a = qorusTypeEntry(types, typeName)) === null || _a === void 0 ? void 0 : _a.display_name) !== null && _b !== void 0 ? _b : typeName) : undefined; };
+exports.qorusTypeDisplayName = qorusTypeDisplayName;
+/**
+ * What a type is called inside a sentence ("a whole number": "The expression gives a whole number"), by the type
+ * catalogue - its sentence form, which the server gives in the language it is asked for (qorus#646, c6b3fb97c).
+ *
+ * A catalogue with no sentence form for it (a server before c6b3fb97c) gives a wording that needs no article -
+ * "a value of type Whole number" - with its display name, or the type's own name where the catalogue lists it under
+ * none. An English article is never built from a display name: "a Exact number", "a Whole number" in a sentence
+ * of another language.
+ *
+ * No type (`undefined` or an empty name) has no sentence form: `undefined`, and the caller words its sentence
+ * without a type ("This expression gives nothing", "Converted to a whole number") rather than "a value of type
+ * undefined" (qorus#646).
+ */
+var qorusTypeSentenceForm = function (types, typeName) {
+    var _a;
+    if (!typeName) {
+        return undefined;
+    }
+    var entry = qorusTypeEntry(types, typeName);
+    return (entry === null || entry === void 0 ? void 0 : entry.sentence_form) || "a value of type ".concat((_a = entry === null || entry === void 0 ? void 0 : entry.display_name) !== null && _a !== void 0 ? _a : typeName);
+};
+exports.qorusTypeSentenceForm = qorusTypeSentenceForm;
+//# sourceMappingURL=qorusTypeCatalogue.js.map

package/dist/helpers/qorusTypeCatalogue.js.map

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

package/dist/helpers/readableColors.d.ts

@@ -0,0 +1,36 @@
+import { IReqoreTheme } from '@qoretechnologies/reqore/dist/constants/theme';
+/**
+ * Colors that stand out from what they are drawn on (WCAG 2.1 AA, qorus#646): 4.5:1 for text, 3:1 for icons and
+ * large text. Reqore has these from qoretechnologies/reqore#708 on (`getReadableAccentColorOn`, `getReadableAlpha`);
+ * until reqraft builds on that release, the read-first form picks its own colors with these.
+ */
+export declare const READABLE_TEXT = 4.5;
+export declare const READABLE_ICON = 3;
+export declare const READABLE_MARGIN = 0.1;
+/** The WCAG contrast ratio of two opaque colors, unrounded (polished's getContrast rounds 4.495 up to 4.5). */
+export declare const contrastRatio: (a: string, b: string) => number;
+/**
+ * `color` in the shade of it that stands out by `minContrast` from every one of `backgrounds` (opaque): the color
+ * itself when it does, else moved toward white or black - whichever stands out more from the worst of them - only
+ * as far as it takes. The hue is kept: a warning stays amber, only lighter on a dark surface. `alpha` is how faded
+ * it is drawn: a mark that something else draws at 70% (reqore's panel and button icons) needs a stronger shade.
+ */
+export declare const getReadableShade: (color: string, backgrounds: string[], minContrast?: number, alpha?: number) => string;
+/**
+ * How faded `color` can be drawn on every one of `backgrounds` (opaque) and still stand out by `minContrast`:
+ * `alpha`, or as little more as it takes (1 when even that does not).
+ */
+export declare const getReadableOpacity: (color: string, backgrounds: string[], alpha: number, minContrast?: number) => number;
+/** A translucent `color` (rgba) at `alpha` that still stands out from `backgrounds` (see `getReadableOpacity`). */
+export declare const getReadableFaded: (color: string, backgrounds: string[], alpha: number, minContrast?: number) => string;
+/**
+ * What reqraft's components are drawn on in `theme`: its background, and a shade darker and lighter, as the page
+ * or a panel around them may be.
+ */
+export declare const getThemeSurfaces: (theme: IReqoreTheme) => string[];
+/**
+ * How faded the theme's text can be drawn (`opacity`, a softer note) and still read on what it is drawn on in
+ * the theme (`getThemeSurfaces`): `opacity`, or as little more as it takes. An icon needs 3:1 (`READABLE_ICON`).
+ */
+export declare const getReadableTextOpacity: (theme: IReqoreTheme, opacity: number, minContrast?: number) => number;
+//# sourceMappingURL=readableColors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readableColors.d.ts","sourceRoot":"","sources":["../../src/helpers/readableColors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAS7E;;;;GAIG;AACH,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,aAAa,IAAI,CAAC;AAI/B,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,+GAA+G;AAC/G,eAAO,MAAM,aAAa,MAAO,MAAM,KAAK,MAAM,KAAG,MAIpD,CAAC;AAYF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,UACpB,MAAM,eACA,MAAM,EAAE,gBACR,MAAM,UACZ,MAAM,KACZ,MA0BF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,UACtB,MAAM,eACA,MAAM,EAAE,SACd,MAAM,gBACA,MAAM,KAClB,MA6BF,CAAC;AAEF,mHAAmH;AACnH,eAAO,MAAM,gBAAgB,UACpB,MAAM,eACA,MAAM,EAAE,SACd,MAAM,gBACA,MAAM,KAClB,MAAiF,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,UAAW,YAAY,KAAG,MAAM,EAI5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,UAC1B,YAAY,WACV,MAAM,gBACF,MAAM,KAClB,MACyF,CAAC"}

package/dist/helpers/readableColors.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getReadableTextOpacity = exports.getThemeSurfaces = exports.getReadableFaded = exports.getReadableOpacity = exports.getReadableShade = exports.contrastRatio = exports.READABLE_MARGIN = exports.READABLE_ICON = exports.READABLE_TEXT = void 0;
+var colors_1 = require("@qoretechnologies/reqore/dist/helpers/colors");
+var polished_1 = require("polished");
+/**
+ * Colors that stand out from what they are drawn on (WCAG 2.1 AA, qorus#646): 4.5:1 for text, 3:1 for icons and
+ * large text. Reqore has these from qoretechnologies/reqore#708 on (`getReadableAccentColorOn`, `getReadableAlpha`);
+ * until reqraft builds on that release, the read-first form picks its own colors with these.
+ */
+exports.READABLE_TEXT = 4.5;
+exports.READABLE_ICON = 3;
+/* A browser blends a color a shade differently (alphas in 255ths, its own rounding): a color that just reaches the
+   ratio here can fall a hair short on the page, so these aim a little past it. */
+exports.READABLE_MARGIN = 0.1;
+/** The WCAG contrast ratio of two opaque colors, unrounded (polished's getContrast rounds 4.495 up to 4.5). */
+var contrastRatio = function (a, b) {
+    var _a = [(0, polished_1.getLuminance)(a), (0, polished_1.getLuminance)(b)].sort(function (x, y) { return y - x; }), light = _a[0], dark = _a[1];
+    return (light + 0.05) / (dark + 0.05);
+};
+exports.contrastRatio = contrastRatio;
+/** `color` at `alpha` drawn over the opaque `background`. */
+var drawnAt = function (color, alpha, background) {
+    return (0, polished_1.mix)(alpha, color, background);
+};
+/* how `color` stands out from the least contrasting of `backgrounds`, drawn on each at `alpha` */
+var worst = function (color, backgrounds, alpha) {
+    if (alpha === void 0) { alpha = 1; }
+    return Math.min.apply(Math, backgrounds.map(function (background) { return (0, exports.contrastRatio)(drawnAt(color, alpha, background), background); }));
+};
+/**
+ * `color` in the shade of it that stands out by `minContrast` from every one of `backgrounds` (opaque): the color
+ * itself when it does, else moved toward white or black - whichever stands out more from the worst of them - only
+ * as far as it takes. The hue is kept: a warning stays amber, only lighter on a dark surface. `alpha` is how faded
+ * it is drawn: a mark that something else draws at 70% (reqore's panel and button icons) needs a stronger shade.
+ */
+var getReadableShade = function (color, backgrounds, minContrast, alpha) {
+    if (minContrast === void 0) { minContrast = exports.READABLE_TEXT; }
+    if (alpha === void 0) { alpha = 1; }
+    var target = minContrast + exports.READABLE_MARGIN;
+    if (worst(color, backgrounds, alpha) >= target) {
+        return color;
+    }
+    var toward = worst('#ffffff', backgrounds, alpha) >= worst('#000000', backgrounds, alpha) ?
+        '#ffffff'
+        : '#000000';
+    // the least of `toward` mixed in that reaches the ratio: halve the range until it is a hundredth wide
+    var low = 0;
+    var high = 1;
+    while (high - low > 0.01) {
+        var middle = (low + high) / 2;
+        if (worst((0, polished_1.mix)(middle, toward, color), backgrounds, alpha) >= target) {
+            high = middle;
+        }
+        else {
+            low = middle;
+        }
+    }
+    return (0, polished_1.mix)(high, toward, color);
+};
+exports.getReadableShade = getReadableShade;
+/**
+ * How faded `color` can be drawn on every one of `backgrounds` (opaque) and still stand out by `minContrast`:
+ * `alpha`, or as little more as it takes (1 when even that does not).
+ */
+var getReadableOpacity = function (color, backgrounds, alpha, minContrast) {
+    if (minContrast === void 0) { minContrast = exports.READABLE_TEXT; }
+    var target = minContrast + exports.READABLE_MARGIN;
+    var reads = function (at) {
+        return backgrounds.every(function (background) { return (0, exports.contrastRatio)(drawnAt(color, at, background), background) >= target; });
+    };
+    if (alpha >= 1 || reads(alpha)) {
+        return alpha;
+    }
+    if (!reads(1)) {
+        return 1;
+    }
+    var low = alpha;
+    var high = 1;
+    while (high - low > 0.005) {
+        var middle = (low + high) / 2;
+        if (reads(middle)) {
+            high = middle;
+        }
+        else {
+            low = middle;
+        }
+    }
+    return Math.min(1, Math.ceil(high * 100) / 100);
+};
+exports.getReadableOpacity = getReadableOpacity;
+/** A translucent `color` (rgba) at `alpha` that still stands out from `backgrounds` (see `getReadableOpacity`). */
+var getReadableFaded = function (color, backgrounds, alpha, minContrast) {
+    if (minContrast === void 0) { minContrast = exports.READABLE_TEXT; }
+    return (0, polished_1.rgba)(color, (0, exports.getReadableOpacity)(color, backgrounds, alpha, minContrast));
+};
+exports.getReadableFaded = getReadableFaded;
+/**
+ * What reqraft's components are drawn on in `theme`: its background, and a shade darker and lighter, as the page
+ * or a panel around them may be.
+ */
+var getThemeSurfaces = function (theme) {
+    var page = (0, colors_1.getMainBackgroundColor)(theme);
+    return [(0, colors_1.changeDarkness)(page, 0.05), page, (0, colors_1.changeLightness)(page, 0.05)];
+};
+exports.getThemeSurfaces = getThemeSurfaces;
+/**
+ * How faded the theme's text can be drawn (`opacity`, a softer note) and still read on what it is drawn on in
+ * the theme (`getThemeSurfaces`): `opacity`, or as little more as it takes. An icon needs 3:1 (`READABLE_ICON`).
+ */
+var getReadableTextOpacity = function (theme, opacity, minContrast) {
+    if (minContrast === void 0) { minContrast = exports.READABLE_TEXT; }
+    return (0, exports.getReadableOpacity)((0, colors_1.getReadableColor)(theme), (0, exports.getThemeSurfaces)(theme), opacity, minContrast);
+};
+exports.getReadableTextOpacity = getReadableTextOpacity;
+//# sourceMappingURL=readableColors.js.map

package/dist/helpers/readableColors.js.map

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

package/dist/helpers/recordFieldReference.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The record field reference at the start of `text` - `@pos`, `@"create.order-id"`, `@orders[*].id` - read as the
+ * template the server gives it (`$record:{create.order-id}`, `$record:{orders[*].id}`) and the length it takes, or
+ * undefined where there is none.
+ */
+export declare const readRecordReference: (text: string) => {
+    template: string;
+    length: number;
+} | undefined;
+/**
+ * The `$record:{…}` template a field reference stands for, when `reference` is exactly one field reference
+ * (`@orders[*].id` is `$record:{orders[*].id}`), or undefined.
+ */
+export declare const recordTemplateOfReference: (reference: string) => string | undefined;
+//# sourceMappingURL=recordFieldReference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recordFieldReference.d.ts","sourceRoot":"","sources":["../../src/helpers/recordFieldReference.ts"],"names":[],"mappings":"AA2BA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,SACxB,MAAM,KACX;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SA0CzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,cAAe,MAAM,KAAG,MAAM,GAAG,SAGtE,CAAC"}

package/dist/helpers/recordFieldReference.js

@@ -0,0 +1,89 @@
+"use strict";
+// Copyright 2026 Qore Technologies, s.r.o.
+// A record field reference in DPQL text - `@pos`, `@"create.order-id"`, `@orders[*].id` - read as the `$record:{…}`
+// template it stands for (qorus#646). Qorus reads `$record:{<path>}` as a test path (`QorusRecordPath`), and its DPQL
+// serializer writes the same path after `@` (qore#5480: dots separate the parts of a name, quoted or bare, and a dot
+// that is part of a key is `\.`). A field written in DPQL and the template a value holds are one record field, so they
+// are drawn as one chip; and the stories' stand-in for the server reads the reference back to the template with this.
+// Pure: no React, no transport.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordTemplateOfReference = exports.readRecordReference = void 0;
+/**
+ * The text in the braces of a template that decodes to `path`, as the Qorus IDE writes it (`recordTemplateOf`):
+ * every backslash and every brace is escaped, except the hash wildcard `{*}`. `Unit.Price` under `create` (the path
+ * `create.Unit\.Price`) is `$record:{create.Unit\\.Price}`.
+ */
+var recordTemplateText = function (path) {
+    return path.replace(/\{\*\}|[\\{}]/g, function (found) { return (found === '{*}' ? found : "\\".concat(found)); });
+};
+/** A key of a test path: a dot, a bracket, a brace or a backslash in it is escaped. */
+var testPathKey = function (key) { return key.replace(/[.[{\\]/g, function (ch) { return "\\".concat(ch); }); };
+/** The accessors a field reference may be followed by, as `dpql/parse` reads them. */
+var ACCESSOR = /^(?:\[\*\]|\[\d+\]|\{\*\}|\.[\p{L}_](?:[\p{L}\p{M}\p{N}_]|-[a-zA-Z])*|\{"(?:\\.|[^"\\])*"\}|\{[A-Za-z_]\w*\})/u;
+/** A field reference, bare or quoted, at the start of a text. */
+var FIELD_REFERENCE = /^@(?:"((?:\\.|[^"\\])*)"|([\p{L}_][\p{L}\p{M}\p{N}_]*(?:\.[\p{L}\p{M}\p{N}_]+)*))/u;
+/**
+ * The record field reference at the start of `text` - `@pos`, `@"create.order-id"`, `@orders[*].id` - read as the
+ * template the server gives it (`$record:{create.order-id}`, `$record:{orders[*].id}`) and the length it takes, or
+ * undefined where there is none.
+ */
+var readRecordReference = function (text) {
+    var match = FIELD_REFERENCE.exec(text);
+    if (!match)
+        return undefined;
+    var path;
+    if (match[1] !== undefined) {
+        // a quoted name: dots separate its parts, `\.` is a dot of a key, `\"` and `\\` are a quote and a backslash
+        var keys = [];
+        var key = '';
+        var quoted = match[1];
+        for (var i = 0; i < quoted.length; ++i) {
+            var ch = quoted[i];
+            if (ch === '\\' && i + 1 < quoted.length) {
+                key += quoted[++i];
+            }
+            else if (ch === '.') {
+                keys.push(key);
+                key = '';
+            }
+            else
+                key += ch;
+        }
+        keys.push(key);
+        path = keys.map(testPathKey).join('.');
+    }
+    else {
+        path = match[2];
+    }
+    var length = match[0].length;
+    for (var rest = text.slice(length), accessor = ACCESSOR.exec(rest); accessor;) {
+        var written = accessor[0];
+        if (written.startsWith('[') || written === '{*}') {
+            path += written;
+        }
+        else if (written.startsWith('.')) {
+            path += written;
+        }
+        else {
+            var key = written.startsWith('{"') ?
+                JSON.parse(written.slice(1, -1))
+                : written.slice(1, -1);
+            path += ".".concat(testPathKey(key));
+        }
+        length += written.length;
+        rest = text.slice(length);
+        accessor = ACCESSOR.exec(rest);
+    }
+    return { template: "$record:{".concat(recordTemplateText(path), "}"), length: length };
+};
+exports.readRecordReference = readRecordReference;
+/**
+ * The `$record:{…}` template a field reference stands for, when `reference` is exactly one field reference
+ * (`@orders[*].id` is `$record:{orders[*].id}`), or undefined.
+ */
+var recordTemplateOfReference = function (reference) {
+    var read = (0, exports.readRecordReference)(reference);
+    return read && read.length === reference.length ? read.template : undefined;
+};
+exports.recordTemplateOfReference = recordTemplateOfReference;
+//# sourceMappingURL=recordFieldReference.js.map

package/dist/helpers/recordFieldReference.js.map

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

package/dist/helpers/templateItems.d.ts

@@ -40,8 +40,8 @@ export declare const templateItemsToShow: <T>(items: T[] | undefined) => T[] | u
  * description into a `ReqoreTextEffect` and styled-components filters the prop
  * off the DOM.
  *
- * Without a host renderer the items are returned untouched, so a host that has
- * no markdown keeps exactly what it had.
+ * Without a host renderer a description reads as the prose its markdown renders
+ * to (`markdownToProse`): the words, none of the marks, on the row's one line.
  */
 export declare const renderTemplateItemDescriptions: <T>(items: T[] | undefined, render: TMarkdownRenderer | undefined) => T[] | undefined;
 //# sourceMappingURL=templateItems.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"templateItems.d.ts","sourceRoot":"","sources":["../../src/helpers/templateItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAE3F;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,aAAe,CAAC,EAAE,GAAG,SAAS,KAAG,CAAC,EAAE,GAAG,SAMtE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,8BAA8B,aAClC,CAAC,EAAE,GAAG,SAAS,UACd,iBAAiB,GAAG,SAAS,KACpC,CAAC,EAAE,GAAG,SAwBR,CAAC"}
+{"version":3,"file":"templateItems.d.ts","sourceRoot":"","sources":["../../src/helpers/templateItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAG3F;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,aAAe,CAAC,EAAE,GAAG,SAAS,KAAG,CAAC,EAAE,GAAG,SAMtE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,8BAA8B,aAClC,CAAC,EAAE,GAAG,SAAS,UACd,iBAAiB,GAAG,SAAS,KACpC,CAAC,EAAE,GAAG,SAyBR,CAAC"}

package/dist/helpers/templateItems.js

@@ -12,6 +12,7 @@ var __assign = (this && this.__assign) || function () {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderTemplateItemDescriptions = exports.templateItemsToShow = void 0;
+var markdownText_1 = require("./markdownText");
 /**
  * What a template picker should actually list.
  *
@@ -60,11 +61,11 @@ exports.templateItemsToShow = templateItemsToShow;
  * description into a `ReqoreTextEffect` and styled-components filters the prop
  * off the DOM.
  *
- * Without a host renderer the items are returned untouched, so a host that has
- * no markdown keeps exactly what it had.
+ * Without a host renderer a description reads as the prose its markdown renders
+ * to (`markdownToProse`): the words, none of the marks, on the row's one line.
  */
 var renderTemplateItemDescriptions = function (items, render) {
-    if (!render || !(items === null || items === void 0 ? void 0 : items.length)) {
+    if (!(items === null || items === void 0 ? void 0 : items.length)) {
         return items;
     }
     return items.map(function (item) {
@@ -74,7 +75,8 @@ var renderTemplateItemDescriptions = function (items, render) {
             /* `compact`, for the reason the context gives: a row is a constrained
                container, and markdown authored as a document opens with a heading
                that would outgrow the label above it. */
-            next.description = render({ value: entry.description, compact: true });
+            next.description =
+                render ? render({ value: entry.description, compact: true }) : (0, markdownText_1.markdownToProse)(entry.description);
         }
         // Only when the item HAS children — writing the key unconditionally would
         // give every leaf an `items` a picker could read as an empty submenu.

package/dist/helpers/templateItems.js.map

@@ -1 +1 @@
-{"version":3,"file":"templateItems.js","sourceRoot":"","sources":["../../src/helpers/templateItems.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAEA;;;;;;;;;;;;;;;;;GAiBG;AACI,IAAM,mBAAmB,GAAG,UAAK,KAAsB;IAC5D,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,MAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAA0B,CAAC;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,IAAI,CAAC,KAAa,CAAC,CAAC,CAAC,KAAK,CAAC;AACtF,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,IAAM,8BAA8B,GAAG,UAC5C,KAAsB,EACtB,MAAqC;IAErC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,CAAA,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,UAAC,IAAI;QACpB,IAAM,KAAK,GAAG,IAAkD,CAAC;QACjE,IAAM,IAAI,GAAG,aAAK,KAAK,CAA6B,CAAC;QAErD,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YACtE;;wDAE4C;YAC5C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,0EAA0E;QAC1E,sEAAsE;QACtE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,GAAG,IAAA,sCAA8B,EAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AA3BW,QAAA,8BAA8B,kCA2BzC"}
+{"version":3,"file":"templateItems.js","sourceRoot":"","sources":["../../src/helpers/templateItems.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AACA,+CAAiD;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACI,IAAM,mBAAmB,GAAG,UAAK,KAAsB;IAC5D,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,MAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAA0B,CAAC;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,IAAI,CAAC,KAAa,CAAC,CAAC,CAAC,KAAK,CAAC;AACtF,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,IAAM,8BAA8B,GAAG,UAC5C,KAAsB,EACtB,MAAqC;IAErC,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,CAAA,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,UAAC,IAAI;QACpB,IAAM,KAAK,GAAG,IAAkD,CAAC;QACjE,IAAM,IAAI,GAAG,aAAK,KAAK,CAA6B,CAAC;QAErD,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YACtE;;wDAE4C;YAC5C,IAAI,CAAC,WAAW;gBACd,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAA,8BAAe,EAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtG,CAAC;QAED,0EAA0E;QAC1E,sEAAsE;QACtE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,GAAG,IAAA,sCAA8B,EAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AA5BW,QAAA,8BAA8B,kCA4BzC"}

package/dist/helpers/templateText.js

@@ -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
@@ -152,7 +152,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), 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) {