Merge main into flow-builder

Author: eandreeva-twr

.claude/skills/localize/SKILL.md

@@ -449,7 +449,7 @@ Initialize the SDK in your app delegate:
 
 ```swift
 // AppDelegate.swift
-func application(_ application: UIApplication, 
+func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
     Adapty.activate("YOUR_API_KEY")
     return true

.claude/skills/product-manager/references/mobile-product-context.md

@@ -7,4 +7,5 @@ PUBLIC_ALGOLIA_ANALYTICS_KEY=5e3fd9357b98f9f0d44bab0f0b7634c0
 # Locale-specific Algolia indices
 PUBLIC_ALGOLIA_INDEX_NAME_ZH=adapty_zh
 PUBLIC_ALGOLIA_INDEX_NAME_TR=adapty_tr
-PUBLIC_ALGOLIA_INDEX_NAME_RU=adapty_ru
+PUBLIC_ALGOLIA_INDEX_NAME_RU=adapty_ru
+PUBLIC_ALGOLIA_INDEX_NAME_ES=adapty_es

.env

@@ -4,7 +4,18 @@ on:
     branches:
       - develop
 jobs:
+  lint-mdx:
+    name: Lint MDX
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: node scripts/lint-mdx.mjs
+
   build-en:
+    needs: lint-mdx
     runs-on: ubuntu-latest
     concurrency:
       group: build-en-${{ github.workflow }}-${{ github.ref }}
@@ -30,12 +41,12 @@ jobs:
 
       - name: Build English only
         env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192
         run: npm run prebuild && ASTRO_TELEMETRY_DISABLED=1 BUILD_LOCALES=none npx astro build
 
       - name: Generate markdown exports
         env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192
         run: npm run build:md:prod
 
       - uses: actions/upload-artifact@v4
@@ -45,10 +56,11 @@ jobs:
           retention-days: 1
 
   build-locale:
+    needs: lint-mdx
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        locale: [zh, tr, ru]
+        locale: [zh, tr, ru, es]
     concurrency:
       group: build-locale-${{ matrix.locale }}-${{ github.workflow }}-${{ github.ref }}
       cancel-in-progress: true
@@ -73,9 +85,18 @@ jobs:
 
       - name: Build locale ${{ matrix.locale }}
         env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192
         run: npm run prebuild && ASTRO_TELEMETRY_DISABLED=1 BUILD_LOCALES=${{ matrix.locale }} npx astro build
 
+      # Generate locale .md / llms.txt / llms-full.txt exports into
+      # build/${{ matrix.locale }}/ so they land in the artifact alongside
+      # the Astro HTML pages.
+      - name: Generate locale markdown exports
+        env:
+          NODE_OPTIONS: --max-old-space-size=8192
+          BUILD_LOCALES: ${{ matrix.locale }}
+        run: npm run build:md:prod
+
       - uses: actions/upload-artifact@v4
         with:
           name: build-${{ matrix.locale }}
@@ -117,6 +138,11 @@ jobs:
           name: build-ru
           path: build/ru/
 
+      - uses: actions/download-artifact@v4
+        with:
+          name: build-es
+          path: build/es/
+
       - name: Deploy
         uses: reggionick/s3-deploy@v4
         with:

.github/workflows/s3-deploy-development.yml

@@ -55,11 +55,42 @@ jobs:
       - run: npm install github-slugger
       - run: node scripts/check-links/index.mjs --diff --base=last-production-deploy --internal-only
 
+  # Fast-fail static checks for translator-introduced regressions
+  # (missing blank line after imports, missing client:load imports).
+  # Gates both content and translation-only deploy paths.
+  lint-mdx:
+    name: Lint MDX
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: node scripts/lint-mdx.mjs
+
+  # MDX parse sweep: compiles every .mdx file with the same remark plugins
+  # Astro uses, surfaces every parse error in one pass. Astro's locale
+  # builds halt at the first error, so without this gate broken files
+  # stay hidden behind whichever one CI happens to hit first.
+  check-mdx-parse:
+    name: Check MDX parse
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+      - run: npm ci
+        env:
+          PUPPETEER_SKIP_DOWNLOAD: '1'
+      - run: node scripts/check-mdx-parse.mjs
+
   # ──────────────────────────────────────────────────────────────
   # Full deploy: English + all locales (on content pushes)
   # ──────────────────────────────────────────────────────────────
   build-en:
-    needs: check-internal-links
+    needs: [check-internal-links, lint-mdx, check-mdx-parse]
     runs-on: ubuntu-latest
     concurrency:
       group: build-en-${{ github.workflow }}-${{ github.ref }}
@@ -85,12 +116,12 @@ jobs:
 
       - name: Build English only
         env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192
         run: npm run prebuild && ASTRO_TELEMETRY_DISABLED=1 BUILD_LOCALES=none npx astro build
 
       - name: Generate markdown exports
         env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192
         run: npm run build:md:prod
 
       - uses: actions/upload-artifact@v4
@@ -100,11 +131,11 @@ jobs:
           retention-days: 1
 
   build-locale-full:
-    needs: check-internal-links
+    needs: [check-internal-links, lint-mdx, check-mdx-parse]
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        locale: [zh, tr, ru]
+        locale: [zh, tr, ru, es]
     concurrency:
       group: build-locale-full-${{ matrix.locale }}-${{ github.workflow }}-${{ github.ref }}
       cancel-in-progress: true
@@ -129,9 +160,19 @@ jobs:
 
       - name: Build locale ${{ matrix.locale }}
         env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192
         run: npm run prebuild && ASTRO_TELEMETRY_DISABLED=1 BUILD_LOCALES=${{ matrix.locale }} npx astro build
 
+      # Generate locale .md / llms.txt / llms-full.txt exports into
+      # build/${{ matrix.locale }}/ so they're included in the artifact.
+      # Without this, the translation-only deploy (aws s3 sync --delete)
+      # wipes them from S3 on every translator commit.
+      - name: Generate locale markdown exports
+        env:
+          NODE_OPTIONS: --max-old-space-size=8192
+          BUILD_LOCALES: ${{ matrix.locale }}
+        run: npm run build:md:prod
+
       - uses: actions/upload-artifact@v4
         with:
           name: build-${{ matrix.locale }}
@@ -173,6 +214,11 @@ jobs:
           name: build-ru
           path: build/ru/
 
+      - uses: actions/download-artifact@v4
+        with:
+          name: build-es
+          path: build/es/
+
       - name: Deploy
         uses: reggionick/s3-deploy@v4
         with:
@@ -193,12 +239,12 @@ jobs:
   # Translation-only deploy: build + upload only locale dirs
   # ──────────────────────────────────────────────────────────────
   build-locale-only:
-    needs: classify
+    needs: [classify, lint-mdx, check-mdx-parse]
     if: needs.classify.outputs.translation_only == 'true'
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        locale: [zh, tr, ru]
+        locale: [zh, tr, ru, es]
     concurrency:
       group: build-locale-only-${{ matrix.locale }}-${{ github.workflow }}-${{ github.ref }}
       cancel-in-progress: true
@@ -223,9 +269,20 @@ jobs:
 
       - name: Build locale ${{ matrix.locale }}
         env:
-          NODE_OPTIONS: --max-old-space-size=6144
+          NODE_OPTIONS: --max-old-space-size=8192
         run: npm run prebuild && ASTRO_TELEMETRY_DISABLED=1 BUILD_LOCALES=${{ matrix.locale }} npx astro build
 
+      # Generate locale .md / llms.txt / llms-full.txt exports into
+      # build/${{ matrix.locale }}/ so they land in the artifact. Required
+      # because the deploy uses `aws s3 sync --delete`, which would
+      # otherwise remove these files from S3 on every translation-only
+      # update.
+      - name: Generate locale markdown exports
+        env:
+          NODE_OPTIONS: --max-old-space-size=8192
+          BUILD_LOCALES: ${{ matrix.locale }}
+        run: npm run build:md:prod
+
       - uses: actions/upload-artifact@v4
         with:
           name: build-tr-only-${{ matrix.locale }}
@@ -262,19 +319,25 @@ jobs:
           name: build-tr-only-ru
           path: build/ru/
 
+      - uses: actions/download-artifact@v4
+        with:
+          name: build-tr-only-es
+          path: build/es/
+
       # Sync locale directories to S3 using AWS CLI —
-      # only overwrites zh/, tr/, and ru/ prefixes, leaves English untouched.
+      # only overwrites zh/, tr/, ru/, and es/ prefixes, leaves English untouched.
       - name: Deploy translations to S3
         run: |
           aws s3 sync build/zh/ s3://${{ secrets.S3_BUCKET }}/zh/ --delete
           aws s3 sync build/tr/ s3://${{ secrets.S3_BUCKET }}/tr/ --delete
           aws s3 sync build/ru/ s3://${{ secrets.S3_BUCKET }}/ru/ --delete
+          aws s3 sync build/es/ s3://${{ secrets.S3_BUCKET }}/es/ --delete
 
       - name: Invalidate locale paths
         run: |
           aws cloudfront create-invalidation \
             --distribution-id ${{ secrets.CLOUDFRONT_DISTRIBUTION_ID }} \
-            --paths "/zh/*" "/tr/*" "/ru/*"
+            --paths "/zh/*" "/tr/*" "/ru/*" "/es/*"
 
       - name: Update deployment tag
         run: |