@uipath/apollo-react 7.2.1 → 7.3.0

package/dist/canvas/components/Guardrails/use-guardrail-definitions.js

@@ -1,97 +1,24 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useMemo } from "react";
 import { useGuardrailDefinitionCopy } from "./definitions-copy.js";
 import { enrichGuardrailDefinitions } from "./definitions-enrich.js";
 import { parseGuardrailDefinitions } from "./definitions-parse.js";
+import { useGuardrailsRequest } from "./use-guardrails-request.js";
 const GUARDRAIL_DEFINITIONS_PATH = '/api/execution/guardrails/definitions';
 const EMPTY_RESULT = {
     definitions: [],
     invalid: []
 };
-const NOTHING_SETTLED = {
-    key: 'none',
-    result: EMPTY_RESULT,
-    error: null
-};
 function useGuardrailDefinitions(ctx, options = {}) {
     const { definitions: provided, hiddenValidators, copy: copyOverride, enabled: enabledOption = true } = options;
     const linguiCopy = useGuardrailDefinitionCopy();
     const copy = copyOverride ?? linguiCopy;
-    const requestKey = null === ctx ? '' : JSON.stringify({
-        baseUrl: ctx.baseUrl,
-        token: ctx.token,
-        tenantId: ctx.tenantId,
-        accountId: ctx.accountId,
-        headers: ctx.headers
+    const { data: fetched, loading, error, refetch } = useGuardrailsRequest(ctx, {
+        path: GUARDRAIL_DEFINITIONS_PATH,
+        endpointName: 'Guardrail definitions',
+        parse: parseGuardrailDefinitions,
+        empty: EMPTY_RESULT,
+        enabled: enabledOption && void 0 === provided
     });
-    const request = useMemo(()=>'' === requestKey ? null : JSON.parse(requestKey), [
-        requestKey
-    ]);
-    const fetchRef = useRef(ctx?.fetch);
-    fetchRef.current = ctx?.fetch;
-    const enabled = enabledOption && void 0 === provided && null !== request;
-    const [settled, setSettled] = useState(NOTHING_SETTLED);
-    const [inFlight, setInFlight] = useState(false);
-    const abortRef = useRef(null);
-    const isCurrent = enabled && settled.key === requestKey;
-    const fetched = isCurrent ? settled.result : EMPTY_RESULT;
-    const error = isCurrent ? settled.error : null;
-    const loading = enabled && (inFlight || !isCurrent);
-    const load = useCallback(async ()=>{
-        if (!enabled || null === request) return;
-        abortRef.current?.abort();
-        const controller = new AbortController();
-        abortRef.current = controller;
-        const key = requestKey;
-        setInFlight(true);
-        const base = (request.baseUrl ?? '').replace(/\/$/, '');
-        const headers = {
-            Accept: 'application/json',
-            'X-UiPath-Internal-TenantId': request.tenantId
-        };
-        if (request.token) headers.Authorization = `Bearer ${request.token}`;
-        if (request.accountId) headers['X-UiPath-Internal-AccountId'] = request.accountId;
-        Object.assign(headers, request.headers);
-        const doFetch = fetchRef.current ?? ((input, init)=>globalThis.fetch(input, init));
-        try {
-            const response = await doFetch(`${base}${GUARDRAIL_DEFINITIONS_PATH}`, {
-                headers,
-                signal: controller.signal
-            });
-            if (!response.ok) throw new Error(`Guardrail definitions API ${response.status} ${response.statusText}`);
-            const payload = await response.json();
-            if (!controller.signal.aborted) setSettled({
-                key,
-                result: parseGuardrailDefinitions(payload),
-                error: null
-            });
-        } catch (err) {
-            if (err?.name === 'AbortError') return;
-            if (!controller.signal.aborted) setSettled((prev)=>({
-                    key,
-                    result: prev.key === key ? prev.result : EMPTY_RESULT,
-                    error: err instanceof Error ? err : new Error(String(err))
-                }));
-        } finally{
-            if (!controller.signal.aborted) setInFlight(false);
-        }
-    }, [
-        enabled,
-        request,
-        requestKey
-    ]);
-    useEffect(()=>{
-        if (!enabled) {
-            abortRef.current?.abort();
-            setInFlight(false);
-            setSettled((prev)=>prev === NOTHING_SETTLED ? prev : NOTHING_SETTLED);
-            return;
-        }
-        load();
-        return ()=>abortRef.current?.abort();
-    }, [
-        enabled,
-        load
-    ]);
     const parsed = useMemo(()=>void 0 === provided ? fetched : parseGuardrailDefinitions(provided), [
         provided,
         fetched
@@ -115,7 +42,7 @@ function useGuardrailDefinitions(ctx, options = {}) {
         inputError: parsed.inputError,
         loading,
         error,
-        refetch: load
+        refetch
     };
 }
 export { GUARDRAIL_DEFINITIONS_PATH, useGuardrailDefinitions };

package/dist/canvas/components/Guardrails/use-guardrails-request.cjs

@@ -0,0 +1,133 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    useGuardrailsRequest: ()=>useGuardrailsRequest
+});
+const external_react_namespaceObject = require("react");
+const NOTHING_SETTLED_KEY = 'none';
+function useGuardrailsRequest(ctx, { path, endpointName, parse, empty, enabled: enabledOption }) {
+    const requestKey = null === ctx ? '' : JSON.stringify({
+        baseUrl: ctx.baseUrl,
+        token: ctx.token,
+        tenantId: ctx.tenantId,
+        accountId: ctx.accountId,
+        headers: ctx.headers
+    });
+    const request = (0, external_react_namespaceObject.useMemo)(()=>'' === requestKey ? null : JSON.parse(requestKey), [
+        requestKey
+    ]);
+    const fetchRef = (0, external_react_namespaceObject.useRef)(ctx?.fetch);
+    fetchRef.current = ctx?.fetch;
+    const enabled = enabledOption && null !== request;
+    const nothingSettled = (0, external_react_namespaceObject.useMemo)(()=>({
+            key: NOTHING_SETTLED_KEY,
+            data: empty,
+            error: null
+        }), [
+        empty
+    ]);
+    const [settled, setSettled] = (0, external_react_namespaceObject.useState)(nothingSettled);
+    const [inFlight, setInFlight] = (0, external_react_namespaceObject.useState)(false);
+    const abortRef = (0, external_react_namespaceObject.useRef)(null);
+    const isCurrent = enabled && settled.key === requestKey;
+    const data = isCurrent ? settled.data : empty;
+    const error = isCurrent ? settled.error : null;
+    const loading = enabled && (inFlight || !isCurrent);
+    const load = (0, external_react_namespaceObject.useCallback)(async ()=>{
+        if (!enabled || null === request) return;
+        abortRef.current?.abort();
+        const controller = new AbortController();
+        abortRef.current = controller;
+        const key = requestKey;
+        setInFlight(true);
+        const base = (request.baseUrl ?? '').replace(/\/$/, '');
+        const headers = {
+            Accept: 'application/json',
+            'X-UiPath-Internal-TenantId': request.tenantId
+        };
+        if (request.token) headers.Authorization = `Bearer ${request.token}`;
+        if (request.accountId) headers['X-UiPath-Internal-AccountId'] = request.accountId;
+        Object.assign(headers, request.headers);
+        const doFetch = fetchRef.current ?? ((input, init)=>globalThis.fetch(input, init));
+        try {
+            const response = await doFetch(`${base}${path}`, {
+                headers,
+                signal: controller.signal
+            });
+            if (!response.ok) throw new Error(`${endpointName} API ${response.status} ${response.statusText}`);
+            const payload = await response.json();
+            if (!controller.signal.aborted) setSettled({
+                key,
+                data: parse(payload),
+                error: null
+            });
+        } catch (err) {
+            if (err?.name === 'AbortError') return;
+            if (!controller.signal.aborted) setSettled((prev)=>({
+                    key,
+                    data: prev.key === key ? prev.data : empty,
+                    error: err instanceof Error ? err : new Error(String(err))
+                }));
+        } finally{
+            if (!controller.signal.aborted) setInFlight(false);
+        }
+    }, [
+        enabled,
+        request,
+        requestKey,
+        path,
+        endpointName,
+        parse,
+        empty
+    ]);
+    (0, external_react_namespaceObject.useEffect)(()=>{
+        if (!enabled) {
+            abortRef.current?.abort();
+            setInFlight(false);
+            setSettled((prev)=>prev === nothingSettled ? prev : nothingSettled);
+            return;
+        }
+        load();
+        return ()=>abortRef.current?.abort();
+    }, [
+        enabled,
+        load,
+        nothingSettled
+    ]);
+    return {
+        data,
+        loading,
+        error,
+        refetch: load
+    };
+}
+exports.useGuardrailsRequest = __webpack_exports__.useGuardrailsRequest;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "useGuardrailsRequest"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/canvas/components/Guardrails/use-guardrails-request.d.ts

@@ -0,0 +1,23 @@
+export interface GuardrailDefinitionsRequestContext {
+    baseUrl?: string;
+    token?: string;
+    tenantId: string;
+    accountId?: string;
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+}
+interface GuardrailsRequestOptions<T> {
+    path: string;
+    endpointName: string;
+    parse: (payload: unknown) => T;
+    empty: T;
+    enabled: boolean;
+}
+export declare function useGuardrailsRequest<T>(ctx: GuardrailDefinitionsRequestContext | null, { path, endpointName, parse, empty, enabled: enabledOption }: GuardrailsRequestOptions<T>): {
+    data: T;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+export {};
+//# sourceMappingURL=use-guardrails-request.d.ts.map

package/dist/canvas/components/Guardrails/use-guardrails-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-guardrails-request.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/Guardrails/use-guardrails-request.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kCAAkC;IAEjD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,QAAQ,EAAE,MAAM,CAAC;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,UAAU,wBAAwB,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,YAAY,EAAE,MAAM,CAAC;IAErB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;CAClB;AAoBD,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,GAAG,EAAE,kCAAkC,GAAG,IAAI,EAC9C,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACxF;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA0HzE"}

package/dist/canvas/components/Guardrails/use-guardrails-request.js

@@ -0,0 +1,99 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+const NOTHING_SETTLED_KEY = 'none';
+function useGuardrailsRequest(ctx, { path, endpointName, parse, empty, enabled: enabledOption }) {
+    const requestKey = null === ctx ? '' : JSON.stringify({
+        baseUrl: ctx.baseUrl,
+        token: ctx.token,
+        tenantId: ctx.tenantId,
+        accountId: ctx.accountId,
+        headers: ctx.headers
+    });
+    const request = useMemo(()=>'' === requestKey ? null : JSON.parse(requestKey), [
+        requestKey
+    ]);
+    const fetchRef = useRef(ctx?.fetch);
+    fetchRef.current = ctx?.fetch;
+    const enabled = enabledOption && null !== request;
+    const nothingSettled = useMemo(()=>({
+            key: NOTHING_SETTLED_KEY,
+            data: empty,
+            error: null
+        }), [
+        empty
+    ]);
+    const [settled, setSettled] = useState(nothingSettled);
+    const [inFlight, setInFlight] = useState(false);
+    const abortRef = useRef(null);
+    const isCurrent = enabled && settled.key === requestKey;
+    const data = isCurrent ? settled.data : empty;
+    const error = isCurrent ? settled.error : null;
+    const loading = enabled && (inFlight || !isCurrent);
+    const load = useCallback(async ()=>{
+        if (!enabled || null === request) return;
+        abortRef.current?.abort();
+        const controller = new AbortController();
+        abortRef.current = controller;
+        const key = requestKey;
+        setInFlight(true);
+        const base = (request.baseUrl ?? '').replace(/\/$/, '');
+        const headers = {
+            Accept: 'application/json',
+            'X-UiPath-Internal-TenantId': request.tenantId
+        };
+        if (request.token) headers.Authorization = `Bearer ${request.token}`;
+        if (request.accountId) headers['X-UiPath-Internal-AccountId'] = request.accountId;
+        Object.assign(headers, request.headers);
+        const doFetch = fetchRef.current ?? ((input, init)=>globalThis.fetch(input, init));
+        try {
+            const response = await doFetch(`${base}${path}`, {
+                headers,
+                signal: controller.signal
+            });
+            if (!response.ok) throw new Error(`${endpointName} API ${response.status} ${response.statusText}`);
+            const payload = await response.json();
+            if (!controller.signal.aborted) setSettled({
+                key,
+                data: parse(payload),
+                error: null
+            });
+        } catch (err) {
+            if (err?.name === 'AbortError') return;
+            if (!controller.signal.aborted) setSettled((prev)=>({
+                    key,
+                    data: prev.key === key ? prev.data : empty,
+                    error: err instanceof Error ? err : new Error(String(err))
+                }));
+        } finally{
+            if (!controller.signal.aborted) setInFlight(false);
+        }
+    }, [
+        enabled,
+        request,
+        requestKey,
+        path,
+        endpointName,
+        parse,
+        empty
+    ]);
+    useEffect(()=>{
+        if (!enabled) {
+            abortRef.current?.abort();
+            setInFlight(false);
+            setSettled((prev)=>prev === nothingSettled ? prev : nothingSettled);
+            return;
+        }
+        load();
+        return ()=>abortRef.current?.abort();
+    }, [
+        enabled,
+        load,
+        nothingSettled
+    ]);
+    return {
+        data,
+        loading,
+        error,
+        refetch: load
+    };
+}
+export { useGuardrailsRequest };

package/dist/canvas/components/Guardrails/utils.cjs

@@ -81,7 +81,8 @@ function normalizeGuardrailParameters(parameters, definitions) {
     });
     return changed ? next : parameters;
 }
-function syncMapEnumParameters(parameters, definitions) {
+function syncMapEnumParameters(parameters, definitions, options) {
+    const leaveUnset = new Set(options?.leaveUnsetIds);
     const selectionBySourceId = new Map();
     for (const param of parameters)if ('enum-list' === param.$parameterType && Array.isArray(param.value)) selectionBySourceId.set(param.id, param.value);
     const defById = new Map(definitions.map((d)=>[
@@ -102,7 +103,8 @@ function syncMapEnumParameters(parameters, definitions) {
         const synced = {};
         for (const key of allowedKeys){
             const persisted = currentMap[key];
-            synced[key] = 'number' == typeof persisted && Number.isFinite(persisted) ? persisted : defaults[key] ?? fallback;
+            if ('number' == typeof persisted && Number.isFinite(persisted)) synced[key] = persisted;
+            else if (!leaveUnset.has(param.id)) synced[key] = defaults[key] ?? fallback;
         }
         return {
             ...param,

package/dist/canvas/components/Guardrails/utils.d.ts

@@ -2,7 +2,10 @@ import type { GuardrailDetectionScope, GuardrailParameterDefinition, GuardrailVa
 export declare function coerceParameterValueToType(value: unknown, paramDef: Pick<GuardrailParameterDefinition, 'type' | 'min'>): GuardrailValidatorParameter['value'];
 export declare function seedGuardrailParameters(definitions: GuardrailParameterDefinition[], existing?: GuardrailValidatorParameter[]): GuardrailValidatorParameter[];
 export declare function normalizeGuardrailParameters(parameters: readonly GuardrailValidatorParameter[], definitions: readonly GuardrailParameterDefinition[]): GuardrailValidatorParameter[];
-export declare function syncMapEnumParameters(parameters: GuardrailValidatorParameter[], definitions: GuardrailParameterDefinition[]): GuardrailValidatorParameter[];
+export declare function syncMapEnumParameters(parameters: GuardrailValidatorParameter[], definitions: GuardrailParameterDefinition[], options?: SyncMapEnumParametersOptions): GuardrailValidatorParameter[];
+export interface SyncMapEnumParametersOptions {
+    leaveUnsetIds?: readonly string[];
+}
 export declare function dropEmptyOptionalParameters(parameters: readonly GuardrailValidatorParameter[], definitions: readonly GuardrailParameterDefinition[]): GuardrailValidatorParameter[];
 export declare function getOutOfRangeParameterIds(definitions: readonly GuardrailParameterDefinition[], parameters: readonly GuardrailValidatorParameter[]): string[];
 export declare function getRequiredEmptyParameterIds(definitions: readonly GuardrailParameterDefinition[], parameters: readonly GuardrailValidatorParameter[]): string[];

package/dist/canvas/components/Guardrails/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/Guardrails/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAcjB,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,IAAI,CAAC,4BAA4B,EAAE,MAAM,GAAG,KAAK,CAAC,GAC3D,2BAA2B,CAAC,OAAO,CAAC,CAmBtC;AAQD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,4BAA4B,EAAE,EAC3C,QAAQ,CAAC,EAAE,2BAA2B,EAAE,GACvC,2BAA2B,EAAE,CAU/B;AAWD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,SAAS,2BAA2B,EAAE,EAClD,WAAW,EAAE,SAAS,4BAA4B,EAAE,GACnD,2BAA2B,EAAE,CAoB/B;AAcD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,2BAA2B,EAAE,EACzC,WAAW,EAAE,4BAA4B,EAAE,GAC1C,2BAA2B,EAAE,CA2C/B;AAQD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,SAAS,2BAA2B,EAAE,EAClD,WAAW,EAAE,SAAS,4BAA4B,EAAE,GACnD,2BAA2B,EAAE,CAW/B;AAeD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,4BAA4B,EAAE,EACpD,UAAU,EAAE,SAAS,2BAA2B,EAAE,GACjD,MAAM,EAAE,CA6BV;AAUD,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,SAAS,4BAA4B,EAAE,EACpD,UAAU,EAAE,SAAS,2BAA2B,EAAE,GACjD,MAAM,EAAE,CA+BV;AAED,eAAO,MAAM,sCAAsC,mBAAmB,CAAC;AAQvE,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,4BAA4B,EAAE,EACpD,UAAU,EAAE,SAAS,2BAA2B,EAAE,GACjD,uBAAuB,GAAG,SAAS,CAarC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/Guardrails/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAcjB,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,IAAI,CAAC,4BAA4B,EAAE,MAAM,GAAG,KAAK,CAAC,GAC3D,2BAA2B,CAAC,OAAO,CAAC,CAmBtC;AAQD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,4BAA4B,EAAE,EAC3C,QAAQ,CAAC,EAAE,2BAA2B,EAAE,GACvC,2BAA2B,EAAE,CAU/B;AAWD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,SAAS,2BAA2B,EAAE,EAClD,WAAW,EAAE,SAAS,4BAA4B,EAAE,GACnD,2BAA2B,EAAE,CAoB/B;AAeD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,2BAA2B,EAAE,EACzC,WAAW,EAAE,4BAA4B,EAAE,EAC3C,OAAO,CAAC,EAAE,4BAA4B,GACrC,2BAA2B,EAAE,CA6C/B;AAED,MAAM,WAAW,4BAA4B;IAK3C,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAQD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,SAAS,2BAA2B,EAAE,EAClD,WAAW,EAAE,SAAS,4BAA4B,EAAE,GACnD,2BAA2B,EAAE,CAW/B;AAeD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,4BAA4B,EAAE,EACpD,UAAU,EAAE,SAAS,2BAA2B,EAAE,GACjD,MAAM,EAAE,CA6BV;AAUD,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,SAAS,4BAA4B,EAAE,EACpD,UAAU,EAAE,SAAS,2BAA2B,EAAE,GACjD,MAAM,EAAE,CA+BV;AAED,eAAO,MAAM,sCAAsC,mBAAmB,CAAC;AAQvE,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,4BAA4B,EAAE,EACpD,UAAU,EAAE,SAAS,2BAA2B,EAAE,GACjD,uBAAuB,GAAG,SAAS,CAarC"}

package/dist/canvas/components/Guardrails/utils.js

@@ -45,7 +45,8 @@ function normalizeGuardrailParameters(parameters, definitions) {
     });
     return changed ? next : parameters;
 }
-function syncMapEnumParameters(parameters, definitions) {
+function syncMapEnumParameters(parameters, definitions, options) {
+    const leaveUnset = new Set(options?.leaveUnsetIds);
     const selectionBySourceId = new Map();
     for (const param of parameters)if ('enum-list' === param.$parameterType && Array.isArray(param.value)) selectionBySourceId.set(param.id, param.value);
     const defById = new Map(definitions.map((d)=>[
@@ -66,7 +67,8 @@ function syncMapEnumParameters(parameters, definitions) {
         const synced = {};
         for (const key of allowedKeys){
             const persisted = currentMap[key];
-            synced[key] = 'number' == typeof persisted && Number.isFinite(persisted) ? persisted : defaults[key] ?? fallback;
+            if ('number' == typeof persisted && Number.isFinite(persisted)) synced[key] = persisted;
+            else if (!leaveUnset.has(param.id)) synced[key] = defaults[key] ?? fallback;
         }
         return {
             ...param,