@teleporthq/teleport-plugin-next-data-source 0.43.66 → 0.43.67

package/dist/esm/product-filter-fields.js

@@ -0,0 +1,154 @@
+/**
+ * Filtering a products list on things that are not a plain column.
+ *
+ * The storefront's product filters ask questions the `teleport_products` row
+ * cannot answer with a single column comparison: "what does it cost right now"
+ * (`price` net of a live markdown), "how many stars" (an aggregate over the
+ * reviews table), "is it on sale", and "does it come in size XL" (a value
+ * inside the `variant_options` JSON). Like the discount-aware sort in
+ * `product-price-sort.ts`, these have to be answered by the DATABASE — the list
+ * is paginated, so filtering the fetched page would only filter 20 of N rows.
+ *
+ * The editor emits such a filter as an ordinary condition whose `source` is
+ * one of the VIRTUAL field names below. Every SQL builder that can receive a
+ * products filter rewrites them into the expressions here:
+ *
+ *   - this file → the generated store's `teleport_products` API route
+ *     (`fetchers/teleport.ts`, `fetchers/postgresql.ts`);
+ *   - `database-provider-worker/src/lib/product-filter-fields.ts` → the editor
+ *     canvas. ⛔ A byte-for-byte mirror of the SQL below; both repos pin the
+ *     strings with a test, because a clause the canvas cannot build is an HTTP
+ *     500 the canvas draws as an EMPTY grid.
+ *
+ * ## The expressions cannot raise
+ *
+ * Same discipline as the sort: the JSON column is cast only when its text
+ * already looks like an array, the axis key is validated against a slug pattern
+ * before it is bound, and an unknown key filters to no rows instead of erroring
+ * — a filter that the database rejects would empty the whole products page.
+ */
+import { PRODUCTS_TABLE_NAME, PRODUCT_PRICE_SORT_FIELD, buildProductEffectivePriceSql, supportsProductPriceSort, } from './product-price-sort';
+/** The reviews table the star-rating aggregate reads. Exists once reviews were enabled. */
+export var PRODUCT_REVIEWS_TABLE_NAME = 'teleport_product_reviews';
+/** Virtual field: the product's star bucket — `ROUND(AVG(approved rating))`, 1..5, NULL when unreviewed. */
+export var PRODUCT_RATING_FILTER_FIELD = 'rating';
+/** Virtual field: `'true'` while a markdown is live, else `'false'`. */
+export var PRODUCT_ON_SALE_FILTER_FIELD = 'on_sale';
+/**
+ * Virtual field family: `variant_options.<axisKey>` — the product offers the
+ * axis (e.g. `size`) in one of the given values (e.g. `xl`).
+ */
+export var PRODUCT_VARIANT_AXIS_FILTER_PREFIX = 'variant_options.';
+/**
+ * What an axis key may look like. Keys are produced by the editor's slug
+ * helper (`deriveOptionKey`), so this is what every real key matches; anything
+ * else is refused before it can reach the database.
+ */
+export var PRODUCT_VARIANT_AXIS_KEY_PATTERN = '^[a-z0-9][a-z0-9_-]{0,63}$';
+/** Generic multi-value operand: the column equals ANY of the destination values. */
+export var IN_OPERAND = 'in';
+/**
+ * `ROUND(AVG(rating))` over the product's APPROVED reviews. Only approved rows
+ * count — moderation is the merchant's veto — and the outer row is the
+ * unaliased `teleport_products` the fetchers select from.
+ */
+export var buildProductRatingBucketSql = function () {
+    return "(SELECT ROUND(AVG(r.rating)) FROM ".concat(PRODUCT_REVIEWS_TABLE_NAME, " r WHERE r.product_id = ").concat(PRODUCTS_TABLE_NAME, ".id AND r.status = 'approved' AND r.rating IS NOT NULL)");
+};
+/** `'true'` when the price paid today is below the list price, i.e. a markdown is live. */
+export var buildProductOnSaleSql = function () {
+    return "(CASE WHEN ".concat(buildProductEffectivePriceSql(), " < \"price\"::numeric THEN 'true' ELSE 'false' END)");
+};
+/**
+ * Only text that already looks like a JSON array is cast; NULL, empty or a
+ * hand-edited scalar reads as "no variant axes".
+ */
+export var SAFE_VARIANT_OPTIONS_JSONB = "CASE\n        WHEN \"variant_options\" IS NULL OR btrim(\"variant_options\") NOT LIKE '[%' THEN '[]'::jsonb\n        ELSE \"variant_options\"::jsonb\n      END";
+/**
+ * True when the product declares the axis bound to `keyParam` with at least one
+ * of the values bound to `valuesParam` (a `text[]`). Both are PARAMETERS, never
+ * interpolated text.
+ */
+export var buildProductVariantAxisExistsSql = function (keyParam, valuesParam) {
+    return "EXISTS (SELECT 1 FROM jsonb_array_elements(".concat(SAFE_VARIANT_OPTIONS_JSONB, ") AS ax, jsonb_array_elements(CASE WHEN jsonb_typeof(ax->'values') = 'array' THEN ax->'values' ELSE '[]'::jsonb END) AS v WHERE ax->>'key' = ").concat(keyParam, " AND v->>'value' = ANY(").concat(valuesParam, "::text[]))");
+};
+/**
+ * The complete `productFilterClause(field, operand, value, pushParam)` helper a
+ * SQL fetcher embeds in its generated route.
+ *
+ * Returns a finished WHERE clause for a virtual (or rewritten) products field,
+ * or `null` for anything else so the fetcher's ordinary branches run. `pushParam`
+ * binds a value and answers its `$n` placeholder. By the time it is called an
+ * `in` filter has been normalised to `=` with an ARRAY value (see
+ * `normalizeInOperand` in `utils.ts`), which reads as "any of". A virtual field
+ * never answers `null` once matched — an operand it cannot express filters to
+ * no rows rather than falling into a branch that would name a column the table
+ * does not have.
+ *
+ * Emitted through `JSON.stringify` and string concatenation only — no backtick
+ * and no `${` may appear in the output, which is interpolated into a fetcher's
+ * template literal. On a table that is not the products table the helper still
+ * exists and always answers `null`, so a fetcher can embed it unconditionally.
+ */
+export var generateProductFilterClauseHelper = function (tableName) {
+    if (!supportsProductPriceSort(tableName)) {
+        return [
+            '// Virtual products-table filter fields. This table has none, so every',
+            "// condition takes the fetcher's ordinary branches.",
+            'function productFilterClause() {',
+            '  return null',
+            '}',
+        ].join('\n');
+    }
+    var lines = [
+        "// Rewrites the products table's virtual filter fields - the price paid",
+        '// today, the star-rating bucket, the on-sale flag and a variant axis - into',
+        '// SQL. Answers null for a plain column so the ordinary branches run. An',
+        '// "in" filter arrives here already normalised to "=" with an ARRAY value.',
+        'function productFilterClause(field, operand, value, pushParam) {',
+        "  var scalarOps = ['=', '!=', '>', '<', '>=', '<=']",
+        "  var equalityOps = ['=', '!=']",
+        '  var compare = function (expression, allowedOps, virtual) {',
+        '    if (Array.isArray(value)) {',
+        "      if (operand === '=') {",
+        "        return expression + '::text = ANY(' + pushParam(value.map(String)) + '::text[])'",
+        '      }',
+        "      if (operand === '!=') {",
+        "        return expression + '::text <> ALL(' + pushParam(value.map(String)) + '::text[])'",
+        '      }',
+        "      return virtual ? 'FALSE' : null",
+        '    }',
+        "    if (allowedOps.indexOf(operand) === -1) return virtual ? 'FALSE' : null",
+        "    return expression + ' ' + operand + ' ' + pushParam(value)",
+        '  }',
+        "  if (field === ".concat(JSON.stringify(PRODUCT_PRICE_SORT_FIELD), ") {"),
+        "    return compare(".concat(JSON.stringify('(' + buildProductEffectivePriceSql() + ')'), ", scalarOps, false)"),
+        '  }',
+        "  if (field === ".concat(JSON.stringify(PRODUCT_RATING_FILTER_FIELD), ") {"),
+        "    return compare(".concat(JSON.stringify(buildProductRatingBucketSql()), ", scalarOps, true)"),
+        '  }',
+        "  if (field === ".concat(JSON.stringify(PRODUCT_ON_SALE_FILTER_FIELD), ") {"),
+        "    return compare(".concat(JSON.stringify(buildProductOnSaleSql()), ", equalityOps, true)"),
+        '  }',
+        "  if (field.indexOf(".concat(JSON.stringify(PRODUCT_VARIANT_AXIS_FILTER_PREFIX), ") === 0) {"),
+        "    var axisKey = field.slice(".concat(PRODUCT_VARIANT_AXIS_FILTER_PREFIX.length, ")"),
+        "    if (!new RegExp(".concat(JSON.stringify(PRODUCT_VARIANT_AXIS_KEY_PATTERN), ").test(axisKey)) {"),
+        '      // Not a key the editor could have written: no rows, never an error.',
+        "      return 'FALSE'",
+        '    }',
+        "    if (operand !== '=') return 'FALSE'",
+        '    var values = (Array.isArray(value) ? value : [value]).map(String)',
+        '    var keyParam = pushParam(axisKey)',
+        '    var valuesParam = pushParam(values)',
+        "    return ".concat(JSON.stringify(buildProductVariantAxisExistsSql('__KEY__', '__VALUES__'))),
+        // Function replacements: a "$1" inside a replacement STRING is a special
+        // pattern, so the placeholders are swapped by callback.
+        "      .replace('__KEY__', function () { return keyParam })",
+        "      .replace('__VALUES__', function () { return valuesParam })",
+        '  }',
+        '  return null',
+        '}',
+    ];
+    return lines.join('\n');
+};
+//# sourceMappingURL=product-filter-fields.js.map

package/dist/esm/product-filter-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-filter-fields.js","sourceRoot":"","sources":["../../src/product-filter-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,sBAAsB,CAAA;AAE7B,2FAA2F;AAC3F,MAAM,CAAC,IAAM,0BAA0B,GAAG,0BAA0B,CAAA;AAEpE,4GAA4G;AAC5G,MAAM,CAAC,IAAM,2BAA2B,GAAG,QAAQ,CAAA;AAEnD,wEAAwE;AACxE,MAAM,CAAC,IAAM,4BAA4B,GAAG,SAAS,CAAA;AAErD;;;GAGG;AACH,MAAM,CAAC,IAAM,kCAAkC,GAAG,kBAAkB,CAAA;AAEpE;;;;GAIG;AACH,MAAM,CAAC,IAAM,gCAAgC,GAAG,4BAA4B,CAAA;AAE5E,oFAAoF;AACpF,MAAM,CAAC,IAAM,UAAU,GAAG,IAAI,CAAA;AAE9B;;;;GAIG;AACH,MAAM,CAAC,IAAM,2BAA2B,GAAG;IACzC,OAAA,4CAAqC,0BAA0B,qCAA2B,mBAAmB,4DAAyD;AAAtK,CAAsK,CAAA;AAExK,2FAA2F;AAC3F,MAAM,CAAC,IAAM,qBAAqB,GAAG;IACnC,OAAA,qBAAc,6BAA6B,EAAE,wDAAmD;AAAhG,CAAgG,CAAA;AAElG;;;GAGG;AACH,MAAM,CAAC,IAAM,0BAA0B,GAAG,iKAGhC,CAAA;AAEV;;;;GAIG;AACH,MAAM,CAAC,IAAM,gCAAgC,GAAG,UAAC,QAAgB,EAAE,WAAmB;IACpF,OAAA,qDAA8C,0BAA0B,0JAAgJ,QAAQ,oCAA0B,WAAW,eAAY;AAAjR,CAAiR,CAAA;AAEnR;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,IAAM,iCAAiC,GAAG,UAAC,SAAiB;IACjE,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,EAAE;QACxC,OAAO;YACL,wEAAwE;YACxE,qDAAqD;YACrD,kCAAkC;YAClC,eAAe;YACf,GAAG;SACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;KACb;IAED,IAAM,KAAK,GAAG;QACZ,yEAAyE;QACzE,8EAA8E;QAC9E,0EAA0E;QAC1E,4EAA4E;QAC5E,kEAAkE;QAClE,qDAAqD;QACrD,iCAAiC;QACjC,8DAA8D;QAC9D,iCAAiC;QACjC,8BAA8B;QAC9B,0FAA0F;QAC1F,SAAS;QACT,+BAA+B;QAC/B,2FAA2F;QAC3F,SAAS;QACT,uCAAuC;QACvC,OAAO;QACP,6EAA6E;QAC7E,gEAAgE;QAChE,KAAK;QACL,0BAAmB,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,QAAK;QAChE,6BAAsB,IAAI,CAAC,SAAS,CAClC,GAAG,GAAG,6BAA6B,EAAE,GAAG,GAAG,CAC5C,wBAAqB;QACtB,KAAK;QACL,0BAAmB,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,QAAK;QACnE,6BAAsB,IAAI,CAAC,SAAS,CAAC,2BAA2B,EAAE,CAAC,uBAAoB;QACvF,KAAK;QACL,0BAAmB,IAAI,CAAC,SAAS,CAAC,4BAA4B,CAAC,QAAK;QACpE,6BAAsB,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC,yBAAsB;QACnF,KAAK;QACL,8BAAuB,IAAI,CAAC,SAAS,CAAC,kCAAkC,CAAC,eAAY;QACrF,wCAAiC,kCAAkC,CAAC,MAAM,MAAG;QAC7E,8BAAuB,IAAI,CAAC,SAAS,CAAC,gCAAgC,CAAC,uBAAoB;QAC3F,4EAA4E;QAC5E,sBAAsB;QACtB,OAAO;QACP,yCAAyC;QACzC,uEAAuE;QACvE,uCAAuC;QACvC,yCAAyC;QACzC,qBAAc,IAAI,CAAC,SAAS,CAAC,gCAAgC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAE;QACzF,yEAAyE;QACzE,wDAAwD;QACxD,4DAA4D;QAC5D,kEAAkE;QAClE,KAAK;QACL,eAAe;QACf,GAAG;KACJ,CAAA;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC,CAAA"}

package/dist/esm/request-locale.d.ts

@@ -0,0 +1,49 @@
+import * as types from '@babel/types';
+import type { UIDLDependency } from '@teleporthq/teleport-types';
+/**
+ * How a generated data-source fetch says which language it is for.
+ *
+ * A multi-language project stores a translatable column once per language
+ * (`name`, `es_name`, …) and the generated fetcher resolves each row against
+ * ONE of them (see `transformations/` and `localized-columns.ts`). Nothing
+ * about the API route knows the page it serves — an API route has no locale
+ * segment in its URL — so the page tells it, through this query parameter:
+ *
+ *   - a client-side fetch (`DataProvider` `params`) sends `router.locale`;
+ *   - a build-time fetch inside `getStaticProps` sends `context.locale`.
+ *
+ * Both are what Next.js resolved from the `/es/...` route, so the rows a page
+ * renders are in the language the page is in. The same name the details-page
+ * fetch (`teleport-plugin-next-static-props`) has always sent.
+ */
+export declare const REQUEST_LOCALE_PARAM = "locale";
+/**
+ * `router?.locale` — the client's current locale. Optional-chained like every
+ * other generated `router` read: `useRouter()` answers `null` during a static
+ * export's first paint.
+ */
+export declare const buildClientLocaleExpression: () => types.Expression;
+/** `locale: router?.locale` — the param of a client-side fetch. */
+export declare const buildClientLocaleParam: () => types.ObjectProperty;
+/** `locale: context.locale` — the param of a fetch inside getStaticProps. */
+export declare const buildServerLocaleParam: () => types.ObjectProperty;
+/** Whether an object literal already carries the locale param. */
+export declare const hasLocaleParam: (properties: types.ObjectExpression['properties']) => boolean;
+/**
+ * Adds the client locale to a fetch's params, once, and to the `useMemo` deps
+ * that must rebuild them: a locale switch is a client-side transition on the
+ * SAME page instance, so only a dependency change refetches the rows in the
+ * new language.
+ */
+export declare const appendClientLocaleParam: (paramsProps: types.ObjectExpression['properties'], memoDeps: types.Expression[]) => void;
+/**
+ * Puts `const router = useRouter()` (and its import) in scope, once.
+ *
+ * Idempotent with every sibling plugin that declares the same hook — the i18n
+ * locale mapper, the URL search-params plugin and the base component plugin
+ * all guard on the same identifier, so whichever runs first wins and the rest
+ * find it in place. Unshifted to the top of the body: nothing reads it before
+ * an effect runs, and hooks must not sit below a conditional return.
+ */
+export declare const ensureRouterDeclaration: (body: types.Statement[], dependencies: Record<string, UIDLDependency>) => void;
+//# sourceMappingURL=request-locale.d.ts.map

package/dist/esm/request-locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-locale.d.ts","sourceRoot":"","sources":["../../src/request-locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAA;AAU5C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAAO,MAAM,UAMlD,CAAA;AAEH,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,QAAO,MAAM,cAC6C,CAAA;AAE7F,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,QAAO,MAAM,cAI7C,CAAA;AAEH,kEAAkE;AAClE,eAAO,MAAM,cAAc,eAAgB,MAAM,gBAAgB,CAAC,YAAY,CAAC,KAAG,OAM/E,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,gBACrB,MAAM,gBAAgB,CAAC,YAAY,CAAC,YACvC,MAAM,UAAU,EAAE,KAC3B,IAKF,CAAA;AASD;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,SAC5B,MAAM,SAAS,EAAE,gBACT,OAAO,MAAM,EAAE,cAAc,CAAC,KAC3C,IAeF,CAAA"}

package/dist/esm/request-locale.js

@@ -0,0 +1,98 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import * as types from '@babel/types';
+/**
+ * How a generated data-source fetch says which language it is for.
+ *
+ * A multi-language project stores a translatable column once per language
+ * (`name`, `es_name`, …) and the generated fetcher resolves each row against
+ * ONE of them (see `transformations/` and `localized-columns.ts`). Nothing
+ * about the API route knows the page it serves — an API route has no locale
+ * segment in its URL — so the page tells it, through this query parameter:
+ *
+ *   - a client-side fetch (`DataProvider` `params`) sends `router.locale`;
+ *   - a build-time fetch inside `getStaticProps` sends `context.locale`.
+ *
+ * Both are what Next.js resolved from the `/es/...` route, so the rows a page
+ * renders are in the language the page is in. The same name the details-page
+ * fetch (`teleport-plugin-next-static-props`) has always sent.
+ */
+export var REQUEST_LOCALE_PARAM = 'locale';
+/** The dependency behind the `router` every client-side locale read closes over. */
+var USE_ROUTER_DEPENDENCY = {
+    type: 'library',
+    path: 'next/router',
+    version: '^12.1.10',
+    meta: { namedImport: true },
+};
+/**
+ * `router?.locale` — the client's current locale. Optional-chained like every
+ * other generated `router` read: `useRouter()` answers `null` during a static
+ * export's first paint.
+ */
+export var buildClientLocaleExpression = function () {
+    return types.optionalMemberExpression(types.identifier('router'), types.identifier('locale'), false, true);
+};
+/** `locale: router?.locale` — the param of a client-side fetch. */
+export var buildClientLocaleParam = function () {
+    return types.objectProperty(types.identifier(REQUEST_LOCALE_PARAM), buildClientLocaleExpression());
+};
+/** `locale: context.locale` — the param of a fetch inside getStaticProps. */
+export var buildServerLocaleParam = function () {
+    return types.objectProperty(types.identifier(REQUEST_LOCALE_PARAM), types.memberExpression(types.identifier('context'), types.identifier('locale')));
+};
+/** Whether an object literal already carries the locale param. */
+export var hasLocaleParam = function (properties) {
+    return properties.some(function (property) {
+        return property.type === 'ObjectProperty' &&
+            ((property.key.type === 'Identifier' && property.key.name === REQUEST_LOCALE_PARAM) ||
+                (property.key.type === 'StringLiteral' && property.key.value === REQUEST_LOCALE_PARAM));
+    });
+};
+/**
+ * Adds the client locale to a fetch's params, once, and to the `useMemo` deps
+ * that must rebuild them: a locale switch is a client-side transition on the
+ * SAME page instance, so only a dependency change refetches the rows in the
+ * new language.
+ */
+export var appendClientLocaleParam = function (paramsProps, memoDeps) {
+    if (!hasLocaleParam(paramsProps)) {
+        paramsProps.push(buildClientLocaleParam());
+    }
+    memoDeps.push(buildClientLocaleExpression());
+};
+/** Any declaration of `router` — a second one, however it is initialised, is a syntax error. */
+var declaresRouter = function (statement) {
+    return statement.type === 'VariableDeclaration' &&
+        statement.declarations.some(function (declaration) { return declaration.id.type === 'Identifier' && declaration.id.name === 'router'; });
+};
+/**
+ * Puts `const router = useRouter()` (and its import) in scope, once.
+ *
+ * Idempotent with every sibling plugin that declares the same hook — the i18n
+ * locale mapper, the URL search-params plugin and the base component plugin
+ * all guard on the same identifier, so whichever runs first wins and the rest
+ * find it in place. Unshifted to the top of the body: nothing reads it before
+ * an effect runs, and hooks must not sit below a conditional return.
+ */
+export var ensureRouterDeclaration = function (body, dependencies) {
+    if (!dependencies.useRouter) {
+        dependencies.useRouter = __assign({}, USE_ROUTER_DEPENDENCY);
+    }
+    if (body.some(declaresRouter)) {
+        return;
+    }
+    body.unshift(types.variableDeclaration('const', [
+        types.variableDeclarator(types.identifier('router'), types.callExpression(types.identifier('useRouter'), [])),
+    ]));
+};
+//# sourceMappingURL=request-locale.js.map

package/dist/esm/request-locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-locale.js","sourceRoot":"","sources":["../../src/request-locale.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAGrC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,IAAM,oBAAoB,GAAG,QAAQ,CAAA;AAE5C,oFAAoF;AACpF,IAAM,qBAAqB,GAAmB;IAC5C,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;CAC5B,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,IAAM,2BAA2B,GAAG;IACzC,OAAA,KAAK,CAAC,wBAAwB,CAC5B,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAC1B,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAC1B,KAAK,EACL,IAAI,CACL;AALD,CAKC,CAAA;AAEH,mEAAmE;AACnE,MAAM,CAAC,IAAM,sBAAsB,GAAG;IACpC,OAAA,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,2BAA2B,EAAE,CAAC;AAA3F,CAA2F,CAAA;AAE7F,6EAA6E;AAC7E,MAAM,CAAC,IAAM,sBAAsB,GAAG;IACpC,OAAA,KAAK,CAAC,cAAc,CAClB,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,EACtC,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAChF;AAHD,CAGC,CAAA;AAEH,kEAAkE;AAClE,MAAM,CAAC,IAAM,cAAc,GAAG,UAAC,UAAgD;IAC7E,OAAA,UAAU,CAAC,IAAI,CACb,UAAC,QAAQ;QACP,OAAA,QAAQ,CAAC,IAAI,KAAK,gBAAgB;YAClC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,oBAAoB,CAAC;gBACjF,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,eAAe,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,KAAK,oBAAoB,CAAC,CAAC;IAFzF,CAEyF,CAC5F;AALD,CAKC,CAAA;AAEH;;;;;GAKG;AACH,MAAM,CAAC,IAAM,uBAAuB,GAAG,UACrC,WAAiD,EACjD,QAA4B;IAE5B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE;QAChC,WAAW,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAA;KAC3C;IACD,QAAQ,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC,CAAA;AAC9C,CAAC,CAAA;AAED,gGAAgG;AAChG,IAAM,cAAc,GAAG,UAAC,SAA0B;IAChD,OAAA,SAAS,CAAC,IAAI,KAAK,qBAAqB;QACxC,SAAS,CAAC,YAAY,CAAC,IAAI,CACzB,UAAC,WAAW,IAAK,OAAA,WAAW,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY,IAAI,WAAW,CAAC,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAxE,CAAwE,CAC1F;AAHD,CAGC,CAAA;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,IAAM,uBAAuB,GAAG,UACrC,IAAuB,EACvB,YAA4C;IAE5C,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE;QAC3B,YAAY,CAAC,SAAS,gBAAQ,qBAAqB,CAAE,CAAA;KACtD;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE;QAC7B,OAAM;KACP;IACD,IAAI,CAAC,OAAO,CACV,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE;QACjC,KAAK,CAAC,kBAAkB,CACtB,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAC1B,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CACxD;KACF,CAAC,CACH,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/search-clear.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The "clear search" button a listing's search field carries — marked
+ * `data-tq-search-clear` by the editor (`listing-search-field.ts`), the same
+ * marker the canvas renderer acts on. The search keyword is the mapper's own
+ * React state, which no authored workflow can reach, so the generator wires
+ * the button here: a click empties the query, and the button renders only
+ * while the query is non-empty.
+ *
+ * A button belongs to the search input it shares a parent with — the field
+ * wrapper — never to "the next search-enabled mapper": a page with two lists
+ * and one clear button would otherwise wire it to the wrong list.
+ */
+export declare const SEARCH_CLEAR_ATTR = "data-tq-search-clear";
+export interface SearchClearButton {
+    node: any;
+    parent: any;
+    index: number;
+}
+/** Every marked button under `root`, with the JSX parent and child index it sits at. */
+export declare function findAllSearchClearButtonsInJSX(root: any): SearchClearButton[];
+/** The search input the button shares its parent with, or null. */
+export declare function findSiblingSearchInput(button: SearchClearButton, searchInputs: any[]): any | null;
+/**
+ * Wires one button: `onClick` empties the query, and the element is replaced
+ * in its parent by `{query ? <button…/> : null}`.
+ */
+export declare function wireSearchClearButton(button: SearchClearButton, vars: {
+    searchQueryVar: string;
+    setSearchQueryVar: string;
+}): void;
+//# sourceMappingURL=search-clear.d.ts.map

package/dist/esm/search-clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-clear.d.ts","sourceRoot":"","sources":["../../src/search-clear.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,iBAAiB,yBAAyB,CAAA;AAIvD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,GAAG,CAAA;IACT,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAQD,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,GAAG,GAAG,iBAAiB,EAAE,CAqC7E;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAGjG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAC1D,IAAI,CAgBN"}

package/dist/esm/search-clear.js

@@ -0,0 +1,74 @@
+import * as types from '@babel/types';
+import { setJSXExpressionAttribute } from './pagination-controls';
+/**
+ * The "clear search" button a listing's search field carries — marked
+ * `data-tq-search-clear` by the editor (`listing-search-field.ts`), the same
+ * marker the canvas renderer acts on. The search keyword is the mapper's own
+ * React state, which no authored workflow can reach, so the generator wires
+ * the button here: a click empties the query, and the button renders only
+ * while the query is non-empty.
+ *
+ * A button belongs to the search input it shares a parent with — the field
+ * wrapper — never to "the next search-enabled mapper": a page with two lists
+ * and one clear button would otherwise wire it to the wrong list.
+ */
+export var SEARCH_CLEAR_ATTR = 'data-tq-search-clear';
+function hasSearchClearMarker(node) {
+    var _a, _b;
+    return !!((_b = (_a = node === null || node === void 0 ? void 0 : node.openingElement) === null || _a === void 0 ? void 0 : _a.attributes) === null || _b === void 0 ? void 0 : _b.some(function (attr) { var _a; return attr.type === 'JSXAttribute' && ((_a = attr.name) === null || _a === void 0 ? void 0 : _a.name) === SEARCH_CLEAR_ATTR; }));
+}
+/** Every marked button under `root`, with the JSX parent and child index it sits at. */
+export function findAllSearchClearButtonsInJSX(root) {
+    var results = [];
+    var traverse = function (node) {
+        if (!node) {
+            return;
+        }
+        if (node.type === 'JSXElement' && Array.isArray(node.children)) {
+            node.children.forEach(function (child, index) {
+                if ((child === null || child === void 0 ? void 0 : child.type) === 'JSXElement' && hasSearchClearMarker(child)) {
+                    results.push({ node: child, parent: node, index: index });
+                }
+                traverse(child);
+            });
+            return;
+        }
+        if (node.body) {
+            if (Array.isArray(node.body)) {
+                node.body.forEach(function (statement) { return traverse(statement); });
+            }
+            else {
+                traverse(node.body);
+            }
+        }
+        if (node.consequent) {
+            traverse(node.consequent);
+        }
+        if (node.alternate) {
+            traverse(node.alternate);
+        }
+        if (node.expression) {
+            traverse(node.expression);
+        }
+        if (node.argument) {
+            traverse(node.argument);
+        }
+    };
+    traverse(root);
+    return results;
+}
+/** The search input the button shares its parent with, or null. */
+export function findSiblingSearchInput(button, searchInputs) {
+    var _a, _b;
+    var siblings = (_a = button.parent.children) !== null && _a !== void 0 ? _a : [];
+    return (_b = siblings.find(function (sibling) { return searchInputs.includes(sibling); })) !== null && _b !== void 0 ? _b : null;
+}
+/**
+ * Wires one button: `onClick` empties the query, and the element is replaced
+ * in its parent by `{query ? <button…/> : null}`.
+ */
+export function wireSearchClearButton(button, vars) {
+    setJSXExpressionAttribute(button.node, 'onClick', types.arrowFunctionExpression([], types.callExpression(types.identifier(vars.setSearchQueryVar), [types.stringLiteral('')])));
+    button.parent.children[button.index] = types.jsxExpressionContainer(types.conditionalExpression(types.identifier(vars.searchQueryVar), button.node, types.nullLiteral()));
+}
+//# sourceMappingURL=search-clear.js.map

package/dist/esm/search-clear.js.map

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

package/dist/esm/transformations/index.d.ts

@@ -1,5 +1,6 @@
 import type { GeneratorOptions, UIDLEcommerceCategory } from '@teleporthq/teleport-types';
 import { type EcommerceProductTransformOptions } from './ecommerce-product';
+import { type ContentLocalization, type LocalizedProjectOptions } from '../content-localization';
 export type { EcommerceProductTransformOptions };
 /**
  * Everything a generated fetcher bakes in, for EITHER entity. One options object
@@ -10,6 +11,13 @@ export type { EcommerceProductTransformOptions };
 export interface EntityTransformOptions extends EcommerceProductTransformOptions {
     /** Blog post-category taxonomy — see `blogSettings.categories`. */
     blogCategories?: UIDLEcommerceCategory[];
+    /**
+     * The languages the rows are stored in — absent for a single-language
+     * project. The transform resolves every translatable field against the
+     * request's locale (`?locale=es` → `es_name`, falling back to `name`), and
+     * the fetcher matches and sorts translatable columns the same way.
+     */
+    localization?: ContentLocalization;
 }
 /**
  * Collects everything the product transform bakes in from the generator
@@ -20,7 +28,7 @@ export interface EntityTransformOptions extends EcommerceProductTransformOptions
  * tax-inclusive or untaxed stores. `allowBackorders` is the effective
  * "stock never blocks a purchase" flag — see `resolveAllowBackorders`.
  */
-export declare const buildProductTransformOptions: (options: Pick<GeneratorOptions, 'ecommerceSettings' | 'invoiceSettings' | 'blogSettings'>) => EntityTransformOptions;
+export declare const buildProductTransformOptions: (options: Pick<GeneratorOptions, 'ecommerceSettings' | 'invoiceSettings' | 'blogSettings'> & LocalizedProjectOptions) => EntityTransformOptions;
 export type TransformationType = 'blog-post' | 'ecommerce-product' | 'custom-page' | null;
 /**
  * Detects which transformation type to apply based on the table name.
@@ -61,6 +69,12 @@ export declare const REVIEWS_PER_PRODUCT = 5;
  * Returns the transform wrapper function code that handles asset map loading
  * and calls the appropriate transformer.
  * Returns empty string if no transformation is needed.
+ *
+ * The request's `locale` (see `REQUEST_LOCALE_PARAM`) is what every
+ * translatable field resolves against; the MAIN locale it falls back to is a
+ * project constant and is baked in from `options.localization` rather than
+ * asked of every caller. Without a localization every row reads as before —
+ * the base columns.
  */
-export declare const getTransformWrapperCode: (tableName: string) => string;
+export declare const getTransformWrapperCode: (tableName: string, options?: Pick<EntityTransformOptions, 'localization'>) => string;
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/transformations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transformations/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAKzF,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EAAE,gCAAgC,EAAE,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gCAAgC;IAC9E,mEAAmE;IACnE,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACzC;AAkBD;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,YAC9B,KAAK,gBAAgB,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,cAAc,CAAC,KACxF,sBAKD,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,mBAAmB,GAAG,aAAa,GAAG,IAAI,CAAA;AAezF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,cAAe,MAAM,KAAG,kBAe5D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,cACrB,MAAM,YACR,sBAAsB,KAC9B,MAkBF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,cAAe,MAAM,KAAG,MAAM,GAAG,IAgBnE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,cAAe,MAAM,KAAG,MAiI3D,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transformations/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAKzF,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EAAE,gCAAgC,EAAE,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gCAAgC;IAC9E,mEAAmE;IACnE,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACxC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC;AAkBD;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,YAC9B,KAAK,gBAAgB,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,cAAc,CAAC,GACvF,uBAAuB,KACxB,sBAMD,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,mBAAmB,GAAG,aAAa,GAAG,IAAI,CAAA;AAezF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,cAAe,MAAM,KAAG,kBAe5D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,cACrB,MAAM,YACR,sBAAsB,KAC9B,MAkBF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,cAAe,MAAM,KAAG,MAAM,GAAG,IAgBnE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,cACvB,MAAM,YACR,KAAK,sBAAsB,EAAE,cAAc,CAAC,KACpD,MAkIF,CAAA"}

package/dist/esm/transformations/index.js

@@ -3,6 +3,8 @@ import { generateSharedTransformationCode } from './shared-utils';
 import { generateBlogPostTransformationCode } from './blog-post';
 import { generateCustomPageTransformationCode } from './custom-page';
 import { generateEcommerceProductTransformationCode, } from './ecommerce-product';
+import { REQUEST_LOCALE_PARAM } from '../request-locale';
+import { resolveContentLocalization, } from '../content-localization';
 /**
  * Stock never gates purchasability when the merchant disabled stock management
  * entirely or opted into backorders. Mirrors the GUI rule in
@@ -33,6 +35,7 @@ export var buildProductTransformOptions = function (options) {
         blogCategories: (_b = options.blogSettings) === null || _b === void 0 ? void 0 : _b.categories,
         storefrontTaxRate: StorefrontTax.resolveStorefrontTaxRate(options.invoiceSettings),
         allowBackorders: resolveAllowBackorders(options.ecommerceSettings),
+        localization: resolveContentLocalization(options),
     });
 };
 /**
@@ -133,12 +136,21 @@ export var REVIEWS_PER_PRODUCT = 5;
  * Returns the transform wrapper function code that handles asset map loading
  * and calls the appropriate transformer.
  * Returns empty string if no transformation is needed.
+ *
+ * The request's `locale` (see `REQUEST_LOCALE_PARAM`) is what every
+ * translatable field resolves against; the MAIN locale it falls back to is a
+ * project constant and is baked in from `options.localization` rather than
+ * asked of every caller. Without a localization every row reads as before —
+ * the base columns.
  */
-export var getTransformWrapperCode = function (tableName) {
+export var getTransformWrapperCode = function (tableName, options) {
+    var _a, _b;
+    if (options === void 0) { options = {}; }
     var type = detectTransformationType(tableName);
     if (!type) {
         return '';
     }
+    var mainLanguageLiteral = JSON.stringify((_b = (_a = options.localization) === null || _a === void 0 ? void 0 : _a.mainLocale) !== null && _b !== void 0 ? _b : null);
     var transformFn = type === 'blog-post'
         ? 'transformBlogPosts'
         : type === 'custom-page'
@@ -182,6 +194,6 @@ export var getTransformWrapperCode = function (tableName) {
         ? "\n  var ".concat(relatedMapVar, " = null\n  if (Array.isArray(records) && records.length === 1) {\n    try {\n      ").concat(relatedMapVar, " = await ").concat(relatedMapFn, "(getClientFn, records)\n    } catch (e) {\n      // Best-effort; the related rail stays hidden behind its empty gate.\n    }\n  }")
         : '';
     var relatedOption = hasRelatedItems ? ", ".concat(relatedMapVar, ": ").concat(relatedMapVar) : '';
-    return "\nasync function transformRecords(records, getClientFn, reqQuery) {\n  var assetMap = {}\n  try {\n    assetMap = await getAssetMap(getClientFn)\n  } catch (e) {\n    // Asset resolution is best-effort; continue without it\n  }".concat(relatedEnrichment).concat(variantEnrichment, "\n  var currentLanguage = (reqQuery && reqQuery.lang) || null\n  var mainLanguage = (reqQuery && reqQuery.mainLang) || null\n  var options = { assetMap: assetMap, currentLanguage: currentLanguage, mainLanguage: mainLanguage").concat(variantOption).concat(relatedOption, " }\n  return ").concat(transformFn, "(records, options)\n}\n");
+    return "\nasync function transformRecords(records, getClientFn, reqQuery) {\n  var assetMap = {}\n  try {\n    assetMap = await getAssetMap(getClientFn)\n  } catch (e) {\n    // Asset resolution is best-effort; continue without it\n  }".concat(relatedEnrichment).concat(variantEnrichment, "\n  var currentLanguage = reqQuery && typeof reqQuery.").concat(REQUEST_LOCALE_PARAM, " === 'string' && reqQuery.").concat(REQUEST_LOCALE_PARAM, " ? reqQuery.").concat(REQUEST_LOCALE_PARAM, " : null\n  var options = { assetMap: assetMap, currentLanguage: currentLanguage, mainLanguage: ").concat(mainLanguageLiteral).concat(variantOption).concat(relatedOption, " }\n  return ").concat(transformFn, "(records, options)\n}\n");
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/transformations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transformations/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAAE,kCAAkC,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,oCAAoC,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EACL,0CAA0C,GAE3C,MAAM,qBAAqB,CAAA;AAe5B;;;;;;GAMG;AACH,IAAM,sBAAsB,GAAG,UAC7B,QAA2D;;IAE3D,IAAI,CAAC,QAAQ,EAAE;QACb,OAAO,KAAK,CAAA;KACb;IACD,OAAO,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAA,MAAA,QAAQ,CAAC,qBAAqB,0CAAE,eAAe,MAAK,IAAI,CAAA;AAC9F,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,IAAM,4BAA4B,GAAG,UAC1C,OAAyF;;IAC9D,OAAA,CAAC;QAC5B,UAAU,EAAE,MAAA,OAAO,CAAC,iBAAiB,0CAAE,UAAU;QACjD,cAAc,EAAE,MAAA,OAAO,CAAC,YAAY,0CAAE,UAAU;QAChD,iBAAiB,EAAE,aAAa,CAAC,wBAAwB,CAAC,OAAO,CAAC,eAAe,CAAC;QAClF,eAAe,EAAE,sBAAsB,CAAC,OAAO,CAAC,iBAAiB,CAAC;KACnE,CAAC,CAAA;CAAA,CAAA;AAIF;;;;GAIG;AACH,IAAM,oBAAoB,GAAG,UAAC,SAAiB;IAC7C,IAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAA;IAC5C,IAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACtC,IAAM,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC5D,kEAAkE;IAClE,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;AACnC,CAAC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,IAAM,wBAAwB,GAAG,UAAC,SAAiB;IACxD,IAAI,CAAC,SAAS,EAAE;QACd,OAAO,IAAI,CAAA;KACZ;IACD,IAAM,IAAI,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAA;IAC5C,IAAI,IAAI,KAAK,qBAAqB,EAAE;QAClC,OAAO,WAAW,CAAA;KACnB;IACD,IAAI,IAAI,KAAK,mBAAmB,EAAE;QAChC,OAAO,mBAAmB,CAAA;KAC3B;IACD,IAAI,IAAI,KAAK,gBAAgB,EAAE;QAC7B,OAAO,aAAa,CAAA;KACrB;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,IAAM,qBAAqB,GAAG,UACnC,SAAiB,EACjB,OAAoC;IAApC,wBAAA,EAAA,YAAoC;IAEpC,IAAM,IAAI,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAA;IAChD,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,EAAE,CAAA;KACV;IAED,IAAM,MAAM,GAAG,gCAAgC,EAAE,CAAA;IAEjD,QAAQ,IAAI,EAAE;QACZ,KAAK,WAAW;YACd,OAAO,MAAM,GAAG,kCAAkC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;QAC5F,KAAK,mBAAmB;YACtB,OAAO,MAAM,GAAG,0CAA0C,CAAC,OAAO,CAAC,CAAA;QACrE,KAAK,aAAa;YAChB,OAAO,MAAM,GAAG,oCAAoC,EAAE,CAAA;QACxD;YACE,OAAO,EAAE,CAAA;KACZ;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,IAAM,sBAAsB,GAAG,UAAC,SAAiB;IACtD,IAAM,IAAI,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAA;IAChD,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,IAAI,CAAA;KACZ;IAED,QAAQ,IAAI,EAAE;QACZ,KAAK,WAAW;YACd,OAAO,wDAAwD,CAAA;QACjE,KAAK,mBAAmB;YACtB,OAAO,wDAAwD,CAAA;QACjE,KAAK,aAAa;YAChB,OAAO,wDAAwD,CAAA;QACjE;YACE,OAAO,IAAI,CAAA;KACd;AACH,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,IAAM,mBAAmB,GAAG,CAAC,CAAA;AAEpC;;;;GAIG;AACH,MAAM,CAAC,IAAM,uBAAuB,GAAG,UAAC,SAAiB;IACvD,IAAM,IAAI,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAA;IAChD,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,EAAE,CAAA;KACV;IAED,IAAM,WAAW,GACf,IAAI,KAAK,WAAW;QAClB,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,IAAI,KAAK,aAAa;YACxB,CAAC,CAAC,sBAAsB;YACxB,CAAC,CAAC,4BAA4B,CAAA;IAElC,+EAA+E;IAC/E,+EAA+E;IAC/E,EAAE;IACF,yEAAyE;IACzE,wEAAwE;IACxE,8EAA8E;IAC9E,2EAA2E;IAC3E,wCAAwC;IACxC,EAAE;IACF,8EAA8E;IAC9E,yEAAyE;IACzE,4EAA4E;IAC5E,IAAM,iBAAiB,GACrB,IAAI,KAAK,mBAAmB;QAC1B,CAAC,CAAC,yzEA+C4E,mBAAmB,8GAInG;QACE,CAAC,CAAC,EAAE,CAAA;IAER,IAAM,aAAa,GACjB,IAAI,KAAK,mBAAmB;QAC1B,CAAC,CAAC,4HAA4H;QAC9H,CAAC,CAAC,EAAE,CAAA;IAER,2EAA2E;IAC3E,0EAA0E;IAC1E,6EAA6E;IAC7E,6EAA6E;IAC7E,0EAA0E;IAC1E,2EAA2E;IAC3E,qBAAqB;IACrB,EAAE;IACF,0EAA0E;IAC1E,8EAA8E;IAC9E,iBAAiB;IACjB,2EAA2E;IAC3E,mCAAmC;IACnC,IAAM,eAAe,GAAG,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,mBAAmB,CAAA;IAC5E,IAAM,aAAa,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,qBAAqB,CAAA;IACvF,IAAM,YAAY,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,uBAAuB,CAAA;IAC1F,IAAM,iBAAiB,GAAG,eAAe;QACvC,CAAC,CAAC,kBACE,aAAa,gGAGb,aAAa,sBAAY,YAAY,sIAIzC;QACA,CAAC,CAAC,EAAE,CAAA;IACN,IAAM,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,YAAK,aAAa,eAAK,aAAa,CAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAEnF,OAAO,6OAOJ,iBAAiB,SAAG,iBAAiB,4OAG0D,aAAa,SAAG,aAAa,0BACtH,WAAW,4BAErB,CAAA;AACD,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transformations/index.ts"],"names":[],"mappings":"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"}