@uipath/maestro-builder-sdk 6.17.5 → 6.18.0

package/dist/bpmn/decompile.js

@@ -60,6 +60,7 @@ import { SCRIPT_ARGS_ENVELOPE, defaultScriptInputSchema } from './serialize.js';
 import { BPMN_SCHEMA_VERSIONS } from './format-profile.js';
 import { preserveSchemaVersion } from '../schema-version.js';
 import { commentText } from '../core/comment-text.js';
+import { tsLiteral, tsText } from '../core/ts-literal.js';
 const require = createRequire(import.meta.url);
 const uipathDescriptor = require('./uipath-moddle.v1.json');
 /**
@@ -78,21 +79,6 @@ let pinExplicitInBodies = false;
  */
 let foldedVarSchemas;
 // ─── Source emitters ──────────────────────────────────────────────────────────
-/**
- * A JS/TS string literal.
- *
- * `JSON.stringify` escapes quotes, backslashes and control characters, so a value
- * out of an untrusted `.bpmn` — a label, an expression, a URL — can never break
- * out of the literal and become code in the emitted source. U+2028/U+2029 are
- * escaped too: legal in JSON, historically illegal in JS string literals.
- */
-function str(s) {
-    return JSON.stringify(String(s ?? '')).replace(/[\u2028\u2029]/g, (c) => `\\u${c.charCodeAt(0).toString(16)}`);
-}
-/** An arbitrary JSON value as an inert TS literal. Never executable. */
-function literal(v) {
-    return JSON.stringify(v ?? null);
-}
 /**
  * Schema bodies that need no declaration, because the platform defines them.
  *
@@ -144,7 +130,7 @@ function planSchemas(rows) {
         }
         else if (count > 1) {
             const id = schemaIdFrom(firstName.get(text), taken);
-            plan.ref.set(text, str(id));
+            plan.ref.set(text, tsText(id));
             plan.declare.push([id, jsonLiteral(text)]);
         }
     }
@@ -165,7 +151,7 @@ function planSchemas(rows) {
  */
 function jsonLiteral(body) {
     const value = jsonValue(body);
-    return typeof value === 'string' ? str(value) : literal(value);
+    return typeof value === 'string' ? tsText(value) : tsLiteral(value ?? null);
 }
 /**
  * The same decision, as a VALUE rather than as source text — for a body that lands
@@ -195,7 +181,7 @@ function jsonValue(body) {
 }
 /** An object key: a bare identifier when legal, otherwise a quoted string. */
 function key(k) {
-    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(k) ? k : str(k);
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(k) ? k : tsText(k);
 }
 /** Render `{ a: 1, b: 2 }` from the entries that are present; `''` when none are. */
 function opts(entries) {
@@ -215,7 +201,7 @@ function record(r) {
     if (!r || Object.keys(r).length === 0)
         return undefined;
     return `{ ${Object.entries(r)
-        .map(([k, v]) => `${key(k)}: ${typeof v === 'string' ? str(v) : literal(v)}`)
+        .map(([k, v]) => `${key(k)}: ${typeof v === 'string' ? tsText(v) : tsLiteral(v ?? null)}`)
         .join(', ')} }`;
 }
 /**
@@ -309,12 +295,12 @@ function emitContextRows(payload) {
         return undefined;
     return `[${rows
         .map((r) => opts([
-        ['name', str(r.name)],
-        ['type', r.type !== undefined ? str(r.type) : undefined],
+        ['name', tsText(r.name)],
+        ['type', r.type !== undefined ? tsText(r.type) : undefined],
         ['required', r.required !== undefined ? 'true' : undefined],
-        ['target', r.target !== undefined ? str(r.target) : undefined],
-        ['value', r.value !== undefined ? str(r.value) : undefined],
-        ['body', r.body !== undefined ? (r.type === 'json' ? jsonLiteral(r.body) : str(String(r.body))) : undefined],
+        ['target', r.target !== undefined ? tsText(r.target) : undefined],
+        ['value', r.value !== undefined ? tsText(r.value) : undefined],
+        ['body', r.body !== undefined ? (r.type === 'json' ? jsonLiteral(r.body) : tsText(String(r.body))) : undefined],
     ]))
         .join(', ')}]`;
 }
@@ -339,11 +325,11 @@ function emitRetry(retry) {
         return undefined;
     return opts([
         ['maxRetries', String(count)],
-        ['backoff', retry.retryBackoff ? str(retry.retryBackoff) : undefined],
-        ['backoffType', retry.retryBackoffType === 'Exponential' ? str('exponential') : undefined],
+        ['backoff', retry.retryBackoff ? tsText(retry.retryBackoff) : undefined],
+        ['backoffType', retry.retryBackoffType === 'Exponential' ? tsText('exponential') : undefined],
         ['exponentialBase', retry.exponentialBase !== undefined ? String(Number(retry.exponentialBase)) : undefined],
         ['allErrors', retry.retryAllErrors === 'true' || retry.retryAllErrors === true ? 'true' : undefined],
-        ['maxDuration', retry.maxDuration ? str(retry.maxDuration) : undefined],
+        ['maxDuration', retry.maxDuration ? tsText(retry.maxDuration) : undefined],
     ]);
 }
 /** The `uipath:ErrorMapping` element on an element, if it has one. */
@@ -366,14 +352,14 @@ function emitErrorMapping(em) {
     if (!rows.length)
         return undefined;
     const parts = rows.map((r) => opts([
-        ['code', str(r.errorRef ?? '')],
+        ['code', tsText(r.errorRef ?? '')],
         ['retryable', r.retryable === undefined ? undefined : r.retryable === 'true' || r.retryable === true ? 'true' : 'false'],
-        ['id', r.id !== undefined ? str(r.id) : undefined],
+        ['id', r.id !== undefined ? tsText(r.id) : undefined],
         // A numeric-looking priority round-trips as a number; anything else stays a
         // string, since the wire is a string either way and the author's form is unknown.
-        ['priority', r.priority === undefined ? undefined : /^-?\d+$/.test(String(r.priority)) ? String(Number(r.priority)) : str(r.priority)],
-        ['condition', r.condition !== undefined ? str(r.condition) : undefined],
-        ['detail', r.detail !== undefined ? str(r.detail) : undefined],
+        ['priority', r.priority === undefined ? undefined : /^-?\d+$/.test(String(r.priority)) ? String(Number(r.priority)) : tsText(r.priority)],
+        ['condition', r.condition !== undefined ? tsText(r.condition) : undefined],
+        ['detail', r.detail !== undefined ? tsText(r.detail) : undefined],
     ]));
     return `[${parts.join(', ')}]`;
 }
@@ -386,10 +372,10 @@ function emitLoop(el) {
     if (!uip)
         return undefined;
     return opts([
-        ['collection', str(uip.inputCollection ?? '')],
-        ['itemVar', str(uip.inputElement ?? 'item')],
+        ['collection', tsText(uip.inputCollection ?? '')],
+        ['itemVar', tsText(uip.inputElement ?? 'item')],
         ['sequential', loop.isSequential ? 'true' : undefined],
-        ['completion', loop.completionCondition?.body ? str(loop.completionCondition.body) : undefined],
+        ['completion', loop.completionCondition?.body ? tsText(loop.completionCondition.body) : undefined],
     ]);
 }
 /** An event definition back into the `{ message | timer | error | terminate }` option. */
@@ -399,7 +385,7 @@ function eventOptions(el) {
         return [];
     switch (def.$type) {
         case 'bpmn:MessageEventDefinition':
-            return [['message', str(def.messageRef?.name ?? '')]];
+            return [['message', tsText(def.messageRef?.name ?? '')]];
         case 'bpmn:TerminateEventDefinition':
             return [['terminate', 'true']];
         case 'bpmn:ErrorEventDefinition': {
@@ -412,7 +398,7 @@ function eventOptions(el) {
             // The builder defaults an error's code to its name, so re-emitting the pair
             // only matters when they differ — otherwise the shorter form round-trips.
             return [
-                ['error', ref.errorCode && ref.errorCode !== ref.name ? opts([['name', str(ref.name)], ['code', str(ref.errorCode)]]) : str(ref.name)],
+                ['error', ref.errorCode && ref.errorCode !== ref.name ? opts([['name', tsText(ref.name)], ['code', tsText(ref.errorCode)]]) : tsText(ref.name)],
             ];
         }
         case 'bpmn:TimerEventDefinition': {
@@ -421,15 +407,15 @@ function eventOptions(el) {
             const cycle = def.timeCycle?.body;
             // A bare duration is the shorthand the builder accepts directly.
             if (d !== undefined && date === undefined && cycle === undefined)
-                return [['timer', str(d)]];
-            return [['timer', opts([['duration', d !== undefined ? str(d) : undefined], ['date', date !== undefined ? str(date) : undefined], ['cycle', cycle !== undefined ? str(cycle) : undefined]])]];
+                return [['timer', tsText(d)]];
+            return [['timer', opts([['duration', d !== undefined ? tsText(d) : undefined], ['date', date !== undefined ? tsText(date) : undefined], ['cycle', cycle !== undefined ? tsText(cycle) : undefined]])]];
         }
         default:
             return [];
     }
 }
 /** `uipath:output` rows split into the type's own row and the author-mapped extras. */
-function outputsOf(payload, id, type) {
+function outputsOf(payload, _id, type) {
     const rows = payload?.output ?? [];
     const extras = {};
     let outputVar;
@@ -476,13 +462,13 @@ function emitOutputRows(payload) {
     if (!rows.length)
         return undefined;
     const rendered = rows.map((row) => opts([
-        ['name', str(row.name)],
-        ['type', row.type !== undefined ? str(row.type) : undefined],
-        ['var', row.var !== undefined ? str(row.var) : undefined],
-        ['source', row.source !== undefined ? str(row.source) : undefined],
+        ['name', tsText(row.name)],
+        ['type', row.type !== undefined ? tsText(row.type) : undefined],
+        ['var', row.var !== undefined ? tsText(row.var) : undefined],
+        ['source', row.source !== undefined ? tsText(row.source) : undefined],
         ['custom', row.custom ? 'true' : undefined],
-        ['description', row.description !== undefined ? str(row.description) : undefined],
-        ['target', row.target !== undefined ? str(row.target) : undefined],
+        ['description', row.description !== undefined ? tsText(row.description) : undefined],
+        ['target', row.target !== undefined ? tsText(row.target) : undefined],
         // The body goes back as the STRING it was, not as a re-serialized object: a
         // schema is carried, never interpreted, so nothing here can reorder its keys
         // or drop a field this SDK does not know about.
@@ -537,20 +523,20 @@ function emitTypedNode(chain, el, payload, type) {
     const { outputVar, extras } = outputsOf(payload, id, type);
     const defaultVar = spec.output ? `${id}_${identifierize(spec.output.name)}` : undefined;
     const verbatimRows = outputRowsNeedSpellingOut(payload) ? emitOutputRows(payload) : undefined;
-    chain.add(`.activity(${str(id)}, ${str(type)}${optionalArg(opts([
-        ['name', el.name !== undefined ? str(el.name) : undefined],
+    chain.add(`.activity(${tsText(id)}, ${tsText(type)}${optionalArg(opts([
+        ['name', el.name !== undefined ? tsText(el.name) : undefined],
         // Only when it differs from the registry's own template, so an
         // SDK-authored node keeps the shorter source it had.
-        ['typeVersion', payload.type?.version && payload.type.version !== 'v1' ? str(payload.type.version) : undefined],
+        ['typeVersion', payload.type?.version && payload.type.version !== 'v1' ? tsText(payload.type.version) : undefined],
         ['context', verbatimContext ? undefined : record(ctx)],
         ['contextRows', verbatimContext],
         ['inputSchema', payload.context?.inputSchema?.body !== undefined ? jsonLiteral(payload.context.inputSchema.body) : undefined],
         ['inputs', record(inputs)],
         ['inputRows', verbatimInputs],
         ['outputRows', verbatimRows],
-        ['outputVar', verbatimRows === undefined && outputVar !== undefined && outputVar !== defaultVar ? str(outputVar) : undefined],
+        ['outputVar', verbatimRows === undefined && outputVar !== undefined && outputVar !== defaultVar ? tsText(outputVar) : undefined],
         ['outputs', verbatimRows === undefined ? record(extras) : undefined],
-        ['skipCondition', payload.skipCondition !== undefined ? str(payload.skipCondition) : undefined],
+        ['skipCondition', payload.skipCondition !== undefined ? tsText(payload.skipCondition) : undefined],
         ['contextVerbatim', Object.keys(ctx).length ? 'true' : undefined],
         ['tags', tagsOf(el)],
         ['retry', emitRetry(retryOf(el))],
@@ -585,11 +571,11 @@ function emitInputRows(rows) {
         return undefined;
     return `[${rows
         .map((r) => opts([
-        ['name', str(r.name)],
-        ['type', r.type !== undefined ? str(r.type) : undefined],
-        ['target', r.target !== undefined ? str(r.target) : undefined],
-        ['value', r.value !== undefined ? str(r.value) : undefined],
-        ['body', r.body !== undefined ? (r.type === 'json' ? jsonLiteral(r.body) : str(String(r.body))) : undefined],
+        ['name', tsText(r.name)],
+        ['type', r.type !== undefined ? tsText(r.type) : undefined],
+        ['target', r.target !== undefined ? tsText(r.target) : undefined],
+        ['value', r.value !== undefined ? tsText(r.value) : undefined],
+        ['body', r.body !== undefined ? (r.type === 'json' ? jsonLiteral(r.body) : tsText(String(r.body))) : undefined],
     ]))
         .join(', ')}]`;
 }
@@ -663,7 +649,7 @@ function emitScriptTask(chain, el, payload, type) {
     // schema that differs from the default (the designer's carries `$schema`) is kept.
     const rawInputs = args ? safeJson(args.body) : undefined;
     const inputs = rawInputs
-        ? Object.fromEntries(Object.entries(rawInputs).filter(([k, v]) => !(k in SCRIPT_ARGS_ENVELOPE) || v !== SCRIPT_ARGS_ENVELOPE[k]))
+        ? Object.fromEntries(Object.entries(rawInputs).filter(([k, v]) => !(Object.hasOwn(SCRIPT_ARGS_ENVELOPE, k) && v === SCRIPT_ARGS_ENVELOPE[k])))
         : undefined;
     const schemaBody = payload?.context?.inputSchema?.body;
     const schemaIsDefault = schemaBody !== undefined && rawInputs !== undefined && JSON.stringify(safeJson(schemaBody)) === JSON.stringify(defaultScriptInputSchema(rawInputs));
@@ -675,14 +661,14 @@ function emitScriptTask(chain, el, payload, type) {
     // `Error`) while binding a differently-named variable, and the derived form
     // names it after the variable.
     const verbatim = outputRowsNeedSpellingOut(payload) ? emitOutputRows(payload) : undefined;
-    chain.add(`.scriptTask(${str(el.id)}, ${opts([
-        ['name', el.name !== undefined ? str(el.name) : undefined],
-        ['script', str(el.script ?? '')],
-        ['scriptFormat', el.scriptFormat && el.scriptFormat !== 'JavaScript' ? str(el.scriptFormat) : undefined],
+    chain.add(`.scriptTask(${tsText(el.id)}, ${opts([
+        ['name', el.name !== undefined ? tsText(el.name) : undefined],
+        ['script', tsText(el.script ?? '')],
+        ['scriptFormat', el.scriptFormat && el.scriptFormat !== 'JavaScript' ? tsText(el.scriptFormat) : undefined],
         // The builder's default is v3; anything else is load-bearing (it selects the
         // runtime's result shape) and must survive the round trip. An absent element
         // is spelled `'v1'`, the meaning it has to the runtime.
-        ['scriptVersion', scriptVersionOf(el) !== 'v3' ? str(scriptVersionOf(el)) : undefined],
+        ['scriptVersion', scriptVersionOf(el) !== 'v3' ? tsText(scriptVersionOf(el)) : undefined],
         // Only when it is neither the contract's value nor the invalid one this SDK
         // used to emit. `BPMN.ScriptTask` is NORMALISED AWAY rather than preserved:
         // the runtime contract has no such type, so reproducing it would propagate a
@@ -690,7 +676,7 @@ function emitScriptTask(chain, el, payload, type) {
         // already makes for a bare `<uipath:input name="args">`.
         [
             'type',
-            type !== undefined && type !== 'BPMN.Variables' && type !== 'BPMN.ScriptTask' ? str(type) : undefined,
+            type !== undefined && type !== 'BPMN.Variables' && type !== 'BPMN.ScriptTask' ? tsText(type) : undefined,
         ],
         ['inputSchema', schemaBody !== undefined && !schemaIsDefault ? jsonLiteral(schemaBody) : undefined],
         ['inputs', record(inputs)],
@@ -712,8 +698,8 @@ function emitVariableTask(chain, el, payload) {
         const asLiteral = /^=js:(".*")$/.exec(source);
         set[row.var ?? row.name] = asLiteral ? JSON.parse(asLiteral[1]) : source;
     }
-    chain.add(`.task(${str(el.id)}, ${opts([
-        ['name', el.name !== undefined ? str(el.name) : undefined],
+    chain.add(`.task(${tsText(el.id)}, ${opts([
+        ['name', el.name !== undefined ? tsText(el.name) : undefined],
         ['set', record(set)],
         ['tags', tagsOf(el)],
         ['retry', emitRetry(retryOf(el))],
@@ -733,10 +719,10 @@ function emitScope(chain, container, depth, indent) {
     }
     for (const f of flows) {
         const auto = `Flow_${f.sourceRef?.id}_${f.targetRef?.id}`;
-        chain.add(`.sequenceFlow(${str(f.sourceRef?.id)}, ${str(f.targetRef?.id)}${optionalArg(opts([
-            ['id', f.id !== auto ? str(f.id) : undefined],
-            ['name', f.name !== undefined ? str(f.name) : undefined],
-            ['condition', f.conditionExpression?.body !== undefined ? str(f.conditionExpression.body) : undefined],
+        chain.add(`.sequenceFlow(${tsText(f.sourceRef?.id)}, ${tsText(f.targetRef?.id)}${optionalArg(opts([
+            ['id', f.id !== auto ? tsText(f.id) : undefined],
+            ['name', f.name !== undefined ? tsText(f.name) : undefined],
+            ['condition', f.conditionExpression?.body !== undefined ? tsText(f.conditionExpression.body) : undefined],
         ]))})`);
     }
 }
@@ -1109,7 +1095,7 @@ function renderElementNested(plan, el, depth, indent) {
 function renderArmLines(plan, arm, depth, indent) {
     const lines = arm.items.map((item) => ('el' in item ? renderElementNested(plan, item.el, depth, indent) : renderBranch(plan, item.lift, depth, indent)));
     if (arm.end === 'goto')
-        lines.push(`.goto(${str(arm.gotoTarget)})`);
+        lines.push(`.goto(${tsText(arm.gotoTarget)})`);
     return lines;
 }
 function renderArmBody(plan, arm, depth, indent) {
@@ -1128,10 +1114,10 @@ function renderHandler(plan, h, depth, indent) {
     const payload = payloadOf(b);
     const type = extensionTypeOf(payload);
     const optsText = opts([
-        ['id', b.id !== `${host}_${method}` ? str(b.id) : undefined],
-        ['name', b.name !== undefined ? str(b.name) : undefined],
+        ['id', b.id !== `${host}_${method}` ? tsText(b.id) : undefined],
+        ['name', b.name !== undefined ? tsText(b.name) : undefined],
         ['interrupting', def !== 'error' && b.cancelActivity === false ? 'false' : undefined],
-        ['payload', payload && type ? opts([['type', str(type)], ['outputRows', emitOutputRows(payload) ?? '[]']]) : undefined],
+        ['payload', payload && type ? opts([['type', tsText(type)], ['outputRows', emitOutputRows(payload) ?? '[]']]) : undefined],
     ]);
     const body = renderArmBody(plan, h.arm, depth, indent);
     const args = [defExpr, ...(optsText !== '' && optsText !== '{}' ? [optsText] : []), ...(body ? [body] : [])];
@@ -1145,12 +1131,12 @@ function renderBranch(plan, lift, depth, indent) {
     const gw = lift.gateway;
     const joinOpt = lift.join !== undefined
         ? opts([
-            ['id', lift.join.id !== `${gw.id}_join` ? str(lift.join.id) : undefined],
-            ['name', lift.join.name !== undefined ? str(lift.join.name) : undefined],
+            ['id', lift.join.id !== `${gw.id}_join` ? tsText(lift.join.id) : undefined],
+            ['name', lift.join.name !== undefined ? tsText(lift.join.name) : undefined],
         ])
         : undefined;
     const optsText = opts([
-        ['name', gw.name !== undefined ? str(gw.name) : undefined],
+        ['name', gw.name !== undefined ? tsText(gw.name) : undefined],
         ['inclusive', lift.inclusive ? 'true' : undefined],
         ['join', joinOpt !== undefined && joinOpt !== '' && joinOpt !== '{}' ? joinOpt : undefined],
     ]);
@@ -1159,13 +1145,13 @@ function renderBranch(plan, lift, depth, indent) {
         if (lift.construct !== 'choose')
             return body ?? '() => {}';
         return opts([
-            otherwise ? ['otherwise', 'true'] : ['when', str(flow.conditionExpression?.body)],
-            ['label', flow.name !== undefined ? str(flow.name) : undefined],
+            otherwise ? ['otherwise', 'true'] : ['when', tsText(flow.conditionExpression?.body)],
+            ['label', flow.name !== undefined ? tsText(flow.name) : undefined],
             ['body', body],
         ]);
     });
     const arms = `[\n${pad}${armTexts.join(`,\n${pad}`)},\n${indent.repeat(depth + 1)}]`;
-    return `.${lift.construct}(${str(gw.id)}, ${arms}${optionalArg(optsText)})`;
+    return `.${lift.construct}(${tsText(gw.id)}, ${arms}${optionalArg(optsText)})`;
 }
 /**
  * An event sub-process as `.eventSubProcess()`, or nothing.
@@ -1253,7 +1239,7 @@ function renderEventSubProcess(plan, sp, depth, indent) {
     const spPayload = payloadOf(sp);
     const spType = extensionTypeOf(spPayload);
     const optsText = opts([
-        ['name', sp.name !== undefined ? str(sp.name) : undefined],
+        ['name', sp.name !== undefined ? tsText(sp.name) : undefined],
         [def, defExpr],
         ['interrupting', def !== 'error' && start.isInterrupting === false ? 'false' : undefined],
         // `` `${id}_Error` `` is compile's default and `false` its opt-out, so neither is
@@ -1261,13 +1247,13 @@ function renderEventSubProcess(plan, sp, depth, indent) {
         // without one, and a capture the designer named something else is spelled out.
         [
             'errorVar',
-            capture === `${sp.id}_Error` ? undefined : capture !== undefined ? str(capture) : def === 'error' ? 'false' : undefined,
+            capture === `${sp.id}_Error` ? undefined : capture !== undefined ? tsText(capture) : def === 'error' ? 'false' : undefined,
         ],
-        ['startId', start.id !== `${sp.id}_start` ? str(start.id) : undefined],
-        ['startName', start.name !== undefined ? str(start.name) : undefined],
-        ['startPayload', payload && type && capture === undefined ? opts([['type', str(type)], ['outputRows', emitOutputRows(payload) ?? '[]']]) : undefined],
+        ['startId', start.id !== `${sp.id}_start` ? tsText(start.id) : undefined],
+        ['startName', start.name !== undefined ? tsText(start.name) : undefined],
+        ['startPayload', payload && type && capture === undefined ? opts([['type', tsText(type)], ['outputRows', emitOutputRows(payload) ?? '[]']]) : undefined],
         ['tags', tagsOf(sp)],
-        ['payload', spPayload && spType ? opts([['type', str(spType)], ['outputRows', emitOutputRows(spPayload) ?? '[]']]) : undefined],
+        ['payload', spPayload && spType ? opts([['type', tsText(spType)], ['outputRows', emitOutputRows(spPayload) ?? '[]']]) : undefined],
     ]);
     const vars = new Chain('');
     emitVariablesInto(vars, sp, sp.id, capture !== undefined && captureDeclLooksDerived(sp, capture, start.id) ? new Set([capture]) : undefined);
@@ -1275,7 +1261,7 @@ function renderEventSubProcess(plan, sp, depth, indent) {
     const pad = indent.repeat(depth + 2);
     const body = bodyLines.length ? `(h) => h\n${pad}${bodyLines.join(`\n${pad}`)}` : '(h) => h';
     plan.summary.nets++;
-    return `.eventSubProcess(${str(sp.id)}, ${optsText}, ${body})`;
+    return `.eventSubProcess(${tsText(sp.id)}, ${optsText}, ${body})`;
 }
 /** `emitScope`, with the liftable regions written as constructs. */
 function emitScopeNested(chain, container, depth, indent, summary, relabel, sequence) {
@@ -1286,10 +1272,10 @@ function emitScopeNested(chain, container, depth, indent, summary, relabel, sequ
     const written = new Set();
     if (sequence)
         chain.add(".flowMode('sequence')");
-    const renderFlow = (f) => `.sequenceFlow(${str(f.sourceRef?.id)}, ${str(f.targetRef?.id)}${optionalArg(opts([
-        ['id', f.id !== derivedFlowId(f) ? str(f.id) : undefined],
-        ['name', f.name !== undefined ? str(f.name) : undefined],
-        ['condition', f.conditionExpression?.body !== undefined ? str(f.conditionExpression.body) : undefined],
+    const renderFlow = (f) => `.sequenceFlow(${tsText(f.sourceRef?.id)}, ${tsText(f.targetRef?.id)}${optionalArg(opts([
+        ['id', f.id !== derivedFlowId(f) ? tsText(f.id) : undefined],
+        ['name', f.name !== undefined ? tsText(f.name) : undefined],
+        ['condition', f.conditionExpression?.body !== undefined ? tsText(f.conditionExpression.body) : undefined],
     ]))})`;
     /** Write an element's remaining flows now, before the next statement — so "explicit wins" applies. */
     const writeNow = (flows) => {
@@ -1386,17 +1372,17 @@ function emitScopeNested(chain, container, depth, indent, summary, relabel, sequ
         if (plan.impliedFlows.has(f.id) || written.has(f.id))
             continue;
         const auto = `Flow_${f.sourceRef?.id}_${f.targetRef?.id}`;
-        chain.add(`.sequenceFlow(${str(f.sourceRef?.id)}, ${str(f.targetRef?.id)}${optionalArg(opts([
-            ['id', f.id !== auto ? str(f.id) : undefined],
-            ['name', f.name !== undefined ? str(f.name) : undefined],
-            ['condition', f.conditionExpression?.body !== undefined ? str(f.conditionExpression.body) : undefined],
+        chain.add(`.sequenceFlow(${tsText(f.sourceRef?.id)}, ${tsText(f.targetRef?.id)}${optionalArg(opts([
+            ['id', f.id !== auto ? tsText(f.id) : undefined],
+            ['name', f.name !== undefined ? tsText(f.name) : undefined],
+            ['condition', f.conditionExpression?.body !== undefined ? tsText(f.conditionExpression.body) : undefined],
         ]))})`);
     }
     // Last, so it is first: the implied edges whose id is not the one the construct
     // derives. Emitted at the front of the chain because it is a declaration about the
     // whole scope, and only knowable once the walk has decided what to imply.
     if (plan.pinned.length) {
-        const rows = plan.pinned.map((e) => `{ source: ${str(e.source)}, target: ${str(e.target)}, id: ${str(e.id)} }`);
+        const rows = plan.pinned.map((e) => `{ source: ${tsText(e.source)}, target: ${tsText(e.target)}, id: ${tsText(e.id)} }`);
         chain.addFirst(`.flowIds([${rows.join(', ')}])`);
     }
 }
@@ -1436,9 +1422,9 @@ function emitTriggerStartEvent(chain, el, payload, type) {
     const row = (payload.output ?? [])[0];
     const defaultVar = spec.output ? `${el.id}_${identifierize(spec.output.name)}` : undefined;
     const outputVar = row?.var;
-    const trigger = outputVar !== undefined && outputVar !== defaultVar ? opts([['outputVar', str(outputVar)]]) : 'true';
-    chain.add(`.startEvent(${str(el.id)}, ${opts([
-        ['name', el.name !== undefined ? str(el.name) : undefined],
+    const trigger = outputVar !== undefined && outputVar !== defaultVar ? opts([['outputVar', tsText(outputVar)]]) : 'true';
+    chain.add(`.startEvent(${tsText(el.id)}, ${opts([
+        ['name', el.name !== undefined ? tsText(el.name) : undefined],
         ...eventOptions(el),
         ['trigger', trigger],
     ])})`);
@@ -1503,14 +1489,14 @@ function emitEvent(chain, el, kind, payload, type) {
     // after all, which is the branch this function is not on.
     const eventPayload = payload && type
         ? opts([
-            ['type', str(type)],
+            ['type', tsText(type)],
             ['outputRows', emitOutputRows(payload) ?? '[]'],
         ])
         : undefined;
     if (kind === 'boundaryEvent') {
-        chain.add(`.boundaryEvent(${str(el.id)}, ${opts([
-            ['name', el.name !== undefined ? str(el.name) : undefined],
-            ['attachedTo', str(el.attachedToRef?.id)],
+        chain.add(`.boundaryEvent(${tsText(el.id)}, ${opts([
+            ['name', el.name !== undefined ? tsText(el.name) : undefined],
+            ['attachedTo', tsText(el.attachedToRef?.id)],
             // The builder defaults to interrupting; only the exception is worth saying.
             ['cancelActivity', el.cancelActivity === false ? 'false' : undefined],
             ...eventOptions(el),
@@ -1518,8 +1504,8 @@ function emitEvent(chain, el, kind, payload, type) {
         ])})`);
         return;
     }
-    chain.add(`.${kind}(${str(el.id)}${optionalArg(opts([
-        ['name', el.name !== undefined ? str(el.name) : undefined],
+    chain.add(`.${kind}(${tsText(el.id)}${optionalArg(opts([
+        ['name', el.name !== undefined ? tsText(el.name) : undefined],
         ...eventOptions(el),
         // Only a start event can be non-interrupting, and only the exception is
         // spelled — the builder's default is BPMN's.
@@ -1583,14 +1569,14 @@ function emitElement(chain, el, depth, indent) {
     switch (kind) {
         case 'exclusiveGateway':
         case 'inclusiveGateway':
-            chain.add(`.${kind}(${str(el.id)}${optionalArg(opts([
-                ['name', el.name !== undefined ? str(el.name) : undefined],
-                ['default', el.default?.id !== undefined ? str(el.default.id) : undefined],
+            chain.add(`.${kind}(${tsText(el.id)}${optionalArg(opts([
+                ['name', el.name !== undefined ? tsText(el.name) : undefined],
+                ['default', el.default?.id !== undefined ? tsText(el.default.id) : undefined],
             ]))})`);
             return;
         case 'parallelGateway':
         case 'eventBasedGateway':
-            chain.add(`.${kind}(${str(el.id)}${optionalArg(opts([['name', el.name !== undefined ? str(el.name) : undefined]]))})`);
+            chain.add(`.${kind}(${tsText(el.id)}${optionalArg(opts([['name', el.name !== undefined ? tsText(el.name) : undefined]]))})`);
             return;
         // A task element with no `uipath:*` payload — an abstract task. All seven kinds are
         // legal bare and `validate` accepts every one, so they decompile through
@@ -1608,11 +1594,11 @@ function emitElement(chain, el, depth, indent) {
         case 'manualTask':
         case 'businessRuleTask':
         case 'receiveTask':
-            chain.add(`.plainTask(${str(el.id)}${optionalArg(opts([
-                ['name', el.name !== undefined ? str(el.name) : undefined],
+            chain.add(`.plainTask(${tsText(el.id)}${optionalArg(opts([
+                ['name', el.name !== undefined ? tsText(el.name) : undefined],
                 // Only when it is not the default, so the common case stays terse. Spelled
                 // the way the XML is, not the way moddle types it.
-                ['element', kind === 'task' ? undefined : str(`bpmn:${kind}`)],
+                ['element', kind === 'task' ? undefined : tsText(`bpmn:${kind}`)],
                 ['tags', tagsOf(el)],
                 ['retry', emitRetry(retryOf(el))],
                 ['errorMapping', emitErrorMapping(errorMappingOf(el))],
@@ -1633,13 +1619,13 @@ function emitElement(chain, el, depth, indent) {
             // `emitVariablesInto` has already written into the body above.
             const spPayload = payloadOf(el);
             const spType = extensionTypeOf(spPayload);
-            chain.add(`.subProcess(${str(el.id)}, ${body}${optionalArg(opts([
-                ['name', el.name !== undefined ? str(el.name) : undefined],
+            chain.add(`.subProcess(${tsText(el.id)}, ${body}${optionalArg(opts([
+                ['name', el.name !== undefined ? tsText(el.name) : undefined],
                 [
                     'payload',
                     spPayload && spType
                         ? opts([
-                            ['type', str(spType)],
+                            ['type', tsText(spType)],
                             ['outputRows', emitOutputRows(spPayload) ?? '[]'],
                         ])
                         : undefined,
@@ -1675,7 +1661,7 @@ function emitElementId(elementId, ownerId, rehome) {
     if (elementId === undefined)
         return 'null';
     const effective = rehome && elementId === rehome.from ? rehome.to : elementId;
-    return effective === ownerId ? undefined : str(effective);
+    return effective === ownerId ? undefined : tsText(effective);
 }
 /**
  * Whether an error net's capture variable is declared exactly as `errorVar` would
@@ -1729,15 +1715,15 @@ defaultScope = () => ownerId) {
                 continue;
             const type = varType(v.type);
             const def = v.default === undefined ? undefined : decodeDefault(v.default, v.type);
-            entries.push(`{ id: ${str(v.id)}, type: ${str(type)}${inner([
-                ['direction', direction === 'inputOutput' ? undefined : str(direction)],
-                ['name', v.name !== undefined && v.name !== v.id ? str(v.name) : undefined],
+            entries.push(`{ id: ${tsText(v.id)}, type: ${tsText(type)}${inner([
+                ['direction', direction === 'inputOutput' ? undefined : tsText(direction)],
+                ['name', v.name !== undefined && v.name !== v.id ? tsText(v.name) : undefined],
                 ['default', def],
                 ['schema', v.body !== undefined ? (plan?.ref.get(String(v.body)) ?? jsonLiteral(v.body)) : undefined],
                 ['required', v.required !== undefined ? 'true' : undefined],
                 ['custom', v.custom !== undefined ? 'true' : undefined],
                 ['internal', v.internal !== undefined ? 'true' : undefined],
-                ['subType', v.subType !== undefined ? str(v.subType) : undefined],
+                ['subType', v.subType !== undefined ? tsText(v.subType) : undefined],
                 ['elementId', emitElementId(v.elementId, defaultScope(prop, v), rehome)],
             ])} }`);
         }
@@ -1777,17 +1763,17 @@ function bindingIsReferenced(xml, id) {
  */
 function decodeDefault(raw, wire) {
     if (raw.startsWith('='))
-        return str(raw); // an expression, not a value of `wire`
+        return tsText(raw); // an expression, not a value of `wire`
     if (wire === 'json')
         return raw; // already JSON — emit it verbatim
     if (wire === 'number')
-        return Number.isFinite(Number(raw)) ? String(Number(raw)) : str(raw);
+        return Number.isFinite(Number(raw)) ? String(Number(raw)) : tsText(raw);
     // Only the two literals are booleans. Anything else — an empty `default=""`, which
     // a real export writes to mean "no value" — is text, and collapsing it to `false`
     // is the same silent inversion as the expression case above.
     if (wire === 'boolean' || wire === 'bool')
-        return raw === 'true' || raw === 'false' ? raw : str(raw);
-    return str(raw);
+        return raw === 'true' || raw === 'false' ? raw : tsText(raw);
+    return tsText(raw);
 }
 // ─── Entry point ──────────────────────────────────────────────────────────────
 /**
@@ -1880,12 +1866,12 @@ export async function decompile(xml, options = {}) {
         nonExecutable) {
         chain.add(`.metadata(${opts([
             ['executable', nonExecutable ? 'false' : undefined],
-            ['entryPointId', entryPoint?.value !== undefined ? str(entryPoint.value) : undefined],
-            ['tags', tagValues.length > 0 ? `[${tagValues.map((t) => str(t)).join(', ')}]` : undefined],
+            ['entryPointId', entryPoint?.value !== undefined ? tsText(entryPoint.value) : undefined],
+            ['tags', tagValues.length > 0 ? `[${tagValues.map((t) => tsText(t)).join(', ')}]` : undefined],
             [
                 'caseManagement',
                 caseMgmt?.version !== undefined
-                    ? `{ version: ${str(caseMgmt.version)}${caseMgmt.value !== undefined ? `, value: ${str(caseMgmt.value)}` : ''} }`
+                    ? `{ version: ${tsText(caseMgmt.version)}${caseMgmt.value !== undefined ? `, value: ${tsText(caseMgmt.value)}` : ''} }`
                     : undefined,
             ],
         ])})`);
@@ -1900,13 +1886,13 @@ export async function decompile(xml, options = {}) {
             droppedBindings.push(b.id);
             continue;
         }
-        bindingEntries.push(`{ id: ${str(b.id)}${inner([
-            ['name', b.name !== undefined && b.name !== b.id ? str(b.name) : undefined],
-            ['value', b.default !== undefined ? str(b.default) : undefined],
-            ['resource', b.resource !== undefined && b.resource !== 'custom' ? str(b.resource) : undefined],
-            ['resourceKey', b.resourceKey !== undefined && b.resourceKey !== b.default ? str(b.resourceKey) : undefined],
-            ['propertyAttribute', b.propertyAttribute !== undefined && b.propertyAttribute !== 'value' ? str(b.propertyAttribute) : undefined],
-            ['resourceSubType', b.resourceSubType !== undefined ? str(b.resourceSubType) : undefined],
+        bindingEntries.push(`{ id: ${tsText(b.id)}${inner([
+            ['name', b.name !== undefined && b.name !== b.id ? tsText(b.name) : undefined],
+            ['value', b.default !== undefined ? tsText(b.default) : undefined],
+            ['resource', b.resource !== undefined && b.resource !== 'custom' ? tsText(b.resource) : undefined],
+            ['resourceKey', b.resourceKey !== undefined && b.resourceKey !== b.default ? tsText(b.resourceKey) : undefined],
+            ['propertyAttribute', b.propertyAttribute !== undefined && b.propertyAttribute !== 'value' ? tsText(b.propertyAttribute) : undefined],
+            ['resourceSubType', b.resourceSubType !== undefined ? tsText(b.resourceSubType) : undefined],
         ])} }`);
     }
     if (bindingEntries.length)
@@ -1930,7 +1916,7 @@ export async function decompile(xml, options = {}) {
         ...(varsExt?.inputOutput ?? []),
         ...(varsExt?.output ?? []),
     ]);
-    const schemaEntries = [...schemaPlan.declare].map(([id, body]) => `{ id: ${str(id)}, body: ${body} }`);
+    const schemaEntries = [...schemaPlan.declare].map(([id, body]) => `{ id: ${tsText(id)}, body: ${body} }`);
     if (schemaEntries.length)
         chain.add(arrayCall('schemas', schemaEntries, chain.indent));
     // A folded body is written the way a declaration's would be — through the shared
@@ -1947,7 +1933,7 @@ export async function decompile(xml, options = {}) {
     // be noise.
     if (derived.size) {
         const ids = [...(varsExt?.input ?? []), ...(varsExt?.inputOutput ?? []), ...(varsExt?.output ?? [])].map((v) => v.id);
-        chain.add(`.preserve({ variableOrder: [${ids.map(str).join(', ')}] })`);
+        chain.add(`.preserve({ variableOrder: [${ids.map(tsText).join(', ')}] })`);
     }
     try {
         emitVariablesInto(chain, host.container, host.rehome?.to ?? host.container.id, derived, host.rehome, schemaPlan, publicDeclarationScopeOf(process, host.rehome?.to ?? host.container.id));
@@ -1972,8 +1958,8 @@ export async function decompile(xml, options = {}) {
     }
     const importFrom = options.importSpecifier ?? './bpmn-sdk.js';
     const imported = ['bpmn', ...[...schemaPlan.imports].sort()].join(', ');
-    const head = `import { ${imported} } from ${str(importFrom)};\n\nexport default bpmn(${str(process.id)})`;
-    const name = process.name !== undefined ? `\n${indent}.name(${str(process.name)})` : '';
+    const head = `import { ${imported} } from ${tsText(importFrom)};\n\nexport default bpmn(${tsText(process.id)})`;
+    const name = process.name !== undefined ? `\n${indent}.name(${tsText(process.name)})` : '';
     return `${host.note}${head}${name}\n${chain.all.join('\n')}\n${indent}.build();\n`;
 }
 /**