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

package/dist/cjs/localized-columns.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Filtering and sorting a translatable column in the visitor's language.
+ *
+ * A translatable column of a platform table exists once per language:
+ * `slug` holds the main language and `es_slug` the Spanish copy (see
+ * `ContentLocalization`). The row transform resolves what a page DISPLAYS —
+ * a Spanish listing shows `es_name` and links to `es_slug` — but the SQL a
+ * fetch runs still names the base column, so without this file:
+ *
+ *   - the details page a Spanish card links to (`/es/products/<es_slug>`)
+ *     looks the row up with `slug = $1` and answers 404;
+ *   - "sort by name" on the Spanish listing orders the Spanish names by
+ *     their ENGLISH counterparts.
+ *
+ * The teleport fetcher (`fetchers/teleport.ts`) therefore embeds the helper
+ * emitted here:
+ *
+ *   - equality on a translatable column matches the value in ANY language:
+ *     `("slug" = $1 OR "es_slug" = $1)`. Deliberately every language, not the
+ *     request's: the language switcher keeps the URL and changes the locale,
+ *     so `/products/<es_slug>` (English page, Spanish slug) has to resolve as
+ *     well as `/es/products/<slug>`. Only `=` (and the `in` it is normalised
+ *     to) — a translatable column is never compared with `<`, and `!=` on one
+ *     has no sensible cross-language reading;
+ *   - ordering by a translatable column orders by the REQUEST's language,
+ *     falling back to the base column exactly like the transform does:
+ *     `COALESCE(NULLIF("es_name", ''), "name")`.
+ *
+ * Which columns take part is decided at GENERATION time from the table's
+ * schema and the project's languages — never by prefix-sniffing column names,
+ * which would mistake `og_title` for a translation. A copy the schema does not
+ * list (a language added before a column became translatable) is simply not
+ * referenced, so the SQL can only ever name columns that exist.
+ */
+import type { ContentLocalization } from './content-localization';
+/**
+ * Base column → `{ locale: copy column }`, for every translatable column of a
+ * table that has at least one per-language copy in the schema.
+ */
+export type LocalizedColumnMap = Record<string, Record<string, string>>;
+/**
+ * Pairs every column with the per-language copies the schema actually holds.
+ * Empty (no families) when the project has one language or the table has no
+ * translated column — the emitted helper is then inert.
+ */
+export declare const collectLocalizedColumns: (columnNames: string[], localization: ContentLocalization | undefined) => LocalizedColumnMap;
+/**
+ * The `localizedEqualityClause` / `localizedSortFieldSql` helpers a fetcher
+ * embeds, with the column map baked in.
+ *
+ * Emitted as plain source with no backtick and no `${`, because the fetcher
+ * interpolates it into a template literal. Every identifier it quotes comes
+ * from the baked map, so a request can only ever name a column the schema had.
+ */
+export declare const generateLocalizedColumnsHelper: (families: LocalizedColumnMap) => string;
+//# sourceMappingURL=localized-columns.d.ts.map

package/dist/cjs/localized-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localized-columns.d.ts","sourceRoot":"","sources":["../../src/localized-columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAQvE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gBACrB,MAAM,EAAE,gBACP,mBAAmB,GAAG,SAAS,KAC5C,kBAmBF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,aAAc,kBAAkB,KAAG,MA8C7E,CAAA"}

package/dist/cjs/localized-columns.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Filtering and sorting a translatable column in the visitor's language.
+ *
+ * A translatable column of a platform table exists once per language:
+ * `slug` holds the main language and `es_slug` the Spanish copy (see
+ * `ContentLocalization`). The row transform resolves what a page DISPLAYS —
+ * a Spanish listing shows `es_name` and links to `es_slug` — but the SQL a
+ * fetch runs still names the base column, so without this file:
+ *
+ *   - the details page a Spanish card links to (`/es/products/<es_slug>`)
+ *     looks the row up with `slug = $1` and answers 404;
+ *   - "sort by name" on the Spanish listing orders the Spanish names by
+ *     their ENGLISH counterparts.
+ *
+ * The teleport fetcher (`fetchers/teleport.ts`) therefore embeds the helper
+ * emitted here:
+ *
+ *   - equality on a translatable column matches the value in ANY language:
+ *     `("slug" = $1 OR "es_slug" = $1)`. Deliberately every language, not the
+ *     request's: the language switcher keeps the URL and changes the locale,
+ *     so `/products/<es_slug>` (English page, Spanish slug) has to resolve as
+ *     well as `/es/products/<slug>`. Only `=` (and the `in` it is normalised
+ *     to) — a translatable column is never compared with `<`, and `!=` on one
+ *     has no sensible cross-language reading;
+ *   - ordering by a translatable column orders by the REQUEST's language,
+ *     falling back to the base column exactly like the transform does:
+ *     `COALESCE(NULLIF("es_name", ''), "name")`.
+ *
+ * Which columns take part is decided at GENERATION time from the table's
+ * schema and the project's languages — never by prefix-sniffing column names,
+ * which would mistake `og_title` for a translation. A copy the schema does not
+ * list (a language added before a column became translatable) is simply not
+ * referenced, so the SQL can only ever name columns that exist.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateLocalizedColumnsHelper = exports.collectLocalizedColumns = void 0;
+/** The only identifiers the generated SQL is allowed to quote — same rule as the search columns. */
+var SQL_IDENTIFIER_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+/** The column holding `column` in `locale` — the editor's `getI18nColumnName`. */
+var localizedColumnName = function (locale, column) { return "".concat(locale, "_").concat(column); };
+/**
+ * Pairs every column with the per-language copies the schema actually holds.
+ * Empty (no families) when the project has one language or the table has no
+ * translated column — the emitted helper is then inert.
+ */
+var collectLocalizedColumns = function (columnNames, localization) {
+    var families = {};
+    if (!localization || localization.secondaryLocales.length === 0) {
+        return families;
+    }
+    var present = new Set(columnNames.filter(function (name) { return SQL_IDENTIFIER_PATTERN.test(name); }));
+    present.forEach(function (column) {
+        localization.secondaryLocales.forEach(function (locale) {
+            var copy = localizedColumnName(locale, column);
+            if (!present.has(copy)) {
+                return;
+            }
+            if (!families[column]) {
+                families[column] = {};
+            }
+            families[column][locale] = copy;
+        });
+    });
+    return families;
+};
+exports.collectLocalizedColumns = collectLocalizedColumns;
+/**
+ * The `localizedEqualityClause` / `localizedSortFieldSql` helpers a fetcher
+ * embeds, with the column map baked in.
+ *
+ * Emitted as plain source with no backtick and no `${`, because the fetcher
+ * interpolates it into a template literal. Every identifier it quotes comes
+ * from the baked map, so a request can only ever name a column the schema had.
+ */
+var generateLocalizedColumnsHelper = function (families) {
+    var lines = [
+        '// Per-language copies of the translatable columns, base column -> locale -> copy.',
+        '// Baked from the table schema and the project languages at generation time.',
+        "var LOCALIZED_COLUMNS = ".concat(JSON.stringify(families)),
+        '',
+        'function quoteLocalizedColumn(column) {',
+        "  return '\"' + column + '\"'",
+        '}',
+        '',
+        '// Equality on a translatable column matches the value in ANY language, so a',
+        '// localized slug resolves whichever locale the URL is under. Answers null',
+        '// for every other column and operand, leaving them to the ordinary branches.',
+        'function localizedEqualityClause(field, operand, value, pushParam) {',
+        '  var copies = LOCALIZED_COLUMNS[field]',
+        "  if (!copies || operand !== '=' || value === null || value === undefined) return null",
+        '  // An empty set means "no filter", as it does in the ordinary array branch.',
+        '  if (Array.isArray(value) && value.length === 0) return null',
+        '  var columns = [field]',
+        '  for (var locale in copies) {',
+        '    if (Object.prototype.hasOwnProperty.call(copies, locale)) columns.push(copies[locale])',
+        '  }',
+        '  var param = Array.isArray(value) ? pushParam(value.map(String)) : pushParam(value)',
+        '  var clauses = []',
+        '  for (var i = 0; i < columns.length; i++) {',
+        '    clauses.push(',
+        '      Array.isArray(value)',
+        "        ? quoteLocalizedColumn(columns[i]) + '::text = ANY(' + param + '::text[])'",
+        "        : quoteLocalizedColumn(columns[i]) + ' = ' + param",
+        '    )',
+        '  }',
+        "  return '(' + clauses.join(' OR ') + ')'",
+        '}',
+        '',
+        "// ORDER BY a translatable column in the request's language, falling back to",
+        '// the base column for a row with no translation — the same resolution the',
+        '// row transform applies to what is displayed. Null when the field or the',
+        '// locale has no copy, so the ordinary sort runs.',
+        'function localizedSortFieldSql(field, locale) {',
+        '  var copies = LOCALIZED_COLUMNS[field]',
+        "  var copy = copies && typeof locale === 'string' ? copies[locale] : null",
+        '  if (!copy) return null',
+        "  return 'COALESCE(NULLIF(' + quoteLocalizedColumn(copy) + \", ''), \" + quoteLocalizedColumn(field) + ')'",
+        '}',
+    ];
+    return lines.join('\n');
+};
+exports.generateLocalizedColumnsHelper = generateLocalizedColumnsHelper;
+//# sourceMappingURL=localized-columns.js.map

package/dist/cjs/localized-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localized-columns.js","sourceRoot":"","sources":["../../src/localized-columns.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AAUH,oGAAoG;AACpG,IAAM,sBAAsB,GAAG,0BAA0B,CAAA;AAEzD,kFAAkF;AAClF,IAAM,mBAAmB,GAAG,UAAC,MAAc,EAAE,MAAc,IAAa,OAAA,UAAG,MAAM,cAAI,MAAM,CAAE,EAArB,CAAqB,CAAA;AAE7F;;;;GAIG;AACI,IAAM,uBAAuB,GAAG,UACrC,WAAqB,EACrB,YAA6C;IAE7C,IAAM,QAAQ,GAAuB,EAAE,CAAA;IACvC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE;QAC/D,OAAO,QAAQ,CAAA;KAChB;IACD,IAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAjC,CAAiC,CAAC,CAAC,CAAA;IACxF,OAAO,CAAC,OAAO,CAAC,UAAC,MAAM;QACrB,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAC,MAAM;YAC3C,IAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACtB,OAAM;aACP;YACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;gBACrB,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;aACtB;YACD,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;QACjC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAtBY,QAAA,uBAAuB,2BAsBnC;AAED;;;;;;;GAOG;AACI,IAAM,8BAA8B,GAAG,UAAC,QAA4B;IACzE,IAAM,KAAK,GAAG;QACZ,oFAAoF;QACpF,8EAA8E;QAC9E,kCAA2B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAE;QACrD,EAAE;QACF,yCAAyC;QACzC,+BAA+B;QAC/B,GAAG;QACH,EAAE;QACF,8EAA8E;QAC9E,4EAA4E;QAC5E,+EAA+E;QAC/E,sEAAsE;QACtE,yCAAyC;QACzC,wFAAwF;QACxF,+EAA+E;QAC/E,+DAA+D;QAC/D,yBAAyB;QACzB,gCAAgC;QAChC,4FAA4F;QAC5F,KAAK;QACL,sFAAsF;QACtF,oBAAoB;QACpB,8CAA8C;QAC9C,mBAAmB;QACnB,4BAA4B;QAC5B,oFAAoF;QACpF,4DAA4D;QAC5D,OAAO;QACP,KAAK;QACL,2CAA2C;QAC3C,GAAG;QACH,EAAE;QACF,8EAA8E;QAC9E,4EAA4E;QAC5E,2EAA2E;QAC3E,mDAAmD;QACnD,iDAAiD;QACjD,yCAAyC;QACzC,2EAA2E;QAC3E,0BAA0B;QAC1B,4GAA4G;QAC5G,GAAG;KACJ,CAAA;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC,CAAA;AA9CY,QAAA,8BAA8B,kCA8C1C"}

package/dist/cjs/pagination-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination-plugin.d.ts","sourceRoot":"","sources":["../../src/pagination-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAGvB,MAAM,4BAA4B,CAAA;AA4iCnC,eAAO,MAAM,qCAAqC,EAAE,sBAAsB,CAAC,EAAE,CA40B5E,CAAA"}
+{"version":3,"file":"pagination-plugin.d.ts","sourceRoot":"","sources":["../../src/pagination-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAGvB,MAAM,4BAA4B,CAAA;AA4jCnC,eAAO,MAAM,qCAAqC,EAAE,sBAAsB,CAAC,EAAE,CAo1B5E,CAAA"}

package/dist/cjs/pagination-plugin.js

@@ -84,10 +84,13 @@ var config_1 = require("./cache/config");
 var ast_1 = require("./cache/ast");
 var pagination_controls_1 = require("./pagination-controls");
 var count_effect_1 = require("./count-effect");
+var search_clear_1 = require("./search-clear");
 var numbered_pagination_1 = require("./numbered-pagination");
 var infinite_scroll_1 = require("./infinite-scroll");
 var page_reset_1 = require("./page-reset");
 var page_url_sync_1 = require("./page-url-sync");
+var content_localization_1 = require("./content-localization");
+var request_locale_1 = require("./request-locale");
 // tslint:disable-next-line:no-any
 function parseSearchDefaultValue(raw) {
     if (!raw || typeof raw !== 'object') {
@@ -557,6 +560,7 @@ function getStateVarsForUsage(usage) {
         combinedStateVar: "ds_".concat(idx, "_state"),
         setCombinedStateVar: "setDs_".concat(idx, "_state"),
         skipDebounceRefVar: "ds_".concat(idx, "_skipDebounce"),
+        countSeqRefVar: "ds_".concat(idx, "_countSeq"),
         propsPrefix: "".concat(usage.dataSourceIdentifier, "_ds_").concat(idx),
     };
 }
@@ -769,7 +773,7 @@ function pushFilterSortPageResetEffect(stateDeclarations, effectStatements, usag
 // ==================== MAIN PLUGIN ====================
 var createNextArrayMapperPaginationPlugin = function () {
     var paginationPlugin = function (structure) { return __awaiter(void 0, void 0, void 0, function () {
-        var uidl, chunks, dependencies, options, componentChunk, variableDeclaration, declarator, arrowFunction, blockStatement, registry, getStaticPropsChunk, isPage, stateDeclarations, effectStatements, needsUseRouter, hasRouterDecl, returnIndex, insertIndex, dataProviders, dataProvidersWithRepeaters, usageIndexByDataSourceId, loadingStateDeclarations, usagesWithLoadingState, usageByProviderNode, cacheDeclarations, sharedOptions, cachedScopes, dataProvidersWithoutRepeaters, searchInputs, searchEnabledUsages;
+        var uidl, chunks, dependencies, options, componentChunk, variableDeclaration, declarator, arrowFunction, blockStatement, registry, getStaticPropsChunk, isPage, localized, stateDeclarations, effectStatements, needsUseRouter, returnIndex, insertIndex, dataProviders, dataProvidersWithRepeaters, usageIndexByDataSourceId, loadingStateDeclarations, usagesWithLoadingState, usageByProviderNode, cacheDeclarations, sharedOptions, cachedScopes, dataProvidersWithoutRepeaters, searchInputs, searchEnabledUsages, usageBySearchInput;
         var _a, _b;
         return __generator(this, function (_c) {
             uidl = structure.uidl, chunks = structure.chunks, dependencies = structure.dependencies, options = structure.options;
@@ -799,6 +803,7 @@ var createNextArrayMapperPaginationPlugin = function () {
             }
             getStaticPropsChunk = chunks.find(function (chunk) { return chunk.name === 'getStaticProps'; });
             isPage = !!getStaticPropsChunk;
+            localized = (0, content_localization_1.isLocalizedProject)(options);
             // Add React dependencies
             if (!dependencies.useState) {
                 dependencies.useState = {
@@ -960,12 +965,14 @@ var createNextArrayMapperPaginationPlugin = function () {
                     (0, filter_utils_1.pushPropIdsAsDeps)(countEffectDeps, countEffectSeen, usage.filterPropIds);
                     // Same goes for URL-driven filters (already documented above).
                     pushUrlSearchParamMemoDeps(countEffectDeps, usage);
+                    stateDeclarations.push((0, count_effect_1.buildCountSeqDeclaration)(vars.countSeqRefVar));
                     effectStatements.push((0, count_effect_1.buildCountFetchEffect)({
                         fileName: fileName,
                         perPage: usage.perPage,
                         setMaxPagesVar: vars.setMaxPagesStateVar,
                         urlParams: urlParams,
                         deps: countEffectDeps,
+                        countSeqRefVar: vars.countSeqRefVar,
                     }));
                     // Two-way URL sync for the search input when bound to a URL param.
                     pushSearchUrlSyncEffects(effectStatements, usage, vars);
@@ -1025,12 +1032,14 @@ var createNextArrayMapperPaginationPlugin = function () {
                         (0, filter_utils_1.pushStateIdsAsDeps)(countDeps, countDepsSeen, usage.filterStateIds);
                         (0, filter_utils_1.pushPropIdsAsDeps)(countDeps, countDepsSeen, usage.filterPropIds);
                         pushUrlSearchParamMemoDeps(countDeps, usage);
+                        stateDeclarations.push((0, count_effect_1.buildCountSeqDeclaration)(vars.countSeqRefVar));
                         effectStatements.push((0, count_effect_1.buildCountFetchEffect)({
                             fileName: fileName,
                             perPage: usage.perPage,
                             setMaxPagesVar: vars.setMaxPagesStateVar,
                             urlParams: countUrlParams,
                             deps: countDeps,
+                            countSeqRefVar: vars.countSeqRefVar,
                         }));
                     }
                     // Visible page numbers, when this mapper draws a numbered strip.
@@ -1087,35 +1096,10 @@ var createNextArrayMapperPaginationPlugin = function () {
             });
             // Insert state declarations at the beginning
             stateDeclarations.reverse().forEach(function (s) { return blockStatement.body.unshift(s); });
-            needsUseRouter = registry.usages.some(function (u) { return hasUrlSearchParamFilters(u) || usageHasSearchUrlSync(u) || usageHasPageUrlSync(u); });
+            needsUseRouter = localized ||
+                registry.usages.some(function (u) { return hasUrlSearchParamFilters(u) || usageHasSearchUrlSync(u) || usageHasPageUrlSync(u); });
             if (needsUseRouter) {
-                if (!dependencies.useRouter) {
-                    // Match the shape the sibling Next.js plugins use (i18n locale mapper,
-                    // search-params plugin) so the deduped import line is identical and
-                    // the dependency-resolver merges instead of emitting a second one.
-                    dependencies.useRouter = {
-                        type: 'library',
-                        path: 'next/router',
-                        version: '^12.1.10',
-                        meta: { namedImport: true },
-                    };
-                }
-                hasRouterDecl = blockStatement.body.some(function (statement) {
-                    return statement.type === 'VariableDeclaration' &&
-                        statement.declarations.some(function (decl) {
-                            var _a;
-                            return decl.id.type === 'Identifier' &&
-                                decl.id.name === 'router' &&
-                                ((_a = decl.init) === null || _a === void 0 ? void 0 : _a.type) === 'CallExpression' &&
-                                decl.init.callee.type === 'Identifier' &&
-                                decl.init.callee.name === 'useRouter';
-                        });
-                });
-                if (!hasRouterDecl) {
-                    blockStatement.body.unshift(types.variableDeclaration('const', [
-                        types.variableDeclarator(types.identifier('router'), types.callExpression(types.identifier('useRouter'), [])),
-                    ]));
-                }
+                (0, request_locale_1.ensureRouterDeclaration)(blockStatement.body, dependencies);
             }
             // Both the search write-back and the page ⇄ URL effect write the URL through
             // the shared `URLQueryWriter`, so the ref + helper they close over must be in
@@ -1157,16 +1141,16 @@ var createNextArrayMapperPaginationPlugin = function () {
                 var fileName = (0, utils_1.generateSafeFileName)(usage.resourceDefinition.dataSourceType, usage.resourceDefinition.tableName, usage.resourceDefinition.dataSourceId);
                 // Update DataProvider based on category
                 if (usage.category === 'paginated+search') {
-                    updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDeclarations);
+                    updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDeclarations, localized);
                 }
                 else if (usage.category === 'paginated-only') {
-                    updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDeclarations);
+                    updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDeclarations, localized);
                 }
                 else if (usage.category === 'search-only') {
-                    updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclarations);
+                    updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclarations, localized);
                 }
                 else if (usage.category === 'plain') {
-                    updateDataProviderForPlain(dp, fileName, usage);
+                    updateDataProviderForPlain(dp, fileName, usage, localized);
                 }
                 // Show the array mapper's loading state while a category/sort/search
                 // change refetches, instead of leaving the previous rows on screen with
@@ -1226,7 +1210,7 @@ var createNextArrayMapperPaginationPlugin = function () {
             });
             searchInputs = findAllSearchInputsInJSX(blockStatement);
             searchEnabledUsages = registry.usages.filter(function (u) { return u.searchEnabled; });
-            // Match by order - search input 0 -> searchEnabledUsages[0], etc.
+            usageBySearchInput = new Map();
             searchInputs.forEach(function (input, idx) {
                 if (idx >= searchEnabledUsages.length) {
                     return;
@@ -1234,6 +1218,15 @@ var createNextArrayMapperPaginationPlugin = function () {
                 var usage = searchEnabledUsages[idx];
                 var vars = getStateVarsForUsage(usage);
                 wireSearchInput(input.node, vars);
+                usageBySearchInput.set(input.node, usage);
+            });
+            // STEP 4.5: Wire the clear buttons, each to the input it shares a parent with.
+            (0, search_clear_1.findAllSearchClearButtonsInJSX)(blockStatement).forEach(function (button) {
+                var input = (0, search_clear_1.findSiblingSearchInput)(button, searchInputs.map(function (entry) { return entry.node; }));
+                var usage = input ? usageBySearchInput.get(input) : undefined;
+                if (usage) {
+                    (0, search_clear_1.wireSearchClearButton)(button, getStateVarsForUsage(usage));
+                }
             });
             // STEP 5: Wire pagination widgets
             //
@@ -1255,7 +1248,7 @@ var createNextArrayMapperPaginationPlugin = function () {
             });
             // STEP 6: Update getStaticProps if this is a page
             if (isPage) {
-                updateGetStaticProps(chunks, registry, dependencies, (_b = uidl.outputOptions) === null || _b === void 0 ? void 0 : _b.folderPath);
+                updateGetStaticProps(chunks, registry, dependencies, (_b = uidl.outputOptions) === null || _b === void 0 ? void 0 : _b.folderPath, localized);
             }
             return [2 /*return*/, structure];
         });
@@ -1305,6 +1298,20 @@ function insertSentinelAfterProvider(blockStatement, provider, sentinel) {
         if (node.alternate) {
             traverse(node.alternate);
         }
+        // `{activeTabIndex === 0 && (<div>…<DataProvider/>…</div>)}` — a tab
+        // panel, a gated section: the provider sits on the RIGHT of a logical
+        // expression (or in a ternary's `test`), which is not a child, a body or
+        // an argument. Left unvisited, the products list under the first tab of
+        // a shop was never paginated or seeded, and rendered nothing.
+        if (node.left) {
+            traverse(node.left);
+        }
+        if (node.right) {
+            traverse(node.right);
+        }
+        if (node.test) {
+            traverse(node.test);
+        }
         if (node.expression) {
             traverse(node.expression);
         }
@@ -1342,6 +1349,20 @@ function findAllDataProvidersInJSX(blockStatement) {
         if (node.alternate) {
             traverse(node.alternate);
         }
+        // `{activeTabIndex === 0 && (<div>…<DataProvider/>…</div>)}` — a tab
+        // panel, a gated section: the provider sits on the RIGHT of a logical
+        // expression (or in a ternary's `test`), which is not a child, a body or
+        // an argument. Left unvisited, the products list under the first tab of
+        // a shop was never paginated or seeded, and rendered nothing.
+        if (node.left) {
+            traverse(node.left);
+        }
+        if (node.right) {
+            traverse(node.right);
+        }
+        if (node.test) {
+            traverse(node.test);
+        }
         if (node.expression) {
             traverse(node.expression);
         }
@@ -1424,6 +1445,20 @@ function findAllSearchInputsInJSX(blockStatement) {
         if (node.alternate) {
             traverse(node.alternate);
         }
+        // `{activeTabIndex === 0 && (<div>…<DataProvider/>…</div>)}` — a tab
+        // panel, a gated section: the provider sits on the RIGHT of a logical
+        // expression (or in a ternary's `test`), which is not a child, a body or
+        // an argument. Left unvisited, the products list under the first tab of
+        // a shop was never paginated or seeded, and rendered nothing.
+        if (node.left) {
+            traverse(node.left);
+        }
+        if (node.right) {
+            traverse(node.right);
+        }
+        if (node.test) {
+            traverse(node.test);
+        }
         if (node.expression) {
             traverse(node.expression);
         }
@@ -1479,6 +1514,20 @@ function findPaginationNodesWithOwners(blockStatement, usageByProviderNode) {
         if (node.alternate) {
             traverse(node.alternate);
         }
+        // `{activeTabIndex === 0 && (<div>…<DataProvider/>…</div>)}` — a tab
+        // panel, a gated section: the provider sits on the RIGHT of a logical
+        // expression (or in a ternary's `test`), which is not a child, a body or
+        // an argument. Left unvisited, the products list under the first tab of
+        // a shop was never paginated or seeded, and rendered nothing.
+        if (node.left) {
+            traverse(node.left);
+        }
+        if (node.right) {
+            traverse(node.right);
+        }
+        if (node.test) {
+            traverse(node.test);
+        }
         if (node.expression) {
             traverse(node.expression);
         }
@@ -1521,7 +1570,7 @@ dp, usage, paramsProps, memoDeps, cacheDeclarations) {
     dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('params'), types.jsxExpressionContainer(types.identifier(hoisted.paramsIdentifier))));
     return hoisted.cachedIdentifier;
 }
-function updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDeclarations) {
+function updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDeclarations, localized) {
     var attrs = dp.openingElement.attributes;
     // Remove existing params, key, initialData, fetchData, persistDataDuringLoading
     dp.openingElement.attributes = attrs.filter(function (attr) {
@@ -1550,6 +1599,9 @@ function updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDe
         (0, filter_utils_1.pushStateIdsAsDeps)(memoDeps, seenDeps, usage.dynamicSort.depStateIds);
     }
     pushUrlSearchParamMemoDeps(memoDeps, usage);
+    if (localized) {
+        (0, request_locale_1.appendClientLocaleParam)(paramsProps, memoDeps);
+    }
     var cachedInitialData = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations);
     // Add initialData. Skip the server-prefetched data entirely when a dynamic
     // state-bound sort is active — the prefetch ran without sort parameters, so
@@ -1601,7 +1653,7 @@ function updateDataProviderForPaginatedSearch(dp, usage, vars, fileName, cacheDe
     // Add persistDataDuringLoading
     dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('persistDataDuringLoading'), types.jsxExpressionContainer(types.booleanLiteral(true))));
 }
-function updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDeclarations) {
+function updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDeclarations, localized) {
     var attrs = dp.openingElement.attributes;
     dp.openingElement.attributes = attrs.filter(function (attr) {
         var _a;
@@ -1625,6 +1677,9 @@ function updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDec
         (0, filter_utils_1.pushStateIdsAsDeps)(memoDeps, seenDeps, usage.dynamicSort.depStateIds);
     }
     pushUrlSearchParamMemoDeps(memoDeps, usage);
+    if (localized) {
+        (0, request_locale_1.appendClientLocaleParam)(paramsProps, memoDeps);
+    }
     // Add params
     var cachedInitialData = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations);
     // Add initialData. See paginated+search updater for why we skip prefetch
@@ -1650,7 +1705,7 @@ function updateDataProviderForPaginationOnly(dp, usage, vars, fileName, cacheDec
     dp.openingElement.attributes.push(buildFetchDataForUsage(fileName, usage));
     dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('persistDataDuringLoading'), types.jsxExpressionContainer(types.booleanLiteral(true))));
 }
-function updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclarations) {
+function updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclarations, localized) {
     var _a;
     var attrs = dp.openingElement.attributes;
     dp.openingElement.attributes = attrs.filter(function (attr) {
@@ -1677,6 +1732,9 @@ function updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclara
         (0, filter_utils_1.pushStateIdsAsDeps)(memoDeps, seenDeps, usage.dynamicSort.depStateIds);
     }
     pushUrlSearchParamMemoDeps(memoDeps, usage);
+    if (localized) {
+        (0, request_locale_1.appendClientLocaleParam)(paramsProps, memoDeps);
+    }
     var cachedInitialData = pushParamsAttribute(dp, usage, paramsProps, memoDeps, cacheDeclarations);
     // Add initialData. See paginated+search updater for why we skip prefetch
     // reuse when a dynamic state-bound sort is active.
@@ -1692,7 +1750,7 @@ function updateDataProviderForSearchOnly(dp, usage, vars, fileName, cacheDeclara
     dp.openingElement.attributes.push(createFetchDataAttribute(fileName, ((_a = usage.cache) === null || _a === void 0 ? void 0 : _a.client) ? usage.cache : undefined));
     dp.openingElement.attributes.push(types.jsxAttribute(types.jsxIdentifier('persistDataDuringLoading'), types.jsxExpressionContainer(types.booleanLiteral(true))));
 }
-function updateDataProviderForPlain(dp, fileName, usage) {
+function updateDataProviderForPlain(dp, fileName, usage, localized) {
     var _a, _b, _c, _d;
     var attrs = dp.openingElement.attributes;
     var clientCache = ((_a = usage.cache) === null || _a === void 0 ? void 0 : _a.client) ? usage.cache : undefined;
@@ -1714,10 +1772,16 @@ function updateDataProviderForPlain(dp, fileName, usage) {
     if (!hasPersistData) {
         attrs.push(types.jsxAttribute(types.jsxIdentifier('persistDataDuringLoading'), types.jsxExpressionContainer(types.booleanLiteral(true))));
     }
-    // Find the params attribute
+    // Find the params attribute. A plain list may have none at all — but the
+    // fetch it was just given sends `params` regardless, and in a localized
+    // project those have to carry the locale, so the attribute is created.
     var paramsAttrIndex = attrs.findIndex(function (attr) { return attr.type === 'JSXAttribute' && attr.name.name === 'params'; });
     if (paramsAttrIndex === -1) {
-        return;
+        if (!localized) {
+            return;
+        }
+        attrs.push(types.jsxAttribute(types.jsxIdentifier('params'), types.jsxExpressionContainer(types.objectExpression([]))));
+        paramsAttrIndex = attrs.length - 1;
     }
     var paramsAttr = attrs[paramsAttrIndex];
     // Check if params is already wrapped in useMemo
@@ -1740,6 +1804,9 @@ function updateDataProviderForPlain(dp, fileName, usage) {
     (0, filter_utils_1.pushStateIdsAsDeps)(memoDeps, memoSeen, usage.filterStateIds);
     (0, filter_utils_1.pushPropIdsAsDeps)(memoDeps, memoSeen, usage.filterPropIds);
     pushUrlSearchParamMemoDeps(memoDeps, usage);
+    if (localized && paramsExpression.type === 'ObjectExpression') {
+        (0, request_locale_1.appendClientLocaleParam)(paramsExpression.properties, memoDeps);
+    }
     // Wrap params in useMemo with filter state dependencies
     var memoizedParams = types.callExpression(types.identifier('useMemo'), [
         types.arrowFunctionExpression([], paramsExpression),
@@ -1771,11 +1838,18 @@ function stabilizeDataProviderWithoutRepeater(dp) {
     if (!paramsExpression) {
         return;
     }
-    // Wrap params in useMemo with empty dependencies array
-    // This ensures the object reference stays stable across re-renders
+    // Wrap params in useMemo with an empty dependencies array so the object
+    // reference stays stable across re-renders. The one thing that may vary is
+    // the locale a client-fetched item carries (put there by the data-source
+    // plugin): a locale switch must rebuild the params, or the item would keep
+    // its previous language.
+    var memoDeps = [];
+    if (paramsExpression.type === 'ObjectExpression' && (0, request_locale_1.hasLocaleParam)(paramsExpression.properties)) {
+        memoDeps.push((0, request_locale_1.buildClientLocaleExpression)());
+    }
     var memoizedParams = types.callExpression(types.identifier('useMemo'), [
         types.arrowFunctionExpression([], paramsExpression),
-        types.arrayExpression([]),
+        types.arrayExpression(memoDeps),
     ]);
     // Replace the params attribute
     attrs[paramsAttrIndex] = types.jsxAttribute(types.jsxIdentifier('params'), types.jsxExpressionContainer(memoizedParams));
@@ -2087,7 +2161,7 @@ function ensureAPIRouteExists(extractedResources, usage, dataSources, transformO
         };
     }
 }
-function updateGetStaticProps(chunks, registry, dependencies, folderPath) {
+function updateGetStaticProps(chunks, registry, dependencies, folderPath, localized) {
     var _a;
     var getStaticPropsChunk = chunks.find(function (c) { return c.name === 'getStaticProps'; });
     if (!getStaticPropsChunk || getStaticPropsChunk.type !== teleport_types_1.ChunkType.AST) {
@@ -2182,6 +2256,10 @@ function updateGetStaticProps(chunks, registry, dependencies, folderPath) {
                 })),
             ])));
         }
+        // The prefetch is per locale — getStaticProps runs once per language.
+        if (localized) {
+            fetchParams.push((0, request_locale_1.buildServerLocaleParam)());
+        }
         // Check if this fetch already exists
         var existingFetchIndex = arrayPattern.elements.findIndex(function (el) { return (el === null || el === void 0 ? void 0 : el.type) === 'Identifier' && el.name === vars.propsPrefix; });
         if (existingFetchIndex === -1) {