@uipath/maestro-builder-sdk 6.33.2 → 6.35.0

package/dist/nodes/hitl/flow/node-type.js

@@ -13,7 +13,7 @@
  * every edge out of an outcome-handle node to.
  */
 import { Expr, toExpr } from '../../../core/expr.js';
-import { formFieldJsonSchema, formFieldOptionsWire, liftFormFieldOptions, sourceFormFieldType, wireFormFieldType } from '../../../core/form-field-type.js';
+import { formFieldJsonSchema, formFieldRowLoss, formFieldRowLossMessage, formFieldSettingsSource, formFieldSettingsWire, liftFormFieldSettings, sourceFormFieldType, wireFormFieldType, } from '../../../core/form-field-type.js';
 import { isAnswerField } from '../../../core/hitl-answers.js';
 import { OUTCOME_HANDLE_NODE_TYPES, hitlExitModel, outcomeIdOf, outcomeSlug } from '../../../core/hitl-routing.js';
 import { jsonClone } from '../../../core/json-clone.js';
@@ -75,23 +75,23 @@ function hitlInputs(inputs, nodeType, ctx) {
             // contract flow-v1's serializer reads), and the WRITE target is the field
             // id itself — deliberately decoupled from the binding, so no `variable`.
             base.binding = bindingPath(f.value, ctx);
-            if (f.required)
-                base.required = true;
+            const required = f.required;
+            if (typeof required === 'boolean')
+                base.required = required;
         }
         else {
             // The answer's landing variable. The platform falls back to the field id
             // when this is absent; naming it keeps the emitted flow explicit and
             // matches what the designer writes.
             base.variable = `vars.${f.id}`;
-            if (f.required)
-                base.required = true;
+            const required = f.required;
+            if (typeof required === 'boolean')
+                base.required = required;
         }
-        // A picker's choices (a `singleSelect` dropdown, a `multiSelect`), as the
-        // canvas stores them on the row (#1235).
-        const options = formFieldOptionsWire(f.options);
-        if (options !== undefined)
-            base.options = options;
-        return base;
+        // The field's settings — `controlType`, a picker's `options`,
+        // `defaultValue`, `colSpan`, `rules`, … — as the canvas stores them on the
+        // row, in the platform's key order (#1235, #1250).
+        return { ...base, ...formFieldSettingsWire(f) };
     });
     const outcomes = (inputs?.outcomes ?? []).map((o, i) => {
         const name = typeof o === 'string' ? o : o?.name;
@@ -331,7 +331,11 @@ function liftHitl(node, typeName, ctx) {
         const id = String(f.id ?? '');
         const direction = String(f.direction ?? 'output');
         const value = direction === 'input' || direction === 'inOut' ? bindingExpr(f.binding) : undefined;
-        const options = liftFormFieldOptions(f.options);
+        // Every row key the source cannot carry is reported, never dropped
+        // silently: a warning, an error under --strict (#1250).
+        const loss = formFieldRowLoss(f, 'human task');
+        if (loss.length > 0)
+            ctx.lossy(formFieldRowLossMessage(`human task ${JSON.stringify(n.id)}`, id, loss));
         return {
             id,
             // serialize defaults a row's label to its id.
@@ -341,8 +345,8 @@ function liftHitl(node, typeName, ctx) {
             type: sourceFormFieldType(f.type ?? 'string'),
             direction,
             ...(value !== undefined ? { value } : {}),
-            ...(f.required === true ? { required: true } : {}),
-            ...(options !== undefined ? { options } : {}),
+            ...(typeof f.required === 'boolean' && direction !== 'input' ? { required: f.required } : {}),
+            ...liftFormFieldSettings(f),
         };
     });
     const outcomeRows = (Array.isArray(schema.outcomes) ? schema.outcomes : []);
@@ -504,12 +508,8 @@ function printHitl({ inputs }, ctx) {
         ['type', ctx.string(f.type)],
         ['direction', ctx.string(f.direction)],
         ['value', f.value !== undefined ? ctx.value(f.value) : undefined],
-        ['required', f.required ? 'true' : undefined],
-        ['options', f.options !== undefined ? `[${f.options.map((o) => obj([
-                ['id', ctx.string(o.id)],
-                ['value', ctx.string(o.value)],
-                ['label', ctx.string(o.label)],
-            ], ctx)).join(', ')}]` : undefined],
+        ['required', f.required !== undefined ? String(f.required) : undefined],
+        ...formFieldSettingsSource(f, ctx.value),
     ], ctx));
     const outcomes = h.outcomes.map((o) => (typeof o === 'string' ? ctx.string(o) : obj([
         ['name', ctx.string(o.name)],

package/dist/schema-version.js

@@ -106,11 +106,16 @@ export function schemaVersionRefusal(policy, requested) {
     if (isWritableSchemaVersion(policy, requested))
         return undefined;
     const writable = writableSchemaVersions(policy);
+    const newestWritable = writable.at(-1);
     const direction = policy.latestKnown !== undefined && schemaVersionAtLeast(requested, policy.latestKnown)
         ? compareSchemaVersions(requested, policy.latestKnown) > 0
             ? `The platform's newest known ${family} schema version is ${policy.latestKnown}, so ${requested} is newer than anything this SDK has read.`
             : `${requested} is the platform's current ${family} schema version, but this SDK build has not been taught to write it.`
-        : `${requested} is older than the ${writable.length === 1 ? 'one version' : 'versions'} this build writes.`;
+        : newestWritable !== undefined && compareSchemaVersions(requested, newestWritable) > 0
+            ? `${requested} is a platform ${family} schema version newer than this build writes`
+                + (policy.latestKnown !== undefined ? ` (the platform's current is ${policy.latestKnown})` : '')
+                + '; this SDK build has not been taught to write it.'
+            : `${requested} is older than the ${writable.length === 1 ? 'one version' : 'versions'} this build writes.`;
     return (`${method}("${requested}"): this SDK build writes ${family} schema ${writable.join(' / ')}. ${direction} `
         + `A document's version claims that the WHOLE document matches that schema, so declaring one this build cannot emit `
         + `would write a false claim rather than a different document. ${policy.migration}`);

package/dist/serialize.js

@@ -20,7 +20,7 @@ import { FLOW_NODE_TYPES } from './flow-node-registry.js';
 import { stepExits } from './flow-step-exits.js';
 import { resolveVersionCarried } from './core/nodes/versioned.js';
 import { indexCarriedDefinitions } from './core/carried-definitions.js';
-import { formFieldJsonSchema, formFieldOptionsWire, wireFormFieldType } from './core/form-field-type.js';
+import { formFieldJsonSchema, formFieldSettingsWire, wireFormFieldType } from './core/form-field-type.js';
 import { ConnectorResolveError } from './core/connector-resolve-error.js';
 import { connectionConnectors } from './bindings-v2.js';
 import { BindingRefusal, GUID_RE, bindingLabelRefusal, bindingMissingMessage, missingBindingLabels } from './core/binding-messages.js';
@@ -5751,14 +5751,17 @@ export function serialize(built, opts = {}) {
                     qnode.display = { ...qnode.display, shape: 'circle' };
                     delete qnode.model;
                     const rows = (esc.fields ?? []).map((f) => {
-                        const options = formFieldOptionsWire(f.options);
+                        const required = f.direction === 'input' ? undefined : f.required;
                         return {
                             id: f.id,
                             label: f.label ?? f.id,
                             type: wireFormFieldType(f.type),
                             direction: f.direction,
-                            // A picker's choices, as the human task's rows carry them (#1235).
-                            ...(options !== undefined ? { options } : {}),
+                            ...(typeof required === 'boolean' ? { required } : {}),
+                            // The field's settings (`controlType`, a picker's `options`,
+                            // `defaultValue`, `colSpan`, …), as the human task's rows carry
+                            // them (#1235, #1250).
+                            ...formFieldSettingsWire(f),
                         };
                     });
                     const qsource = esc.source ?? derivedEscalationSource(built.id, step.name, esc.name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.33.2",
+  "version": "6.35.0",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -93,5 +93,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "04124f15f4e70827cb18bbd0f52c0bf676ceedd1"
+  "gitref": "467e33fe1378eddf63acb88201f18ecac8a73967"
 }