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

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

@@ -0,0 +1 @@
+{"version":3,"file":"domProps.d.ts","sourceRoot":"","sources":["../../src/helpers/domProps.ts"],"names":[],"mappings":"AAgCA,gHAAgH;AAChH,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,OACmC,CAAC;AAErF,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,4BAA6B,CAAC,KAAG,QAAQ,CAAC,CAGtD,CAAC"}

package/dist/helpers/domProps.js

@@ -0,0 +1,47 @@
+"use strict";
+// Copyright 2026 Qore Technologies, s.r.o.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.htmlElementProps = exports.isHtmlElementProp = void 0;
+/**
+ * The attributes any HTML element takes, beside `aria-*`, `data-*` and event handlers (qorus#646).
+ *
+ * A component that renders a plain element and takes the rest of its props for it passes that element only these.
+ * What else it is handed is not an attribute: a Reqore control group hands each component in it its layout props
+ * (`fluid`, `spaceBetween`, `size`, `intent`, `customTheme`, ...), and spread onto an element React warns of each
+ * ("Received `true` for a non-boolean attribute `fluid`") and writes the rest into the DOM.
+ */
+var GLOBAL_ATTRIBUTES = new Set([
+    'id',
+    'className',
+    'style',
+    'title',
+    'role',
+    'tabIndex',
+    'lang',
+    'dir',
+    'hidden',
+    'translate',
+    'draggable',
+    'slot',
+    'accessKey',
+    'autoFocus',
+    'inert',
+    'contentEditable',
+    'spellCheck',
+    'suppressContentEditableWarning',
+    'suppressHydrationWarning',
+]);
+/** Whether a prop is one any HTML element takes: a global attribute, `aria-*`, `data-*` or an event handler. */
+var isHtmlElementProp = function (name) {
+    return GLOBAL_ATTRIBUTES.has(name) || /^(aria|data)-/.test(name) || /^on[A-Z]/.test(name);
+};
+exports.isHtmlElementProp = isHtmlElementProp;
+/** The props any HTML element takes, and nothing else; see `isHtmlElementProp`. */
+var htmlElementProps = function (props) {
+    return Object.fromEntries(Object.entries(props).filter(function (_a) {
+        var name = _a[0];
+        return (0, exports.isHtmlElementProp)(name);
+    }));
+};
+exports.htmlElementProps = htmlElementProps;
+//# sourceMappingURL=domProps.js.map

package/dist/helpers/domProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domProps.js","sourceRoot":"","sources":["../../src/helpers/domProps.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;AAE3C;;;;;;;GAOG;AACH,IAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,IAAI;IACJ,WAAW;IACX,OAAO;IACP,OAAO;IACP,MAAM;IACN,UAAU;IACV,MAAM;IACN,KAAK;IACL,QAAQ;IACR,WAAW;IACX,WAAW;IACX,MAAM;IACN,WAAW;IACX,WAAW;IACX,OAAO;IACP,iBAAiB;IACjB,YAAY;IACZ,gCAAgC;IAChC,0BAA0B;CAC3B,CAAC,CAAC;AAEH,gHAAgH;AACzG,IAAM,iBAAiB,GAAG,UAAC,IAAY;IAC5C,OAAA,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;AAAlF,CAAkF,CAAC;AADxE,QAAA,iBAAiB,qBACuD;AAErF,mFAAmF;AAC5E,IAAM,gBAAgB,GAAG,UAAmB,KAAQ;IACzD,OAAA,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAC,EAAM;YAAL,IAAI,QAAA;QAAM,OAAA,IAAA,yBAAiB,EAAC,IAAI,CAAC;IAAvB,CAAuB,CAAC,CACpD;AAFf,CAEe,CAAC;AAHL,QAAA,gBAAgB,oBAGX"}

package/dist/helpers/expressions.d.ts

@@ -1,6 +1,13 @@
 import { IExpression, IExpressionSchema, IExpressionSchemaArg } from '../components/form/expressions/types';
 import { IQorusTypeObject } from '../hooks/useQorusTypes';
-export declare const getArgumentType: (expressions: IExpressionSchema[], arg?: IExpression, schema?: IExpressionSchemaArg) => string;
+/**
+ * The UI type of an argument: a value's own type, or, for an expression, the
+ * type the server gave for it (`useExpressionType`) — an expression's type is
+ * never worked out here, so it is the same as everywhere else in Qorus
+ * (qoretechnologies/qorus#713). `any`, which nothing is judged by, until the
+ * server has given it.
+ */
+export declare const getArgumentType: (_expressions: IExpressionSchema[], arg?: IExpression, schema?: IExpressionSchemaArg) => string;
 export declare const argumentMatchesType: (expressions: IExpressionSchema[], arg: IExpression | undefined, schema: IExpressionSchemaArg) => boolean;
 export declare const areQorusTypesCompatible: (mainType: string | string[], checkType: string | string[], fallbackTypes?: IQorusTypeObject[]) => boolean;
 /**
@@ -10,8 +17,106 @@ export declare const areQorusTypesCompatible: (mainType: string | string[], chec
  * instead (`@status == "open"`, `@note != ""`). The Qorus server applies the same rule.
  */
 export declare const isTextOrDateType: (type: string) => boolean;
-/** Whether a place takes a condition: its result must be true or false (`bool`, or a list of only that). */
+/**
+ * Whether a place takes a condition: its result must be true or false (`bool`, optional or soft, or a list of
+ * only that).
+ */
 export declare const isConditionType: (returnType: string | string[] | undefined) => boolean;
+/**
+ * What an editor says of a condition that gives this type (qorus#646): nothing for true or false or a type it
+ * cannot tell (`any`, `auto`); an error for text, a date or a time, which do not say plainly what is meant;
+ * and a warning for any other (a number, a list, a hash), which the condition reads as true unless it is
+ * zero or empty - accepted, as the Qorus server accepts it, but said, because it is seldom what was meant.
+ * qorus-ide says the same of its own condition editors.
+ */
+export declare const conditionVerdict: (type: string | undefined) => 'error' | 'warning' | undefined;
+/**
+ * Whether a field is a condition: its schema's `metadata.condition`, the mark a host sets on the options that
+ * are conditions (a Qog transition's value, a built-in if's value, a while or for block's condition). The
+ * schema's own `type` cannot say it: a value of type bool is not a condition.
+ */
+export declare const isConditionOption: (field: {
+    metadata?: Record<string, unknown>;
+} | undefined) => boolean;
+/** A type as a condition reads it: without the optional mark, `soft`, or what a list or hash holds. */
+export declare const conditionBaseType: (type: string | undefined) => string;
+/**
+ * What is said of a condition that gives text, a date or a time (NOT_A_CONDITION): what it gives, and how to make
+ * it one, with an example for its type. `typeInSentence` is the type named inside a sentence - its sentence form
+ * ("text"), as `qorusTypeSentenceForm` gives it - and `baseType` the type it is (`string`, `date`, `time`): the
+ * example follows it. These are the server's words: a fallback for when it said none, never a second wording of
+ * them. With no type to name, the sentence names none: "The condition must evaluate to true or false. …".
+ */
+export declare const conditionErrorText: (typeInSentence: string | undefined, baseType: string | undefined) => string;
+/**
+ * What the expression builder says of an expression whose result does not fit its place: what it gives, what the
+ * place takes, and what to do. `gives` and `takes` name the types inside the sentence - their sentence forms ("a
+ * whole number"), as `qorusTypeSentenceForm` gives them, `takes` joined with "or" where a place takes more than
+ * one - and `gives` is undefined for an expression that gives nothing yet, `takes` for a place whose type is not
+ * known: the sentence then says what it gives without naming a type it cannot name (qorus#646).
+ */
+export declare const expressionTypeMismatchText: (gives: string | undefined, takes: string | undefined) => string;
+/**
+ * What the builder's conversion list says of an argument it converts: from what to what. `from` and `to` name the
+ * types inside the sentence - their sentence forms, as `qorusTypeSentenceForm` gives them - and either is undefined
+ * where the type is not known; the sentence then names only the other, or neither (qorus#646).
+ */
+export declare const conversionText: (from: string | undefined, to: string | undefined) => string;
+/**
+ * What is said of a condition that gives a number, a list, a hash or a type that is not known
+ * (CONDITION_BY_TRUTHINESS): how Qorus reads it, and how to say it explicitly, by the type it gives - named by its
+ * sentence form ("a whole number", "key-value pairs (a hash)"), as the server names it
+ * (`QonsoleDesignI18n::conditionByTruthinessText`, qorus 04e6c502f). These are the server's words: a fallback for
+ * when it said none.
+ */
+export declare const conditionByTruthinessText: (type: string | undefined) => string;
+/** The operators whose every part is read as true or false by its value: AND, OR and NOT. */
+export declare const LOGICAL_OPERATORS: readonly ["&&", "||", "!"];
+/** Whether an expression is an AND, an OR or a NOT. */
+export declare const isLogicalOperation: (expression: IExpression | undefined) => boolean;
+/** How the server reads a part of a condition (`dpql/parse` with `condition: true`, qorus#646). */
+export type TConditionReading = 'condition' | 'truthiness' | 'not_a_condition' | 'unknown';
+/** A part of an AND, an OR or a NOT in a condition: the type it gives and how it is read. */
+export interface IConditionPart {
+    type: string;
+    reading: TConditionReading;
+    /** What the server says of it, in its words, when it says anything. */
+    message?: string;
+}
+/**
+ * What the server says of a whole condition, in its words: the first condition diagnostic, when the whole
+ * expression's type (`inferredType`) makes it one the server says something of and the diagnostic is that kind.
+ * Undefined when it says nothing of the whole - true or false, a type it cannot tell, or diagnostics that do not
+ * line up.
+ */
+export declare const conditionWholeMessage: (inferredType: string | undefined, diagnostics: Array<{
+    code?: string | number;
+    message: string;
+}>) => string | undefined;
+/**
+ * The parts the server judged, each with what it said of it.
+ *
+ * The server says it in the diagnostics (NOT_A_CONDITION, CONDITION_BY_TRUTHINESS), in the order it judged:
+ * the whole expression first, then its parts - one for each that is not true or false, all over the whole
+ * text. The whole's own reading is the one its type gives (`inferredType`); the answer's `condition_reading`
+ * is the worst of all of them. A part keeps no words when the diagnostics do not line up with the readings.
+ */
+export declare const conditionPartsWithMessages: (parts: IConditionPart[] | undefined, inferredType: string | undefined, diagnostics: Array<{
+    code?: string | number;
+    message: string;
+}>) => IConditionPart[] | undefined;
+/**
+ * Where each part the server judged is drawn, by the path of its card in the expression (the builder's
+ * `path`; `''` for the expression itself).
+ *
+ * The server reads each part of `&&`, `||` and `!` as a condition (qorus#646) and answers `parts` in its own
+ * walk order: the operands of the expression's logical operator, left to right, a nested `&&`, `||` or `!`
+ * standing for its own parts. A part of an AND or an OR has its own card; the part a NOT reads is drawn on
+ * the NOT's card. An answer whose parts are not this expression's (a stale one, or none) places nothing.
+ */
+export declare const conditionPartCards: (expression: IExpression | undefined, parts: IConditionPart[] | undefined) => Record<string, IConditionPart>;
+/** What is said of a part of a condition: nothing when it is true or false or cannot be told. */
+export declare const conditionPartVerdict: (part: IConditionPart | undefined) => 'error' | 'warning' | undefined;
 /**
  * Whether an operation is offered where its result must be of `returnType`: a condition (`bool`) is
  * built from the operations whose result decides it, which is any result but text, a date or a time.

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

@@ -1 +1 @@
-{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../src/helpers/expressions.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAoC,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE5F,eAAO,MAAM,eAAe,gBACb,iBAAiB,EAAE,QAC1B,WAAW,WACR,oBAAoB,WAS9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,gBACjB,iBAAiB,EAAE,OAC3B,WAAW,GAAG,SAAS,UACpB,oBAAoB,YAgB7B,CAAC;AAgBF,eAAO,MAAM,uBAAuB,aACxB,MAAM,GAAG,MAAM,EAAE,aAChB,MAAM,GAAG,MAAM,EAAE,kBACZ,gBAAgB,EAAE,KACjC,OAmCF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,SAAU,MAAM,KAAG,OACoC,CAAC;AAErF,4GAA4G;AAC5G,eAAO,MAAM,eAAe,eAAgB,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,KAAG,OAG3E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,eACvB,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,cAC7B;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAE,KACvE,OASF,CAAC"}
+{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../src/helpers/expressions.ts"],"names":[],"mappings":"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"}

package/dist/helpers/expressions.js

@@ -1,17 +1,37 @@
 "use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expressionFitsReturnType = exports.isConditionType = exports.isTextOrDateType = exports.areQorusTypesCompatible = exports.argumentMatchesType = exports.getArgumentType = void 0;
+exports.expressionFitsReturnType = exports.conditionPartVerdict = exports.conditionPartCards = exports.conditionPartsWithMessages = exports.conditionWholeMessage = exports.isLogicalOperation = exports.LOGICAL_OPERATORS = exports.conditionByTruthinessText = exports.conversionText = exports.expressionTypeMismatchText = exports.conditionErrorText = exports.conditionBaseType = exports.isConditionOption = exports.conditionVerdict = exports.isConditionType = exports.isTextOrDateType = exports.areQorusTypesCompatible = exports.argumentMatchesType = exports.getArgumentType = void 0;
 // Copyright 2026 Qore Technologies, s.r.o.
-// Expression / type-compatibility helpers — ported verbatim from qorus-ide
+// Expression / type-compatibility helpers — ported from qorus-ide
 // (`src/helpers/expressions.ts` + `areQorusTypesCompatible` from
 // `src/helpers/functions.tsx`), import paths adapted to reqraft. Used by the
 // ported ExpressionBuilder.
 var lodash_1 = require("lodash");
+var useExpressionType_1 = require("../components/form/expressions/useExpressionType");
 var useQorusTypes_1 = require("../hooks/useQorusTypes");
-var getArgumentType = function (expressions, arg, schema) {
-    var _a;
+var qorusTypeCatalogue_1 = require("./qorusTypeCatalogue");
+/**
+ * The UI type of an argument: a value's own type, or, for an expression, the
+ * type the server gave for it (`useExpressionType`) — an expression's type is
+ * never worked out here, so it is the same as everywhere else in Qorus
+ * (qoretechnologies/qorus#713). `any`, which nothing is judged by, until the
+ * server has given it.
+ */
+var getArgumentType = function (_expressions, arg, schema) {
+    var _a, _b;
     if (arg === null || arg === void 0 ? void 0 : arg.is_expression) {
-        return (_a = expressions === null || expressions === void 0 ? void 0 : expressions.find(function (exp) { var _a; return exp.name === ((_a = arg.value) === null || _a === void 0 ? void 0 : _a.exp); })) === null || _a === void 0 ? void 0 : _a.ui_return_type;
+        return (_b = (_a = (0, useExpressionType_1.getCachedExpressionType)(arg.value)) === null || _a === void 0 ? void 0 : _a.ui_type) !== null && _b !== void 0 ? _b : 'any';
     }
     return (arg === null || arg === void 0 ? void 0 : arg.type) || (schema === null || schema === void 0 ? void 0 : schema.ui_type);
 };
@@ -41,8 +61,13 @@ exports.argumentMatchesType = argumentMatchesType;
  * template from it, and the picker offered a group header with nothing under
  * it. The field was not "a field with no templates" — it was a field whose
  * templates had all been filtered away by a name mismatch.
+ *
+ * Qore's other names for a type (`integer`, `boolean`) are the catalogue's name for it too: the server's catalogue
+ * lists and converts each type by one name only (qorus#646).
  */
-var normalizeAnyLikeTypeName = function (name) { return (name === 'auto' ? 'any' : name); };
+var normalizeAnyLikeTypeName = function (name) {
+    return name === 'auto' ? 'any' : (0, qorusTypeCatalogue_1.catalogueTypeName)(name);
+};
 var areQorusTypesCompatible = function (mainType, checkType, fallbackTypes) {
     var _a, _b;
     var types = (0, useQorusTypes_1.getQorusTypes)() || fallbackTypes || useQorusTypes_1.defaultQorusTypes;
@@ -99,12 +124,202 @@ var isTextOrDateType = function (type) {
     return /^(string|richtext|date|time)$/.test(type.replace(/^\*/, '').replace(/^soft/, ''));
 };
 exports.isTextOrDateType = isTextOrDateType;
-/** Whether a place takes a condition: its result must be true or false (`bool`, or a list of only that). */
+/**
+ * Whether a place takes a condition: its result must be true or false (`bool`, optional or soft, or a list of
+ * only that).
+ */
 var isConditionType = function (returnType) {
     var types = (0, lodash_1.isArray)(returnType) ? returnType : returnType ? [returnType] : [];
-    return types.length > 0 && types.every(function (type) { return /^\*?(bool|boolean)$/.test(type); });
+    return types.length > 0 && types.every(function (type) { return /^\*?(soft)?(bool|boolean)$/.test(type); });
 };
 exports.isConditionType = isConditionType;
+/**
+ * What an editor says of a condition that gives this type (qorus#646): nothing for true or false or a type it
+ * cannot tell (`any`, `auto`); an error for text, a date or a time, which do not say plainly what is meant;
+ * and a warning for any other (a number, a list, a hash), which the condition reads as true unless it is
+ * zero or empty - accepted, as the Qorus server accepts it, but said, because it is seldom what was meant.
+ * qorus-ide says the same of its own condition editors.
+ */
+var conditionVerdict = function (type) {
+    if (!type) {
+        return undefined;
+    }
+    var base = type.replace(/^\*/, '').replace(/^soft/, '').replace(/<.*$/, '');
+    if (!base || /^(bool|boolean|any|auto)$/.test(base)) {
+        return undefined;
+    }
+    return (0, exports.isTextOrDateType)(base) ? 'error' : 'warning';
+};
+exports.conditionVerdict = conditionVerdict;
+/**
+ * Whether a field is a condition: its schema's `metadata.condition`, the mark a host sets on the options that
+ * are conditions (a Qog transition's value, a built-in if's value, a while or for block's condition). The
+ * schema's own `type` cannot say it: a value of type bool is not a condition.
+ */
+var isConditionOption = function (field) { var _a; return ((_a = field === null || field === void 0 ? void 0 : field.metadata) === null || _a === void 0 ? void 0 : _a.condition) === true; };
+exports.isConditionOption = isConditionOption;
+/** A type as a condition reads it: without the optional mark, `soft`, or what a list or hash holds. */
+var conditionBaseType = function (type) {
+    return (type !== null && type !== void 0 ? type : '').replace(/^\*/, '').replace(/^soft/, '').replace(/<.*$/, '');
+};
+exports.conditionBaseType = conditionBaseType;
+/** How a condition that gives this base type is made one: compare the value (qorus#646, as the server says). */
+var conditionExample = function (baseType) {
+    return baseType === 'date' ? '@shipped_on > @ordered_on'
+        : baseType === 'time' ? '@starts_at < @ends_at'
+            : '@status == "open"';
+};
+/**
+ * What is said of a condition that gives text, a date or a time (NOT_A_CONDITION): what it gives, and how to make
+ * it one, with an example for its type. `typeInSentence` is the type named inside a sentence - its sentence form
+ * ("text"), as `qorusTypeSentenceForm` gives it - and `baseType` the type it is (`string`, `date`, `time`): the
+ * example follows it. These are the server's words: a fallback for when it said none, never a second wording of
+ * them. With no type to name, the sentence names none: "The condition must evaluate to true or false. …".
+ */
+var conditionErrorText = function (typeInSentence, baseType) {
+    return "".concat(typeInSentence ? "The condition evaluates to ".concat(typeInSentence, ", but it") : 'The condition', " must evaluate to true or false. Compare the value instead, for example ").concat(conditionExample((0, exports.conditionBaseType)(baseType)), ".");
+};
+exports.conditionErrorText = conditionErrorText;
+/**
+ * What the expression builder says of an expression whose result does not fit its place: what it gives, what the
+ * place takes, and what to do. `gives` and `takes` name the types inside the sentence - their sentence forms ("a
+ * whole number"), as `qorusTypeSentenceForm` gives them, `takes` joined with "or" where a place takes more than
+ * one - and `gives` is undefined for an expression that gives nothing yet, `takes` for a place whose type is not
+ * known: the sentence then says what it gives without naming a type it cannot name (qorus#646).
+ */
+var expressionTypeMismatchText = function (gives, takes) {
+    return takes ?
+        "This expression gives ".concat(gives !== null && gives !== void 0 ? gives : 'nothing', ", but this field takes ").concat(takes, ". Choose an expression that gives ").concat(takes, ", or put this one inside an expression that converts it.")
+        : "This expression gives ".concat(gives !== null && gives !== void 0 ? gives : 'nothing', ", which this field does not take. Choose another expression, or put this one inside an expression that converts it.");
+};
+exports.expressionTypeMismatchText = expressionTypeMismatchText;
+/**
+ * What the builder's conversion list says of an argument it converts: from what to what. `from` and `to` name the
+ * types inside the sentence - their sentence forms, as `qorusTypeSentenceForm` gives them - and either is undefined
+ * where the type is not known; the sentence then names only the other, or neither (qorus#646).
+ */
+var conversionText = function (from, to) {
+    return "Converted".concat(from ? " from ".concat(from) : '').concat(to ? " to ".concat(to) : '');
+};
+exports.conversionText = conversionText;
+/**
+ * What is said of a condition that gives a number, a list, a hash or a type that is not known
+ * (CONDITION_BY_TRUTHINESS): how Qorus reads it, and how to say it explicitly, by the type it gives - named by its
+ * sentence form ("a whole number", "key-value pairs (a hash)"), as the server names it
+ * (`QonsoleDesignI18n::conditionByTruthinessText`, qorus 04e6c502f). These are the server's words: a fallback for
+ * when it said none.
+ */
+var conditionByTruthinessText = function (type) {
+    var base = (0, exports.conditionBaseType)(type);
+    var named = (0, qorusTypeCatalogue_1.qorusTypeSentenceForm)((0, useQorusTypes_1.getQorusTypes)(), base);
+    if (/^(int|integer|float|number)$/.test(base)) {
+        return "The condition evaluates to ".concat(named, "; Qorus treats it as true unless it is 0. To make that explicit, compare it, for example @count > 0.");
+    }
+    if (base === 'list') {
+        return "The condition evaluates to ".concat(named, "; Qorus treats it as true unless it is empty. To make that explicit, compare its size, for example size(@items) > 0.");
+    }
+    if (base === 'hash') {
+        return "The condition evaluates to ".concat(named, "; Qorus treats it as true unless it holds no pairs. To make that explicit, compare its size, for example size(@details) > 0.");
+    }
+    return "The condition's value is not true or false; Qorus treats it as true unless it is 0 or empty. To make that explicit, compare it, for example @count > 0.";
+};
+exports.conditionByTruthinessText = conditionByTruthinessText;
+/** The operators whose every part is read as true or false by its value: AND, OR and NOT. */
+exports.LOGICAL_OPERATORS = ['&&', '||', '!'];
+/** Whether an expression is an AND, an OR or a NOT. */
+var isLogicalOperation = function (expression) {
+    var _a;
+    return !!(expression === null || expression === void 0 ? void 0 : expression.is_expression) &&
+        exports.LOGICAL_OPERATORS.includes((_a = expression.value) === null || _a === void 0 ? void 0 : _a.exp);
+};
+exports.isLogicalOperation = isLogicalOperation;
+/** The server's code for what it says of a condition read as this verdict. */
+var CONDITION_CODE_OF_VERDICT = { error: 'NOT_A_CONDITION', warning: 'CONDITION_BY_TRUTHINESS' };
+/**
+ * What the server says of a whole condition, in its words: the first condition diagnostic, when the whole
+ * expression's type (`inferredType`) makes it one the server says something of and the diagnostic is that kind.
+ * Undefined when it says nothing of the whole - true or false, a type it cannot tell, or diagnostics that do not
+ * line up.
+ */
+var conditionWholeMessage = function (inferredType, diagnostics) {
+    var verdict = (0, exports.conditionVerdict)(inferredType);
+    if (!verdict) {
+        return undefined;
+    }
+    var first = diagnostics.find(function (d) { return d.code === 'NOT_A_CONDITION' || d.code === 'CONDITION_BY_TRUTHINESS'; });
+    return (first === null || first === void 0 ? void 0 : first.code) === CONDITION_CODE_OF_VERDICT[verdict] ? first.message : undefined;
+};
+exports.conditionWholeMessage = conditionWholeMessage;
+/**
+ * The parts the server judged, each with what it said of it.
+ *
+ * The server says it in the diagnostics (NOT_A_CONDITION, CONDITION_BY_TRUTHINESS), in the order it judged:
+ * the whole expression first, then its parts - one for each that is not true or false, all over the whole
+ * text. The whole's own reading is the one its type gives (`inferredType`); the answer's `condition_reading`
+ * is the worst of all of them. A part keeps no words when the diagnostics do not line up with the readings.
+ */
+var conditionPartsWithMessages = function (parts, inferredType, diagnostics) {
+    if (!parts) {
+        return undefined;
+    }
+    var said = diagnostics.filter(function (d) { return d.code === 'NOT_A_CONDITION' || d.code === 'CONDITION_BY_TRUTHINESS'; });
+    var codeOf = function (reading) {
+        return reading === 'not_a_condition' ? 'NOT_A_CONDITION'
+            : reading === 'truthiness' ? 'CONDITION_BY_TRUTHINESS'
+                : undefined;
+    };
+    // the whole's diagnostic comes first, when its type gives it one (`conditionWholeMessage`)
+    var rest = (0, exports.conditionVerdict)(inferredType) ? said.slice(1) : said;
+    var partCodes = parts.map(function (part) { return codeOf(part.reading); }).filter(Boolean);
+    if (rest.length !== partCodes.length || rest.some(function (d, index) { return d.code !== partCodes[index]; })) {
+        return parts;
+    }
+    var next = 0;
+    return parts.map(function (part) {
+        return codeOf(part.reading) ? __assign(__assign({}, part), { message: rest[next++].message }) : part;
+    });
+};
+exports.conditionPartsWithMessages = conditionPartsWithMessages;
+/**
+ * Where each part the server judged is drawn, by the path of its card in the expression (the builder's
+ * `path`; `''` for the expression itself).
+ *
+ * The server reads each part of `&&`, `||` and `!` as a condition (qorus#646) and answers `parts` in its own
+ * walk order: the operands of the expression's logical operator, left to right, a nested `&&`, `||` or `!`
+ * standing for its own parts. A part of an AND or an OR has its own card; the part a NOT reads is drawn on
+ * the NOT's card. An answer whose parts are not this expression's (a stale one, or none) places nothing.
+ */
+var conditionPartCards = function (expression, parts) {
+    var cards = [];
+    var walk = function (node, path) {
+        var _a, _b;
+        ((_b = (_a = node.value) === null || _a === void 0 ? void 0 : _a.args) !== null && _b !== void 0 ? _b : []).forEach(function (arg, index) {
+            var _a;
+            var argPath = "".concat(path ? "".concat(path, ".") : '', "value.args.").concat(index);
+            if ((0, exports.isLogicalOperation)(arg)) {
+                walk(arg, argPath);
+            }
+            else {
+                cards.push(((_a = node.value) === null || _a === void 0 ? void 0 : _a.exp) === '!' ? path : argPath);
+            }
+        });
+    };
+    if (expression && (0, exports.isLogicalOperation)(expression)) {
+        walk(expression, '');
+    }
+    if (!parts || parts.length !== cards.length) {
+        return {};
+    }
+    return Object.fromEntries(cards.map(function (card, index) { return [card, parts[index]]; }));
+};
+exports.conditionPartCards = conditionPartCards;
+/** What is said of a part of a condition: nothing when it is true or false or cannot be told. */
+var conditionPartVerdict = function (part) {
+    return (part === null || part === void 0 ? void 0 : part.reading) === 'not_a_condition' ? 'error'
+        : (part === null || part === void 0 ? void 0 : part.reading) === 'truthiness' ? 'warning'
+            : undefined;
+};
+exports.conditionPartVerdict = conditionPartVerdict;
 /**
  * Whether an operation is offered where its result must be of `returnType`: a condition (`bool`) is
  * built from the operations whose result decides it, which is any result but text, a date or a time.

package/dist/helpers/expressions.js.map

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

package/dist/helpers/hoveringPointer.d.ts

@@ -0,0 +1,26 @@
+/** What `isHoveringPointer` reads of a pointer event: a DOM `PointerEvent` or React's own. */
+export interface IHoveringPointerEvent {
+    pointerType?: string;
+    buttons?: number;
+}
+/**
+ * The pointer can hover: a mouse, or a pen held above the screen. A finger cannot.
+ *
+ * A tap is followed by the mouse events a browser emulates for pages written for a mouse - `mousemove`,
+ * `mouseenter`, `mousedown`, `mouseup`, `click` - at the tap, with nothing in them to tell them from a mouse's.
+ * Something shown on `mouseenter` or `mousemove` was therefore shown by a tap too: the SmartEditor's hover
+ * opened where the finger had put the caret, beside its own Details button (qorus#646), and a compact form's
+ * group highlight lit at a tap and stayed lit until the next. The pointer event before them says what the
+ * pointer was, so a hover starts on a pointer event, and only for a pointer this says can hover.
+ *
+ * It is asked of each event, not of the device: a touch laptop's mouse hovers, and so does a mouse plugged
+ * into a tablet, whose screen is still a finger's. A pen hovers while it is held above the screen
+ * (`buttons` 0); pressed to it, it is drawing, not hovering.
+ *
+ * Only what cannot hover is turned away: a finger, and a pen pressed to the screen. A pointer the event does
+ * not name (`pointerType` '' - which the specification allows where the type cannot be told, and which
+ * user-event sends under some jsdom setups - or none at all) is taken for one that hovers, as reqore's
+ * `isHoveringPointer` takes it: taken for a finger, it hovered nothing in a consumer's test.
+ */
+export declare const isHoveringPointer: ({ pointerType, buttons }: IHoveringPointerEvent) => boolean;
+//# sourceMappingURL=hoveringPointer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hoveringPointer.d.ts","sourceRoot":"","sources":["../../src/helpers/hoveringPointer.ts"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,6BAA8B,qBAAqB,KAAG,OACd,CAAC"}

package/dist/helpers/hoveringPointer.js

@@ -0,0 +1,29 @@
+"use strict";
+// Copyright 2026 Qore Technologies, s.r.o.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isHoveringPointer = void 0;
+/**
+ * The pointer can hover: a mouse, or a pen held above the screen. A finger cannot.
+ *
+ * A tap is followed by the mouse events a browser emulates for pages written for a mouse - `mousemove`,
+ * `mouseenter`, `mousedown`, `mouseup`, `click` - at the tap, with nothing in them to tell them from a mouse's.
+ * Something shown on `mouseenter` or `mousemove` was therefore shown by a tap too: the SmartEditor's hover
+ * opened where the finger had put the caret, beside its own Details button (qorus#646), and a compact form's
+ * group highlight lit at a tap and stayed lit until the next. The pointer event before them says what the
+ * pointer was, so a hover starts on a pointer event, and only for a pointer this says can hover.
+ *
+ * It is asked of each event, not of the device: a touch laptop's mouse hovers, and so does a mouse plugged
+ * into a tablet, whose screen is still a finger's. A pen hovers while it is held above the screen
+ * (`buttons` 0); pressed to it, it is drawing, not hovering.
+ *
+ * Only what cannot hover is turned away: a finger, and a pen pressed to the screen. A pointer the event does
+ * not name (`pointerType` '' - which the specification allows where the type cannot be told, and which
+ * user-event sends under some jsdom setups - or none at all) is taken for one that hovers, as reqore's
+ * `isHoveringPointer` takes it: taken for a finger, it hovered nothing in a consumer's test.
+ */
+var isHoveringPointer = function (_a) {
+    var pointerType = _a.pointerType, buttons = _a.buttons;
+    return pointerType !== 'touch' && !(pointerType === 'pen' && buttons !== 0);
+};
+exports.isHoveringPointer = isHoveringPointer;
+//# sourceMappingURL=hoveringPointer.js.map

package/dist/helpers/hoveringPointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hoveringPointer.js","sourceRoot":"","sources":["../../src/helpers/hoveringPointer.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;AAQ3C;;;;;;;;;;;;;;;;;;GAkBG;AACI,IAAM,iBAAiB,GAAG,UAAC,EAA+C;QAA7C,WAAW,iBAAA,EAAE,OAAO,aAAA;IACtD,OAAA,WAAW,KAAK,OAAO,IAAI,CAAC,CAAC,WAAW,KAAK,KAAK,IAAI,OAAO,KAAK,CAAC,CAAC;AAApE,CAAoE,CAAC;AAD1D,QAAA,iBAAiB,qBACyC"}

package/dist/helpers/markdownText.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+/**
+ * Markdown as plain text: its words, with no marks, a blank line between its paragraphs and a line of its own for
+ * each list item. A fenced code block keeps its lines. Empty for anything but a string.
+ */
+export declare const markdownToPlainText: (value: unknown) => string;
+/** Markdown as prose on one line: `markdownToPlainText` with its breaks run together. */
+export declare const markdownToProse: (value: unknown) => string;
+/**
+ * Markdown as plain text to show: the text alone when it is one line, or a block that keeps its paragraph and
+ * line breaks (`white-space: pre-line`) when it has more.
+ */
+export declare const plainTextNode: (value: unknown) => ReactNode;
+//# sourceMappingURL=markdownText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdownText.d.ts","sourceRoot":"","sources":["../../src/helpers/markdownText.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AA0GjD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UAAW,OAAO,KAAG,MAiCpD,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,eAAe,UAAW,OAAO,KAAG,MACO,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,SAS9C,CAAC"}