@qoretechnologies/reqraft 0.10.53 → 0.10.54-pr.115.g9bc96ed

package/dist/components/form/engine/rowMenuContext.d.ts

@@ -0,0 +1,78 @@
+/// <reference types="react" />
+import { IReqoreDropdownItem } from '@qoretechnologies/reqore/dist/components/Dropdown/list';
+/**
+ * SEAM (reqraft): an editor publishes its own actions into the row's ⋮ menu.
+ *
+ * A row already renders one overflow menu — Edit fullscreen, Remove field, and
+ * any `optionActions` the host injected — and the comment on it has always said
+ * why: *"this row already has a menu, so they reuse it rather than adding a
+ * second one beside it."* An EDITOR could not reach that menu, so an editor
+ * with affordances of its own had no choice but to draw a second ⋮ inside the
+ * value cell. The IDE's template field does exactly that, and the two menus
+ * ended up side by side on one control, at slightly different widths.
+ *
+ * `optionActions` does not solve it: that seam is host configuration, resolved
+ * from the option's name and schema before the editor exists, so it cannot know
+ * what the editor can offer *now* — whether its templates have loaded, whether
+ * the value is already an expression, which custom items the field was given.
+ *
+ * ## Why registration is keyed, and by whom
+ *
+ * Menu items carry `onClick` handlers, so they are a new array on every render
+ * and cannot be compared by value. An editor therefore publishes a `key`
+ * alongside them: a primitive describing WHICH items it is currently offering
+ * (`'expression,template'`). The row re-renders only when a publisher's key
+ * changes, so a re-rendering editor cannot drive the row into a state loop.
+ *
+ * Each registration also belongs to ONE publisher. A single shared slot let
+ * two publishers in the same row — an expression builder's operands — overwrite
+ * each other's key on every render, which re-rendered the row and both of them,
+ * which published again: a synchronous render loop that froze the page. And a
+ * slot that outlived its editor kept that editor's handlers after it unmounted,
+ * so a row closed and reopened offered items that did nothing. Registrations
+ * are therefore per publisher, withdrawn on unmount, and a click always reaches
+ * the handler from the publisher's latest render.
+ *
+ * Publish with `useRowMenuPublisher`; provide with `useRowMenuRegistry`.
+ */
+export interface IRowMenuRegistration {
+    /**
+     * Publish a publisher's menu items into the containing row's ⋮.
+     *
+     * @param publisherId identifies the publishing editor (one per mounted editor)
+     * @param key a primitive describing which items are being offered; the row
+     * re-renders only when it changes
+     * @param items the items to merge, or an empty array to contribute none
+     */
+    registerRowMenuItems: (publisherId: string, key: string, items: IReqoreDropdownItem[]) => void;
+    /** Withdraw a publisher's items — when it unmounts or leaves the row. */
+    unregisterRowMenuItems: (publisherId: string) => void;
+}
+/**
+ * Absent outside a compact row — the classic (non-compact) render path has no
+ * row menu to merge into, and an editor there keeps drawing its own control.
+ */
+export declare const RowMenuContext: import("react").Context<IRowMenuRegistration>;
+/**
+ * The row-menu channel for the row this editor is inside, or `undefined` when
+ * there is no row menu to publish into.
+ *
+ * An editor that finds it should render no menu of its own; one that does not
+ * must keep rendering its own, or its actions become unreachable.
+ */
+export declare const useRowMenu: () => IRowMenuRegistration | undefined;
+/**
+ * Publish `items` into `rowMenu` for as long as the calling editor is mounted.
+ * `rowMenu` is passed rather than read here so an editor can claim the channel
+ * and hide it from what it renders (see `TemplateField`).
+ */
+export declare const useRowMenuPublisher: (rowMenu: IRowMenuRegistration | undefined, key: string, items: IReqoreDropdownItem[]) => void;
+/**
+ * The row side of the channel: the registration to provide, and the items the
+ * row's ⋮ should list.
+ */
+export declare const useRowMenuRegistry: () => {
+    rowMenu: IRowMenuRegistration;
+    items: IReqoreDropdownItem[];
+};
+//# sourceMappingURL=rowMenuContext.d.ts.map

package/dist/components/form/engine/rowMenuContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowMenuContext.d.ts","sourceRoot":"","sources":["../../../../src/components/form/engine/rowMenuContext.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAY7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,oBAAoB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IAC/F,yEAAyE;IACzE,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,+CAA6D,CAAC;AAEzF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,QAAO,oBAAoB,GAAG,SAAuC,CAAC;AAE7F;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,YACrB,oBAAoB,GAAG,SAAS,OACpC,MAAM,SACJ,mBAAmB,EAAE,KAC3B,IAQF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO;IACpC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAwD9B,CAAC"}

package/dist/components/form/engine/rowMenuContext.js

@@ -0,0 +1,103 @@
+"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);
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRowMenuRegistry = exports.useRowMenuPublisher = exports.useRowMenu = exports.RowMenuContext = void 0;
+var react_1 = require("react");
+/**
+ * Absent outside a compact row — the classic (non-compact) render path has no
+ * row menu to merge into, and an editor there keeps drawing its own control.
+ */
+exports.RowMenuContext = (0, react_1.createContext)(undefined);
+/**
+ * The row-menu channel for the row this editor is inside, or `undefined` when
+ * there is no row menu to publish into.
+ *
+ * An editor that finds it should render no menu of its own; one that does not
+ * must keep rendering its own, or its actions become unreachable.
+ */
+var useRowMenu = function () { return (0, react_1.useContext)(exports.RowMenuContext); };
+exports.useRowMenu = useRowMenu;
+/**
+ * Publish `items` into `rowMenu` for as long as the calling editor is mounted.
+ * `rowMenu` is passed rather than read here so an editor can claim the channel
+ * and hide it from what it renders (see `TemplateField`).
+ */
+var useRowMenuPublisher = function (rowMenu, key, items) {
+    var publisherId = (0, react_1.useId)();
+    (0, react_1.useEffect)(function () {
+        rowMenu === null || rowMenu === void 0 ? void 0 : rowMenu.registerRowMenuItems(publisherId, key, items);
+    }, [rowMenu, publisherId, key, items]);
+    (0, react_1.useEffect)(function () { return function () { return rowMenu === null || rowMenu === void 0 ? void 0 : rowMenu.unregisterRowMenuItems(publisherId); }; }, [rowMenu, publisherId]);
+};
+exports.useRowMenuPublisher = useRowMenuPublisher;
+/**
+ * The row side of the channel: the registration to provide, and the items the
+ * row's ⋮ should list.
+ */
+var useRowMenuRegistry = function () {
+    // Which publishers are offering which item SET — the only state, so only a
+    // change of set re-renders the row.
+    var _a = (0, react_1.useState)({}), keys = _a[0], setKeys = _a[1];
+    // Each publisher's items from its latest render, read at click time.
+    var latest = (0, react_1.useRef)({});
+    var registerRowMenuItems = (0, react_1.useCallback)(function (publisherId, key, items) {
+        latest.current[publisherId] = items;
+        setKeys(function (previous) {
+            var _a;
+            return previous[publisherId] === key ? previous : __assign(__assign({}, previous), (_a = {}, _a[publisherId] = key, _a));
+        });
+    }, []);
+    var unregisterRowMenuItems = (0, react_1.useCallback)(function (publisherId) {
+        delete latest.current[publisherId];
+        setKeys(function (previous) {
+            if (!(publisherId in previous)) {
+                return previous;
+            }
+            var next = __assign({}, previous);
+            delete next[publisherId];
+            return next;
+        });
+    }, []);
+    var rowMenu = (0, react_1.useMemo)(function () { return ({ registerRowMenuItems: registerRowMenuItems, unregisterRowMenuItems: unregisterRowMenuItems }); }, [registerRowMenuItems, unregisterRowMenuItems]);
+    var items = (0, react_1.useMemo)(function () {
+        return Object.keys(keys).flatMap(function (publisherId) {
+            var _a;
+            return ((_a = latest.current[publisherId]) !== null && _a !== void 0 ? _a : []).map(function (item, index) {
+                return item.onClick
+                    ? __assign(__assign({}, item), { 
+                        // Same key, same item set, so the index still names this item;
+                        // the handler is whatever the publisher rendered last.
+                        onClick: (function () {
+                            var _a, _b, _c;
+                            var args = [];
+                            for (var _i = 0; _i < arguments.length; _i++) {
+                                args[_i] = arguments[_i];
+                            }
+                            return (_c = (_b = (_a = latest.current[publisherId]) === null || _a === void 0 ? void 0 : _a[index]) === null || _b === void 0 ? void 0 : _b.onClick) === null || _c === void 0 ? void 0 : _c.call.apply(_c, __spreadArray([_b], args, false));
+                        }) }) : item;
+            });
+        });
+    }, [keys]);
+    return { rowMenu: rowMenu, items: items };
+};
+exports.useRowMenuRegistry = useRowMenuRegistry;
+//# sourceMappingURL=rowMenuContext.js.map

package/dist/components/form/engine/rowMenuContext.js.map

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

package/dist/components/form/engine/typeChoices.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Which options offer the per-type choices ("Integer", "Text", "Hash", …) in
+ * the row's menu.
+ *
+ * A field that pins no concrete type has to give the author some way to say
+ * what kind of value they mean, and the row menu is where that lives — the
+ * alternative, a standalone *"Please select data type"* control, replaces a
+ * typable field with a pick-only one.
+ *
+ * The rule was `ui_type === 'any'`, which is one of the three ways a schema
+ * says "untyped", so the choices went missing on the other two:
+ *
+ *  - **`type: 'auto'` with no `ui_type` at all.** This is how the server
+ *    declares an assertion's Expected Value, so that field never offered them.
+ *    They appeared only inside an expression, where the OPERAND's schema does
+ *    say `ui_type: 'any'` — so the same option offered them in the Visual view
+ *    and not in the Text view, which reads as the menu losing items.
+ *  - **A host's own untyped editor.** The IDE renders Expected Value through
+ *    `test-reference`, a `ui_type` reqraft knows nothing about; the field is no
+ *    less untyped for having a custom editor.
+ *
+ * `ui_type` is asked FIRST and on its own: a schema that names a concrete
+ * editor (`ui_type: 'string'`) has pinned the field even if its storage `type`
+ * is still `auto`.
+ */
+import { IQorusFormField } from '@qoretechnologies/ts-toolkit';
+/** The spellings that mean "no concrete type" wherever they appear. */
+export declare const BuiltInAnyLikeTypes: string[];
+/**
+ * Does this option leave its type up to the author?
+ *
+ * @param option the option's schema entry
+ * @param extraUiTypes host `ui_type` names that are untyped editors of their
+ * own — see `FormEngine`'s `anyLikeUiTypes`
+ */
+export declare const offersTypeChoices: (option: Partial<IQorusFormField> | undefined, extraUiTypes?: string[]) => boolean;
+//# sourceMappingURL=typeChoices.d.ts.map

package/dist/components/form/engine/typeChoices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeChoices.d.ts","sourceRoot":"","sources":["../../../../src/components/form/engine/typeChoices.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,UAAkB,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,WACpB,QAAQ,eAAe,CAAC,GAAG,SAAS,iBAC7B,MAAM,EAAE,KACtB,OAaF,CAAC"}

package/dist/components/form/engine/typeChoices.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.offersTypeChoices = exports.BuiltInAnyLikeTypes = void 0;
+/** The spellings that mean "no concrete type" wherever they appear. */
+exports.BuiltInAnyLikeTypes = ['any', 'auto'];
+/**
+ * Does this option leave its type up to the author?
+ *
+ * @param option the option's schema entry
+ * @param extraUiTypes host `ui_type` names that are untyped editors of their
+ * own — see `FormEngine`'s `anyLikeUiTypes`
+ */
+var offersTypeChoices = function (option, extraUiTypes) {
+    if (!option) {
+        return false;
+    }
+    var uiType = option.ui_type;
+    if (uiType) {
+        return exports.BuiltInAnyLikeTypes.includes(uiType) || !!(extraUiTypes === null || extraUiTypes === void 0 ? void 0 : extraUiTypes.includes(uiType));
+    }
+    // No `ui_type`: the storage type is the only thing that can pin the field.
+    return exports.BuiltInAnyLikeTypes.includes(option.type);
+};
+exports.offersTypeChoices = offersTypeChoices;
+//# sourceMappingURL=typeChoices.js.map

package/dist/components/form/engine/typeChoices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeChoices.js","sourceRoot":"","sources":["../../../../src/components/form/engine/typeChoices.ts"],"names":[],"mappings":";;;AA4BA,uEAAuE;AAC1D,QAAA,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAEnD;;;;;;GAMG;AACI,IAAM,iBAAiB,GAAG,UAC/B,MAA4C,EAC5C,YAAuB;IAEvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAM,MAAM,GAAI,MAA+B,CAAC,OAAO,CAAC;IAExD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,2BAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,QAAQ,CAAC,MAAM,CAAC,CAAA,CAAC;IAClF,CAAC;IAED,2EAA2E;IAC3E,OAAO,2BAAmB,CAAC,QAAQ,CAAE,MAA4B,CAAC,IAAc,CAAC,CAAC;AACpF,CAAC,CAAC;AAhBW,QAAA,iBAAiB,qBAgB5B"}

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

@@ -0,0 +1,26 @@
+import { IReqoreFormTemplates } from '@qoretechnologies/reqore/dist/components/Textarea';
+import { IExpressionValue } from './types';
+export interface IDpqlRenderingProps {
+    /** DPQL, or a readable rendering of it, to show. */
+    text: string;
+    /** The surface's template catalogue: a reference in it reads as its name. */
+    templates?: IReqoreFormTemplates;
+    'data-testid'?: string;
+}
+/** Shows `text` as DPQL: monospace, server-coloured, references as chips. */
+export declare const DpqlRendering: ({ text, templates, "data-testid": testId }: IDpqlRenderingProps) => import("react/jsx-runtime").JSX.Element;
+export interface IExpressionRenderingProps {
+    /** The expression AST to render. */
+    expression: IExpressionValue;
+    /** The surface's template catalogue: a reference in it reads as its name. */
+    templates?: IReqoreFormTemplates;
+    'data-testid'?: string;
+}
+/**
+ * The server's readable rendering of `expression`, shown through
+ * `DpqlRendering`. It waits for the server — in the form's one waiting shape —
+ * and says so plainly if the server cannot render, rather than showing an
+ * approximation that reads like the real thing.
+ */
+export declare const ExpressionRendering: ({ expression, templates, "data-testid": testId, }: IExpressionRenderingProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DpqlRendering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DpqlRendering.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/DpqlRendering.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAIzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAK3C,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,6EAA6E;AAC7E,eAAO,MAAM,aAAa,+CAAgD,mBAAmB,4CAiB5F,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,sDAI7B,yBAAyB,4CAiB3B,CAAC"}

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

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressionRendering = exports.DpqlRendering = void 0;
+var jsx_runtime_1 = require("react/jsx-runtime");
+// Copyright 2026 Qore Technologies, s.r.o.
+// How a DPQL expression is shown when it is shown but not edited.
+//
+// ONE rendering for every read-only place an expression appears — the Explain
+// panel, the Text view's Preview, the conversion a type-fit message suggests,
+// a collapsed expression row — so they read the same everywhere: monospace,
+// coloured by the language server's semantic tokens (the canonical tokenizer,
+// see `useLspSemanticTokens`), template references as chips. Before, the same
+// expression could be highlighted in one place, plain proportional text in the
+// next and a bare `<code>` in a third, depending only on which component
+// happened to draw it.
+var reqore_1 = require("@qoretechnologies/reqore");
+var react_use_1 = require("react-use");
+var dpqlEditor_1 = require("../../dpqlEditor");
+var FormFieldsSkeleton_1 = require("../engine/FormFieldsSkeleton");
+var useRenderExpression_1 = require("./useRenderExpression");
+var noop = function () { return undefined; };
+/** Shows `text` as DPQL: monospace, server-coloured, references as chips. */
+var DpqlRendering = function (_a) {
+    var text = _a.text, templates = _a.templates, testId = _a["data-testid"];
+    return ((0, jsx_runtime_1.jsx)("div", { className: 'dpql-rendering', "data-testid": testId, style: { width: '100%', minWidth: 0 }, children: (0, jsx_runtime_1.jsx)(dpqlEditor_1.DpqlEditor, { value: text, onChange: noop, readOnly: true, 
+            // The text is a rendering, not something being written: nothing to
+            // diagnose, and a hover would describe tokens of a document nobody edits.
+            showDiagnostics: false, enableHover: false, templateTagsUseIntent: true, templates: templates, 
+            // The text is already known; only its colours wait for the server, so
+            // nothing is hidden behind "Connecting to language server…".
+            loadingIndicator: null }) }));
+};
+exports.DpqlRendering = DpqlRendering;
+/**
+ * The server's readable rendering of `expression`, shown through
+ * `DpqlRendering`. It waits for the server — in the form's one waiting shape —
+ * and says so plainly if the server cannot render, rather than showing an
+ * approximation that reads like the real thing.
+ */
+var ExpressionRendering = function (_a) {
+    var expression = _a.expression, templates = _a.templates, testId = _a["data-testid"];
+    var renderRich = (0, useRenderExpression_1.useRenderExpression)().renderRich;
+    var rendering = (0, react_use_1.useAsync)(function () { return renderRich(expression); }, [JSON.stringify(expression)]);
+    if (rendering.loading) {
+        return (0, jsx_runtime_1.jsx)(FormFieldsSkeleton_1.FormFieldsSkeleton, { rows: 1, reason: 'expression-rendering' });
+    }
+    if (!rendering.value) {
+        return ((0, jsx_runtime_1.jsx)(reqore_1.ReqoreMessage, { size: 'small', intent: 'muted', flat: true, opaque: false, "data-testid": testId, children: "This expression could not be rendered." }));
+    }
+    return (0, jsx_runtime_1.jsx)(exports.DpqlRendering, { text: rendering.value.text, templates: templates, "data-testid": testId });
+};
+exports.ExpressionRendering = ExpressionRendering;
+//# sourceMappingURL=DpqlRendering.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DpqlRendering.js","sourceRoot":"","sources":["../../../../src/components/form/expressions/DpqlRendering.tsx"],"names":[],"mappings":";;;;AAAA,2CAA2C;AAC3C,kEAAkE;AAClE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,yEAAyE;AACzE,uBAAuB;AACvB,mDAAyD;AAEzD,uCAAqC;AACrC,+CAA8C;AAC9C,mEAAkE;AAElE,6DAA4D;AAE5D,IAAM,IAAI,GAAG,cAAY,OAAA,SAAS,EAAT,CAAS,CAAC;AAUnC,6EAA6E;AACtE,IAAM,aAAa,GAAG,UAAC,EAA+D;QAA7D,IAAI,UAAA,EAAE,SAAS,eAAA,EAAiB,MAAM,oBAAA;IAA4B,OAAA,CAChG,gCAAK,SAAS,EAAC,gBAAgB,iBAAc,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,YACxF,uBAAC,uBAAU,IACT,KAAK,EAAE,IAAI,EACX,QAAQ,EAAE,IAAI,EACd,QAAQ;YACR,mEAAmE;YACnE,0EAA0E;YAC1E,eAAe,EAAE,KAAK,EACtB,WAAW,EAAE,KAAK,EAClB,qBAAqB,QACrB,SAAS,EAAE,SAAS;YACpB,sEAAsE;YACtE,6DAA6D;YAC7D,gBAAgB,EAAE,IAAI,GACtB,GACE,CACP;AAjBiG,CAiBjG,CAAC;AAjBW,QAAA,aAAa,iBAiBxB;AAUF;;;;;GAKG;AACI,IAAM,mBAAmB,GAAG,UAAC,EAIR;QAH1B,UAAU,gBAAA,EACV,SAAS,eAAA,EACM,MAAM,oBAAA;IAEb,IAAA,UAAU,GAAK,IAAA,yCAAmB,GAAE,WAA1B,CAA2B;IAC7C,IAAM,SAAS,GAAG,IAAA,oBAAQ,EAAC,cAAM,OAAA,UAAU,CAAC,UAAU,CAAC,EAAtB,CAAsB,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEvF,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO,uBAAC,uCAAkB,IAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAC,sBAAsB,GAAG,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CACL,uBAAC,sBAAa,IAAC,IAAI,EAAC,OAAO,EAAC,MAAM,EAAC,OAAO,EAAC,IAAI,QAAC,MAAM,EAAE,KAAK,iBAAe,MAAM,uDAElE,CACjB,CAAC;IACJ,CAAC;IAED,OAAO,uBAAC,qBAAa,IAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,iBAAe,MAAM,GAAI,CAAC;AAClG,CAAC,CAAC;AArBW,QAAA,mBAAmB,uBAqB9B"}

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

@@ -38,10 +38,16 @@ export interface IExpressionFieldProps {
     recordType?: string;
     /** Initial editor mode (default `visual`). */
     defaultMode?: TExpressionMode;
+    /**
+     * SEAM (reqraft): the host's per-`ui_type` editors, forwarded to the
+     * builder's operand fields. Without them an operand typed with one of the
+     * CONSUMER's ui_types renders "Unknown type!".
+     */
+    componentOverrides?: Record<string, React.FC<any>>;
     size?: string;
     /** Forwarded to the builder — operand reordering for varargs expressions. */
     reorder?: TExpressionReorder;
 }
-export declare const ExpressionField: import("react").MemoExoticComponent<({ value, onChange, type, returnType, readOnly, expressions: expressionsOverride, expressionsUrl, localTemplates, serverHandled, extraActions, provider, recordType, defaultMode, size, reorder, }: IExpressionFieldProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const ExpressionField: import("react").MemoExoticComponent<({ value, onChange, type, returnType, readOnly, expressions: expressionsOverride, expressionsUrl, localTemplates, serverHandled, extraActions, provider, recordType, defaultMode, size, componentOverrides, reorder, }: IExpressionFieldProps) => import("react/jsx-runtime").JSX.Element>;
 export default ExpressionField;
 //# sourceMappingURL=ExpressionField.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ExpressionField.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/ExpressionField.tsx"],"names":[],"mappings":";AAYA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAGzF,OAAO,EAAqB,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAoB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAI/F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;AAShD,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAC,cAAc,CAAC,CAAC;IACvD,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,eAAO,MAAM,eAAe,0OAiBvB,qBAAqB,6CAgMzB,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ExpressionField.d.ts","sourceRoot":"","sources":["../../../../src/components/form/expressions/ExpressionField.tsx"],"names":[],"mappings":";AAaA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAIzF,OAAO,EAAqB,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAoB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAI/F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;AAgBhD,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAC,cAAc,CAAC,CAAC;IACvD,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,eAAO,MAAM,eAAe,8PAkBvB,qBAAqB,6CAkYzB,CAAC;AAEF,eAAe,eAAe,CAAC"}