@qoretechnologies/reqraft 0.10.55-pr.124.g43fa138 → 0.10.55

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

@@ -1,4 +1,5 @@
 import { IReqoreTagProps } from '@qoretechnologies/reqore/dist/components/Tag';
+import { TReqoreIntent } from '@qoretechnologies/reqore/dist/constants/theme';
 import { IQorusFormField, IQorusFormSchema, TQorusForm } from '@qoretechnologies/ts-toolkit';
 /** A `messages` entry that appears only for certain values of its siblings. */
 export interface IConditionalFieldMessage {
@@ -35,18 +36,123 @@ export interface IConditionalFieldMessage {
 export declare const isConditionalMessageShown: (message: IConditionalFieldMessage, allOptions?: TQorusForm, optionsSchema?: IQorusFormSchema) => boolean;
 /** The subset of a field's `messages` that applies right now. */
 export declare const getShownSchemaMessages: <T extends IConditionalFieldMessage>(messages: T[] | undefined, allOptions?: TQorusForm, optionsSchema?: IQorusFormSchema) => T[];
+/**
+ * The whole `depends_on` list as one phrase.
+ *
+ * A nested entry is an OR — only one of its members has to hold. It used to be
+ * flattened into the same comma-separated list as the top-level entries, which
+ * are an AND, so an either/or was shown to the reader as a set of things all
+ * required. The alternatives now stay grouped and joined by "or".
+ */
+export declare const describeDependencies: (dependencies: (string | string[])[] | string[][], schema: IQorusFormSchema) => string;
+/**
+ * An allowed VALUE, as far as being offered is concerned.
+ *
+ * ts-toolkit 0.5.82 carries both `IQorusAllowedValue.depends_on` and
+ * `IQorusFormFieldMessage.when` / `unless`, so this no longer waits on a publish.
+ * It remains its own shape because it states only what DECIDING AVAILABILITY needs —
+ * three keys out of the twenty an allowed value can carry — so a caller that has
+ * only those three can be answered, and the predicate cannot quietly start reading
+ * a fourth.
+ */
+export interface IAllowedValueAvailabilityInput {
+    /**
+     * The value is offered only while every entry holds — the SAME grammar, the
+     * same parser and the same evaluator a field's `depends_on` uses, one level
+     * down. For what this form can decide on its own.
+     */
+    depends_on?: (string | string[])[];
+    /**
+     * Someone who already knows has refused it — the server, for a sandbox or
+     * permission context, a capability of the selected kind, or a requirement in
+     * a scope `depends_on` deliberately cannot reach.
+     */
+    disabled?: boolean;
+    /** Where a refusal says why. */
+    messages?: IConditionalFieldMessage[];
+}
+/** Whether a value can be picked, and the sentence that stands in for it. */
+export interface IAllowedValueAvailability {
+    available: boolean;
+    /** Why not. Read by the row itself, by its tooltip and by the list's search. */
+    reason?: string;
+    /** A heading the refusal came with, when it came with one. */
+    title?: string;
+    intent?: TReqoreIntent;
+}
+/** One object for every available value, so identity says "nothing to show". */
+export declare const ALLOWED_VALUE_AVAILABLE: IAllowedValueAvailability;
+/**
+ * Whether an offered value can be picked, and why not.
+ *
+ * Two things can refuse a value and they render identically, because a reader
+ * has no way to tell them apart and no reason to care:
+ *
+ * - **the predicate** — the value's own `depends_on`, judged against the form
+ *   it is standing in. Whatever the form itself can decide.
+ * - **the pre-resolved refusal** — `disabled: true` with a message, from
+ *   whoever already knows. A sandbox that denies a domain, a capability of the
+ *   selected kind, a requirement in another value scope: none of them are
+ *   reachable from a sibling's answer, and a predicate that pretended otherwise
+ *   would be a predicate that never fires.
+ *
+ * The predicate is checked first when both could speak. It names a field in
+ * this very form, so the reader can act on it without leaving the row; a served
+ * reason is a statement about somewhere else.
+ *
+ * A value is never HIDDEN for either reason. A choice that vanishes takes its
+ * own explanation with it, and leaves the reader looking for something they
+ * were told exists.
+ */
+export declare const getAllowedValueAvailability: (value: IAllowedValueAvailabilityInput | undefined, allOptions?: TQorusForm, schema?: IQorusFormSchema) => IAllowedValueAvailability;
+/**
+ * The availability of each offered value, against the form the picker stands in.
+ *
+ * Aligned with `items`: the result at index `i` describes `items[i]`.
+ *
+ * The answer is computed INSIDE the context selector, not from a copy of the
+ * form values pulled out of it. `OptionsContext` hands down a fresh object on
+ * every render of the engine, so a picker that selected the values themselves
+ * would re-render on every keystroke anywhere in the form; selecting the
+ * computed answer re-renders it only when an availability actually changes.
+ *
+ * Values that gate on nothing skip the computation entirely, and that is a
+ * claim about each VALUE rather than about the field it belongs to. The gate
+ * used to be one flag for the whole list, so a single gated value in a
+ * thousand-item picker resolved all thousand and serialised all thousand on
+ * every keystroke anywhere in the form. Only the gated indices are resolved
+ * and serialised; every other position is the same frozen
+ * {@link ALLOWED_VALUE_AVAILABLE}, which costs nothing to fill in and lets
+ * identity say "nothing to show".
+ */
+export declare const useAllowedValueAvailability: (items: readonly IAllowedValueAvailabilityInput[] | undefined) => IAllowedValueAvailability[];
 export interface IOptionFieldMessagesProps {
     schema: IQorusFormSchema;
     option: IQorusFormField;
     allOptions?: TQorusForm;
     name: string;
     getType: (type: string) => string;
+    /**
+     * The reader has not edited this field in this session.
+     *
+     * An error is a report that something went WRONG. "This field is required"
+     * under a field nobody has been in yet reports nothing: the form is empty
+     * because it is new. The requirement is already carried three other ways —
+     * the asterisk on the label, the Needs-attention box the row sits in, and the
+     * completion meter — so the message waits until the reader has been in the
+     * field and left it empty, which IS a thing that went wrong.
+     *
+     * Only the plain required message is held back. A value that fails
+     * validation, an unmet required GROUP and a locked dependency are all facts
+     * about what the form currently holds, and they show immediately.
+     */
+    untouched?: boolean;
 }
 /**
  * Compute the validation / required-group / dependency messages for an option —
  * pure, so the compact read-first rows can surface the same messages the
  * expanded editor shows (single source of truth).
  */
-export declare const getOptionFieldMessages: ({ schema, option, name, allOptions, getType, }: IOptionFieldMessagesProps) => IReqoreTagProps[];
-export declare const OptionFieldMessages: ({ schema, option, name, allOptions, getType, }: IOptionFieldMessagesProps) => import("react/jsx-runtime").JSX.Element;
+export declare const getOptionFieldMessages: ({ schema, option, name, allOptions, getType, untouched, }: IOptionFieldMessagesProps) => IReqoreTagProps[];
+export declare const OptionFieldMessages: ({ schema, option, name, allOptions, getType, untouched, }: IOptionFieldMessagesProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=OptionFieldMessages.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"OptionFieldMessages.d.ts","sourceRoot":"","sources":["../../../../src/components/form/engine/OptionFieldMessages.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAU7F,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,yBAAyB,YAC3B,wBAAwB,eACpB,UAAU,kBACP,gBAAgB,KAC/B,OASF,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,iDACvB,CAAC,EAAE,GAAG,SAAS,eACZ,UAAU,kBACP,gBAAgB,KAC/B,CAAC,EAA6F,CAAC;AAElG,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACnC;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,mDAMhC,yBAAyB,KAAG,eAAe,EA+D7C,CAAC;AAEF,eAAO,MAAM,mBAAmB,mDAM7B,yBAAyB,4CAoB3B,CAAC"}
+{"version":3,"file":"OptionFieldMessages.d.ts","sourceRoot":"","sources":["../../../../src/components/form/engine/OptionFieldMessages.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAkB7F,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,yBAAyB,YAC3B,wBAAwB,eACpB,UAAU,kBACP,gBAAgB,KAC/B,OAYF,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,iDACvB,CAAC,EAAE,GAAG,SAAS,eACZ,UAAU,kBACP,gBAAgB,KAC/B,CAAC,EAA6F,CAAC;AAoClG;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,iBACjB,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,UACxC,gBAAgB,KACvB,MAeY,CAAC;AAEhB;;;;;;;;;GASG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACvC;AAED,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,EAAE,yBAEpC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,2BAA2B,UAC/B,8BAA8B,GAAG,SAAS,eACpC,UAAU,WACd,gBAAgB,KACxB,yBAiDF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,2BAA2B,UAC/B,SAAS,8BAA8B,EAAE,GAAG,SAAS,KAC3D,yBAAyB,EAsC3B,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,8DAOhC,yBAAyB,KAAG,eAAe,EA6E7C,CAAC;AAEF,eAAO,MAAM,mBAAmB,8DAO7B,yBAAyB,4CAoB3B,CAAC"}

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

@@ -11,13 +11,16 @@ var __assign = (this && this.__assign) || function () {
     return __assign.apply(this, arguments);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OptionFieldMessages = exports.getOptionFieldMessages = exports.getShownSchemaMessages = exports.isConditionalMessageShown = void 0;
+exports.OptionFieldMessages = exports.getOptionFieldMessages = exports.useAllowedValueAvailability = exports.getAllowedValueAvailability = exports.ALLOWED_VALUE_AVAILABLE = exports.describeDependencies = exports.getShownSchemaMessages = exports.isConditionalMessageShown = void 0;
 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 use_context_selector_1 = require("use-context-selector");
 var options_1 = require("../../../helpers/options");
+var optionUiTypes_1 = require("../../../helpers/optionUiTypes");
 var validations_1 = require("../../../helpers/validations");
+var optionsContext_1 = require("./optionsContext");
 /**
  * Whether a schema message applies to the form as it currently stands.
  *
@@ -41,7 +44,8 @@ var isConditionalMessageShown = function (message, allOptions, optionsSchema) {
     if (message.when && !(0, validations_1.hasAllDependenciesFullfilled)(message.when, values, optionsSchema)) {
         return false;
     }
-    if (message.unless && (0, validations_1.hasAllDependenciesFullfilled)(message.unless, values, optionsSchema)) {
+    if (message.unless &&
+        (0, validations_1.hasAllDependenciesFullfilled)(message.unless, values, optionsSchema)) {
         return false;
     }
     return true;
@@ -50,17 +54,202 @@ exports.isConditionalMessageShown = isConditionalMessageShown;
 /** The subset of a field's `messages` that applies right now. */
 var getShownSchemaMessages = function (messages, allOptions, optionsSchema) { return (messages || []).filter(function (m) { return (0, exports.isConditionalMessageShown)(m, allOptions, optionsSchema); }); };
 exports.getShownSchemaMessages = getShownSchemaMessages;
+/**
+ * Name one `depends_on` entry so the reader can act on it.
+ *
+ * The list used to be built by looking each entry up as a whole field name,
+ * which is only ever true of the bare-name form. A COMPARISON entry
+ * (`kind=type`, `kind!=type`) matched no field, was dropped, and a field whose
+ * dependencies are all comparisons — the shape every subject field of a test
+ * uses — rendered "…are not fulfilled:" with nothing after the colon. The
+ * reader was told a dependency was unmet and not which one, by a sentence that
+ * stopped mid-way.
+ *
+ * One parser for both halves, the same one the evaluator uses, so the sentence
+ * and the lock cannot disagree about what an entry means.
+ */
+var describeDependency = function (dependency, schema) {
+    var _a = (0, validations_1.parseDependency)(dependency), name = _a.name, op = _a.op, value = _a.value;
+    var dependencySchema = schema[name];
+    if (!dependencySchema) {
+        return undefined;
+    }
+    var label = "\"".concat(dependencySchema.display_name || name, "\"");
+    // `!name` names no value to compare against — it is satisfied by the sibling
+    // being unanswered — so it gets a sentence of its own rather than the
+    // comparison template, which would read `must not be "undefined"`.
+    if (op === '!') {
+        return "".concat(label, " must have no value");
+    }
+    return op ? "".concat(label, " must ").concat(op === '!=' ? 'not ' : '', "be \"").concat(value, "\"") : label;
+};
+/**
+ * The whole `depends_on` list as one phrase.
+ *
+ * A nested entry is an OR — only one of its members has to hold. It used to be
+ * flattened into the same comma-separated list as the top-level entries, which
+ * are an AND, so an either/or was shown to the reader as a set of things all
+ * required. The alternatives now stay grouped and joined by "or".
+ */
+var describeDependencies = function (dependencies, schema) {
+    return dependencies
+        .map(function (entry) {
+        if (!(0, lodash_1.isArray)(entry)) {
+            return describeDependency(entry, schema);
+        }
+        var alternatives = entry
+            .map(function (dep) { return describeDependency(dep, schema); })
+            .filter(function (dep) { return !!dep; });
+        if (!alternatives.length) {
+            return undefined;
+        }
+        return alternatives.length > 1 ? "(".concat(alternatives.join(' or '), ")") : alternatives[0];
+    })
+        .filter(function (entry) { return !!entry; })
+        .join(', ');
+};
+exports.describeDependencies = describeDependencies;
+/** One object for every available value, so identity says "nothing to show". */
+exports.ALLOWED_VALUE_AVAILABLE = Object.freeze({
+    available: true,
+});
+/**
+ * Whether an offered value can be picked, and why not.
+ *
+ * Two things can refuse a value and they render identically, because a reader
+ * has no way to tell them apart and no reason to care:
+ *
+ * - **the predicate** — the value's own `depends_on`, judged against the form
+ *   it is standing in. Whatever the form itself can decide.
+ * - **the pre-resolved refusal** — `disabled: true` with a message, from
+ *   whoever already knows. A sandbox that denies a domain, a capability of the
+ *   selected kind, a requirement in another value scope: none of them are
+ *   reachable from a sibling's answer, and a predicate that pretended otherwise
+ *   would be a predicate that never fires.
+ *
+ * The predicate is checked first when both could speak. It names a field in
+ * this very form, so the reader can act on it without leaving the row; a served
+ * reason is a statement about somewhere else.
+ *
+ * A value is never HIDDEN for either reason. A choice that vanishes takes its
+ * own explanation with it, and leaves the reader looking for something they
+ * were told exists.
+ */
+var getAllowedValueAvailability = function (value, allOptions, schema) {
+    if (!value) {
+        return exports.ALLOWED_VALUE_AVAILABLE;
+    }
+    /* `allOptions` is undefined only when there is no form around the picker at
+       all (see `OptionsContext`). A predicate about siblings has nothing to judge
+       there, and locking every gated value in a standalone picker would be a
+       rendering fault rather than a fact about the form. */
+    if ((0, lodash_1.size)(value.depends_on) &&
+        allOptions &&
+        !(0, validations_1.hasAllDependenciesFullfilled)(value.depends_on, allOptions, schema)) {
+        var dependsOn = schema ? (0, exports.describeDependencies)(value.depends_on, schema) : '';
+        return {
+            available: false,
+            intent: 'warning',
+            reason: dependsOn ?
+                "Unavailable because some dependencies are not fulfilled: ".concat(dependsOn)
+                // Nothing nameable: every entry pointed at a field this schema does
+                // not contain. A sentence that ends in a colon and then stops reads
+                // as a rendering fault rather than as a fact about the form.
+                : 'Unavailable because some dependencies are not fulfilled',
+        };
+    }
+    if (value.disabled) {
+        /* The refusal picks its own words out of `messages`, through the same
+           `when`/`unless` filter a field's messages go through — a served reason
+           can itself be conditional. The most serious one speaks: a `danger`
+           message is the one that explains a refusal, and an `info` note beside it
+           is not. */
+        var explanation = (0, options_1.getRefusalMessage)((0, exports.getShownSchemaMessages)(value.messages, allOptions, schema));
+        return {
+            available: false,
+            intent: (explanation === null || explanation === void 0 ? void 0 : explanation.intent) || 'warning',
+            title: explanation === null || explanation === void 0 ? void 0 : explanation.title,
+            // A refusal with no message at all still has to say something: silence
+            // over a value that will not respond is the defect this whole mechanism
+            // exists to remove.
+            reason: (explanation === null || explanation === void 0 ? void 0 : explanation.content) || options_1.UNAVAILABLE_VALUE_FALLBACK_REASON,
+        };
+    }
+    return exports.ALLOWED_VALUE_AVAILABLE;
+};
+exports.getAllowedValueAvailability = getAllowedValueAvailability;
+/**
+ * The availability of each offered value, against the form the picker stands in.
+ *
+ * Aligned with `items`: the result at index `i` describes `items[i]`.
+ *
+ * The answer is computed INSIDE the context selector, not from a copy of the
+ * form values pulled out of it. `OptionsContext` hands down a fresh object on
+ * every render of the engine, so a picker that selected the values themselves
+ * would re-render on every keystroke anywhere in the form; selecting the
+ * computed answer re-renders it only when an availability actually changes.
+ *
+ * Values that gate on nothing skip the computation entirely, and that is a
+ * claim about each VALUE rather than about the field it belongs to. The gate
+ * used to be one flag for the whole list, so a single gated value in a
+ * thousand-item picker resolved all thousand and serialised all thousand on
+ * every keystroke anywhere in the form. Only the gated indices are resolved
+ * and serialised; every other position is the same frozen
+ * {@link ALLOWED_VALUE_AVAILABLE}, which costs nothing to fill in and lets
+ * identity say "nothing to show".
+ */
+var useAllowedValueAvailability = function (items) {
+    var gatedIndices = (0, react_1.useMemo)(function () {
+        return (items || []).reduce(function (indices, item, index) {
+            if ((0, lodash_1.size)(item === null || item === void 0 ? void 0 : item.depends_on) || (item === null || item === void 0 ? void 0 : item.disabled) === true) {
+                indices.push(index);
+            }
+            return indices;
+        }, []);
+    }, [items]);
+    var serialized = (0, use_context_selector_1.useContextSelector)(optionsContext_1.OptionsContext, function (context) {
+        return gatedIndices.length ?
+            JSON.stringify(gatedIndices.map(function (index) {
+                return (0, exports.getAllowedValueAvailability)(items[index], context.value, context.schema);
+            }))
+            : '';
+    });
+    return (0, react_1.useMemo)(function () {
+        var result = (items || []).map(function () { return exports.ALLOWED_VALUE_AVAILABLE; });
+        if (!serialized) {
+            return result;
+        }
+        // Aligned back onto the caller's own indices: the picker asks for
+        // `availability[i]` and must get the answer for `items[i]`.
+        var resolved = JSON.parse(serialized);
+        gatedIndices.forEach(function (index, position) {
+            result[index] = resolved[position];
+        });
+        return result;
+    }, [serialized, items, gatedIndices]);
+};
+exports.useAllowedValueAvailability = useAllowedValueAvailability;
 /**
  * Compute the validation / required-group / dependency messages for an option —
  * pure, so the compact read-first rows can surface the same messages the
  * expanded editor shows (single source of truth).
  */
 var getOptionFieldMessages = function (_a) {
-    var schema = _a.schema, option = _a.option, name = _a.name, allOptions = _a.allOptions, getType = _a.getType;
+    var schema = _a.schema, option = _a.option, name = _a.name, allOptions = _a.allOptions, getType = _a.getType, untouched = _a.untouched;
     var optionSchema = schema[name];
     var result = [];
     if (option.value || option.value === false || option.value === 0 || option.value === null) {
-        var validationData = (0, validations_1.validateFieldWithResult)(getType((optionSchema === null || optionSchema === void 0 ? void 0 : optionSchema.ui_type) || option.type), option.value, __assign(__assign({ has_to_have_value: true, isFunction: option.is_expression }, optionSchema), { optionSchema: schema }));
+        /* A concrete type the VALUE carries beats an untyped schema.
+           `auto`/`any` declare no type — the author picks one (Binary, Date, …)
+           and it is recorded beside the value. Reading the schema first validated
+           a binary value as `auto`, which auto-detects from the value and accepts
+           anything, so the form said the field needed attention while the field
+           itself gave no reason. The form's own check already prefers the stored
+           type (`getOptionFieldStorageType`); this is the same precedence. */
+        var schemaType = optionSchema === null || optionSchema === void 0 ? void 0 : optionSchema.ui_type;
+        var storedType = option.type;
+        var typeToValidate = (0, optionUiTypes_1.isUntypedOptionType)(schemaType) && storedType ? storedType : schemaType || storedType;
+        var validationData = (0, validations_1.validateFieldWithResult)(getType(typeToValidate), option.value, __assign(__assign({ has_to_have_value: true, isFunction: option.is_expression }, optionSchema), { optionSchema: schema }));
         if (!validationData.isValid) {
             result.push({
                 label: validationData.reason || 'Field value is not valid',
@@ -69,7 +258,7 @@ var getOptionFieldMessages = function (_a) {
         }
     }
     else {
-        if (optionSchema === null || optionSchema === void 0 ? void 0 : optionSchema.required) {
+        if ((optionSchema === null || optionSchema === void 0 ? void 0 : optionSchema.required) && !untouched) {
             result.push({ label: 'This field is required', intent: 'danger' });
         }
         if ((optionSchema === null || optionSchema === void 0 ? void 0 : optionSchema.required_groups) &&
@@ -83,13 +272,14 @@ var getOptionFieldMessages = function (_a) {
     }
     if ((optionSchema === null || optionSchema === void 0 ? void 0 : optionSchema.depends_on) &&
         !(0, validations_1.hasAllDependenciesFullfilled)(optionSchema.depends_on, allOptions, schema)) {
-        var dependsOn = (0, lodash_1.flatten)(optionSchema.depends_on)
-            .filter(function (dep) { return !!schema[dep]; })
-            .map(function (dep) { return schema[dep].display_name || dep; })
-            .map(function (dep) { return "\"".concat(dep, "\""); })
-            .join(', ');
+        var dependsOn = (0, exports.describeDependencies)(optionSchema.depends_on, schema);
         result.push({
-            label: "This field is disabled because some dependencies are not fulfilled: ".concat(dependsOn),
+            label: dependsOn ?
+                "This field is disabled because some dependencies are not fulfilled: ".concat(dependsOn)
+                // Nothing nameable: every entry pointed at a field this schema does
+                // not contain. A sentence that ends in a colon and then stops reads
+                // as a rendering fault rather than as a fact about the form.
+                : 'This field is disabled because some dependencies are not fulfilled',
             intent: 'warning',
         });
     }
@@ -97,8 +287,8 @@ var getOptionFieldMessages = function (_a) {
 };
 exports.getOptionFieldMessages = getOptionFieldMessages;
 var OptionFieldMessages = function (_a) {
-    var schema = _a.schema, option = _a.option, name = _a.name, allOptions = _a.allOptions, getType = _a.getType;
-    var messages = (0, react_1.useMemo)(function () { return (0, exports.getOptionFieldMessages)({ schema: schema, option: option, name: name, allOptions: allOptions, getType: getType }); }, [JSON.stringify(schema), JSON.stringify(option), JSON.stringify(allOptions), name]);
+    var schema = _a.schema, option = _a.option, name = _a.name, allOptions = _a.allOptions, getType = _a.getType, untouched = _a.untouched;
+    var messages = (0, react_1.useMemo)(function () { return (0, exports.getOptionFieldMessages)({ schema: schema, option: option, name: name, allOptions: allOptions, getType: getType, untouched: untouched }); }, [JSON.stringify(schema), JSON.stringify(option), JSON.stringify(allOptions), name, untouched]);
     if (!(0, lodash_1.size)(messages)) {
         return null;
     }

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

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

package/dist/components/form/engine/_structuredData/SchemaDataView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaDataView.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/engine/_structuredData/SchemaDataView.tsx"],"names":[],"mappings":"AAOA,OAAO,EAEL,gBAAgB,EAEjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAkQ1B,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,iEAAiE;IACjE,MAAM,EAAE,gBAAgB,CAAC;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AA2UD,eAAO,MAAM,cAAc,gFAC2B,oBAAoB,6CASzE,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAAW,OAAO,UAAU,OAAO,KAAG,OASrE,CAAC"}
+{"version":3,"file":"SchemaDataView.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/engine/_structuredData/SchemaDataView.tsx"],"names":[],"mappings":"AAQA,OAAO,EAEL,gBAAgB,EAEjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAqQ1B,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,iEAAiE;IACjE,MAAM,EAAE,gBAAgB,CAAC;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAgaD,eAAO,MAAM,cAAc,gFAC2B,oBAAoB,6CASzE,CAAC;AAIF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAAW,OAAO,UAAU,OAAO,KAAG,OASrE,CAAC"}

package/dist/components/form/engine/_structuredData/SchemaDataView.js

@@ -10,12 +10,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.canRenderWithSchema = exports.SchemaDataView = void 0;
 var jsx_runtime_1 = require("react/jsx-runtime");
 var reqore_1 = require("@qoretechnologies/reqore");
+var templateText_1 = require("../../../../helpers/templateText");
 var react_1 = __importDefault(require("react"));
 var styled_components_1 = __importDefault(require("styled-components"));
 var use_context_selector_1 = require("use-context-selector");
 var compactRowContext_1 = require("../compactRowContext");
 var compactRowStyles_1 = require("../compactRowStyles");
 var readFirst_1 = require("../readFirst");
+var TemplateText_1 = require("../../fields/template/TemplateText");
 var structuredData_1 = require("./structuredData");
 /**
  * A read-only rendering of a value THROUGH the schema that describes it.
@@ -215,13 +217,40 @@ var labelColumn = function (value, schema) {
 var isNavigableUrl = function (value) {
     return typeof value === 'string' && /^(https?|wss?|ftps?):\/\//i.test(value);
 };
+/**
+ * The reference chips inside a formatted value — none when it holds no
+ * reference at all.
+ *
+ * The preview is the SAME value the row above draws, one level down, and it
+ * reached the mono cell as a raw string: a sub-field holding
+ * `$._case.mode != 'simulate'` read as a chip on the row and as the engine's
+ * own spelling in the inset beneath it, which is a row disagreeing with itself
+ * about what its value is.
+ *
+ * A field's OWN list and grammar win where it declares them — the same
+ * precedence the rows use — falling back to the form's shared catalogue.
+ */
+var referenceSegments = function (text, templates, fieldSchema) {
+    var _a;
+    if (typeof text !== 'string' || !text) {
+        return [];
+    }
+    var own = fieldSchema;
+    var segments = (0, templateText_1.templateTextSegments)(text, (_a = own === null || own === void 0 ? void 0 : own.templates) !== null && _a !== void 0 ? _a : templates, own === null || own === void 0 ? void 0 : own.templateToken);
+    return segments.some(function (segment) { return segment.kind === 'tag'; }) ? segments : [];
+};
 /** One field's value, rendered the way its row above renders it. */
 var FieldValue = function (_a) {
+    var _b;
     var field = _a.field, fieldSchema = _a.fieldSchema, color = _a.color;
     var formatted = (0, readFirst_1.formatOptionValue)(field, fieldSchema);
     // An allowed value that carries a logo shows it here too, exactly as the row
     // above does — the preview is the same value, so it gets the same treatment.
+    // An option marked with an ICON rather than a logo gets the same, for the same
+    // reason: the mark is how a list of bare words is told apart, and dropping it
+    // here would make the preview disagree with the row it previews.
     var image = (0, readFirst_1.getAllowedValueImage)(field.value, fieldSchema);
+    var icon = (0, readFirst_1.getAllowedValueIcon)(field.value, fieldSchema);
     // Data reads in mono; a chosen label does not.
     //
     // "qorus-session" is a literal the author typed — an identifier where the
@@ -231,18 +260,43 @@ var FieldValue = function (_a) {
     // dress up a label as a value. Resolving through `allowed_values` is what
     // separates the two, and it is the same lookup that produced the text.
     var isChosenLabel = !!(0, readFirst_1.findAllowedValueOption)(field.value, fieldSchema);
+    /* Read from context, like the code renderer above: a level is arbitrarily
+       deep, and the form's catalogue is a property of the form rather than of any
+       one level. See `referenceSegments`. */
+    var templates = (0, use_context_selector_1.useContextSelector)(compactRowContext_1.CompactRowContext, function (v) { return v.templates; });
+    var fieldTemplates = (_b = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.templates) !== null && _b !== void 0 ? _b : templates;
+    var segments = isNavigableUrl(field.value) ? [] : referenceSegments(formatted, templates, fieldSchema);
     return ((0, jsx_runtime_1.jsx)(compactRowStyles_1.StyledRowValue, { "$color": color, children: field.value === true || field.value === false ?
             (0, jsx_runtime_1.jsx)(reqore_1.ReqoreTag, { size: 'small', minimal: true, intent: field.value === true ? 'success' : 'danger', label: formatted })
             : (0, jsx_runtime_1.jsxs)("span", { className: "options-readfirst-valuetext".concat(isChosenLabel ? '' : ' schema-view-data'), style: isChosenLabel ? undefined : { fontFamily: compactRowStyles_1.MONO_FONT_STACK }, children: [image ?
                         (0, jsx_runtime_1.jsx)(reqore_1.ReqoreIcon, { image: image, size: '14px', style: { flexShrink: 0, marginRight: 6, verticalAlign: 'middle' } })
-                        : null, isNavigableUrl(field.value) ?
+                        : icon ?
+                            (0, jsx_runtime_1.jsx)(reqore_1.ReqoreIcon, { icon: icon, size: '14px', style: { flexShrink: 0, marginRight: 6, verticalAlign: 'middle' } })
+                            : null, isNavigableUrl(field.value) ?
                         // The address IS the link — it used to render as inert text with a
                         // separate icon button beside it to open it, which is two things
                         // where there is one. ReqoreLink renders a real anchor, so
                         // middle-click and "copy link address" still work;
                         // `stopPropagation` because the row around it toggles.
                         (0, jsx_runtime_1.jsx)(reqore_1.ReqoreLink, { className: 'schema-view-open-url', href: field.value, target: '_blank', rel: 'noreferrer noopener', onClick: function (event) { return event.stopPropagation(); }, children: formatted })
-                        : formatted] }) }));
+                        : segments.length ?
+                            // `full`: the preview is where a value that the row had to cut is
+                            // shown whole, so its chips wrap rather than clipping.
+                            (0, jsx_runtime_1.jsx)(TemplateText_1.TemplateText, { segments: segments, templates: fieldTemplates, full: true })
+                            : formatted] }) }));
+};
+/**
+ * A value with no field schema of its own — a bare entry in a list, a level
+ * that turned out to be a scalar. It still reads as prose with named chips
+ * where it holds references, because a reference is not more raw for having
+ * arrived without a schema.
+ */
+var ScalarText = function (_a) {
+    var text = _a.text, templates = _a.templates;
+    var segments = referenceSegments(text, templates);
+    return segments.length ?
+        (0, jsx_runtime_1.jsx)(TemplateText_1.TemplateText, { segments: segments, templates: templates, full: true })
+        : (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: text });
 };
 /** One described hash: its fields as label/value pairs in the shared columns. */
 var SchemaRecord = function (_a) {
@@ -302,6 +356,9 @@ var SchemaRecord = function (_a) {
 var SchemaLevel = function (_a) {
     var value = _a.value, schema = _a.schema, showTypes = _a.showTypes, colors = _a.colors;
     var inner = unwrap(value);
+    // Same reason as `FieldValue`: a heading and a bare list entry are values too,
+    // and a reference in one reads as a name everywhere else in the form.
+    var templates = (0, use_context_selector_1.useContextSelector)(compactRowContext_1.CompactRowContext, function (v) { return v.templates; });
     if (Array.isArray(inner)) {
         return ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: inner.map(function (item, index) {
                 var record = unwrap(item);
@@ -311,15 +368,21 @@ var SchemaLevel = function (_a) {
                                             if (!identity) {
                                                 return null;
                                             }
-                                            return ((0, jsx_runtime_1.jsx)(StyledItemTitle, { className: 'schema-view-item-title', "$color": colors.key, "$mono": identity.mono, "$accent": colors.accent, title: identity.label, children: identity.text }));
+                                            // An item is headed by one of its own fields, so the
+                                            // heading is that field's value and reads like it: a case
+                                            // named by a reference is named by the reference's NAME.
+                                            var titleSegments = referenceSegments(identity.text, templates, schema[identity.key]);
+                                            return ((0, jsx_runtime_1.jsx)(StyledItemTitle, { className: 'schema-view-item-title', "$color": colors.key, "$mono": identity.mono, "$accent": colors.accent, title: identity.label, children: titleSegments.length ?
+                                                    (0, jsx_runtime_1.jsx)(TemplateText_1.TemplateText, { segments: titleSegments, templates: templates, full: true })
+                                                    : identity.text }));
                                         })(), (0, jsx_runtime_1.jsx)(SchemaRecord, { record: record, schema: schema, showTypes: showTypes, colors: colors, skipKey: (0, readFirst_1.titleKeyFor)(record, schema) })] })
-                                : (0, jsx_runtime_1.jsx)(compactRowStyles_1.StyledRowValue, { "$color": colors.key, children: (0, jsx_runtime_1.jsx)("span", { className: 'options-readfirst-valuetext schema-view-data', style: { fontFamily: compactRowStyles_1.MONO_FONT_STACK }, children: (0, readFirst_1.formatOptionValue)({ value: record }) }) }) })] }, index));
+                                : (0, jsx_runtime_1.jsx)(compactRowStyles_1.StyledRowValue, { "$color": colors.key, children: (0, jsx_runtime_1.jsx)("span", { className: 'options-readfirst-valuetext schema-view-data', style: { fontFamily: compactRowStyles_1.MONO_FONT_STACK }, children: (0, jsx_runtime_1.jsx)(ScalarText, { text: (0, readFirst_1.formatOptionValue)({ value: record }), templates: templates }) }) }) })] }, index));
             }) }));
     }
     if (isRecord(inner)) {
         return (0, jsx_runtime_1.jsx)(SchemaRecord, { record: inner, schema: schema, showTypes: showTypes, colors: colors });
     }
-    return ((0, jsx_runtime_1.jsx)(reqore_1.ReqoreP, { size: 'small', style: { color: colors.key }, children: (0, readFirst_1.formatOptionValue)({ value: inner }) }));
+    return ((0, jsx_runtime_1.jsx)(reqore_1.ReqoreP, { size: 'small', style: { color: colors.key }, children: (0, jsx_runtime_1.jsx)(ScalarText, { text: (0, readFirst_1.formatOptionValue)({ value: inner }), templates: templates }) }));
 };
 exports.SchemaDataView = react_1.default.memo(function (_a) {
     var _b;