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

package/dist/components/form/expressions/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,EAAE,WAGpC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC;IACvB,sBAAsB,CAAC,EAAE,GAAG,EAAE,CAAC;IAC/B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,WAAW,EAAE,0BAA0B,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,EAAE,oBAAoB,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAED,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEzF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,yBAAyB,EAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,EAAE,WAGpC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC;IACvB,sBAAsB,CAAC,EAAE,GAAG,EAAE,CAAC;IAC/B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,WAAW,EAAE,0BAA0B,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,EAAE,oBAAoB,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,iGAAiG;AACjG,eAAO,MAAM,mBAAmB,WAAY,KAAK,iBAAiB,EAAE,UAAU,CAAC,KAAG,OACxD,CAAC;AAE3B,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEzF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,yBAAyB,EAAE,CAAC"}

package/dist/components/form/expressions/types.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpressionDefaultValue = void 0;
+exports.isOfferedForPicking = exports.ExpressionDefaultValue = void 0;
 /** The seed value for a fresh expression. */
 exports.ExpressionDefaultValue = {
     value: { args: [] },
     is_expression: true,
 };
+/** Whether a catalogue entry is offered in the operation pickers: any not flagged `internal`. */
+var isOfferedForPicking = function (schema) {
+    return schema.internal !== true;
+};
+exports.isOfferedForPicking = isOfferedForPicking;
 //# sourceMappingURL=types.js.map

package/dist/components/form/expressions/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/form/expressions/types.ts"],"names":[],"mappings":";;;AA0BA,6CAA6C;AAChC,QAAA,sBAAsB,GAAgB;IACjD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IACnB,aAAa,EAAE,IAAI;CACpB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/form/expressions/types.ts"],"names":[],"mappings":";;;AA0BA,6CAA6C;AAChC,QAAA,sBAAsB,GAAgB;IACjD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IACnB,aAAa,EAAE,IAAI;CACpB,CAAC;AA4EF,iGAAiG;AAC1F,IAAM,mBAAmB,GAAG,UAAC,MAA2C;IAC7E,OAAA,MAAM,CAAC,QAAQ,KAAK,IAAI;AAAxB,CAAwB,CAAC;AADd,QAAA,mBAAmB,uBACL"}

package/dist/components/form/expressions/useExpressionType.d.ts

@@ -0,0 +1,26 @@
+import { IExpressionValue } from './types';
+/** The type an expression gives, as the server names it. */
+export interface IExpressionType {
+    /** The type's name, as `dpql/parse` gives it (`float`, `*int`, `hash<auto>`); `auto` when not known. */
+    inferred_type: string;
+    /** The type as the UI names it, as the catalogue's `ui_return_type` does (`number`, `richtext`, `any`). */
+    ui_type: string;
+    /** `true` when the type is known before the expression is evaluated. */
+    known: boolean;
+}
+/**
+ * The type the server gave for an expression, if it has given it — for the
+ * readers that cannot wait (an argument's label, the check of the arguments
+ * that are kept when the operation changes). `undefined` when not known yet.
+ */
+export declare const getCachedExpressionType: (value: IExpressionValue | undefined) => IExpressionType | undefined;
+/** Asks the server for an expression's type; `null` when it cannot say. */
+export declare const fetchExpressionType: (value: IExpressionValue) => Promise<IExpressionType | null>;
+/** @internal Test hook — drop the module-level client, the cache and the health state. */
+export declare const _resetExpressionTypeTransportForTests: () => void;
+/**
+ * The type an expression gives, from the server; `undefined` until the server
+ * has answered, and when it cannot say.
+ */
+export declare const useExpressionType: (value: IExpressionValue | undefined) => IExpressionType | undefined;
+//# sourceMappingURL=useExpressionType.d.ts.map

package/dist/components/form/expressions/useExpressionType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExpressionType.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/useExpressionType.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAK3C,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,wGAAwG;IACxG,aAAa,EAAE,MAAM,CAAC;IACtB,2GAA2G;IAC3G,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;CAChB;AAsBD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,UAC3B,gBAAgB,GAAG,SAAS,KAClC,eAAe,GAAG,SAAsE,CAAC;AAE5F,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,UACvB,gBAAgB,KACtB,QAAQ,eAAe,GAAG,IAAI,CAgChC,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,qCAAqC,QAAO,IAKxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,UACrB,gBAAgB,GAAG,SAAS,KAClC,eAAe,GAAG,SAiCpB,CAAC"}

package/dist/components/form/expressions/useExpressionType.js

@@ -0,0 +1,181 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useExpressionType = exports._resetExpressionTypeTransportForTests = exports.fetchExpressionType = exports.getCachedExpressionType = void 0;
+// Copyright 2026 Qore Technologies, s.r.o.
+// The type an expression gives, as the server works it out.
+//
+// An expression has one type everywhere in Qorus (qoretechnologies/qorus#713):
+// the server's expression type rules decide it for DPQL validation, the
+// language server, evaluation and the editors alike. The builder used to work
+// out its own type from the catalogue's `ui_return_type` one level deep, which
+// disagreed with the server (`1 + 2.5` was "any" here and a float there), so it
+// now asks the server, over the LSP custom method `dpql/expressionType` (next
+// to `dpql/renderExpression` in `QorusLspWebSocketHandler.qc`), on the same
+// shared connection as the rendering.
+//
+// There is no client-side stand-in: until the server answers, or when it
+// cannot (it predates the method, or the connection gave up), the type is not
+// known and nothing is judged by it.
+var nanoid_1 = require("nanoid");
+var react_1 = require("react");
+var lspClient_1 = require("../../../utils/lspClient");
+/** Coalesce rapid changes per consumer (live editing) — trailing edge. */
+var TYPE_DEBOUNCE_MS = 300;
+var typeClient = null;
+/** Set after a `-32601 method not found` — the server predates the method. */
+var methodUnsupported = false;
+/** The types the server gave, by the expression's JSON, for the synchronous readers. */
+var typeCache = new Map();
+var getTypeClient = function () {
+    if (!typeClient) {
+        typeClient = new lspClient_1.ReqraftLspClient({
+            languageId: 'dpql',
+            // Opaque per-load URI; `dpql/expressionType` is stateless (no `didOpen`
+            // needed), the URI only identifies the client locally.
+            uri: "inmemory://reqraft/expression-type/".concat((0, nanoid_1.nanoid)()),
+        });
+    }
+    return typeClient;
+};
+var cacheKey = function (value) { return JSON.stringify(value); };
+/**
+ * The type the server gave for an expression, if it has given it — for the
+ * readers that cannot wait (an argument's label, the check of the arguments
+ * that are kept when the operation changes). `undefined` when not known yet.
+ */
+var getCachedExpressionType = function (value) { return ((value === null || value === void 0 ? void 0 : value.exp) ? typeCache.get(cacheKey(value)) : undefined); };
+exports.getCachedExpressionType = getCachedExpressionType;
+/** Asks the server for an expression's type; `null` when it cannot say. */
+var fetchExpressionType = function (value) { return __awaiter(void 0, void 0, void 0, function () {
+    var key, cached, client, result, type, err_1;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                if (!(value === null || value === void 0 ? void 0 : value.exp) || methodUnsupported)
+                    return [2 /*return*/, null];
+                key = cacheKey(value);
+                cached = typeCache.get(key);
+                if (cached)
+                    return [2 /*return*/, cached];
+                client = getTypeClient();
+                _a.label = 1;
+            case 1:
+                _a.trys.push([1, 4, , 5]);
+                // Waits as long as the connection does: it has its own reconnect schedule
+                // and rejects once it gives up, so this never outlives a dead socket.
+                return [4 /*yield*/, client.connect()];
+            case 2:
+                // Waits as long as the connection does: it has its own reconnect schedule
+                // and rejects once it gives up, so this never outlives a dead socket.
+                _a.sent();
+                return [4 /*yield*/, client.customRequest('dpql/expressionType', {
+                        // The server accepts both the bare `{exp, args}` AST and the
+                        // `{is_expression, value}` wrapper, as `dpql/renderExpression` does.
+                        expression: value,
+                    })];
+            case 3:
+                result = _a.sent();
+                if (typeof (result === null || result === void 0 ? void 0 : result.inferred_type) !== 'string' || typeof (result === null || result === void 0 ? void 0 : result.ui_type) !== 'string') {
+                    return [2 /*return*/, null];
+                }
+                type = {
+                    inferred_type: result.inferred_type,
+                    ui_type: result.ui_type,
+                    known: !!result.known,
+                };
+                typeCache.set(key, type);
+                return [2 /*return*/, type];
+            case 4:
+                err_1 = _a.sent();
+                // `ReqraftLspClient` rejections are `Error('<code>: <message>')`.
+                if (err_1 instanceof Error && err_1.message.startsWith('-32601')) {
+                    methodUnsupported = true;
+                }
+                return [2 /*return*/, null];
+            case 5: return [2 /*return*/];
+        }
+    });
+}); };
+exports.fetchExpressionType = fetchExpressionType;
+/** @internal Test hook — drop the module-level client, the cache and the health state. */
+var _resetExpressionTypeTransportForTests = function () {
+    typeClient === null || typeClient === void 0 ? void 0 : typeClient.disconnect();
+    typeClient = null;
+    methodUnsupported = false;
+    typeCache.clear();
+};
+exports._resetExpressionTypeTransportForTests = _resetExpressionTypeTransportForTests;
+/**
+ * The type an expression gives, from the server; `undefined` until the server
+ * has answered, and when it cannot say.
+ */
+var useExpressionType = function (value) {
+    var key = (value === null || value === void 0 ? void 0 : value.exp) ? cacheKey(value) : undefined;
+    var _a = (0, react_1.useState)(function () {
+        return (0, exports.getCachedExpressionType)(value);
+    }), type = _a[0], setType = _a[1];
+    (0, react_1.useEffect)(function () {
+        if (!key) {
+            setType(undefined);
+            return undefined;
+        }
+        var cached = typeCache.get(key);
+        if (cached) {
+            setType(cached);
+            return undefined;
+        }
+        // the type of the previous expression is not this one's
+        setType(undefined);
+        var current = true;
+        var timer = setTimeout(function () {
+            void (0, exports.fetchExpressionType)(JSON.parse(key)).then(function (served) {
+                if (current) {
+                    setType(served !== null && served !== void 0 ? served : undefined);
+                }
+            });
+        }, TYPE_DEBOUNCE_MS);
+        return function () {
+            current = false;
+            clearTimeout(timer);
+        };
+    }, [key]);
+    return type;
+};
+exports.useExpressionType = useExpressionType;
+//# sourceMappingURL=useExpressionType.js.map

package/dist/components/form/expressions/useExpressionType.js.map

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

package/dist/components/form/expressions/useRenderExpression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRenderExpression.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/useRenderExpression.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAqBlE,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AA2BD,gFAAgF;AAChF,eAAO,MAAM,uCAAuC,QAAO,IAI1D,CAAC;AAOF,MAAM,WAAW,0BAA0B;IACzC,4FAA4F;IAC5F,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5D;;;;OAIG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CAC9E;AAED,eAAO,MAAM,mBAAmB,QAAO,0BA2DtC,CAAC"}
+{"version":3,"file":"useRenderExpression.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/useRenderExpression.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAM3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAqBlE,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAgCD,gFAAgF;AAChF,eAAO,MAAM,uCAAuC,QAAO,IAI1D,CAAC;AAOF,MAAM,WAAW,0BAA0B;IACzC,4FAA4F;IAC5F,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5D;;;;OAIG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CAC9E;AAED,eAAO,MAAM,mBAAmB,QAAO,0BAkEtC,CAAC"}

package/dist/components/form/expressions/useRenderExpression.js

@@ -67,6 +67,8 @@ exports.useRenderExpression = exports._resetRenderExpressionTransportForTests =
 var nanoid_1 = require("nanoid");
 var react_1 = require("react");
 var lspClient_1 = require("../../../utils/lspClient");
+var expressionOperands_1 = require("./expressionOperands");
+var fieldPath_1 = require("./fieldPath");
 /* The synchronous summary a collapsed row prints — see `readFirst.ts`. It is
    not a stand-in for this rendering and is never shown in its place. */
 var renderExpressionToText_1 = require("./renderExpressionToText");
@@ -88,11 +90,14 @@ var getRenderClient = function () {
     return renderClient;
 };
 var renderViaServer = function (value) { return __awaiter(void 0, void 0, void 0, function () {
-    var client, result, err_1;
+    var path, client, result, err_1;
     var _a;
     return __generator(this, function (_b) {
         switch (_b.label) {
             case 0:
+                path = (0, fieldPath_1.fieldPathOf)(value);
+                if (path !== undefined)
+                    return [2 /*return*/, { text: (0, fieldPath_1.fieldPathTemplate)(path), richtext: null }];
                 if (methodUnsupported)
                     return [2 /*return*/, null];
                 client = getRenderClient();
@@ -109,7 +114,7 @@ var renderViaServer = function (value) { return __awaiter(void 0, void 0, void 0
                 return [4 /*yield*/, client.customRequest('dpql/renderExpression', 
                     // The server accepts both the bare `{exp, args}` AST and the
                     // `{is_expression, value}` wrapper; consumers pass the bare AST.
-                    { expression: value })];
+                    { expression: (0, fieldPath_1.withFieldPathsAsReferences)(value) })];
             case 3:
                 result = _b.sent();
                 return [2 /*return*/, typeof (result === null || result === void 0 ? void 0 : result.rendered) === 'string'
@@ -158,23 +163,22 @@ var useRenderExpression = function () {
             };
             var run = function () { return __awaiter(void 0, void 0, void 0, function () {
                 var job, outcome, _a;
-                var _b;
-                return __generator(this, function (_c) {
-                    switch (_c.label) {
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
                         case 0:
                             job = pendingRef.current;
                             pendingRef.current = null;
                             if (!job)
                                 return [2 /*return*/];
                             lastRunRef.current = Date.now();
-                            if (!((_b = job.value) === null || _b === void 0 ? void 0 : _b.exp)) return [3 /*break*/, 2];
-                            return [4 /*yield*/, renderViaServer(job.value)];
+                            if (!(0, expressionOperands_1.isExpressionComplete)(job.value)) return [3 /*break*/, 2];
+                            return [4 /*yield*/, renderViaServer((0, expressionOperands_1.expressionWithOperands)(job.value))];
                         case 1:
-                            _a = _c.sent();
+                            _a = _b.sent();
                             return [3 /*break*/, 3];
                         case 2:
                             _a = null;
-                            _c.label = 3;
+                            _b.label = 3;
                         case 3:
                             outcome = _a;
                             job.resolvers.forEach(function (r) { return r(outcome); });

package/dist/components/form/expressions/useRenderExpression.js.map

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

package/dist/components/form/expressions/wildcardExpressions.d.ts

@@ -0,0 +1,27 @@
+import { IExpressionSchema } from './types';
+export declare const WILDCARD_EXPRESSIONS: IExpressionSchema[];
+/** `@orders[*].id`, as the server parses it. */
+export declare const ORDER_IDS: {
+    is_expression: boolean;
+    value: {
+        exp: string;
+        args: unknown[];
+    };
+};
+/** `@prices{*}`, as the server parses it. */
+export declare const PRICES: {
+    is_expression: boolean;
+    value: {
+        exp: string;
+        args: unknown[];
+    };
+};
+/** `size(@orders[*].id) + size(@prices{*})`. */
+export declare const COUNTED_WILDCARDS: {
+    is_expression: boolean;
+    value: {
+        exp: string;
+        args: unknown[];
+    };
+};
+//# sourceMappingURL=wildcardExpressions.d.ts.map

package/dist/components/form/expressions/wildcardExpressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildcardExpressions.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/wildcardExpressions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAU5C,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAyEnD,CAAC;AAQF,gDAAgD;AAChD,eAAO,MAAM,SAAS;;;;;;CAA2D,CAAC;AAClF,6CAA6C;AAC7C,eAAO,MAAM,MAAM;;;;;;CAA8D,CAAC;AAClF,gDAAgD;AAChD,eAAO,MAAM,iBAAiB;;;;;;CAI7B,CAAC"}

package/dist/components/form/expressions/wildcardExpressions.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COUNTED_WILDCARDS = exports.PRICES = exports.ORDER_IDS = exports.WILDCARD_EXPRESSIONS = void 0;
+var anyArg = function (display_name, short_desc) { return ({
+    name: 'any',
+    display_name: display_name,
+    short_desc: short_desc,
+    ui_type: 'any',
+    required: true,
+}); };
+exports.WILDCARD_EXPRESSIONS = [
+    {
+        name: 'size',
+        display_name: 'Size',
+        short_desc: 'Returns the number of elements in a list or hash',
+        desc: 'Returns the number of elements in a list, the number of keys in a hash, or the length of a string',
+        symbol: 'size',
+        type: 2,
+        subtype: 1,
+        role: 3,
+        return_type: 'int',
+        ui_return_type: 'int',
+        varargs: false,
+        groups: ['List'],
+        args: [anyArg('Value', 'The list, hash or string to measure')],
+    },
+    {
+        name: 'list_wildcard',
+        display_name: 'list wildcard ([*])',
+        short_desc: 'Applies the accessors after [*] to each item of a list, returning a new list',
+        desc: 'Written `source[*]` followed by accessors, such as `@orders[*].id`',
+        symbol: '[*]',
+        render_template: '$arg[0][*] $arg[1]',
+        type: 1,
+        subtype: 1,
+        role: 3,
+        return_type: 'list',
+        ui_return_type: 'list',
+        varargs: false,
+        groups: ['Data Manipulation'],
+        args: [
+            anyArg('Source', 'The list to iterate over'),
+            anyArg('Item Expression', 'The accessors evaluated for each item'),
+        ],
+    },
+    {
+        name: 'hash_wildcard',
+        display_name: 'hash wildcard ({*})',
+        short_desc: 'Applies the accessors after {*} to each value of a hash, returning a new list',
+        desc: 'Written `source{*}` followed by accessors, such as `@prices{*}.amount`',
+        symbol: '{*}',
+        render_template: '$arg[0]{*} $arg[1]',
+        type: 1,
+        subtype: 1,
+        role: 3,
+        return_type: 'list',
+        ui_return_type: 'list',
+        varargs: false,
+        groups: ['Data Manipulation'],
+        args: [
+            anyArg('Source', 'The hash to iterate over'),
+            anyArg('Value Expression', 'The accessors evaluated for each value'),
+        ],
+    },
+    {
+        name: 'wildcard_item',
+        display_name: 'wildcard item',
+        short_desc: 'The item of the enclosing [*] wildcard',
+        desc: 'The item that the accessors after `[*]` are applied to when they do not start with a field; it is only ' +
+            'valid in a list wildcard and is not written in DPQL',
+        symbol: '',
+        type: 1,
+        subtype: 1,
+        role: 3,
+        return_type: 'any',
+        ui_return_type: 'any',
+        varargs: false,
+        groups: ['Data Manipulation'],
+        args: [],
+        // the server's flag: drawn only inside a wildcard, never offered for picking
+        internal: true,
+    },
+];
+var field = function (name) { return ({ type: 'auto', value: "$record:{".concat(name, "}") }); };
+var operation = function (exp) {
+    var args = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args[_i - 1] = arguments[_i];
+    }
+    return ({
+        is_expression: true,
+        value: { exp: exp, args: args },
+    });
+};
+/** `@orders[*].id`, as the server parses it. */
+exports.ORDER_IDS = operation('list_wildcard', field('orders'), field('id'));
+/** `@prices{*}`, as the server parses it. */
+exports.PRICES = operation('hash_wildcard', field('prices'), field('value'));
+/** `size(@orders[*].id) + size(@prices{*})`. */
+exports.COUNTED_WILDCARDS = operation('+', operation('size', exports.ORDER_IDS), operation('size', exports.PRICES));
+//# sourceMappingURL=wildcardExpressions.js.map

package/dist/components/form/expressions/wildcardExpressions.js.map

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

package/dist/components/form/fields/Field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../../../src/components/form/fields/Field.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAIlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAE7E,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAK/G,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAc1E,OAAO,EAIL,gCAAgC,EAChC,iCAAiC,EAElC,MAAM,2BAA2B,CAAC;AA0CnC,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,qFAAqF;IACrF,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC;IACnC,wDAAwD;IACxD,OAAO,CAAC,EAAE,iCAAiC,CAAC;IAC5C,sFAAsF;IACtF,aAAa,CAAC,EAAE,gCAAgC,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,IAAI,CACtF,yBAAyB,EACzB,OAAO,GAAG,eAAe,GAAG,YAAY,GAAG,cAAc,GAAG,iBAAiB,CAC9E,EAAE,eAAe;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAEnE,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAE9C,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvC,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9C,gCAAgC,CAAC,EAAE,OAAO,CAAC;IAE3C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,KAAK,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrD;AAED,eAAO,MAAM,SAAS,gTAwBnB,gBAAgB,CAAC,CAAC,4CAmkBpB,CAAC"}
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../../../src/components/form/fields/Field.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAIlB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAE7E,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAQ/G,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAc1E,OAAO,EAIL,gCAAgC,EAChC,iCAAiC,EAElC,MAAM,2BAA2B,CAAC;AA0CnC,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,qFAAqF;IACrF,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC;IACnC,wDAAwD;IACxD,OAAO,CAAC,EAAE,iCAAiC,CAAC;IAC5C,sFAAsF;IACtF,aAAa,CAAC,EAAE,gCAAgC,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,IAAI,CACtF,yBAAyB,EACzB,OAAO,GAAG,eAAe,GAAG,YAAY,GAAG,cAAc,GAAG,iBAAiB,CAC9E,EAAE,eAAe;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAEnE,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAE9C,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvC,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9C,gCAAgC,CAAC,EAAE,OAAO,CAAC;IAE3C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,KAAK,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrD;AAED,eAAO,MAAM,SAAS,gTAwBnB,gBAAgB,CAAC,CAAC,4CAolBpB,CAAC"}

package/dist/components/form/fields/Field.js

@@ -39,7 +39,10 @@ var jsx_runtime_1 = require("react/jsx-runtime");
 var reqore_1 = require("@qoretechnologies/reqore");
 var lodash_1 = require("lodash");
 var react_1 = require("react");
+var useReadableOpacity_1 = require("../../../hooks/useReadableOpacity");
 var common_1 = require("../../../helpers/common");
+var descriptionTooltip_1 = require("../../../helpers/descriptionTooltip");
+var describedControl_1 = require("../../Description/describedControl");
 var useArgSchema_1 = require("../../../hooks/useArgSchema");
 var Boolean_1 = __importDefault(require("./boolean/Boolean"));
 var Color_1 = __importDefault(require("./color/Color"));
@@ -111,8 +114,16 @@ var FormField = function (_a) {
     tags = _a.tags, // eslint-disable-line @typescript-eslint/no-unused-vars
     options = _a.options, // eslint-disable-line @typescript-eslint/no-unused-vars
     rest = __rest(_a, ["type", "onChange", "value", "fieldProps", "label", "labelPosition", "allowed_values", "allowed_values_creatable", "arg_schema", "element_type", "ui_element_type", "element_allowed_values", "element_allowed_values_creatable", "name", "display_name", "readonly", "size", "tags", "options"]);
+    // an item that cannot be picked is dimmed, as far as its name still reads (qorus#646)
+    var unavailableOpacity = (0, useReadableOpacity_1.useReadableOpacity)(0.55);
     var id = (0, react_1.useId)();
     var _c = (0, useArgSchema_1.useArgSchema)(arg_schema), finalArgSchema = _c.schema, argSchemaLoading = _c.loading;
+    // a choice's description card: drawn as markdown, opened by a tap on touch (`descriptionTooltip`)
+    var descriptions = (0, descriptionTooltip_1.useDescriptionTooltips)();
+    /* The size of a field's few choices, each a checkbox with its ⓘ beside it on a touch screen: `tiny` for a mouse,
+       and at least Reqore's `small` for a finger, which `tiny` is too small to hit (BRAND_DESIGN §5). The ⓘ takes the
+       group's size, so a choice and its ⓘ are always one size. */
+    var choiceSize = descriptions.tapToOpen ? 'small' : 'tiny';
     var handleChange = function (value, event) {
         onChange(value, event);
     };
@@ -153,9 +164,9 @@ var FormField = function (_a) {
                         handleChange(value);
                     }, id: id })));
             case 'rgbcolor':
-                return ((0, jsx_runtime_1.jsx)(Color_1.default, __assign({}, rest, fieldProps, { value: value, onChange: function (color) {
+                return ((0, jsx_runtime_1.jsx)(Color_1.default, __assign({}, fieldProps, { value: value, onChange: function (color) {
                         handleChange(color);
-                    } })));
+                    }, disabled: rest.disabled, readOnly: readonly })));
             case 'long-string':
             case 'binary':
                 return ((0, jsx_runtime_1.jsx)(LongString_1.default, __assign({}, rest, fieldProps, { value: value, onChange: function (selected) {
@@ -221,16 +232,19 @@ var FormField = function (_a) {
                     };
                     var serverValue_1 = formatFromServer(value || []);
                     if (element_allowed_values.length <= 3) {
-                        return ((0, jsx_runtime_1.jsx)(reqore_1.ReqoreControlGroup, { vertical: true, size: 'tiny', children: element_allowed_values.map(function (item, index) {
+                        return ((0, jsx_runtime_1.jsx)(reqore_1.ReqoreControlGroup, { vertical: true, size: choiceSize, children: element_allowed_values.map(function (item, index) {
                                 var _a, _b;
                                 var itemValue = (_a = item.value) === null || _a === void 0 ? void 0 : _a.value;
                                 var checked = serverValue_1.some(function (v) { return (0, lodash_1.isEqual)(v, itemValue); });
-                                return ((0, jsx_runtime_1.jsx)(reqore_1.ReqoreCheckbox, { margin: 'right', label: (_b = item.display_name) !== null && _b !== void 0 ? _b : String(itemValue), tooltip: item.short_desc || item.desc, checked: checked, intent: checked ? 'info' : undefined, onClick: function () {
+                                var label = (_b = item.display_name) !== null && _b !== void 0 ? _b : String(itemValue);
+                                // with a mouse, the hover; on a touch screen, an ⓘ beside the box, whose tap only ticks it
+                                var described = (0, describedControl_1.describedControl)(item.short_desc || item.desc, descriptions, label);
+                                return (0, describedControl_1.besideItsInfo)((0, jsx_runtime_1.jsx)(reqore_1.ReqoreCheckbox, { margin: 'right', label: label, tooltip: described.tooltip, checked: checked, intent: checked ? 'info' : undefined, onClick: function () {
                                         var next = checked ?
                                             serverValue_1.filter(function (v) { return !(0, lodash_1.isEqual)(v, itemValue); })
                                             : __spreadArray(__spreadArray([], serverValue_1, true), [itemValue], false);
                                         handleChange(formatToServer_1(next));
-                                    } }, index));
+                                    } }), described.info, index);
                             }) }));
                     }
                     return ((0, jsx_runtime_1.jsx)(MultiSelectFormField_1.MultiSelectFormField, { items: element_allowed_values, value: serverValue_1, onChange: function (selected) {
@@ -333,13 +347,16 @@ var FormField = function (_a) {
         }
         // Non-creatable ≤3: checkboxes that track the current value
         if (allowed_values.length <= 3) {
-            return ((0, jsx_runtime_1.jsxs)(reqore_1.ReqoreControlGroup, { vertical: true, size: 'tiny', children: [(0, jsx_runtime_1.jsx)(reqore_1.ReqoreSpan, { effect: { opacity: 0.6, uppercase: true, weight: 'bold' }, size: 'tiny', children: display_name ? "".concat(display_name, ":") : 'Select one:' }), allowed_values.map(function (item, index) {
+            return ((0, jsx_runtime_1.jsxs)(reqore_1.ReqoreControlGroup, { vertical: true, size: choiceSize, children: [(0, jsx_runtime_1.jsx)(reqore_1.ReqoreSpan, { effect: { opacity: 0.6, uppercase: true, weight: 'bold' }, size: 'tiny', children: display_name ? "".concat(display_name, ":") : 'Select one:' }), allowed_values.map(function (item, index) {
                         var _a, _b;
                         var itemValue = (_a = item.value) === null || _a === void 0 ? void 0 : _a.value;
                         var checked = (0, lodash_1.isEqual)(value, itemValue);
                         var mapped = mapAllowedValue(item, index);
                         var unavailable = (0, SelectCollection_1.getSelectItemUnavailability)(mapped);
-                        return ((0, jsx_runtime_1.jsx)(reqore_1.ReqoreCheckbox, { margin: 'right', label: (_b = item.display_name) !== null && _b !== void 0 ? _b : JSON.stringify(itemValue), tooltip: (0, SelectCollection_1.getSelectItemShortDescription)(mapped), 
+                        var label = (_b = item.display_name) !== null && _b !== void 0 ? _b : JSON.stringify(itemValue);
+                        // with a mouse, the hover; on a touch screen, an ⓘ beside the box, whose tap only ticks it
+                        var described = (0, describedControl_1.describedControl)((0, SelectCollection_1.getSelectItemShortDescription)(mapped), descriptions, label);
+                        return (0, describedControl_1.besideItsInfo)((0, jsx_runtime_1.jsx)(reqore_1.ReqoreCheckbox, { margin: 'right', label: label, tooltip: described.tooltip, 
                             /* The reason is IN the row, not only on its hover: a checkbox
                                has no body to bury it in, and a hover is the one affordance
                                a touch screen and a keyboard never reach. */
@@ -356,13 +373,13 @@ var FormField = function (_a) {
                                never appeared at all. And the NAME is the right thing to
                                dim: `description` carries the reason, and a reason has to
                                stay readable. Same rule the collection rows follow. */
-                            labelEffect: unavailable ? { opacity: 0.55 } : undefined, 
+                            labelEffect: unavailable ? { opacity: unavailableOpacity } : undefined, 
                             /* `cursor: not-allowed` from reqore's own `ReadOnlyElement`
                                rather than a hand-rolled inline style. It leaves the
                                pointer events intact, which is what the tooltip is read
                                through; it does NOT withhold `onClick`, but this row
                                already withholds it below, so it is purely additive. */
-                            readOnly: !!unavailable, uncheckedIcon: unavailable ? 'LockLine' : undefined, checked: checked, intent: checked ? 'info' : undefined, onClick: unavailable ? undefined : (function () { return handleChange((checked ? undefined : itemValue)); }) }, index));
+                            readOnly: !!unavailable, uncheckedIcon: unavailable ? 'LockLine' : undefined, checked: checked, intent: checked ? 'info' : undefined, onClick: unavailable ? undefined : (function () { return handleChange((checked ? undefined : itemValue)); }) }), described.info, index);
                     })] }));
         }
         // Non-creatable >3: dropdown that tracks the current value