@qoretechnologies/reqraft 0.10.65 → 0.10.66-pr.137.ga1983bf

package/dist/components/form/fields/template/referenceNames.d.ts

@@ -0,0 +1,63 @@
+/// <reference types="react" />
+import { IReqoreFormTemplates } from '@qoretechnologies/reqore/dist/components/Textarea';
+/**
+ * SEAM (reqraft): what a host knows of the references its values mention beyond its catalogue of templates.
+ *
+ * A chip names a reference from the catalogue. One the catalogue does not list drew its raw spelling
+ * (`$._case.attempt`) as if it were a name, in the same style as a named one, so nothing said it was not a value on
+ * offer (qorus#646, David: "the chips / templates / etc were meant to abstract the technical format from our
+ * users"). It now says so, and a host can name the ones it knows.
+ */
+export interface ITemplateReferenceNames {
+    /** A name for a reference the host knows but does not list (the IDE: a value every case has). */
+    label?: (reference: string) => string | undefined;
+    /**
+     * What a reference the host knows but does not list is: its hover's description. A host that names a reference
+     * and says nothing of it leaves its hover saying there is no description (`noDescription`).
+     */
+    describe?: (reference: string) => string | undefined;
+    /** Why a reference's hover has no description, in the host's words; "No description was given for this value." */
+    noDescription?: string;
+    /** What the chip of a reference nothing names says on hover (the IDE: "Not a value this case captures"). */
+    unlistedHint?: string;
+}
+/** What a reference's hover says of it beyond the catalogue: the host's name, description and reason for none. */
+export declare const hostSaysOf: (reference: string, names: ITemplateReferenceNames) => {
+    label: string;
+    description: string;
+    noDescription: string;
+};
+/** What the chip of a reference nothing names says on hover, where the host says nothing of its own. */
+export declare const DEFAULT_UNLISTED_REFERENCE_HINT = "Not one of the values offered here";
+/** The host's names for references, for every chip under it: the read row's and the editor's alike. */
+export declare const TemplateReferenceNamesProvider: import("react").Provider<ITemplateReferenceNames>;
+/** The class of a chip whose reference nothing names. */
+export declare const UNLISTED_REFERENCE_CLASS = "reqraft-reference-unlisted";
+/** How a reference's chip draws, beside what the catalogue says of it. */
+export interface IReferenceStanding {
+    /** The host's name for it, where the catalogue has none. */
+    label?: string;
+    /** Nothing names it: the catalogue does not list it and the host does not know it. */
+    unlisted: boolean;
+}
+/**
+ * The context a reference is in: `$record:` for `$record:{orders[*].id}`, `$._case` for `$._case.attempt` (a host's
+ * own grammar, its root).
+ */
+export declare const referenceContext: (reference: string) => string;
+/**
+ * Whether anything names a reference: the catalogue, else the host. A reference is said to be unlisted only against
+ * a catalogue that speaks for its context - one that lists something in it (`$._case.mode` for `$._case.attempt`):
+ * a catalogue of templates says nothing of a record's fields (`$record:`, the record's own), nor of a context it
+ * lists nothing in, and one with nothing in it (not loaded yet, or a field that offers none) tells nothing apart.
+ */
+export declare const referenceStanding: (templates: IReqoreFormTemplates | undefined, reference: string, names?: ITemplateReferenceNames) => IReferenceStanding;
+/** The chip props a reference nothing names draws with: a warning, and the host's hint on hover. */
+export declare const unlistedReferenceChipProps: (names: ITemplateReferenceNames) => {
+    intent: "warning";
+    tooltip: string;
+    className: string;
+};
+/** The host's names for references, as the nearest provider gives them. */
+export declare const useTemplateReferenceNames: () => ITemplateReferenceNames;
+//# sourceMappingURL=referenceNames.d.ts.map

package/dist/components/form/fields/template/referenceNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceNames.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/template/referenceNames.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAMzF;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,iGAAiG;IACjG,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,kHAAkH;IAClH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,kHAAkH;AAClH,eAAO,MAAM,UAAU,cAAe,MAAM,SAAS,uBAAuB;;;;CAI1E,CAAC;AAEH,wGAAwG;AACxG,eAAO,MAAM,+BAA+B,uCAAuC,CAAC;AAIpF,uGAAuG;AACvG,eAAO,MAAM,8BAA8B,mDAAyC,CAAC;AAErF,yDAAyD;AACzD,eAAO,MAAM,wBAAwB,+BAA+B,CAAC;AAErE,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,cAAe,MAAM,KAAG,MACmC,CAAC;AAEzF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,cACjB,oBAAoB,GAAG,SAAS,aAChC,MAAM,UACV,uBAAuB,KAC7B,kBAgBF,CAAC;AAEF,oGAAoG;AACpG,eAAO,MAAM,0BAA0B,UAAW,uBAAuB;;;;CAIvE,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,QAAO,uBACF,CAAC"}

package/dist/components/form/fields/template/referenceNames.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTemplateReferenceNames = exports.unlistedReferenceChipProps = exports.referenceStanding = exports.referenceContext = exports.UNLISTED_REFERENCE_CLASS = exports.TemplateReferenceNamesProvider = exports.DEFAULT_UNLISTED_REFERENCE_HINT = exports.hostSaysOf = void 0;
+var lodash_1 = require("lodash");
+var react_1 = require("react");
+var templateText_1 = require("../../../../helpers/templateText");
+var templates_1 = require("../../../../helpers/templates");
+/** What a reference's hover says of it beyond the catalogue: the host's name, description and reason for none. */
+var hostSaysOf = function (reference, names) {
+    var _a, _b;
+    return ({
+        label: (_a = names.label) === null || _a === void 0 ? void 0 : _a.call(names, reference),
+        description: (_b = names.describe) === null || _b === void 0 ? void 0 : _b.call(names, reference),
+        noDescription: names.noDescription,
+    });
+};
+exports.hostSaysOf = hostSaysOf;
+/** What the chip of a reference nothing names says on hover, where the host says nothing of its own. */
+exports.DEFAULT_UNLISTED_REFERENCE_HINT = 'Not one of the values offered here';
+var TemplateReferenceNamesContext = (0, react_1.createContext)({});
+/** The host's names for references, for every chip under it: the read row's and the editor's alike. */
+exports.TemplateReferenceNamesProvider = TemplateReferenceNamesContext.Provider;
+/** The class of a chip whose reference nothing names. */
+exports.UNLISTED_REFERENCE_CLASS = 'reqraft-reference-unlisted';
+/**
+ * The context a reference is in: `$record:` for `$record:{orders[*].id}`, `$._case` for `$._case.attempt` (a host's
+ * own grammar, its root).
+ */
+var referenceContext = function (reference) { var _a, _b, _c, _d; return (_d = (_b = (_a = /^\$[\w-]*:/.exec(reference)) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : (_c = /^\$\.?[^.[{]+/.exec(reference)) === null || _c === void 0 ? void 0 : _c[0]) !== null && _d !== void 0 ? _d : reference; };
+exports.referenceContext = referenceContext;
+/**
+ * Whether anything names a reference: the catalogue, else the host. A reference is said to be unlisted only against
+ * a catalogue that speaks for its context - one that lists something in it (`$._case.mode` for `$._case.attempt`):
+ * a catalogue of templates says nothing of a record's fields (`$record:`, the record's own), nor of a context it
+ * lists nothing in, and one with nothing in it (not loaded yet, or a field that offers none) tells nothing apart.
+ */
+var referenceStanding = function (templates, reference, names) {
+    var _a;
+    if (names === void 0) { names = {}; }
+    if ((0, templates_1.describeTemplateReference)(templates, reference).item) {
+        return { unlisted: false };
+    }
+    var label = (_a = names.label) === null || _a === void 0 ? void 0 : _a.call(names, reference);
+    if (typeof label === 'string' && label) {
+        return { label: label, unlisted: false };
+    }
+    if (!(0, lodash_1.size)(templates === null || templates === void 0 ? void 0 : templates.items)) {
+        return { unlisted: false };
+    }
+    // (a walk into a listed value is that value's: `describeTemplateReference` names it)
+    var context = (0, exports.referenceContext)(reference);
+    return {
+        unlisted: (0, templateText_1.catalogueValues)(templates).some(function (value) { return (0, exports.referenceContext)(value) === context; }),
+    };
+};
+exports.referenceStanding = referenceStanding;
+/** The chip props a reference nothing names draws with: a warning, and the host's hint on hover. */
+var unlistedReferenceChipProps = function (names) { return ({
+    intent: 'warning',
+    tooltip: names.unlistedHint || exports.DEFAULT_UNLISTED_REFERENCE_HINT,
+    className: exports.UNLISTED_REFERENCE_CLASS,
+}); };
+exports.unlistedReferenceChipProps = unlistedReferenceChipProps;
+/** The host's names for references, as the nearest provider gives them. */
+var useTemplateReferenceNames = function () {
+    return (0, react_1.useContext)(TemplateReferenceNamesContext);
+};
+exports.useTemplateReferenceNames = useTemplateReferenceNames;
+//# sourceMappingURL=referenceNames.js.map

package/dist/components/form/fields/template/referenceNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceNames.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/template/referenceNames.tsx"],"names":[],"mappings":";;;AAEA,iCAA8B;AAC9B,+BAAkD;AAClD,iEAAmE;AACnE,2DAA0E;AAwB1E,kHAAkH;AAC3G,IAAM,UAAU,GAAG,UAAC,SAAiB,EAAE,KAA8B;;IAAK,OAAA,CAAC;QAChF,KAAK,EAAE,MAAA,KAAK,CAAC,KAAK,sDAAG,SAAS,CAAC;QAC/B,WAAW,EAAE,MAAA,KAAK,CAAC,QAAQ,sDAAG,SAAS,CAAC;QACxC,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC,CAAA;CAAA,CAAC;AAJU,QAAA,UAAU,cAIpB;AAEH,wGAAwG;AAC3F,QAAA,+BAA+B,GAAG,oCAAoC,CAAC;AAEpF,IAAM,6BAA6B,GAAG,IAAA,qBAAa,EAA0B,EAAE,CAAC,CAAC;AAEjF,uGAAuG;AAC1F,QAAA,8BAA8B,GAAG,6BAA6B,CAAC,QAAQ,CAAC;AAErF,yDAAyD;AAC5C,QAAA,wBAAwB,GAAG,4BAA4B,CAAC;AAUrE;;;GAGG;AACI,IAAM,gBAAgB,GAAG,UAAC,SAAiB,wBAChD,OAAA,MAAA,MAAA,MAAA,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,0CAAG,CAAC,CAAC,mCAAI,MAAA,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,0CAAG,CAAC,CAAC,mCAAI,SAAS,CAAA,EAAA,CAAC;AAD5E,QAAA,gBAAgB,oBAC4D;AAEzF;;;;;GAKG;AACI,IAAM,iBAAiB,GAAG,UAC/B,SAA2C,EAC3C,SAAiB,EACjB,KAAmC;;IAAnC,sBAAA,EAAA,UAAmC;IAEnC,IAAI,IAAA,qCAAyB,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,IAAM,KAAK,GAAG,MAAA,KAAK,CAAC,KAAK,sDAAG,SAAS,CAAC,CAAC;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC;QACvC,OAAO,EAAE,KAAK,OAAA,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,IAAA,aAAI,EAAC,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,qFAAqF;IACrF,IAAM,OAAO,GAAG,IAAA,wBAAgB,EAAC,SAAS,CAAC,CAAC;IAC5C,OAAO;QACL,QAAQ,EAAE,IAAA,8BAAe,EAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAC,KAAK,IAAK,OAAA,IAAA,wBAAgB,EAAC,KAAK,CAAC,KAAK,OAAO,EAAnC,CAAmC,CAAC;KAC1F,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,iBAAiB,qBAoB5B;AAEF,oGAAoG;AAC7F,IAAM,0BAA0B,GAAG,UAAC,KAA8B,IAAK,OAAA,CAAC;IAC7E,MAAM,EAAE,SAAkB;IAC1B,OAAO,EAAE,KAAK,CAAC,YAAY,IAAI,uCAA+B;IAC9D,SAAS,EAAE,gCAAwB;CACpC,CAAC,EAJ4E,CAI5E,CAAC;AAJU,QAAA,0BAA0B,8BAIpC;AAEH,2EAA2E;AACpE,IAAM,yBAAyB,GAAG;IACvC,OAAA,IAAA,kBAAU,EAAC,6BAA6B,CAAC;AAAzC,CAAyC,CAAC;AAD/B,QAAA,yBAAyB,6BACM"}

package/dist/components/form/fields/template/writtenAsText.d.ts

@@ -0,0 +1,61 @@
+import { IReqoreFormTemplates } from '@qoretechnologies/reqore/dist/components/Textarea';
+/** Whether a field of this type is written in the template editor: text, untyped, or a textable scalar. */
+export declare const isWrittenAsText: (type?: string) => boolean;
+/**
+ * Whether a form option of this type is written as text on its Value tab - a text field taking templates as
+ * chips and detecting expressions - rather than on its own control (qorus#646, David): text, untyped values,
+ * whole numbers and numbers. A yes / no, a date and fixed choices keep their own control.
+ */
+export declare const isWrittenAsTextOnTheValueTab: (type?: string) => boolean;
+/** The tabs a field's value is entered on (see `valueTabsOf`). */
+export type TValueTab = 'value' | 'expression' | 'visual' | 'template';
+/**
+ * The text a value shows as on the Value tab: text as it is, a number or a yes/no as written, null as
+ * `null` (in an untyped field), nothing for no value.
+ */
+export declare const valueTextOf: (value: unknown, type?: string) => string;
+/**
+ * A value written as an expression's text: a literal as DPQL writes it (`12`, `true`, `"open"`), a template
+ * as itself, text with templates as the text and the templates joined (`concat("SUP-", $record:{pos})`).
+ * The Expression tab opens on this for a value that is not an expression yet.
+ */
+export declare const expressionTextOfValue: (value: unknown) => string;
+/**
+ * A lone template written in the expression editor's Text view, as the server parses it: the `template`
+ * operation with the reference as its one argument. It is stored as the bare template, which every consumer
+ * evaluates; the expression form of it is not one the server reads back as the template's value.
+ */
+export declare const loneTemplateOf: (expression: unknown) => string | undefined;
+/**
+ * The template an expression is when it is nothing but that template: `value($record:{pos})` or
+ * `template($record:{pos})`, as a host may hold a reference to a field (the Qorus IDE reads a test's reference
+ * back as `value(...)`, qorus#646). The Value tab shows it as that template. Undefined for any other expression.
+ */
+export declare const templateOfExpression: (expression: unknown) => string | undefined;
+/**
+ * A lone value written in the expression editor's Text view (`12`, `true`, `"open"`), as the server parses
+ * it: the `value` operation with a plain value as its one argument. It is stored as that value - the field's
+ * own shape - rather than as an expression the Visual view has nothing to show for. A record field is not
+ * such a value: it is read from the row.
+ */
+export declare const loneValueOf: (expression: unknown) => {
+    value: unknown;
+} | undefined;
+/** The text a value is seeded into the Text view as: a template, a number or a yes/no as written. */
+export declare const expressionSeedOf: (value: unknown) => string;
+/** The literal `text` writes in a scalar type, or `undefined` when it writes none. */
+export declare const scalarLiteral: (text: string, type?: string) => number | boolean | undefined;
+/** How null is written in an untyped field: the word, so it is not taken for an empty field. */
+export declare const NULL_TEXT = "null";
+/** The text an untyped field shows for its value: `null` for null; for anything else, the text it is. */
+export declare const untypedTextOf: (value: unknown, type?: string) => string | undefined;
+export interface ITemplateTextValue {
+    value: unknown;
+    /** the value's type: the field's own, or for an untyped field the type the text gives it */
+    type?: string;
+}
+/** What the field holds for `text`, written in its template editor. See the top of this file. */
+export declare const templateTextValue: (text: string, type: string | undefined, templates?: IReqoreFormTemplates) => ITemplateTextValue;
+/** Whether a template of this type is a value of the field's type as it is, with nothing to convert. */
+export declare const sameValueType: (templateType: string, fieldType?: string) => boolean;
+//# sourceMappingURL=writtenAsText.d.ts.map

package/dist/components/form/fields/template/writtenAsText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writtenAsText.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/template/writtenAsText.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAyBzF,2GAA2G;AAC3G,eAAO,MAAM,eAAe,UAAW,MAAM,KAAG,OACwC,CAAC;AAEzF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,UAAW,MAAM,KAAG,OAG0B,CAAC;AAExF,kEAAkE;AAClE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,WAAW,UAAW,OAAO,SAAS,MAAM,KAAG,MAM3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UAAW,OAAO,KAAG,MAYtD,CAAC;AAeF;;;;GAIG;AACH,eAAO,MAAM,cAAc,eAAgB,OAAO,KAAG,MAAM,GAAG,SAC2B,CAAC;AAE1F;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,eAAgB,OAAO,KAAG,MAAM,GAAG,SACd,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,eAAgB,OAAO,KAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAQtE,CAAC;AAEF,qGAAqG;AACrG,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,MAIjD,CAAC;AAMF,sFAAsF;AACtF,eAAO,MAAM,aAAa,SAAU,MAAM,SAAS,MAAM,KAAG,MAAM,GAAG,OAAO,GAAG,SAa9E,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,SAAS,SAAS,CAAC;AAEhC,yGAAyG;AACzG,eAAO,MAAM,aAAa,UAAW,OAAO,SAAS,MAAM,KAAG,MAAM,GAAG,SACF,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,4FAA4F;IAC5F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iGAAiG;AACjG,eAAO,MAAM,iBAAiB,SACtB,MAAM,QACN,MAAM,GAAG,SAAS,cACZ,oBAAoB,KAC/B,kBAmBF,CAAC;AAWF,wGAAwG;AACxG,eAAO,MAAM,aAAa,iBAAkB,MAAM,cAAc,MAAM,KAAG,OAKxE,CAAC"}

package/dist/components/form/fields/template/writtenAsText.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sameValueType = exports.templateTextValue = exports.untypedTextOf = exports.NULL_TEXT = exports.scalarLiteral = exports.expressionSeedOf = exports.loneValueOf = exports.templateOfExpression = exports.loneTemplateOf = exports.expressionTextOfValue = exports.valueTextOf = exports.isWrittenAsTextOnTheValueTab = exports.isWrittenAsText = void 0;
+var optionUiTypes_1 = require("../../../../helpers/optionUiTypes");
+var templates_1 = require("../../../../helpers/templates");
+/** Scalar types whose value can be written as text: whole numbers, numbers, yes/no. Not a date, which has
+ *  its own control. */
+var TEXTABLE_SCALARS = {
+    int: 'int',
+    integer: 'int',
+    softint: 'int',
+    number: 'number',
+    float: 'number',
+    softfloat: 'number',
+    softnumber: 'number',
+    bool: 'bool',
+    boolean: 'bool',
+    softbool: 'bool',
+};
+/** Whether a field of this type is written in the template editor: text, untyped, or a textable scalar. */
+var isWrittenAsText = function (type) {
+    return type === 'string' || (0, optionUiTypes_1.isUntypedOptionType)(type) || (!!type && type in TEXTABLE_SCALARS);
+};
+exports.isWrittenAsText = isWrittenAsText;
+/**
+ * Whether a form option of this type is written as text on its Value tab - a text field taking templates as
+ * chips and detecting expressions - rather than on its own control (qorus#646, David): text, untyped values,
+ * whole numbers and numbers. A yes / no, a date and fixed choices keep their own control.
+ */
+var isWrittenAsTextOnTheValueTab = function (type) {
+    return type === 'string' ||
+        (0, optionUiTypes_1.isUntypedOptionType)(type) ||
+        (!!type && (TEXTABLE_SCALARS[type] === 'int' || TEXTABLE_SCALARS[type] === 'number'));
+};
+exports.isWrittenAsTextOnTheValueTab = isWrittenAsTextOnTheValueTab;
+/**
+ * The text a value shows as on the Value tab: text as it is, a number or a yes/no as written, null as
+ * `null` (in an untyped field), nothing for no value.
+ */
+var valueTextOf = function (value, type) {
+    if (value === undefined)
+        return '';
+    if (value === null)
+        return (0, optionUiTypes_1.isUntypedOptionType)(type) ? exports.NULL_TEXT : '';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return '';
+};
+exports.valueTextOf = valueTextOf;
+/**
+ * A value written as an expression's text: a literal as DPQL writes it (`12`, `true`, `"open"`), a template
+ * as itself, text with templates as the text and the templates joined (`concat("SUP-", $record:{pos})`).
+ * The Expression tab opens on this for a value that is not an expression yet.
+ */
+var expressionTextOfValue = function (value) {
+    if (value === undefined || value === null)
+        return value === null ? 'null' : '';
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (typeof value !== 'string')
+        return '';
+    var text = String(value);
+    // nothing written is nothing to write: not an empty concat()
+    if (text === '')
+        return '';
+    if ((0, templates_1.isCompleteTemplateToken)(text))
+        return String(text);
+    var plain = text;
+    var parts = (0, templates_1.splitAtTemplateTokens)(plain);
+    if (parts.length === 1)
+        return JSON.stringify(plain);
+    return "concat(".concat(parts.map(function (part) { return ((0, templates_1.isCompleteTemplateToken)(part) ? part : JSON.stringify(part)); }).join(', '), ")");
+};
+exports.expressionTextOfValue = expressionTextOfValue;
+/** The template a node is when it is one of `operations` with one template as its one argument: the
+ *  argument as a string, as a value (`{value: "$record:{pos}"}`) or as the parser gives it (`{value: {raw}}`). */
+var templateOperandOf = function (node, operations) {
+    var _a;
+    var _b = (node !== null && node !== void 0 ? node : {}), exp = _b.exp, args = _b.args;
+    if (typeof exp !== 'string' || !operations.includes(exp) || (args === null || args === void 0 ? void 0 : args.length) !== 1)
+        return undefined;
+    var arg = args[0];
+    var raw = typeof arg === 'string' ? arg
+        : typeof (arg === null || arg === void 0 ? void 0 : arg.value) === 'string' ? arg.value
+            : (_a = arg === null || arg === void 0 ? void 0 : arg.value) === null || _a === void 0 ? void 0 : _a.raw;
+    return typeof raw === 'string' && (0, templates_1.isCompleteTemplateToken)(raw) ? raw : undefined;
+};
+/**
+ * A lone template written in the expression editor's Text view, as the server parses it: the `template`
+ * operation with the reference as its one argument. It is stored as the bare template, which every consumer
+ * evaluates; the expression form of it is not one the server reads back as the template's value.
+ */
+var loneTemplateOf = function (expression) {
+    return templateOperandOf(expression === null || expression === void 0 ? void 0 : expression.value, ['template']);
+};
+exports.loneTemplateOf = loneTemplateOf;
+/**
+ * The template an expression is when it is nothing but that template: `value($record:{pos})` or
+ * `template($record:{pos})`, as a host may hold a reference to a field (the Qorus IDE reads a test's reference
+ * back as `value(...)`, qorus#646). The Value tab shows it as that template. Undefined for any other expression.
+ */
+var templateOfExpression = function (expression) {
+    return templateOperandOf(expression, ['value', 'template']);
+};
+exports.templateOfExpression = templateOfExpression;
+/**
+ * A lone value written in the expression editor's Text view (`12`, `true`, `"open"`), as the server parses
+ * it: the `value` operation with a plain value as its one argument. It is stored as that value - the field's
+ * own shape - rather than as an expression the Visual view has nothing to show for. A record field is not
+ * such a value: it is read from the row.
+ */
+var loneValueOf = function (expression) {
+    var _a;
+    var node = expression === null || expression === void 0 ? void 0 : expression.value;
+    if ((node === null || node === void 0 ? void 0 : node.exp) !== 'value' || ((_a = node.args) === null || _a === void 0 ? void 0 : _a.length) !== 1)
+        return undefined;
+    var arg = node.args[0];
+    var value = arg === null || arg === void 0 ? void 0 : arg.value;
+    if (!arg || arg.is_expression || (value !== null && typeof value === 'object'))
+        return undefined;
+    if (typeof value === 'string' && (0, templates_1.isValueTemplate)(value))
+        return undefined;
+    return { value: value };
+};
+exports.loneValueOf = loneValueOf;
+/** The text a value is seeded into the Text view as: a template, a number or a yes/no as written. */
+var expressionSeedOf = function (value) {
+    if (typeof value === 'string')
+        return (0, templates_1.isCompleteTemplateToken)(value) ? value : '';
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return '';
+};
+exports.expressionSeedOf = expressionSeedOf;
+var INT_LITERAL = /^\s*[-+]?\d+\s*$/;
+var NUMBER_LITERAL = /^\s*[-+]?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?\s*$/i;
+var BOOL_LITERAL = /^\s*(true|false)\s*$/i;
+/** The literal `text` writes in a scalar type, or `undefined` when it writes none. */
+var scalarLiteral = function (text, type) {
+    switch (type ? TEXTABLE_SCALARS[type] : undefined) {
+        case 'int':
+            return INT_LITERAL.test(text) ? Number.parseInt(text, 10) : undefined;
+        case 'number':
+            return NUMBER_LITERAL.test(text) ? Number.parseFloat(text) : undefined;
+        case 'bool': {
+            var match = BOOL_LITERAL.exec(text);
+            return match ? match[1].toLowerCase() === 'true' : undefined;
+        }
+        default:
+            return undefined;
+    }
+};
+exports.scalarLiteral = scalarLiteral;
+/** How null is written in an untyped field: the word, so it is not taken for an empty field. */
+exports.NULL_TEXT = 'null';
+/** The text an untyped field shows for its value: `null` for null; for anything else, the text it is. */
+var untypedTextOf = function (value, type) {
+    return value === null && (0, optionUiTypes_1.isUntypedOptionType)(type) ? exports.NULL_TEXT : undefined;
+};
+exports.untypedTextOf = untypedTextOf;
+/** What the field holds for `text`, written in its template editor. See the top of this file. */
+var templateTextValue = function (text, type, templates) {
+    var trimmed = text.trim();
+    if ((0, templates_1.isCompleteTemplateToken)(trimmed)) {
+        if ((0, optionUiTypes_1.isUntypedOptionType)(type)) {
+            // the template's own type (`templateType`): its row's badge is its type's name in a list
+            var templateTypeName = templates ? (0, templates_1.templateType)((0, templates_1.findTemplate)(templates, trimmed)) : undefined;
+            return { value: trimmed, type: templateTypeName !== null && templateTypeName !== void 0 ? templateTypeName : type };
+        }
+        return { value: trimmed, type: type };
+    }
+    // null, the literal that says "no value", is a value of an untyped field: written `null`, it is null
+    if ((0, optionUiTypes_1.isUntypedOptionType)(type) && trimmed === exports.NULL_TEXT) {
+        return { value: null, type: type };
+    }
+    var literal = (0, exports.scalarLiteral)(text, type);
+    if (literal !== undefined) {
+        return { value: literal, type: type };
+    }
+    return { value: text, type: (0, optionUiTypes_1.isUntypedOptionType)(type) ? 'string' : type };
+};
+exports.templateTextValue = templateTextValue;
+/** The kind of value a type holds, for telling whether a template and a field hold the same kind. */
+var valueKindOf = function (type) {
+    if (!type)
+        return undefined;
+    var t = type.replace(/^\*/, '').replace(/^soft/, '');
+    if (TEXTABLE_SCALARS[t])
+        return TEXTABLE_SCALARS[t];
+    if (t === 'string' || t === 'date' || t === 'list' || t === 'hash' || t === 'binary')
+        return t;
+    return undefined;
+};
+/** Whether a template of this type is a value of the field's type as it is, with nothing to convert. */
+var sameValueType = function (templateType, fieldType) {
+    var a = valueKindOf(templateType);
+    var b = valueKindOf(fieldType);
+    // a whole number is a number too
+    return !a || !b || a === b || (a === 'int' && b === 'number');
+};
+exports.sameValueType = sameValueType;
+//# sourceMappingURL=writtenAsText.js.map

package/dist/components/form/fields/template/writtenAsText.js.map

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

package/dist/components/form/index.d.ts

@@ -18,21 +18,33 @@ export * from './fields/number/Number';
 export * from './fields/object/Object';
 export * from './fields/radio-group/RadioGroup';
 export * from './fields/rich-text/RichText';
+export { EmittedValues, useEmittedValues } from './fields/emittedValues';
+export type { TEmittedValuesEquals } from './fields/emittedValues';
+export { usePendingEdit } from './fields/pendingEdit';
+export type { IPendingEdit } from './fields/pendingEdit';
 export * from './fields/select/Select';
 export * from './fields/select/SelectCollection';
 export * from './fields/string/String';
 export * from './fields/template/ExampleValueModal';
 export * from './fields/template/TemplateField';
+export * from './fields/template/referenceNames';
 export * from './engine/FormEngine';
 export * from './engine/FormFieldsSkeleton';
 export * from './engine/optionActions';
 export * from './engine/rendererTypes';
 export * from './engine/rowOpenPicker';
+export { MarkdownRendererContext } from '../Description/markdownRendererContext';
+export type { TMarkdownRenderer } from '../Description/markdownRendererContext';
 export * from './expressions/types';
 export * from './expressions/useExpressions';
 export { renderExpressionToText, useRenderExpression } from './expressions/useRenderExpression';
+export { expressionOperand, expressionWithOperands, isExpressionComplete, } from './expressions/expressionOperands';
+export { EXPRESSION_HOLE } from './expressions/renderExpressionToText';
 export type { IRenderedExpression, IUseRenderExpressionResult, } from './expressions/useRenderExpression';
 export * from './expressions/ExpressionField';
 export { ExpressionBuilder } from './expressions/builder';
 export type { IExpressionBuilderProps } from './expressions/builder';
+export * from './fields/rich-text/useTemplateTags';
+export * from './fields/template/TemplateBrowser';
+export * from './fields/template/TemplatePicker';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/form/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EACV,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAI9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,wBAAwB,CAAC;AAIvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,YAAY,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAChG,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,YAAY,EACV,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAI9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC"}

package/dist/components/form/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpressionBuilder = exports.useRenderExpression = exports.renderExpressionToText = void 0;
+exports.ExpressionBuilder = exports.EXPRESSION_HOLE = exports.isExpressionComplete = exports.expressionWithOperands = exports.expressionOperand = exports.useRenderExpression = exports.renderExpressionToText = exports.MarkdownRendererContext = exports.usePendingEdit = exports.useEmittedValues = exports.EmittedValues = void 0;
 __exportStar(require("./fields/Field"), exports);
 __exportStar(require("./fields/allowed-values/AllowedValues"), exports);
 __exportStar(require("./fields/array/ArrayAuto"), exports);
@@ -35,11 +35,21 @@ __exportStar(require("./fields/number/Number"), exports);
 __exportStar(require("./fields/object/Object"), exports);
 __exportStar(require("./fields/radio-group/RadioGroup"), exports);
 __exportStar(require("./fields/rich-text/RichText"), exports);
+// What a debounced field has reported and not yet heard back, so the echo of a report is not taken for a
+// change: a host's own field (the Qorus IDE's rich text) tracks its reports as reqraft's own fields do.
+var emittedValues_1 = require("./fields/emittedValues");
+Object.defineProperty(exports, "EmittedValues", { enumerable: true, get: function () { return emittedValues_1.EmittedValues; } });
+Object.defineProperty(exports, "useEmittedValues", { enumerable: true, get: function () { return emittedValues_1.useEmittedValues; } });
+// The edit a debounced field has not reported yet, kept for whoever closes its editor: a read-first row's Done
+// sends it, Cancel and Escape drop it. A host's own field (the Qorus IDE's rich text) takes part as reqraft's do.
+var pendingEdit_1 = require("./fields/pendingEdit");
+Object.defineProperty(exports, "usePendingEdit", { enumerable: true, get: function () { return pendingEdit_1.usePendingEdit; } });
 __exportStar(require("./fields/select/Select"), exports);
 __exportStar(require("./fields/select/SelectCollection"), exports);
 __exportStar(require("./fields/string/String"), exports);
 __exportStar(require("./fields/template/ExampleValueModal"), exports);
 __exportStar(require("./fields/template/TemplateField"), exports);
+__exportStar(require("./fields/template/referenceNames"), exports);
 __exportStar(require("./engine/FormEngine"), exports);
 __exportStar(require("./engine/FormFieldsSkeleton"), exports);
 __exportStar(require("./engine/optionActions"), exports);
@@ -47,6 +57,11 @@ __exportStar(require("./engine/rendererTypes"), exports);
 // A host's own editor is a compact row's editor too, so the instruction a row
 // gives when the AUTHOR opens it into a picker is part of the public surface.
 __exportStar(require("./engine/rowOpenPicker"), exports);
+// The renderer a host draws markdown with: `FormEngine` puts its `markdownRenderer` here, and a host that
+// mounts a template chip, a choice or a DPQL editor outside a form provides it once around them, so a
+// description and its card are drawn as the host draws markdown wherever they are shown.
+var markdownRendererContext_1 = require("../Description/markdownRendererContext");
+Object.defineProperty(exports, "MarkdownRendererContext", { enumerable: true, get: function () { return markdownRendererContext_1.MarkdownRendererContext; } });
 __exportStar(require("./expressions/types"), exports);
 __exportStar(require("./expressions/useExpressions"), exports);
 // Named (not wildcard) so the `_resetRenderExpressionTransportForTests`
@@ -54,10 +69,19 @@ __exportStar(require("./expressions/useExpressions"), exports);
 var useRenderExpression_1 = require("./expressions/useRenderExpression");
 Object.defineProperty(exports, "renderExpressionToText", { enumerable: true, get: function () { return useRenderExpression_1.renderExpressionToText; } });
 Object.defineProperty(exports, "useRenderExpression", { enumerable: true, get: function () { return useRenderExpression_1.useRenderExpression; } });
+var expressionOperands_1 = require("./expressions/expressionOperands");
+Object.defineProperty(exports, "expressionOperand", { enumerable: true, get: function () { return expressionOperands_1.expressionOperand; } });
+Object.defineProperty(exports, "expressionWithOperands", { enumerable: true, get: function () { return expressionOperands_1.expressionWithOperands; } });
+Object.defineProperty(exports, "isExpressionComplete", { enumerable: true, get: function () { return expressionOperands_1.isExpressionComplete; } });
+var renderExpressionToText_1 = require("./expressions/renderExpressionToText");
+Object.defineProperty(exports, "EXPRESSION_HOLE", { enumerable: true, get: function () { return renderExpressionToText_1.EXPRESSION_HOLE; } });
 __exportStar(require("./expressions/ExpressionField"), exports);
 // The bare builder is public too: the library's own rule renders the shell at a
 // root field and the bare builder for nested operands, and a host that follows
 // it must be able to reach the builder without a deep import (#119).
 var builder_1 = require("./expressions/builder");
 Object.defineProperty(exports, "ExpressionBuilder", { enumerable: true, get: function () { return builder_1.ExpressionBuilder; } });
+__exportStar(require("./fields/rich-text/useTemplateTags"), exports);
+__exportStar(require("./fields/template/TemplateBrowser"), exports);
+__exportStar(require("./fields/template/TemplatePicker"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,wEAAsD;AACtD,2DAAyC;AACzC,gEAA8C;AAC9C,8DAA4C;AAC5C,8DAA4C;AAC5C,2DAAyC;AACzC,mDAAiC;AACjC,6DAA2C;AAC3C,2DAAyC;AACzC,uDAAqC;AACrC,qDAAmC;AACnC,qDAAmC;AACnC,kEAAgD;AAChD,6DAA2C;AAC3C,6EAA2D;AAC3D,yDAAuC;AACvC,yDAAuC;AACvC,kEAAgD;AAChD,8DAA4C;AAC5C,yDAAuC;AACvC,mEAAiD;AACjD,yDAAuC;AACvC,sEAAoD;AACpD,kEAAgD;AAChD,sDAAoC;AACpC,8DAA4C;AAC5C,yDAAuC;AACvC,yDAAuC;AACvC,8EAA8E;AAC9E,8EAA8E;AAC9E,yDAAuC;AACvC,sDAAoC;AACpC,+DAA6C;AAC7C,wEAAwE;AACxE,qDAAqD;AACrD,yEAAgG;AAAvF,6HAAA,sBAAsB,OAAA;AAAE,0HAAA,mBAAmB,OAAA;AAKpD,gEAA8C;AAC9C,gFAAgF;AAChF,+EAA+E;AAC/E,qEAAqE;AACrE,iDAA0D;AAAjD,4GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,wEAAsD;AACtD,2DAAyC;AACzC,gEAA8C;AAC9C,8DAA4C;AAC5C,8DAA4C;AAC5C,2DAAyC;AACzC,mDAAiC;AACjC,6DAA2C;AAC3C,2DAAyC;AACzC,uDAAqC;AACrC,qDAAmC;AACnC,qDAAmC;AACnC,kEAAgD;AAChD,6DAA2C;AAC3C,6EAA2D;AAC3D,yDAAuC;AACvC,yDAAuC;AACvC,kEAAgD;AAChD,8DAA4C;AAC5C,yGAAyG;AACzG,wGAAwG;AACxG,wDAAyE;AAAhE,8GAAA,aAAa,OAAA;AAAE,iHAAA,gBAAgB,OAAA;AAExC,+GAA+G;AAC/G,kHAAkH;AAClH,oDAAsD;AAA7C,6GAAA,cAAc,OAAA;AAEvB,yDAAuC;AACvC,mEAAiD;AACjD,yDAAuC;AACvC,sEAAoD;AACpD,kEAAgD;AAChD,mEAAiD;AACjD,sDAAoC;AACpC,8DAA4C;AAC5C,yDAAuC;AACvC,yDAAuC;AACvC,8EAA8E;AAC9E,8EAA8E;AAC9E,yDAAuC;AACvC,0GAA0G;AAC1G,sGAAsG;AACtG,yFAAyF;AACzF,kFAAiF;AAAxE,kIAAA,uBAAuB,OAAA;AAEhC,sDAAoC;AACpC,+DAA6C;AAC7C,wEAAwE;AACxE,qDAAqD;AACrD,yEAAgG;AAAvF,6HAAA,sBAAsB,OAAA;AAAE,0HAAA,mBAAmB,OAAA;AACpD,uEAI0C;AAHxC,uHAAA,iBAAiB,OAAA;AACjB,4HAAA,sBAAsB,OAAA;AACtB,0HAAA,oBAAoB,OAAA;AAEtB,+EAAuE;AAA9D,yHAAA,eAAe,OAAA;AAKxB,gEAA8C;AAC9C,gFAAgF;AAChF,+EAA+E;AAC/E,qEAAqE;AACrE,iDAA0D;AAAjD,4GAAA,iBAAiB,OAAA;AAE1B,qEAAmD;AACnD,oEAAkD;AAClD,mEAAiD"}

package/dist/components/form/typeSentenceForm.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+import { TTypeLabel, TTypeName, TTypeSentenceForm } from '../../helpers/qorusTypeCatalogue';
+/** What a type is called inside a sentence, by the catalogue the surrounding form has. */
+export declare const useTypeSentenceForm: () => TTypeSentenceForm;
+/** A type's name as a label where the catalogue lists it, by the catalogue the surrounding form has. */
+export declare const useTypeName: () => TTypeName;
+/**
+ * A type's name as a label that is never its code, by the catalogue the surrounding form has: what a list of
+ * templates badges a template with (`qorusTypeDisplayName`: a user type with no base type by its path, any other
+ * unknown type "Unknown type").
+ */
+export declare const useTypeLabel: () => TTypeLabel;
+/** Gives what it draws the server's catalogue's words for each type (`useQorusTypes`). */
+export declare const TypeSentenceFormProvider: ({ children }: {
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=typeSentenceForm.d.ts.map

package/dist/components/form/typeSentenceForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeSentenceForm.d.ts","sourceRoot":"","sources":["../../../src/components/form/typeSentenceForm.tsx"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAuB,MAAM,OAAO,CAAC;AACtE,OAAO,EAML,UAAU,EACV,SAAS,EACT,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAqB1C,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,QAAO,iBACI,CAAC;AAE5C,wGAAwG;AACxG,eAAO,MAAM,WAAW,QAAO,SAA8C,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAO,UAAgD,CAAC;AAEjF,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB,iBAAkB;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,4CAc7E,CAAC"}

package/dist/components/form/typeSentenceForm.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeSentenceFormProvider = exports.useTypeLabel = exports.useTypeName = exports.useTypeSentenceForm = void 0;
+var jsx_runtime_1 = require("react/jsx-runtime");
+// Copyright 2026 Qore Technologies, s.r.o.
+var react_1 = require("react");
+var qorusTypeCatalogue_1 = require("../../helpers/qorusTypeCatalogue");
+var useQorusTypes_1 = require("../../hooks/useQorusTypes");
+/**
+ * The words a form draws types in (qorus#646): a type inside a sentence, as a reference chip's hover says it ("A
+ * whole number."), and a type's name as a label, as an open option's type tag shows it ("Whole number"). The
+ * server's catalogue, in the language it was asked for, where a form has fetched it (`TypeSentenceFormProvider`,
+ * which `FormEngine` puts around everything it draws); the built-in one elsewhere. A chip drawn on its own
+ * fetches nothing: a fetch needs the host's fetch context, which a chip rendered outside a form (a template
+ * preview, a test) does not have.
+ */
+var TypeWordsContext = (0, react_1.createContext)({
+    sentenceForm: qorusTypeCatalogue_1.builtInTypeSentenceForm,
+    name: qorusTypeCatalogue_1.builtInTypeName,
+    label: qorusTypeCatalogue_1.builtInTypeLabel,
+});
+/** What a type is called inside a sentence, by the catalogue the surrounding form has. */
+var useTypeSentenceForm = function () {
+    return (0, react_1.useContext)(TypeWordsContext).sentenceForm;
+};
+exports.useTypeSentenceForm = useTypeSentenceForm;
+/** A type's name as a label where the catalogue lists it, by the catalogue the surrounding form has. */
+var useTypeName = function () { return (0, react_1.useContext)(TypeWordsContext).name; };
+exports.useTypeName = useTypeName;
+/**
+ * A type's name as a label that is never its code, by the catalogue the surrounding form has: what a list of
+ * templates badges a template with (`qorusTypeDisplayName`: a user type with no base type by its path, any other
+ * unknown type "Unknown type").
+ */
+var useTypeLabel = function () { return (0, react_1.useContext)(TypeWordsContext).label; };
+exports.useTypeLabel = useTypeLabel;
+/** Gives what it draws the server's catalogue's words for each type (`useQorusTypes`). */
+var TypeSentenceFormProvider = function (_a) {
+    var children = _a.children;
+    var _b = (0, useQorusTypes_1.useQorusTypes)(), getTypeSentenceForm = _b.getTypeSentenceForm, value = _b.value;
+    var words = (0, react_1.useMemo)(function () { return ({
+        sentenceForm: getTypeSentenceForm,
+        // a type the catalogue does not list, by its base type (`qorusTypeEntry`)
+        name: function (typeName, baseType) {
+            return (0, qorusTypeCatalogue_1.qorusTypeKnownName)(value, typeName, baseType);
+        },
+        label: function (typeName, baseType) {
+            return (0, qorusTypeCatalogue_1.qorusTypeDisplayName)(value, typeName, baseType);
+        },
+    }); }, [getTypeSentenceForm, value]);
+    return (0, jsx_runtime_1.jsx)(TypeWordsContext.Provider, { value: words, children: children });
+};
+exports.TypeSentenceFormProvider = TypeSentenceFormProvider;
+//# sourceMappingURL=typeSentenceForm.js.map