@teleporthq/teleport-plugin-common 0.43.44 → 0.43.47

package/dist/esm/utils/route-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/route-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,cAAc;;qBACM,MAAM,EAAE;mBAAa,MAAM;;MACxD,OAKH,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,gCAAgC;WAElC,MAAM;;iBAEF,MAAM;mBACJ,MAAM;;wBACe,MAAM;;;eAG9B,aAAa,KACxB,OAiCF,CAAA"}
+{"version":3,"file":"route-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/route-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAG1D;;;GAGG;AACH,eAAO,MAAM,cAAc;;qBACM,MAAM,EAAE;mBAAa,MAAM;;MACxD,OAKH,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAQ,qBAAqB,6BAAE,wBAAwB;;;CAAe,CAAA;AAI7E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,gCAAgC;WAElC,MAAM;;iBAEF,MAAM;mBACJ,MAAM;;wBACe,MAAM;;;eAG9B,aAAa,KACxB,OAiCF,CAAA"}

package/dist/esm/utils/route-utils.js

@@ -7,6 +7,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
+import { RoutePaths } from '@teleporthq/teleport-shared';
 /**
  * True when this UIDL component's output route contains a Next.js dynamic
  * segment (`[id]`, `[slug]`, ...) anywhere in its folder path or file name.
@@ -15,6 +16,13 @@ export var isDynamicRoute = function (uidl) {
     var _a = uidl.outputOptions || {}, _b = _a.folderPath, folderPath = _b === void 0 ? [] : _b, _c = _a.fileName, fileName = _c === void 0 ? '' : _c;
     return __spreadArray(__spreadArray([], folderPath, true), [fileName], false).some(function (segment) { return segment.startsWith('[') && segment.endsWith(']'); });
 };
+/**
+ * Reading a route TEMPLATE (`/event-details/[id]`) rather than a URL. Defined in
+ * teleport-shared because the navlink resolver needs the same two functions and
+ * lives in a package that does not depend on this one; re-exported here so
+ * `RouteUtils` stays the single import for route questions in the plugins.
+ */
+export var pathHasDynamicSegment = RoutePaths.pathHasDynamicSegment, parseDynamicPathSegments = RoutePaths.parseDynamicPathSegments;
 var MUTATION_NODE_TYPES = new Set(['data-create-item', 'data-update-item']);
 /**
  * True when this page both reads one specific database row via its own

package/dist/esm/utils/route-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-utils.js","sourceRoot":"","sources":["../../../src/utils/route-utils.ts"],"names":[],"mappings":";;;;;;;;;AAEA;;;GAGG;AACH,MAAM,CAAC,IAAM,cAAc,GAAG,UAAC,IAE9B;IACO,IAAA,KAAqC,IAAI,CAAC,aAAa,IAAI,EAAE,EAA3D,kBAAe,EAAf,UAAU,mBAAG,EAAE,KAAA,EAAE,gBAAa,EAAb,QAAQ,mBAAG,EAAE,KAA6B,CAAA;IACnE,OAAO,gCAAI,UAAU,UAAE,QAAQ,UAAE,IAAI,CACnC,UAAC,OAAO,IAAK,OAAA,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAhD,CAAgD,CAC9D,CAAA;AACH,CAAC,CAAA;AAED,IAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,IAAM,gCAAgC,GAAG,UAC9C,IAOC,EACD,SAAyB;;IAEzB,IAAM,SAAS,GAAG,MAAA,MAAA,IAAI,CAAC,aAAa,0CAAE,eAAe,0CAAE,SAAS,CAAA;IAChE,IAAI,CAAC,SAAS,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,SAAS,CAAA,EAAE;QACvC,OAAO,KAAK,CAAA;KACb;IAED,IAAM,MAAM,GAAG,CAAA,MAAA,IAAI,CAAC,aAAa,0CAAE,MAAM,MAAI,MAAA,IAAI,CAAC,aAAa,0CAAE,QAAQ,CAAA,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;IAE5F,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAC,EAAE;;QAChD,IAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAA;QAC1B,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE;YACzE,OAAO,KAAK,CAAA;SACb;QAED,wEAAwE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,+CAA+C;QAC/C,IAAM,aAAa,GAAG,MAAA,OAAO,CAAC,MAAM,0CAAE,MAA4B,CAAA;QAClE,IAAM,aAAa,GAAG,MAAA,OAAO,CAAC,MAAM,0CAAE,aAAkD,CAAA;QACxF,IAAM,kBAAkB,GACtB,OAAO,CAAC,KAAK,KAAK,MAAM;YACtB,CAAC,CAAC,CAAC,aAAa,IAAI,aAAa,KAAK,MAAM;YAC5C,CAAC,CAAC,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,EAAE,KAAK,MAAM,EAAf,CAAe,CAAC,CAAA;QAEhG,IAAI,CAAC,kBAAkB,EAAE;YACvB,OAAO,KAAK,CAAA;SACb;QAED,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAClB,UAAC,IAAI,YAAK,OAAA,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA,MAAA,IAAI,CAAC,MAAM,0CAAE,SAAS,MAAK,SAAS,CAAA,EAAA,CACrF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}
+{"version":3,"file":"route-utils.js","sourceRoot":"","sources":["../../../src/utils/route-utils.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAExD;;;GAGG;AACH,MAAM,CAAC,IAAM,cAAc,GAAG,UAAC,IAE9B;IACO,IAAA,KAAqC,IAAI,CAAC,aAAa,IAAI,EAAE,EAA3D,kBAAe,EAAf,UAAU,mBAAG,EAAE,KAAA,EAAE,gBAAa,EAAb,QAAQ,mBAAG,EAAE,KAA6B,CAAA;IACnE,OAAO,gCAAI,UAAU,UAAE,QAAQ,UAAE,IAAI,CACnC,UAAC,OAAO,IAAK,OAAA,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAhD,CAAgD,CAC9D,CAAA;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAS,IAAA,qBAAqB,GAA+B,UAAU,sBAAzC,EAAE,wBAAwB,GAAK,UAAU,yBAAf,CAAe;AAE7E,IAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,IAAM,gCAAgC,GAAG,UAC9C,IAOC,EACD,SAAyB;;IAEzB,IAAM,SAAS,GAAG,MAAA,MAAA,IAAI,CAAC,aAAa,0CAAE,eAAe,0CAAE,SAAS,CAAA;IAChE,IAAI,CAAC,SAAS,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,SAAS,CAAA,EAAE;QACvC,OAAO,KAAK,CAAA;KACb;IAED,IAAM,MAAM,GAAG,CAAA,MAAA,IAAI,CAAC,aAAa,0CAAE,MAAM,MAAI,MAAA,IAAI,CAAC,aAAa,0CAAE,QAAQ,CAAA,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;IAE5F,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAC,EAAE;;QAChD,IAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAA;QAC1B,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE;YACzE,OAAO,KAAK,CAAA;SACb;QAED,wEAAwE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,+CAA+C;QAC/C,IAAM,aAAa,GAAG,MAAA,OAAO,CAAC,MAAM,0CAAE,MAA4B,CAAA;QAClE,IAAM,aAAa,GAAG,MAAA,OAAO,CAAC,MAAM,0CAAE,aAAkD,CAAA;QACxF,IAAM,kBAAkB,GACtB,OAAO,CAAC,KAAK,KAAK,MAAM;YACtB,CAAC,CAAC,CAAC,aAAa,IAAI,aAAa,KAAK,MAAM;YAC5C,CAAC,CAAC,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,EAAE,KAAK,MAAM,EAAf,CAAe,CAAC,CAAA;QAEhG,IAAI,CAAC,kBAAkB,EAAE;YACvB,OAAO,KAAK,CAAA;SACb;QAED,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAClB,UAAC,IAAI,YAAK,OAAA,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA,MAAA,IAAI,CAAC,MAAM,0CAAE,SAAS,MAAK,SAAS,CAAA,EAAA,CACrF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/esm/utils/template-expression-balance.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Delimiter balancing for `{{ … }}` binding expressions.
+ *
+ * THE DEFECT THIS EXISTS FOR. `parseStringWithTemplateExpressions` converted a
+ * UIDL string into a template literal and then handed the result straight to
+ * Babel. When the binding inside was unbalanced the produced source did not
+ * parse, `parse()` threw, and — because the inline-style caller has no
+ * try/catch — the SyntaxError escaped all the way out and killed the ENTIRE
+ * project build:
+ *
+ *     const x = `translateX(${-(cameraX || ''}px) }px)`
+ *                                          ^ Unexpected token, expected ","
+ *
+ * Two separate faults produced that line. The interpolated expression
+ * `-(cameraX || ''` was missing its closing paren, and the "re-close the CSS
+ * function" step counted parentheses across the WHOLE string — including the
+ * ones inside `${…}` — decided one was missing, and appended `px)` to the end,
+ * which could never help because the imbalance was inside the interpolation.
+ *
+ * One bad binding in one style property must never cost a project its build.
+ * These helpers make the imbalance repairable where it actually is, and let the
+ * caller degrade a single value instead of aborting.
+ */
+export interface ExpressionScan {
+    /** Openers still waiting for their closer, outermost first. */
+    unclosed: string[];
+    /** Closers that never had a matching opener. */
+    strayCloserCount: number;
+    /** The quote character still open at the end of the scan, if any. */
+    unterminatedQuote: string | null;
+}
+/**
+ * Single left-to-right pass over an expression, quote and escape aware.
+ * Characters inside a string literal never affect nesting.
+ */
+export declare const scanExpression: (expression: string) => ExpressionScan;
+/** True when every quote and bracket closes and no closer is stray. */
+export declare const isBalancedExpression: (expression: string) => boolean;
+/**
+ * Close an expression that ends mid-quote or mid-bracket:
+ * `-(cameraX || ''` → `-(cameraX || '')`.
+ *
+ * Returns the expression unchanged when it is already balanced, and when the
+ * imbalance is a STRAY CLOSER — appending cannot fix a missing opener, and
+ * inventing one would be a guess.
+ */
+export declare const balanceExpression: (expression: string) => string;
+/**
+ * Parenthesis balance of the STATIC parts of a template string — everything
+ * outside `${…}`.
+ *
+ * This is the number the "re-close the CSS function" step needs. Counting over
+ * the whole string mixes in the expressions' own parentheses, so an imbalance
+ * INSIDE an interpolation reads as a missing close on the CSS function and the
+ * step appends a unit and a `)` that belong nowhere.
+ */
+export declare const countUnclosedStaticParens: (templateStr: string) => number;
+//# sourceMappingURL=template-expression-balance.d.ts.map

package/dist/esm/utils/template-expression-balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-expression-balance.d.ts","sourceRoot":"","sources":["../../../src/utils/template-expression-balance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAYH,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAA;IACxB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,eAAgB,MAAM,KAAG,cAyCnD,CAAA;AAED,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,eAAgB,MAAM,KAAG,OAKzD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,eAAgB,MAAM,KAAG,MAYtD,CAAA;AAQD;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,gBAAiB,MAAM,KAAG,MAkB/D,CAAA"}

package/dist/esm/utils/template-expression-balance.js

@@ -0,0 +1,174 @@
+/**
+ * Delimiter balancing for `{{ … }}` binding expressions.
+ *
+ * THE DEFECT THIS EXISTS FOR. `parseStringWithTemplateExpressions` converted a
+ * UIDL string into a template literal and then handed the result straight to
+ * Babel. When the binding inside was unbalanced the produced source did not
+ * parse, `parse()` threw, and — because the inline-style caller has no
+ * try/catch — the SyntaxError escaped all the way out and killed the ENTIRE
+ * project build:
+ *
+ *     const x = `translateX(${-(cameraX || ''}px) }px)`
+ *                                          ^ Unexpected token, expected ","
+ *
+ * Two separate faults produced that line. The interpolated expression
+ * `-(cameraX || ''` was missing its closing paren, and the "re-close the CSS
+ * function" step counted parentheses across the WHOLE string — including the
+ * ones inside `${…}` — decided one was missing, and appended `px)` to the end,
+ * which could never help because the imbalance was inside the interpolation.
+ *
+ * One bad binding in one style property must never cost a project its build.
+ * These helpers make the imbalance repairable where it actually is, and let the
+ * caller degrade a single value instead of aborting.
+ */
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+/** Closing delimiter for each opener that nests inside an expression. */
+var CLOSER_FOR_OPENER = {
+    '(': ')',
+    '[': ']',
+    '{': '}',
+};
+var CLOSERS = new Set(Object.values(CLOSER_FOR_OPENER));
+var QUOTES = new Set(["'", '"', '`']);
+/**
+ * Single left-to-right pass over an expression, quote and escape aware.
+ * Characters inside a string literal never affect nesting.
+ */
+export var scanExpression = function (expression) {
+    var unclosed = [];
+    var strayCloserCount = 0;
+    var quote = null;
+    for (var index = 0; index < expression.length; index++) {
+        var char = expression[index];
+        if (char === '\\') {
+            index++;
+            continue;
+        }
+        if (quote !== null) {
+            if (char === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (QUOTES.has(char)) {
+            quote = char;
+            continue;
+        }
+        if (CLOSER_FOR_OPENER[char]) {
+            unclosed.push(char);
+            continue;
+        }
+        if (CLOSERS.has(char)) {
+            var expected = unclosed.length > 0 ? CLOSER_FOR_OPENER[unclosed[unclosed.length - 1]] : null;
+            if (expected === char) {
+                unclosed.pop();
+            }
+            else {
+                strayCloserCount++;
+            }
+        }
+    }
+    return { unclosed: unclosed, strayCloserCount: strayCloserCount, unterminatedQuote: quote };
+};
+/** True when every quote and bracket closes and no closer is stray. */
+export var isBalancedExpression = function (expression) {
+    var scan = scanExpression(expression);
+    return (scan.unclosed.length === 0 && scan.strayCloserCount === 0 && scan.unterminatedQuote === null);
+};
+/**
+ * Close an expression that ends mid-quote or mid-bracket:
+ * `-(cameraX || ''` → `-(cameraX || '')`.
+ *
+ * Returns the expression unchanged when it is already balanced, and when the
+ * imbalance is a STRAY CLOSER — appending cannot fix a missing opener, and
+ * inventing one would be a guess.
+ */
+export var balanceExpression = function (expression) {
+    var scan = scanExpression(expression);
+    if (scan.strayCloserCount > 0) {
+        return expression;
+    }
+    if (scan.unclosed.length === 0 && scan.unterminatedQuote === null) {
+        return expression;
+    }
+    var suffix = __spreadArray([scan.unterminatedQuote || ''], unclosedInReverse(scan.unclosed), true).join('');
+    return expression + suffix;
+};
+var unclosedInReverse = function (unclosed) {
+    return unclosed
+        .slice()
+        .reverse()
+        .map(function (opener) { return CLOSER_FOR_OPENER[opener]; });
+};
+/**
+ * Parenthesis balance of the STATIC parts of a template string — everything
+ * outside `${…}`.
+ *
+ * This is the number the "re-close the CSS function" step needs. Counting over
+ * the whole string mixes in the expressions' own parentheses, so an imbalance
+ * INSIDE an interpolation reads as a missing close on the CSS function and the
+ * step appends a unit and a `)` that belong nowhere.
+ */
+export var countUnclosedStaticParens = function (templateStr) {
+    var depth = 0;
+    var index = 0;
+    while (index < templateStr.length) {
+        if (templateStr[index] === '$' && templateStr[index + 1] === '{') {
+            index = skipInterpolation(templateStr, index + 2);
+            continue;
+        }
+        if (templateStr[index] === '(') {
+            depth++;
+        }
+        else if (templateStr[index] === ')') {
+            depth--;
+        }
+        index++;
+    }
+    return depth > 0 ? depth : 0;
+};
+/**
+ * Index just past the `}` that closes an interpolation opened at `start`.
+ * Tracks nested braces and string literals so `${ {a:'}'} }` is skipped whole.
+ * An unterminated interpolation consumes the rest of the string.
+ */
+var skipInterpolation = function (templateStr, start) {
+    var depth = 1;
+    var quote = null;
+    for (var index = start; index < templateStr.length; index++) {
+        var char = templateStr[index];
+        if (char === '\\') {
+            index++;
+            continue;
+        }
+        if (quote !== null) {
+            if (char === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (QUOTES.has(char)) {
+            quote = char;
+            continue;
+        }
+        if (char === '{') {
+            depth++;
+        }
+        else if (char === '}') {
+            depth--;
+            if (depth === 0) {
+                return index + 1;
+            }
+        }
+    }
+    return templateStr.length;
+};
+//# sourceMappingURL=template-expression-balance.js.map

package/dist/esm/utils/template-expression-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-expression-balance.js","sourceRoot":"","sources":["../../../src/utils/template-expression-balance.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teleporthq/teleport-plugin-common",
-  "version": "0.43.44",
+  "version": "0.43.47",
   "description": "Common building and modelating functions for ASTs and HASTs",
   "author": "teleportHQ",
   "license": "MIT",
@@ -27,10 +27,10 @@
     "@babel/core": "^7.5.5",
     "@babel/preset-react": "^7.22.5",
     "@babel/types": "^7.5.5",
-    "@teleporthq/teleport-shared": "^0.43.44",
-    "@teleporthq/teleport-types": "^0.43.44",
+    "@teleporthq/teleport-shared": "^0.43.47",
+    "@teleporthq/teleport-types": "^0.43.47",
     "jss": "^10.0.0",
     "jss-preset-default": "^10.0.0"
   },
-  "gitHead": "c5cac00d70ddb1ebaa54836043880014d6772e78"
+  "gitHead": "5e8cf2c30367f6d57af1a6817a6437ffc01d60e9"
 }

package/src/node-handlers/node-to-jsx/utils.ts

@@ -6,7 +6,7 @@ import {
   convertValueToLiteral,
   getExpressionFromUIDLExpressionNode,
 } from '../../utils/ast-utils'
-import { StringUtils, UIDLUtils } from '@teleporthq/teleport-shared'
+import { JSIdentifiers, StringUtils, UIDLUtils } from '@teleporthq/teleport-shared'
 import {
   UIDLPropDefinition,
   UIDLAttributeValue,
@@ -261,10 +261,14 @@ const createPropCallStatement = (
   const prefix = options.dynamicReferencePrefixMap.prop
     ? options.dynamicReferencePrefixMap.prop + '.'
     : ''
+  // Un-prefixed the prop name is called as a bare binding, so it must be
+  // identifier-safe; prefixed it is `props.<name>`, where the UIDL spelling is
+  // both legal and load-bearing.
+  const calleeName = prefix
+    ? prefix + propFunctionKey
+    : JSIdentifiers.createSafeJSIdentifier(propFunctionKey)
   return t.expressionStatement(
-    t.callExpression(t.identifier(prefix + propFunctionKey), [
-      ...args.map((arg) => convertValueToLiteral(arg)),
-    ])
+    t.callExpression(t.identifier(calleeName), [...args.map((arg) => convertValueToLiteral(arg))])
   )
 }
 
@@ -310,6 +314,12 @@ export const createStateChangeStatement = (
   const statePrefix = options.dynamicReferencePrefixMap.state
     ? options.dynamicReferencePrefixMap.state + '.'
     : ''
+  // Reading/writing the state through a prefix (`this.class`) is a member
+  // access and keeps the UIDL spelling; without one the name IS the binding
+  // and has to match what `createStateHookAST` declared.
+  const stateReadName = statePrefix
+    ? statePrefix + stateKey
+    : JSIdentifiers.createSafeJSIdentifier(stateKey)
 
   const declaredType = stateDefinition.type
   const newState = eventHandlerStatement.newState
@@ -326,7 +336,7 @@ export const createStateChangeStatement = (
       )
       return null
     }
-    newStateValue = t.unaryExpression('!', t.identifier(statePrefix + stateKey))
+    newStateValue = t.unaryExpression('!', t.identifier(stateReadName))
   } else if (typeof newState === 'object' && newState !== null) {
     const obj = newState as
       | UIDLDynamicReference
@@ -473,7 +483,7 @@ export const createStateChangeStatement = (
         return null
       }
       return t.expressionStatement(
-        t.assignmentExpression('=', t.identifier(statePrefix + stateKey), newStateValue)
+        t.assignmentExpression('=', t.identifier(stateReadName), newStateValue)
       )
     }
   }
@@ -540,7 +550,12 @@ export const resolveAndRegisterGlobalStateSource = (
     for (const def of Object.values(definitions)) {
       if (def.id === id) {
         params.globalStateReferences.push({ id: def.id, name: def.name })
-        return original.replace(LEGACY_GLOBAL_STATE_RE, def.name)
+        // The rewritten source is embedded as code, so the placeholder becomes
+        // the LOCAL binding — the sanitised name the destructuring declares.
+        return original.replace(
+          LEGACY_GLOBAL_STATE_RE,
+          JSIdentifiers.createSafeJSIdentifier(def.name)
+        )
       }
     }
     // Legacy prefix found but no matching definition (orphaned reference).
@@ -568,7 +583,11 @@ export const createGlobalStateExpression = (
   definitions?: Record<string, UIDLGlobalStateDefinition>,
   t = types
 ): types.Identifier | types.OptionalMemberExpression => {
-  const name = resolveGlobalStateName(ref.content.id, definitions)
+  // The global-state name is destructured out of `useGlobalState()` as a local
+  // binding, so it goes through the same sanitiser the destructuring site uses.
+  const name = JSIdentifiers.createSafeJSIdentifier(
+    resolveGlobalStateName(ref.content.id, definitions)
+  )
   const refPath = ref.content.refPath || []
 
   if (refPath.length === 0) {
@@ -765,8 +784,12 @@ const createDynamicValueExpressionRaw = (
   const prefix =
     options.dynamicReferencePrefixMap[referenceType as 'prop' | 'state' | 'local'] || ''
 
+  // With no prefix the id IS the binding (React hooks: `class`), so it has to
+  // be sanitised exactly the way the declaration was. With a prefix it is a
+  // MEMBER (`props.class`, `this.class`), where a reserved word is perfectly
+  // legal and renaming it would point at a property that does not exist.
   return prefix === ''
-    ? t.identifier(idWithPath)
+    ? t.identifier(JSIdentifiers.createSafeJSIdentifierPath(idWithPath))
     : t.memberExpression(t.identifier(prefix), t.identifier(idWithPath))
 }
 
@@ -1038,12 +1061,15 @@ export const createBinaryExpression = (
   t = types
 ) => {
   const { operand, operation, containsField } = condition
+  // Same rule as `createDynamicValueExpression`: an un-prefixed key is the
+  // binding itself and must be identifier-safe; a prefixed one is a member
+  // access that has to keep the UIDL's original spelling.
   const identifier = conditionalIdentifier.prefix
     ? t.memberExpression(
         t.identifier(conditionalIdentifier.prefix),
         t.identifier(conditionalIdentifier.key)
       )
-    : t.identifier(conditionalIdentifier.key)
+    : t.identifier(JSIdentifiers.createSafeJSIdentifierPath(conditionalIdentifier.key))
 
   // Array/Object operators
   if (operation === 'isEmpty') {

package/src/utils/ast-utils.ts

@@ -1,7 +1,7 @@
 import * as types from '@babel/types'
 import { parse } from '@babel/core'
 import ParsedASTNode from './parsed-ast'
-import { StringUtils, UIDLUtils } from '@teleporthq/teleport-shared'
+import { JSIdentifiers, StringUtils, UIDLUtils } from '@teleporthq/teleport-shared'
 import {
   UIDLStateDefinition,
   UIDLPropDefinition,
@@ -16,6 +16,7 @@ import {
 } from '@teleporthq/teleport-types'
 import babelPresetReact from '@babel/preset-react'
 import { UnaryOperation, BinaryOperator } from './types'
+import { balanceExpression, countUnclosedStaticParens } from './template-expression-balance'
 
 /**
  * Converts HTML attribute names to React/JSX camelCase format
@@ -140,9 +141,14 @@ export const addDynamicAttributeToJSXTag = (
   t = types
 ) => {
   const reactName = convertToReactAttributeName(name)
+  // Same rule as `createDynamicValueExpression`: with no prefix the value IS the
+  // binding (React hooks state), so it must match the sanitised name
+  // `createStateHookAST` declared — `value={class}` does not parse. With a
+  // prefix it is `props.class` / `this.class`, where the UIDL spelling is legal
+  // AND load-bearing, so it is left alone.
   const content =
     prefix === ''
-      ? t.identifier(value)
+      ? t.identifier(JSIdentifiers.createSafeJSIdentifierPath(value))
       : t.memberExpression(t.identifier(prefix), t.identifier(value))
 
   jsxASTNode.openingElement.attributes.push(
@@ -354,9 +360,15 @@ export const parseStringWithTemplateExpressions = (str: string): types.TemplateL
   const normalized = str.replace(/state\.(\w+)/g, '$1')
 
   // Step 2: Convert well-formed {{ expr }} to ${expr}
+  //
+  // The expression is BALANCED on the way in. A binding that lost a closing
+  // paren upstream (`-(cameraX || ''`) produces source Babel cannot parse, and
+  // no amount of patching the static text around it can help — the repair has
+  // to happen inside the interpolation, which is the only place the bracket is
+  // actually missing.
   let templateStr = normalized.replace(
     /\{\{\s*(.+?)\s*\}\}/g,
-    (_, expr: string) => '${' + expr.trim() + '}'
+    (_, expr: string) => '${' + balanceExpression(expr.trim()) + '}'
   )
 
   // Step 3: Handle unclosed {{ expr (no closing }})
@@ -364,16 +376,20 @@ export const parseStringWithTemplateExpressions = (str: string): types.TemplateL
   if (/\{\{/.test(templateStr)) {
     templateStr = templateStr.replace(
       /\{\{\s*(.+?)$/gm,
-      (_, expr: string) => '${' + expr.trim() + '}'
+      (_, expr: string) => '${' + balanceExpression(expr.trim()) + '}'
     )
   }
 
   // Step 4: Detect and fix incomplete CSS function calls
   // If the original string contained a CSS function like translateX(...) or translate(...)
   // but the template expression consumed the closing, we need to re-close it.
-  const openParens = (templateStr.match(/\(/g) || []).length
-  const closeParens = (templateStr.match(/\)/g) || []).length
-  if (openParens > closeParens) {
+  //
+  // Counted over the STATIC text only. Including the parentheses inside `${…}`
+  // made an imbalance in the expression look like an unclosed CSS function, so
+  // this step appended a unit and a `)` to the end of a string whose real fault
+  // was several characters earlier and inside the interpolation.
+  const missingStaticCloses = countUnclosedStaticParens(templateStr)
+  if (missingStaticCloses > 0) {
     // Determine the CSS unit by:
     // 1. Looking for existing units already in the string (e.g. "translate(${x}px, ${y" → px)
     // 2. Inferring from the CSS function name
@@ -393,22 +409,53 @@ export const parseStringWithTemplateExpressions = (str: string): types.TemplateL
       }
     }
 
-    const missingCloses = openParens - closeParens
-    templateStr += unit + ')'.repeat(missingCloses)
+    templateStr += unit + ')'.repeat(missingStaticCloses)
   }
 
-  const ast = parse('const x = `' + templateStr + '`', {
-    sourceType: 'module',
-  })
+  // Step 5: Parse — and NEVER let a single malformed binding abort the build.
+  //
+  // The inline-style caller has no error handling of its own, so an
+  // unparseable template used to escape as a raw Babel SyntaxError and take the
+  // whole project generation down with it. A UIDL can always carry a binding
+  // this module cannot rescue (hand-edited, produced by an older pipeline, or
+  // broken in a way `balanceExpression` refuses to guess at), and the right
+  // answer is to degrade that ONE value: emit the original text as a plain
+  // string so the property still renders and the other 99 pages still build.
+  try {
+    const ast = parse('const x = `' + templateStr + '`', {
+      sourceType: 'module',
+    })
 
-  if (!ast || !('program' in ast)) {
-    throw new Error(`Failed to parse template expression: ${str}`)
+    if (ast && 'program' in ast) {
+      const decl = ast.program.body[0] as types.VariableDeclaration
+      return decl.declarations[0].init as types.TemplateLiteral
+    }
+  } catch {
+    // Fall through to the static fallback below.
   }
 
-  const decl = ast.program.body[0] as types.VariableDeclaration
-  return decl.declarations[0].init as types.TemplateLiteral
+  return staticTemplateLiteral(stripTemplateExpressions(str))
 }
 
+/**
+ * Drop every `{{ … }}` binding from a string, keeping any `'literal'` fallback
+ * it declared. `translateX({{ -(x || 0) }}px)` → `translateX(px)` is useless as
+ * a style value, but `{{ name || 'Guest' }}` → `Guest` keeps the text the
+ * author intended. Used only when the expression could not be parsed at all.
+ */
+const stripTemplateExpressions = (value: string): string =>
+  value.replace(/\{\{\s*([\s\S]*?)\s*\}\}/g, (_, expr: string) => {
+    const literalFallback = /\|\|\s*(['"])([\s\S]*?)\1\s*$/.exec(expr)
+    return literalFallback ? literalFallback[2] : ''
+  })
+
+/** A TemplateLiteral with no interpolations, holding `value` verbatim. */
+const staticTemplateLiteral = (value: string): types.TemplateLiteral =>
+  types.templateLiteral(
+    [types.templateElement({ raw: value.replace(/[\\`]/g, '\\$&'), cooked: value }, true)],
+    []
+  )
+
 const REACT_BOOLEAN_DOM_PROPS = new Set([
   'disabled',
   'required',
@@ -931,7 +978,11 @@ export const createStateHookAST = (
   return t.variableDeclaration('const', [
     t.variableDeclarator(
       t.arrayPattern([
-        t.identifier(stateKey),
+        // The state NAME comes from the UIDL and may be a reserved word (a
+        // character sheet has a column called `class`), which is fatal in
+        // binding position. Reads go through the same sanitiser, so the
+        // declaration and every reference stay in sync.
+        t.identifier(JSIdentifiers.createSafeJSIdentifier(stateKey)),
         t.identifier(StringUtils.createStateStoringFunction(stateKey)),
       ]),
       t.callExpression(t.identifier('useState'), [useStateArgument])

package/src/utils/route-utils.ts

@@ -1,4 +1,5 @@
 import { UIDLWorkflows } from '@teleporthq/teleport-types'
+import { RoutePaths } from '@teleporthq/teleport-shared'
 
 /**
  * True when this UIDL component's output route contains a Next.js dynamic
@@ -13,6 +14,14 @@ export const isDynamicRoute = (uidl: {
   )
 }
 
+/**
+ * Reading a route TEMPLATE (`/event-details/[id]`) rather than a URL. Defined in
+ * teleport-shared because the navlink resolver needs the same two functions and
+ * lives in a package that does not depend on this one; re-exported here so
+ * `RouteUtils` stays the single import for route questions in the plugins.
+ */
+export const { pathHasDynamicSegment, parseDynamicPathSegments } = RoutePaths
+
 const MUTATION_NODE_TYPES = new Set(['data-create-item', 'data-update-item'])
 
 /**