@qoretechnologies/reqraft 0.10.41-pr.95.g294e5aa → 0.10.41

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

@@ -202,7 +202,7 @@ var StyledCommitDock = styled_components_1.default.div(templateObject_2 || (temp
     return "".concat((0, colors_1.changeDarkness)($bg, 0.4)).concat((0, colors_1.percentToHexAlpha)(55));
 });
 var getType = function (type, operators, operator) {
-    var finalType = getTypeFromOperator(operators, (0, exports.fixOperatorValue)(operator)) || type;
+    var finalType = getTypeFromOperator(operators, (0, common_1.fixOperatorValue)(operator)) || type;
     var resolvedType = (0, isArray_1.default)(finalType) ? finalType[0] : finalType;
     // A value can be received before its server-driven option schema. Keep the
     // renderer type-safe during that transition without guessing a concrete type.
@@ -216,10 +216,11 @@ var getTypeFromOperator = function (operators, operatorData) {
     }
     return ((_a = operators[(0, lodash_1.last)(operatorData)]) === null || _a === void 0 ? void 0 : _a.type) || null;
 };
-var fixOperatorValue = function (operator) {
-    return (0, isArray_1.default)(operator) ? operator : [operator];
-};
-exports.fixOperatorValue = fixOperatorValue;
+/** Re-exported from `helpers/common` so existing importers keep working; it
+ *  lives there because `helpers/validations` needs it and cannot import this
+ *  module (this module imports the validators). */
+var common_2 = require("../../../helpers/common");
+Object.defineProperty(exports, "fixOperatorValue", { enumerable: true, get: function () { return common_2.fixOperatorValue; } });
 var getOptionSchemaStorageType = function (option, isRendererOnly) {
     if (isRendererOnly === void 0) { isRendererOnly = rendererTypes_1.isRendererOnlyUiType; }
     return (((0, readFirst_1.isFixedCompactAllowedValueOption)(option)
@@ -253,7 +254,7 @@ var fixOptions = function (value, options, operators, isRendererOnly) {
         return fixedValue;
     }
     (0, lodash_1.forEach)(options, function (option, name) {
-        var _a, _b, _c, _d, _f, _g, _h;
+        var _a, _b, _c, _d, _f, _g, _h, _j;
         if (option.value ||
             option.required_groups ||
             ((option.required || option.preselected) && !fixedValue[name]) ||
@@ -264,14 +265,30 @@ var fixOptions = function (value, options, operators, isRendererOnly) {
                 ((_c = fixedValue[name]) === null || _c === void 0 ? void 0 : _c.value) === undefined) {
                 obj = option.default_value;
             }
+            else if (option.default_view === 'expression' &&
+                ((_d = fixedValue[name]) === null || _d === void 0 ? void 0 : _d.value) === undefined) {
+                // A field the schema declares as opening in expression mode starts as an
+                // EMPTY expression, not as its raw default. `isDefaultFunction` already
+                // makes the renderer open that way, so without this the data disagreed
+                // with what the operator was looking at: an expression editor whose
+                // value was still the plain default, and no `is_expression` on the field
+                // until the first edit.
+                obj = {
+                    type: type,
+                    value: {
+                        args: [],
+                    },
+                    is_expression: true,
+                };
+            }
             else {
                 obj = {
                     type: type,
-                    value: (_g = (_f = (typeof fixedValue[name] === 'object' ?
-                        (_d = fixedValue[name]) === null || _d === void 0 ? void 0 : _d.value
-                        : fixedValue[name])) !== null && _f !== void 0 ? _f : option.value) !== null && _g !== void 0 ? _g : (0, common_1.getDefaultValue)(option),
+                    value: (_h = (_g = (typeof fixedValue[name] === 'object' ?
+                        (_f = fixedValue[name]) === null || _f === void 0 ? void 0 : _f.value
+                        : fixedValue[name])) !== null && _g !== void 0 ? _g : option.value) !== null && _h !== void 0 ? _h : (0, common_1.getDefaultValue)(option),
                 };
-                if ((_h = fixedValue[name]) === null || _h === void 0 ? void 0 : _h.is_expression) {
+                if ((_j = fixedValue[name]) === null || _j === void 0 ? void 0 : _j.is_expression) {
                     obj.is_expression = true;
                 }
             }
@@ -280,7 +297,7 @@ var fixOptions = function (value, options, operators, isRendererOnly) {
     });
     var res = (0, reduce_1.default)(fixedValue, function (newValue, option, optionName) {
         var _a;
-        var _b, _c, _d, _f, _g, _h;
+        var _b, _c, _d, _f, _g, _h, _j;
         var newOption = option;
         if (!(0, lodash_1.isPlainObject)(newOption) || !(newOption === null || newOption === void 0 ? void 0 : newOption.type)) {
             var isUntypedEnvelope = (0, lodash_1.isPlainObject)(newOption) && 'value' in newOption;
@@ -303,17 +320,27 @@ var fixOptions = function (value, options, operators, isRendererOnly) {
         // every value declared the bare way: the collapsed row still showed its
         // display name while the editor showed "—" and the value never reached
         // the submitted data.
+        // `allowed_values: []` is NOT "no value is permitted" — it is the server
+        // saying it has no reference values to offer right now (the app-action
+        // catalogue ships exactly that, with an
+        // `option_reference_values_unavailable` message attached). An empty array
+        // is truthy, so testing the array itself made every such option erase the
+        // operator's stored value on the first render, before the
+        // connection-refreshed schema arrived to say otherwise — and the emptied
+        // form then autosaved over the draft, so the value was gone for good.
+        // Only an option that actually declares choices can have a value that is
+        // not one of them.
         if (newOption.value !== undefined &&
-            ((_c = options === null || options === void 0 ? void 0 : options[optionName]) === null || _c === void 0 ? void 0 : _c.allowed_values) &&
+            ((_d = (_c = options === null || options === void 0 ? void 0 : options[optionName]) === null || _c === void 0 ? void 0 : _c.allowed_values) === null || _d === void 0 ? void 0 : _d.length) &&
             !(0, readFirst_1.findAllowedValueOption)(newOption.value, options === null || options === void 0 ? void 0 : options[optionName]) &&
             !(0, TemplateField_1.isValueTemplate)(newOption.value) &&
-            !((_d = options === null || options === void 0 ? void 0 : options[optionName]) === null || _d === void 0 ? void 0 : _d.multiselect) &&
-            !((_f = options === null || options === void 0 ? void 0 : options[optionName]) === null || _f === void 0 ? void 0 : _f.allowed_values_creatable)) {
+            !((_f = options === null || options === void 0 ? void 0 : options[optionName]) === null || _f === void 0 ? void 0 : _f.multiselect) &&
+            !((_g = options === null || options === void 0 ? void 0 : options[optionName]) === null || _g === void 0 ? void 0 : _g.allowed_values_creatable)) {
             newOption.value = undefined;
         }
         if (newOption.value &&
-            ((_g = options === null || options === void 0 ? void 0 : options[optionName]) === null || _g === void 0 ? void 0 : _g.readonly) &&
-            ((_h = options === null || options === void 0 ? void 0 : options[optionName]) === null || _h === void 0 ? void 0 : _h.default_value) &&
+            ((_h = options === null || options === void 0 ? void 0 : options[optionName]) === null || _h === void 0 ? void 0 : _h.readonly) &&
+            ((_j = options === null || options === void 0 ? void 0 : options[optionName]) === null || _j === void 0 ? void 0 : _j.default_value) &&
             (0, common_1.getDefaultValue)(options === null || options === void 0 ? void 0 : options[optionName]) !== newOption.value) {
             newOption.value = (0, common_1.getDefaultValue)(options[optionName]);
         }
@@ -372,12 +399,12 @@ var FormEngineImpl = function (_a) {
     var _b, _c, _d, _f, _g, _h;
     var name = _a.name, uniqueName = _a.uniqueName, value = _a.value, onChange = _a.onChange, onSingleOptionsChange = _a.onSingleOptionsChange, onDependableOptionChange = _a.onDependableOptionChange, placeholder = _a.placeholder, noValueString = _a.noValueString, // eslint-disable-line @typescript-eslint/no-unused-vars
     isValid = _a.isValid, // eslint-disable-line @typescript-eslint/no-unused-vars
-    url = _a.url, customUrl = _a.customUrl, operatorsUrl = _a.operatorsUrl, onOptionsLoaded = _a.onOptionsLoaded, recordRequiresSearchOptions = _a.recordRequiresSearchOptions, readOnly = _a.readOnly, _j = _a.allowTemplates, allowTemplates = _j === void 0 ? true : _j, interfaceContext = _a.interfaceContext, templateFieldProps = _a.templateFieldProps, forceDropdown = _a.forceDropdown, _k = _a.showTypeToggle, showTypeToggle = _k === void 0 ? true : _k, compact = _a.compact, _l = _a.compactFlush, compactFlush = _l === void 0 ? false : _l, _m = _a.compactNested, compactNested = _m === void 0 ? false : _m, compactPanelProps = _a.compactPanelProps, _o = _a.commitMode, commitMode = _o === void 0 ? 'immediate' : _o, _p = _a.expandMode, expandMode = _p === void 0 ? 'single' : _p, onCommit = _a.onCommit, operatorsProp = _a.operators, groups = _a.groups, optionsLoader = _a.optionsLoader, onValidityChange = _a.onValidityChange, optionActions = _a.optionActions, _q = _a.optionActionsCollapse, optionActionsCollapse = _q === void 0 ? 'auto' : _q, componentOverrides = _a.componentOverrides, codePreviewRenderer = _a.codePreviewRenderer, 
+    url = _a.url, customUrl = _a.customUrl, operatorsUrl = _a.operatorsUrl, onOptionsLoaded = _a.onOptionsLoaded, recordRequiresSearchOptions = _a.recordRequiresSearchOptions, readOnly = _a.readOnly, _j = _a.allowTemplates, allowTemplates = _j === void 0 ? true : _j, interfaceContext = _a.interfaceContext, templateFieldProps = _a.templateFieldProps, forceDropdown = _a.forceDropdown, _k = _a.showTypeToggle, showTypeToggle = _k === void 0 ? true : _k, compact = _a.compact, _l = _a.compactFlush, compactFlush = _l === void 0 ? false : _l, _m = _a.compactNested, compactNested = _m === void 0 ? false : _m, compactPanelProps = _a.compactPanelProps, _o = _a.compactCollapsedGroups, compactCollapsedGroups = _o === void 0 ? ['optional'] : _o, _p = _a.compactToolbar, compactToolbar = _p === void 0 ? true : _p, _q = _a.commitMode, commitMode = _q === void 0 ? 'immediate' : _q, _r = _a.expandMode, expandMode = _r === void 0 ? 'single' : _r, onCommit = _a.onCommit, operatorsProp = _a.operators, groups = _a.groups, optionsLoader = _a.optionsLoader, onValidityChange = _a.onValidityChange, optionActions = _a.optionActions, _s = _a.optionActionsCollapse, optionActionsCollapse = _s === void 0 ? 'auto' : _s, componentOverrides = _a.componentOverrides, codePreviewRenderer = _a.codePreviewRenderer, 
     // consumed by the wrapper below, which publishes it to every description this
     // form draws; destructured here only so it cannot reach `rest` and be spread
     // onto a DOM node
     _markdownRenderer = _a.markdownRenderer, // eslint-disable-line @typescript-eslint/no-unused-vars
-    rendererOnlyUiTypes = _a.rendererOnlyUiTypes, inheritedFromParent = _a.inheritedFromParent, autoFocusFirstRequired = _a.autoFocusFirstRequired, expandFirstRequired = _a.expandFirstRequired, initialExpandedOptions = _a.initialExpandedOptions, rest = __rest(_a, ["name", "uniqueName", "value", "onChange", "onSingleOptionsChange", "onDependableOptionChange", "placeholder", "noValueString", "isValid", "url", "customUrl", "operatorsUrl", "onOptionsLoaded", "recordRequiresSearchOptions", "readOnly", "allowTemplates", "interfaceContext", "templateFieldProps", "forceDropdown", "showTypeToggle", "compact", "compactFlush", "compactNested", "compactPanelProps", "commitMode", "expandMode", "onCommit", "operators", "groups", "optionsLoader", "onValidityChange", "optionActions", "optionActionsCollapse", "componentOverrides", "codePreviewRenderer", "markdownRenderer", "rendererOnlyUiTypes", "inheritedFromParent", "autoFocusFirstRequired", "expandFirstRequired", "initialExpandedOptions"]);
+    rendererOnlyUiTypes = _a.rendererOnlyUiTypes, inheritedFromParent = _a.inheritedFromParent, autoFocusFirstRequired = _a.autoFocusFirstRequired, expandFirstRequired = _a.expandFirstRequired, initialExpandedOptions = _a.initialExpandedOptions, rest = __rest(_a, ["name", "uniqueName", "value", "onChange", "onSingleOptionsChange", "onDependableOptionChange", "placeholder", "noValueString", "isValid", "url", "customUrl", "operatorsUrl", "onOptionsLoaded", "recordRequiresSearchOptions", "readOnly", "allowTemplates", "interfaceContext", "templateFieldProps", "forceDropdown", "showTypeToggle", "compact", "compactFlush", "compactNested", "compactPanelProps", "compactCollapsedGroups", "compactToolbar", "commitMode", "expandMode", "onCommit", "operators", "groups", "optionsLoader", "onValidityChange", "optionActions", "optionActionsCollapse", "componentOverrides", "codePreviewRenderer", "markdownRenderer", "rendererOnlyUiTypes", "inheritedFromParent", "autoFocusFirstRequired", "expandFirstRequired", "initialExpandedOptions"]);
     // Built-ins + whatever the consumer declared for its own injected editors.
     var isRendererOnly = (0, react_2.useMemo)(function () { return (0, rendererTypes_1.createRendererOnlyUiTypeCheck)(rendererOnlyUiTypes); }, [JSON.stringify(rendererOnlyUiTypes)]);
     // Pointer CAPABILITY and viewport WIDTH are different questions and both
@@ -395,30 +422,30 @@ var FormEngineImpl = function (_a) {
     var collapseOptionActions = optionActionsCollapse === 'always' ? true
         : optionActionsCollapse === 'never' ? false
             : !isHoverCapable || !!isMobile;
-    var _r = (0, react_2.useState)((rest === null || rest === void 0 ? void 0 : rest.options) || undefined), options = _r[0], setOptions = _r[1];
+    var _t = (0, react_2.useState)((rest === null || rest === void 0 ? void 0 : rest.options) || undefined), options = _t[0], setOptions = _t[1];
     // optionsLoader lifecycle: loading feeds the skeleton gate, error the banner.
-    var _s = (0, react_2.useState)(!!optionsLoader && !(rest === null || rest === void 0 ? void 0 : rest.options)), optionsLoading = _s[0], setOptionsLoading = _s[1];
-    var _t = (0, react_2.useState)(), optionsError = _t[0], setOptionsError = _t[1];
+    var _u = (0, react_2.useState)(!!optionsLoader && !(rest === null || rest === void 0 ? void 0 : rest.options)), optionsLoading = _u[0], setOptionsLoading = _u[1];
+    var _v = (0, react_2.useState)(), optionsError = _v[0], setOptionsError = _v[1];
     // Operators: prop-provided (compact) or fetched via operatorsUrl (dpql,
     // ported from IDE Options) — the fetch overrides the seeded prop value.
-    var _u = (0, react_2.useState)(operatorsProp), operators = _u[0], setOperators = _u[1];
+    var _w = (0, react_2.useState)(operatorsProp), operators = _w[0], setOperators = _w[1];
     // Remote-fetch loading (ported from IDE Options); only relevant when one of
     // the fetch urls is set — schema-as-props consumers never see the skeleton.
-    var _v = (0, react_2.useState)(!!(url || customUrl || operatorsUrl)), loading = _v[0], setLoading = _v[1];
+    var _x = (0, react_2.useState)(!!(url || customUrl || operatorsUrl)), loading = _x[0], setLoading = _x[1];
     var confirmAction = (0, reqore_1.useReqoreProperty)('confirmAction');
     var theme = (0, reqore_1.useReqoreTheme)();
-    var _w = (0, react_2.useState)(), focusedEditing = _w[0], setFocusedEditing = _w[1];
-    var _x = (0, react_2.useState)(false), showFieldTypes = _x[0], setShowFieldTypes = _x[1];
+    var _y = (0, react_2.useState)(), focusedEditing = _y[0], setFocusedEditing = _y[1];
+    var _z = (0, react_2.useState)(false), showFieldTypes = _z[0], setShowFieldTypes = _z[1];
     // Global toggle (toolbar ⓘ): reveal the short-description info panel on every
     // field that has a short_desc. Per-row ⓘ overrides still win over it.
     // Global field-info visibility, tri-state: `undefined` = default (critical
     // messages auto-open, the rest closed); `true` = show all; `false` = hide all
     // (even message fields). The toolbar ⓘ drives it.
-    var _y = (0, react_2.useState)(undefined), showAllDescriptions = _y[0], setShowAllDescriptions = _y[1];
-    var _z = (0, react_2.useState)(), showHelpForOption = _z[0], setShowHelpForOption = _z[1];
-    var _0 = (0, react_2.useState)(false), showInvalidOptionsOnly = _0[0], setShowInvalidOptionsOnly = _0[1];
+    var _0 = (0, react_2.useState)(undefined), showAllDescriptions = _0[0], setShowAllDescriptions = _0[1];
+    var _1 = (0, react_2.useState)(), showHelpForOption = _1[0], setShowHelpForOption = _1[1];
+    var _2 = (0, react_2.useState)(false), showInvalidOptionsOnly = _2[0], setShowInvalidOptionsOnly = _2[1];
     // Which options are expanded into their editor (several can be open at once).
-    var _1 = (0, react_2.useState)([]), expandedOptions = _1[0], setExpandedOptions = _1[1];
+    var _3 = (0, react_2.useState)([]), expandedOptions = _3[0], setExpandedOptions = _3[1];
     // --- Reveal a status box's content when it is opened ----------------------
     //
     // The status boxes stack, so the last one ("Optional", which holds every
@@ -434,7 +461,7 @@ var FormEngineImpl = function (_a) {
     // box has not grown and there is nothing to scroll to. A layout effect runs
     // after the DOM is updated and before paint, which makes the reveal
     // deterministic instead of a guessed delay.
-    var _2 = (0, react_2.useState)(undefined), openedStatusBox = _2[0], setOpenedStatusBox = _2[1];
+    var _4 = (0, react_2.useState)(undefined), openedStatusBox = _4[0], setOpenedStatusBox = _4[1];
     var statusBoxRefs = (0, react_2.useRef)({});
     (0, react_2.useLayoutEffect)(function () {
         var _a, _b;
@@ -465,13 +492,13 @@ var FormEngineImpl = function (_a) {
     var settledBucket = (0, react_2.useRef)({});
     // Measured form width (not viewport — the form lives in drawers/panels of
     // arbitrary width) drives the stacked narrow layout.
-    var _3 = (0, react_use_1.useMeasure)(), compactWrapRef = _3[0], compactWrapWidth = _3[1].width;
+    var _5 = (0, react_use_1.useMeasure)(), compactWrapRef = _5[0], compactWrapWidth = _5[1].width;
     // Own handle on the scroll wrap (useMeasure's ref is a callback, no `.current`)
     // so the label-column measurement can publish its CSS var on the element. It's
     // STATE, not a ref: the wrap mounts only after the loading-skeleton gate
     // resolves, so the measurement effect must re-run when the node appears — a
     // ref wouldn't retrigger it.
-    var _4 = (0, react_2.useState)(null), compactWrapNode = _4[0], setCompactWrapNode = _4[1];
+    var _6 = (0, react_2.useState)(null), compactWrapNode = _6[0], setCompactWrapNode = _6[1];
     // Ref mirror of the wrap node for callbacks that must not re-create when it
     // mounts (flashOptions reads it inside a rAF).
     var compactWrapNodeRef = (0, react_2.useRef)(null);
@@ -525,8 +552,8 @@ var FormEngineImpl = function (_a) {
     var readRowHeights = (0, react_2.useRef)({});
     // Required-groups linkage: hovering a group chip highlights every member row;
     // clicking a sibling in the chip's popover scrolls to it and flashes it.
-    var _5 = (0, react_2.useState)([]), highlightedOptions = _5[0], setHighlightedOptions = _5[1];
-    var _6 = (0, react_2.useState)([]), flashedOptions = _6[0], setFlashedOptions = _6[1];
+    var _7 = (0, react_2.useState)([]), highlightedOptions = _7[0], setHighlightedOptions = _7[1];
+    var _8 = (0, react_2.useState)([]), flashedOptions = _8[0], setFlashedOptions = _8[1];
     var flashTimeout = (0, react_2.useRef)();
     var flashOptions = (0, react_2.useCallback)(function (optionNames, scrollToFirst) {
         if (scrollToFirst === void 0) { scrollToFirst = false; }
@@ -575,16 +602,16 @@ var FormEngineImpl = function (_a) {
     });
     var compactNarrow = !!compactWrapWidth && compactWrapWidth < 480;
     // Info panels auto-open on Tier-1 content; the per-row user override sticks.
-    var _7 = (0, react_2.useState)({}), infoPanelOverrides = _7[0], setInfoPanelOverrides = _7[1];
+    var _9 = (0, react_2.useState)({}), infoPanelOverrides = _9[0], setInfoPanelOverrides = _9[1];
     // Toolbar filters affect the listed rows only — the meter reflects the full set.
-    var _8 = (0, react_2.useState)(false), requiredOnly = _8[0], setRequiredOnly = _8[1];
-    var _9 = (0, react_2.useState)(''), compactQuery = _9[0], setCompactQuery = _9[1];
+    var _10 = (0, react_2.useState)(false), requiredOnly = _10[0], setRequiredOnly = _10[1];
+    var _11 = (0, react_2.useState)(''), compactQuery = _11[0], setCompactQuery = _11[1];
     // Compact field sort (Fields menu → "Sort by"); 'schema' = declared order.
-    var _10 = (0, react_2.useState)('schema'), compactSort = _10[0], setCompactSort = _10[1];
-    var _11 = (0, react_2.useState)(function () { return ({
+    var _12 = (0, react_2.useState)('schema'), compactSort = _12[0], setCompactSort = _12[1];
+    var _13 = (0, react_2.useState)(function () { return ({
         fields: (0, exports.fixOptions)(value, options || {}, undefined, isRendererOnly),
         meta: undefined,
-    }); }), localValue = _11[0], setLocalValue = _11[1];
+    }); }), localValue = _13[0], setLocalValue = _13[1];
     var originalValue = (0, react_2.useRef)();
     // Track the last value we emitted via onChange so we can skip re-applying fixOptions
     // when the parent echoes it back as the new value prop (controlled component loop prevention)
@@ -593,7 +620,7 @@ var FormEngineImpl = function (_a) {
         originalValue.current = localValue.fields;
     }
     var unavailableOptionsCount = (0, react_2.useRef)(0);
-    var _12 = (0, useQorusTypes_1.useQorusTypes)(), compactValue = _12.compactValue, typesLoading = _12.loading;
+    var _14 = (0, useQorusTypes_1.useQorusTypes)(), compactValue = _14.compactValue, typesLoading = _14.loading;
     var templates = (0, useTemplates_1.useTemplates)(allowTemplates, rest.stringTemplates, interfaceContext);
     (0, react_2.useEffect)(function () {
         if ((0, lodash_1.isEqual)(localValue.fields, value)) {
@@ -861,7 +888,7 @@ var FormEngineImpl = function (_a) {
     var handleOperatorChange = (0, react_2.useCallback)(function (optionName, currentValue, operator, index) {
         var _a;
         setLocalValue === null || setLocalValue === void 0 ? void 0 : setLocalValue({
-            fields: __assign(__assign({}, currentValue), (_a = {}, _a[optionName] = __assign(__assign({}, currentValue[optionName]), { op: (0, exports.fixOperatorValue)(currentValue[optionName].op).map(function (op, idx) {
+            fields: __assign(__assign({}, currentValue), (_a = {}, _a[optionName] = __assign(__assign({}, currentValue[optionName]), { op: (0, common_1.fixOperatorValue)(currentValue[optionName].op).map(function (op, idx) {
                     if (idx === index) {
                         return operator;
                     }
@@ -873,14 +900,14 @@ var FormEngineImpl = function (_a) {
     var handleAddOperator = (0, react_2.useCallback)(function (optionName, currentValue, index) {
         var _a;
         setLocalValue === null || setLocalValue === void 0 ? void 0 : setLocalValue({
-            fields: __assign(__assign({}, currentValue), (_a = {}, _a[optionName] = __assign(__assign({}, currentValue[optionName]), { op: (0, common_1.insertAtIndex)((0, exports.fixOperatorValue)(currentValue[optionName].op), index, null) }), _a)),
+            fields: __assign(__assign({}, currentValue), (_a = {}, _a[optionName] = __assign(__assign({}, currentValue[optionName]), { op: (0, common_1.insertAtIndex)((0, common_1.fixOperatorValue)(currentValue[optionName].op), index, null) }), _a)),
             meta: undefined,
         });
     }, []);
     var handleRemoveOperator = (0, react_2.useCallback)(function (optionName, currentValue, index) {
         var _a;
         setLocalValue === null || setLocalValue === void 0 ? void 0 : setLocalValue({
-            fields: __assign(__assign({}, currentValue), (_a = {}, _a[optionName] = __assign(__assign({}, currentValue[optionName]), { op: (0, exports.fixOperatorValue)(currentValue[optionName].op).filter(function (_op, idx) { return idx !== index; }) }), _a)),
+            fields: __assign(__assign({}, currentValue), (_a = {}, _a[optionName] = __assign(__assign({}, currentValue[optionName]), { op: (0, common_1.fixOperatorValue)(currentValue[optionName].op).filter(function (_op, idx) { return idx !== index; }) }), _a)),
             meta: undefined,
         });
     }, []);
@@ -1420,9 +1447,9 @@ var FormEngineImpl = function (_a) {
     // The info panel below the row keeps showing schema messages while editing —
     // rendering them in the editor too would balloon a one-line edit.
     suppressSchemaMessages) {
-        var _b, _c, _d, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
+        var _b, _c, _d, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
         var type = _a.type, other = __rest(_a, ["type"]);
-        var operatorParts = (0, exports.fixOperatorValue)(other.op);
+        var operatorParts = (0, common_1.fixOperatorValue)(other.op);
         // The RENDERER type for this row — which editor mounts. Distinct from the
         // storage type on the value envelope: a `richtext` field stores a string
         // but must render the richtext editor, so `ui_type` wins here.
@@ -1520,8 +1547,14 @@ var FormEngineImpl = function (_a) {
                     // `[localValue, onChange]` — an inline lambda resets the pending emit
                     // every render and the typed value can starve.
                     handleValueChange, key: optionName, arg_schema: (_j = options === null || options === void 0 ? void 0 : options[optionName]) === null || _j === void 0 ? void 0 : _j.arg_schema, noSoft: !!(rest === null || rest === void 0 ? void 0 : rest.options), value: other.value, isFunction: other.is_expression, isDefaultFunction: ((_k = options === null || options === void 0 ? void 0 : options[optionName]) === null || _k === void 0 ? void 0 : _k.default_view) === 'expression', sensitive: (_l = options === null || options === void 0 ? void 0 : options[optionName]) === null || _l === void 0 ? void 0 : _l.sensitive, default_value: (0, common_1.getDefaultValue)(options === null || options === void 0 ? void 0 : options[optionName]), isDefaultTemplate: ((_m = options === null || options === void 0 ? void 0 : options[optionName]) === null || _m === void 0 ? void 0 : _m.default_view) === 'template', allowed_values: (_o = options === null || options === void 0 ? void 0 : options[optionName]) === null || _o === void 0 ? void 0 : _o.allowed_values, allowed_values_creatable: (_p = options === null || options === void 0 ? void 0 : options[optionName]) === null || _p === void 0 ? void 0 : _p.allowed_values_creatable, disabled: ((_q = options === null || options === void 0 ? void 0 : options[optionName]) === null || _q === void 0 ? void 0 : _q.disabled) ||
+                        (
+                        // a system-owned field states that as `readonly`; only the older
+                        // compat projection also sent `disabled`, so honouring only
+                        // `disabled` rendered an editable control for a value the user
+                        // cannot change (see CompactRow's `fieldReadonly`)
+                        (_r = options === null || options === void 0 ? void 0 : options[optionName]) === null || _r === void 0 ? void 0 : _r.readonly) ||
                         readOnly ||
-                        !(0, validations_1.hasAllDependenciesFullfilled)((_r = options === null || options === void 0 ? void 0 : options[optionName]) === null || _r === void 0 ? void 0 : _r.depends_on, availableOptions, options || {}), readOnly: readOnly, size: editorSize || rest.size, menuItems: ((_s = options === null || options === void 0 ? void 0 : options[optionName]) === null || _s === void 0 ? void 0 : _s.ui_type) === 'any' ?
+                        !(0, validations_1.hasAllDependenciesFullfilled)((_s = options === null || options === void 0 ? void 0 : options[optionName]) === null || _s === void 0 ? void 0 : _s.depends_on, availableOptions, options || {}), readOnly: readOnly, size: editorSize || rest.size, menuItems: ((_t = options === null || options === void 0 ? void 0 : options[optionName]) === null || _t === void 0 ? void 0 : _t.ui_type) === 'any' ?
                         getCustomMenuTemplateItems(optionName)
                         : undefined }, templateFieldProps, { forceDropdown: effectiveForceDropdown })), (0, jsx_runtime_1.jsx)(OptionFieldMessages_1.OptionFieldMessages, { schema: options || {}, allOptions: availableOptions, name: optionName, option: __assign({ type: resolvedType }, other), getType: getTypeForOption }), operators && (0, size_1.default)(operators) && (0, size_1.default)(other.op) ?
                     (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(reqore_1.ReqoreVerticalSpacer, { height: 5 }), (0, jsx_runtime_1.jsx)(reqore_1.ReqoreMessage, { size: 'small', children: (0, jsx_runtime_1.jsxs)(reqore_1.ReqoreTagGroup, { children: [(0, jsx_runtime_1.jsx)(reqore_1.ReqoreTag, { size: 'small', labelKey: 'WHERE', label: optionName }), (0, jsx_runtime_1.jsx)(reqore_1.ReqoreTag, { size: 'small', labelKey: 'IS', label: operatorParts.join(' ') }), (0, jsx_runtime_1.jsx)(reqore_1.ReqoreTag, { size: 'small', intent: 'info', label: other.value ?
@@ -1670,6 +1703,14 @@ var FormEngineImpl = function (_a) {
         cInfo,
         cBg,
     ]);
+    // `compactToolbar` resolved to a full object, so neither the context type nor
+    // the toolbar itself has to re-default anything. `null` means no toolbar.
+    var compactToolbarParts = (0, react_2.useMemo)(function () {
+        if (compactToolbar === false)
+            return null;
+        var all = { completion: true, search: true, fields: true, help: true };
+        return compactToolbar === true ? all : __assign(__assign({}, all), compactToolbar);
+    }, [JSON.stringify(compactToolbar)]);
     var compactToolbarContextValue = (0, react_2.useMemo)(function () { return ({
         readOnly: readOnly,
         invalidCount: (0, size_1.default)(validityData.invalidFields),
@@ -1677,6 +1718,7 @@ var FormEngineImpl = function (_a) {
         completion: readFirstCompletion,
         showInvalidOnly: showInvalidOptionsOnly,
         onToggleInvalidOnly: handleToggleInvalidOnly,
+        parts: compactToolbarParts !== null && compactToolbarParts !== void 0 ? compactToolbarParts : { completion: false, search: false, fields: false, help: false },
         hasMultipleOptions: (0, size_1.default)(availableOptions) > 1,
         compactQuery: compactQuery,
         setCompactQuery: setCompactQuery,
@@ -1724,8 +1766,9 @@ var FormEngineImpl = function (_a) {
     ]);
     // The engine's own toolbar action, plus whatever the consumer added through
     // `compactPanelProps.actions` — appended, so an outside action can never
-    // knock the form's toolbar out of the header.
-    var compactHeaderActions = (0, react_2.useMemo)(function () { return __spreadArray([{ as: CompactToolbar_1.CompactToolbar, responsive: false }], ((compactPanelProps === null || compactPanelProps === void 0 ? void 0 : compactPanelProps.actions) || []), true); }, [compactPanelProps === null || compactPanelProps === void 0 ? void 0 : compactPanelProps.actions]);
+    // knock the form's toolbar out of the header. Only `compactToolbar={false}`
+    // removes it, and then the header carries just the consumer's own actions.
+    var compactHeaderActions = (0, react_2.useMemo)(function () { return __spreadArray(__spreadArray([], (compactToolbarParts ? [{ as: CompactToolbar_1.CompactToolbar, responsive: false }] : []), true), ((compactPanelProps === null || compactPanelProps === void 0 ? void 0 : compactPanelProps.actions) || []), true); }, [compactPanelProps === null || compactPanelProps === void 0 ? void 0 : compactPanelProps.actions, compactToolbarParts]);
     var renderCompact = function () {
         var headerBg = "".concat((0, colors_1.changeDarkness)((0, colors_1.getMainBackgroundColor)(theme), 0.02)).concat((0, colors_1.percentToHexAlpha)(88));
         // Toolbar filters narrow the listed rows; the meter reflects the full set.
@@ -1736,8 +1779,40 @@ var FormEngineImpl = function (_a) {
             if (requiredOnly && !((schema === null || schema === void 0 ? void 0 : schema.required) || (schema === null || schema === void 0 ? void 0 : schema.required_groups))) {
                 return false;
             }
-            return matchesQuery(optionName);
+            // A field that absorbs a sibling also answers for it: searching
+            // "language" has to surface the row that now holds the language control,
+            // or the field becomes unreachable through the filter.
+            if (matchesQuery(optionName))
+                return true;
+            var absorb = schema === null || schema === void 0 ? void 0 : schema.absorb_fields;
+            return !!(absorb === null || absorb === void 0 ? void 0 : absorb.some(function (absorbedName) { return matchesQuery(absorbedName); }));
         };
+        // Fields a sibling absorbs into its own container.
+        //
+        // A field declaring `absorb_fields: ['language']` renders that sibling's
+        // control inside its own row instead of letting it have a row of its own.
+        // The pair this exists for is a code editor and its language: they are one
+        // decision — "what is this code, and in what language" — and reading them
+        // as two unrelated rows one above the other is what the layout used to say.
+        //
+        // Absorbed fields stay in `grouped`, and therefore in the Set / Optional /
+        // Needs-attention counts and in the completion meter. Only the ROW is
+        // skipped. Dropping them from the buckets instead would leave the meter
+        // ("13/18 set", computed from `availableOptions`) disagreeing with the box
+        // badge beside it, which counts row entries.
+        var absorbedBy = {};
+        (0, lodash_1.forEach)(options, function (option, optionName) {
+            var absorb = option === null || option === void 0 ? void 0 : option.absorb_fields;
+            if (!(absorb === null || absorb === void 0 ? void 0 : absorb.length))
+                return;
+            absorb.forEach(function (absorbedName) {
+                // Only absorb a sibling that exists and is not already spoken for; a
+                // schema naming a missing field must not make the field disappear.
+                if ((options === null || options === void 0 ? void 0 : options[absorbedName]) && !absorbedBy[absorbedName]) {
+                    absorbedBy[absorbedName] = optionName;
+                }
+            });
+        });
         // Group the options by their raw `group` key, remembering the order groups
         // first appear in the schema. Each row carries a `hidden` flag.
         var groupOrder = [];
@@ -1869,18 +1944,30 @@ var FormEngineImpl = function (_a) {
         // together at the first member's slot and rendered as a connected rail (flat
         // rows — no wrapper — so the value surface applies normally; the rail + nodes
         // are drawn per member). Narrow stacks fall back to flat rows.
+        // The absorbed siblings a host row must render, in schema order. Empty for
+        // every row that absorbs nothing, which is all of them by default.
+        var absorbedNamesFor = function (hostName) {
+            return Object.keys(absorbedBy).filter(function (absorbedName) { return absorbedBy[absorbedName] === hostName; });
+        };
         var renderGroupRows = function (names) {
             var renderRow = function (entry, clustered, clusterFirst, clusterLast) { return ((0, jsx_runtime_1.jsx)(CompactRow_1.CompactRow, { optionName: entry.name, optionField: entry.hidden ?
                     {
                         type: getOptionSchemaStorageType(options === null || options === void 0 ? void 0 : options[entry.name], isRendererOnly),
                         value: undefined,
                     }
-                    : shownOptions[entry.name], hidden: entry.hidden, clustered: clustered, clusterFirst: clusterFirst, clusterLast: clusterLast }, entry.name)); };
+                    : shownOptions[entry.name], hidden: entry.hidden, clustered: clustered, clusterFirst: clusterFirst, clusterLast: clusterLast, 
+                // The siblings this row renders inside itself instead of leaving
+                // them a row of their own — see `absorbedBy`.
+                absorbedFields: absorbedNamesFor(entry.name) }, entry.name)); };
             // (Clustering runs in narrow mode too now — the "One of the below is
             // required" box wraps the members regardless of width; it no longer relies
             // on a contiguous rail.)
             var emitted = new Set();
             var groupOf = function (name) { var _a, _b; return (_b = (_a = options === null || options === void 0 ? void 0 : options[name]) === null || _a === void 0 ? void 0 : _a.required_groups) === null || _b === void 0 ? void 0 : _b[0]; };
+            // An absorbed field keeps its place in the buckets — so the Set /
+            // Optional counts and the completion meter still see it — but its host
+            // renders its control, so it gets no row of its own here.
+            names = names.filter(function (entry) { return !absorbedBy[entry.name]; });
             return names.map(function (entry) {
                 var grp = groupOf(entry.name);
                 if (!grp)
@@ -1903,12 +1990,10 @@ var FormEngineImpl = function (_a) {
             });
         };
         return ((0, jsx_runtime_1.jsx)(exports.OptionsContext.Provider, { value: { schema: options, value: availableOptions }, children: (0, jsx_runtime_1.jsx)(compactRowContext_1.CompactRowContext.Provider, { value: compactRowContextValue, children: (0, jsx_runtime_1.jsxs)(reqore_1.ReqoreErrorBoundary, { children: [showHelpForOption && ((0, jsx_runtime_1.jsx)(OptionsHelpDialog_1.OptionsHelpDialog, { onClose: function () { return setShowHelpForOption(undefined); }, option: options[showHelpForOption] })), (0, jsx_runtime_1.jsx)(compactToolbarContext_1.CompactToolbarContext.Provider, { value: compactToolbarContextValue, children: (0, jsx_runtime_1.jsxs)(StyledCompactWrap, { ref: setCompactWrap, className: 'options-readfirst-scroll', "$flush": compactFlush || compactNested, children: [(0, jsx_runtime_1.jsxs)(compactRowStyles_1.StyledCompactPanel
-                                    // The top-level form scrolls, so its toolbar STICKS and carries a
-                                    // dark blurred backdrop so content ghosts cleanly beneath it. A
-                                    // nested (arg_schema) sub-form owns no scroll context — drop the
-                                    // sticky, the backdrop, and the stacking context so its header is
-                                    // transparent inside the parent's card.
-                                    , __assign({ "$headerBg": compactNested ? 'transparent' : headerBg, "$nested": compactNested, flat: true, raised: true, minimal: true, 
+                                    // Mirrors the toolbar's own search-row gate: when no search
+                                    // row renders, the header is a thin strip and sits tight to
+                                    // the first status box (see StyledCompactPanel).
+                                    , __assign({ "$tightHeader": !((compactToolbarParts === null || compactToolbarParts === void 0 ? void 0 : compactToolbarParts.search) && (0, size_1.default)(availableOptions) > 1), "$headerBg": compactNested ? 'transparent' : headerBg, "$nested": compactNested, flat: true, raised: true, minimal: true, 
                                         // No panel background: the form sits transparently on whatever
                                         // hosts it (page, drawer, or — for an arg_schema field — the
                                         // parent's edit card) instead of stacking its own dark surface.
@@ -1938,24 +2023,27 @@ var FormEngineImpl = function (_a) {
                                                     onCollapseChange: function (collapsed) {
                                                         return setOpenedStatusBox(collapsed ? undefined : box.key);
                                                     }, flat: true, minimal: true, collapseButtonProps: { flat: true, minimal: true, size: 'small' }, collapsible: true, 
-                                                    // The Optional box now holds every not-yet-added field, so
-                                                    // it starts COLLAPSED to keep the form focused on what's in
-                                                    // use. But a SEARCH must surface matching addable fields —
-                                                    // and ReqorePanel unmounts collapsed content — so force it
-                                                    // open whenever a query is active. (isCollapsed is the
-                                                    // panel's controllable state; manual toggling still works
-                                                    // when no query is set.)
-                                                    // The Optional box starts collapsed so a form opens on what
-                                                    // is in use — but only when there IS something else to
-                                                    // open on. When every field is optional it is the whole
-                                                    // form, and collapsing it renders a card that looks empty
-                                                    // and broken: an auth profile's Authorization block, whose
-                                                    // nine requirement fields are all optional, showed as a
-                                                    // titled card containing one collapsed "Optional 9" strip
-                                                    // and nothing else. A search still forces it open
-                                                    // (ReqorePanel unmounts collapsed content, so a match
-                                                    // inside it would be unreachable otherwise).
-                                                    isCollapsed: box.key === 'optional' && !query && !onlyOptionalRows, label: (0, jsx_runtime_1.jsxs)(compactRowStyles_1.StyledGroupHeader, { children: [(0, jsx_runtime_1.jsx)(reqore_1.ReqoreP, { effect: { weight: 'bold' }, size: 'normal', children: box.label }), (0, jsx_runtime_1.jsx)(reqore_1.ReqoreTag, { size: 'small', minimal: true, compact: true, intent: box.intent, label: String(count) })] }), icon: box.icon, className: 'options-readfirst-group', padded: false, contentStyle: { padding: '4px 4px 6px' }, children: (0, jsx_runtime_1.jsx)(compactRowStyles_1.StyledGroupBody, { "$divider": cDivider, "$hover": cHover, "$focus": cWarning, "$success": cSuccess, "$rowBg": cRowBg, "$lineColor": cGroupLine, className: compactNarrow ? 'readfirst-narrow' : undefined, children: groupsInBox.map(function (groupName) {
+                                                    // Which boxes start closed is the consumer's call
+                                                    // (`compactCollapsedGroups`, default `['optional']`: the
+                                                    // Optional box holds every not-yet-added field, so a form
+                                                    // opens on what is in use). Two rules override it:
+                                                    //
+                                                    // A SEARCH forces every box open — ReqorePanel unmounts
+                                                    // collapsed content, so a match inside a closed box would
+                                                    // be unreachable. (isCollapsed is the panel's controllable
+                                                    // state; manual toggling still works with no query set.)
+                                                    //
+                                                    // The Optional box stays open when it is the ONLY box,
+                                                    // because collapsing it renders a card that looks empty and
+                                                    // broken: an auth profile's Authorization block, whose nine
+                                                    // requirement fields are all optional, showed as a titled
+                                                    // card containing one collapsed "Optional 9" strip and
+                                                    // nothing else. This does not generalise to the other two —
+                                                    // a lone Set box collapsed is a deliberate ask, and its
+                                                    // header still reports what is in there.
+                                                    isCollapsed: compactCollapsedGroups.includes(box.key) &&
+                                                        !query &&
+                                                        !(box.key === 'optional' && onlyOptionalRows), label: (0, jsx_runtime_1.jsxs)(compactRowStyles_1.StyledGroupHeader, { children: [(0, jsx_runtime_1.jsx)(reqore_1.ReqoreP, { effect: { weight: 'bold' }, size: 'normal', children: box.label }), (0, jsx_runtime_1.jsx)(reqore_1.ReqoreTag, { size: 'small', minimal: true, compact: true, intent: box.intent, label: String(count) })] }), icon: box.icon, className: 'options-readfirst-group', padded: false, contentStyle: { padding: '4px 4px 6px' }, children: (0, jsx_runtime_1.jsx)(compactRowStyles_1.StyledGroupBody, { "$divider": cDivider, "$hover": cHover, "$focus": cWarning, "$success": cSuccess, "$rowBg": cRowBg, "$lineColor": cGroupLine, className: compactNarrow ? 'readfirst-narrow' : undefined, children: groupsInBox.map(function (groupName) {
                                                             var groupConfig = groups === null || groups === void 0 ? void 0 : groups[groupName];
                                                             return ((0, jsx_runtime_1.jsxs)(react_2.default.Fragment, { children: [showGroupSubLabel(groupName) ?
                                                                         (0, jsx_runtime_1.jsx)(compactRowStyles_1.StyledStatusBoxGroupLabel, { children: (0, readFirst_1.getOptionGroupLabel)(groupName, groups) })