perf+a11y: shrink box images, set Netlify cache headers, add main landmark

PSI mobile findings → action:

- Resize applebox.webp (212→33 KiB) and doublebox.webp (474→96 KiB) —
  source was 1440×1920 served at 300px wide. Now 600px wide (2x retina).
  Saves ~560 KiB on /introduction/packaging.
- Convert nologobox.jpg (73 KiB) → nologobox.webp (25 KiB); add width
  + height to all three <img> tags across 9 locales to prevent CLS.
- Add docs/public/_headers (read by Netlify): immutable year-cache for
  /assets/*, 30-day cache for media folders + root static files, no-cache
  for /sw.js. Addresses PSI "Use efficient cache lifetimes" (~1.5 MiB
  on repeat visits).
- Stamp role="main" on .VPContent.is-home via transformHtml — VitePress
  only renders a real <main> on doc layout, so home pages were missing
  a main landmark (Lighthouse a11y).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: TowyTowy

docs/.vitepress/config.ts

@@ -1197,8 +1197,16 @@ export default defineConfig({
 
     // Add loading="lazy" + decoding="async" to every <img> in rendered HTML
     // (markdown images and raw HTML <img>) unless already specified.
+    // Also stamps role="main" on the home-layout content wrapper — VitePress
+    // only renders a real <main> on doc layout, leaving home pages without a
+    // main landmark (Lighthouse a11y).
     transformHtml: (code) =>
-        code.replace(/<img(?![^>]*\bloading=)([^>]*)>/g, '<img loading="lazy" decoding="async"$1>'),
+        code
+            .replace(/<img(?![^>]*\bloading=)([^>]*)>/g, '<img loading="lazy" decoding="async"$1>')
+            .replace(
+                /<div class="VPContent is-home"/g,
+                '<div role="main" class="VPContent is-home"'
+            ),
 
     // Locale configuration for i18n
     locales: {

docs/da/introduction/packaging.md

@@ -10,7 +10,7 @@ AirPods-kopier kommer i forskellige typer emballage, hver med sine egne unikke f
 
 No-logo æsken er hvid og har en lignende form som den originale AirPods-æske. Den viser et billede af AirPods, men mangler "AirPods" teksten, Apple-logoer eller varemærker. Den medfølgende manual og opladerkabel er generiske, uden de serienumre, der typisk findes på original AirPods-emballage.
 
-<img src="/nologobox.jpg" alt="No-Logo Æske" width="300px"/>
+<img src="/nologobox.webp" alt="No-Logo Æske" width="300" height="400"/>
 
 ::: warning
 Hvis du bestiller ved hjælp af et **Alibaba**-link, vil dine replikaer **altid** blive sendt i en neutral kasse uden logo for at undgå toldbeslaglæggelser og ophavsretsstrejker. Apple-brandede kasser er ikke tilgængelige via Alibaba.
@@ -20,7 +20,7 @@ Hvis du bestiller ved hjælp af et **Alibaba**-link, vil dine replikaer **altid*
 
 Apple logo-æsken afspejler emballagen af ægte AirPods med den traditionelle "AirPods" tekst og Apple-logoer. Manualerne og opladerkablet indeni bærer Apple-mærkning. Dog kan anmodning om en "Apple-æske" øge risikoen for produktbeslaglæggelse i tolden, hvilket kan føre til bøder eller ødelæggelse af produktet. For at mindske denne risiko bruger mange sælgere en dobbelt-æske teknik, hvor den faktiske Apple-æske skjules inde i en generisk hovedtelefonformet æske.
 
-<img src="/applebox.webp" alt="Apple Logo Æske" width="300px"/>
+<img src="/applebox.webp" alt="Apple Logo Æske" width="300" height="400"/>
 
 ::: danger
 Anmodning om en "Apple-æske" kan føre til produktbeslaglæggelse i tolden. Mange sælgere bruger en dobbelt-æske teknik for at reducere denne risiko.
@@ -32,7 +32,7 @@ Det bedste valg for de fleste købere. En generisk ydre æske, der ligner almind
 
 Når du vælger Apple Logo Æsken ved kassen, er dobbelt-æsken automatisk inkluderet — sælgere sender altid Apple-æsker inde i en lokkefugl-æske til beskyttelse. Apple-æske muligheden er forvalgt på de fleste betalingsmetoder, selvom nogle kan opkræve et lille ekstragebyr. Hvis du bestiller via **Alibaba**, er Apple/dobbelt-æske **ikke tilgængelig** — du modtager altid en No-Logo æske.
 
-<img src="/doublebox.webp" alt="Dobbelt/Lokkefugl Æske" width="300px"/>
+<img src="/doublebox.webp" alt="Dobbelt/Lokkefugl Æske" width="300" height="400"/>
 
 ::: tip
 Apple-æske (som altid kommer som en dobbelt-æske) er normalt forvalgt ved kassen. Dobbelttjek at den er markeret, før du gennemfører din ordre.

docs/de/introduction/packaging.md

@@ -10,7 +10,7 @@ AirPods Replicas kommen in verschiedenen Verpackungsarten, die jeweils eigene Me
 
 Die No-Logo-Box ist weiß und hat eine ähnliche Form wie die originale AirPods-Box. Sie zeigt ein Bild der AirPods, hat aber keinen „AirPods"-Text, keine Apple-Logos oder Markenzeichen. Das beiliegende Handbuch und Ladekabel sind generisch, ohne die Seriennummern, die man auf der originalen AirPods-Verpackung findet.
 
-<img src="/nologobox.jpg" alt="No-Logo Box" width="300px"/>
+<img src="/nologobox.webp" alt="No-Logo Box" width="300" height="400"/>
 
 ::: warning
 Wenn du über einen **Alibaba**-Link bestellst, werden deine Replicas **immer** in einer neutralen No-Logo-Box versendet, um Zollbeschlagnahmungen und Urheberrechtsabmahnungen zu vermeiden. Apple-gebrandete Boxen sind über Alibaba nicht verfügbar.
@@ -21,7 +21,7 @@ Wenn du über einen **Alibaba**-Link bestellst, werden deine Replicas **immer**
 
 Die Apple-Logo-Box spiegelt die Verpackung echter AirPods wider, mit dem typischen „AirPods"-Text und Apple-Logos. Die Handbücher und das Ladekabel im Inneren tragen Apple-Kennzeichnungen. Das Anfordern einer „Apple-Box" kann jedoch das Risiko einer Beschlagnahmung beim Zoll erhöhen, was zu Geldstrafen oder der Vernichtung des Produkts führen kann. Um dieses Risiko zu minimieren, verwenden viele Verkäufer eine Doppelbox-Technik, bei der die eigentliche Apple-Box in einer generischen Box in Kopfhörerform versteckt wird.
 
-<img src="/applebox.webp" alt="Apple Logo Box" width="300px"/>
+<img src="/applebox.webp" alt="Apple Logo Box" width="300" height="400"/>
 
 ::: danger
 Das Anfordern einer „Apple-Box" kann zur Beschlagnahmung beim Zoll führen. Viele Verkäufer verwenden eine Doppelbox-Technik, um dieses Risiko zu reduzieren.
@@ -33,7 +33,7 @@ Die beste Option für die meisten Käufer. Eine generische äußere Box, die wie
 
 Wenn du an der Kasse die Apple-Logo-Box auswählst, ist die Doppelbox automatisch enthalten – Verkäufer versenden Apple-Boxen immer in einer Tarnbox zum Schutz. Die Apple-Box-Option ist bei den meisten Zahlungsmethoden vorausgewählt, obwohl einige eine kleine Zusatzgebühr erheben können. Wenn du über **Alibaba** bestellst, ist die Apple-/Doppelbox **nicht verfügbar** – du erhältst immer eine No-Logo-Box.
 
-<img src="/doublebox.webp" alt="Doppel-/Tarnbox" width="300px"/>
+<img src="/doublebox.webp" alt="Doppel-/Tarnbox" width="300" height="400"/>
 
 ::: tip
 Apple-Box (die immer als Doppelbox geliefert wird) ist an der Kasse normalerweise vorausgewählt. Überprüfe vor dem Abschluss deiner Bestellung, ob sie ausgewählt ist.

docs/es/introduction/packaging.md

@@ -10,7 +10,7 @@ Las réplicas de AirPods vienen en diferentes tipos de embalaje, cada uno con su
 
 La caja sin logo es blanca y tiene una forma similar a la caja original de AirPods. Muestra una imagen de AirPods pero carece del texto "AirPods", logos de Apple o marcas registradas. El manual incluido y el cable de carga son genéricos, sin los números de serie que típicamente se encuentran en el embalaje original de AirPods.
 
-<img src="/nologobox.jpg" alt="Caja Sin Logo" width="300px"/>
+<img src="/nologobox.webp" alt="Caja Sin Logo" width="300" height="400"/>
 
 ::: warning
 Si pides usando un enlace de **Alibaba**, tus réplicas **siempre** se enviarán en una caja neutral sin logotipo para evitar incautaciones en la aduana y problemas de derechos de autor. Las cajas con la marca de Apple no están disponibles a través de Alibaba.
@@ -21,7 +21,7 @@ Si pides usando un enlace de **Alibaba**, tus réplicas **siempre** se enviarán
 
 La caja con logo de Apple replica el embalaje de AirPods legítimos, con el tradicional texto "AirPods" y logos de Apple. Los manuales y cable de carga dentro llevan marcas de Apple. Sin embargo, solicitar una "caja de Apple" podría aumentar el riesgo de decomiso del producto en aduanas, llevando a multas o destrucción del producto. Para mitigar este riesgo, muchos vendedores usan una técnica de caja doble, escondiendo la caja de Apple real dentro de una caja genérica con forma de auriculares.
 
-<img src="/applebox.webp" alt="Caja con Logo de Apple" width="300px"/>
+<img src="/applebox.webp" alt="Caja con Logo de Apple" width="300" height="400"/>
 
 ::: danger
 Solicitar una "caja de Apple" puede llevar al decomiso del producto en aduanas. Muchos vendedores usan una técnica de caja doble para reducir este riesgo.
@@ -33,7 +33,7 @@ La mejor opción para la mayoría de compradores. Una caja externa genérica que
 
 Cuando seleccionas la Caja con Logo de Apple en el checkout, la caja doble se incluye automáticamente — los vendedores siempre envían las cajas de Apple dentro de una caja señuelo para protección. La opción de caja de Apple viene preseleccionada en la mayoría de métodos de pago, aunque algunos pueden cobrar un pequeño cargo adicional. Si pides a través de **Alibaba**, la caja de Apple/doble **no está disponible** — siempre recibirás una caja Sin Logo.
 
-<img src="/doublebox.webp" alt="Caja Doble/Señuelo" width="300px"/>
+<img src="/doublebox.webp" alt="Caja Doble/Señuelo" width="300" height="400"/>
 
 ::: tip
 La caja de Apple (que siempre viene como caja doble) suele venir preseleccionada en el checkout. Verifica que esté marcada antes de completar tu pedido.

docs/fr/introduction/packaging.md

@@ -10,7 +10,7 @@ Les répliques d'AirPods sont livrées dans différents types d'emballage, chacu
 
 La boîte sans logo est blanche et a une forme similaire à la boîte originale des AirPods. Elle présente une image d'AirPods mais ne comporte pas le texte « AirPods », les logos Apple ou les marques déposées. Le manuel inclus et le câble de charge sont génériques, sans les numéros de série typiquement trouvés sur l'emballage des AirPods originaux.
 
-<img src="/nologobox.jpg" alt="Boîte Sans Logo" width="300px"/>
+<img src="/nologobox.webp" alt="Boîte Sans Logo" width="300" height="400"/>
 
 ::: warning
 Si vous commandez via un lien **Alibaba**, vos répliques seront **toujours** expédiées dans une boîte neutre sans logo pour éviter les saisies en douane et les poursuites pour atteinte au droit d'auteur. Les boîtes portant la marque Apple ne sont pas disponibles via Alibaba.
@@ -21,7 +21,7 @@ Si vous commandez via un lien **Alibaba**, vos répliques seront **toujours** ex
 
 La boîte avec logo Apple reproduit l'emballage des AirPods légitimes, présentant le texte traditionnel « AirPods » et les logos Apple. Les manuels et le câble de charge à l'intérieur portent les marquages Apple. Cependant, demander une « boîte Apple » pourrait augmenter le risque de saisie du produit à la douane, entraînant des amendes ou la destruction du produit. Pour atténuer ce risque, de nombreux vendeurs utilisent une technique de double boîte, cachant la vraie boîte Apple à l'intérieur d'une boîte générique en forme d'écouteurs.
 
-<img src="/applebox.webp" alt="Boîte avec Logo Apple" width="300px"/>
+<img src="/applebox.webp" alt="Boîte avec Logo Apple" width="300" height="400"/>
 
 ::: danger
 Demander une « boîte Apple » peut entraîner la saisie du produit à la douane. De nombreux vendeurs utilisent une technique de double boîte pour réduire ce risque.
@@ -33,7 +33,7 @@ La meilleure option pour la plupart des acheteurs. Une boîte extérieure géné
 
 Lorsque vous sélectionnez la Boîte avec Logo Apple lors du paiement, la boîte double est automatiquement incluse — les vendeurs expédient toujours les boîtes Apple à l'intérieur d'une boîte leurre pour la protection. L'option boîte Apple est pré-sélectionnée sur la plupart des méthodes de paiement, bien que certaines puissent facturer un petit supplément. Si vous commandez via **Alibaba**, la boîte Apple/double n'est **pas disponible** — vous recevrez toujours une boîte sans logo.
 
-<img src="/doublebox.webp" alt="Boîte Double/Leurre" width="300px"/>
+<img src="/doublebox.webp" alt="Boîte Double/Leurre" width="300" height="400"/>
 
 ::: tip
 La boîte Apple (qui est toujours livrée en boîte double) est généralement pré-sélectionnée lors du paiement. Vérifiez bien qu'elle est cochée avant de finaliser votre commande.

docs/introduction/packaging.md

@@ -10,7 +10,7 @@ AirPods replicas come in different types of packaging, each with its own unique
 
 The No-logo box is white and has a similar shape to the original AirPods box. It showcases an image of AirPods but lacks the "AirPods" text, Apple logos, or trademarks. The included manual and charging cable are generic, without the serial numbers typically found on original AirPods packaging.
 
-<img src="/nologobox.jpg" alt="No-Logo Box" width="300px"/>
+<img src="/nologobox.webp" alt="No-Logo Box" width="300" height="400"/>
 
 ::: warning
 If you order using an **Alibaba** link, your replicas will **always** be shipped in a neutral, No-Logo box to avoid customs seizures and copyright strikes. Apple-branded boxes are not available through Alibaba.
@@ -21,7 +21,7 @@ If you order using an **Alibaba** link, your replicas will **always** be shipped
 
 The Apple logo box mirrors the packaging of legitimate AirPods, featuring the traditional "AirPods" text and Apple logos. The manuals and charging cable inside bear Apple markings. However, requesting an "Apple box" could increase the risk of product seizure at customs, leading to fines or destruction of the product. To mitigate this risk, many sellers use a double box technique, hiding the actual Apple box inside a generic headphone-shaped box.
 
-<img src="/applebox.webp" alt="Apple Logo Box" width="300px"/>
+<img src="/applebox.webp" alt="Apple Logo Box" width="300" height="400"/>
 
 ::: danger
 Requesting an "Apple box" can lead to product seizure at customs. Many sellers use a double box technique to reduce this risk.
@@ -33,7 +33,7 @@ The best option for most buyers. A generic outer box that looks like ordinary ea
 
 When you select the Apple Logo Box at checkout, the double box is automatically included — sellers always ship Apple boxes inside a decoy box for protection. The Apple box option is pre-selected on most payment methods, though some may charge a small extra fee. If you're ordering through **Alibaba**, Apple/double box is **not available** — you'll always receive a No-Logo box.
 
-<img src="/doublebox.webp" alt="Double/Decoy Box" width="300px"/>
+<img src="/doublebox.webp" alt="Double/Decoy Box" width="300" height="400"/>
 
 ::: tip
 Apple box (which always comes as a double box) is usually pre-selected at checkout. Double-check it's ticked before completing your order.

docs/pl/introduction/packaging.md

@@ -11,7 +11,7 @@ Klony AirPods są dostępne w różnych rodzajach opakowań, każde z własnymi
 
 Pudełko bez logo jest białe i ma podobny kształt do oryginalnego pudełka AirPods. Pokazuje obraz AirPods, ale brakuje tekstu "AirPods", logo Apple lub znaków towarowych. Dołączona instrukcja i kabel ładowania są generyczne, bez numerów seryjnych typowo obecnych na oryginalnym opakowaniu AirPods.
 
-<img src="/nologobox.jpg" alt="No-Logo Box" width="300px"/>
+<img src="/nologobox.webp" alt="No-Logo Box" width="300" height="400"/>
 
 ::: warning
 Jeśli zamówisz przez link z **Alibaba**, twoje repliki będą **zawsze** wysyłane w neutralnym pudełku bez logo, aby uniknąć konfiskaty przez celników i zgłoszeń naruszenia praw autorskich. Pudełka z logo Apple nie są dostępne przez Alibaba.
@@ -22,7 +22,7 @@ Jeśli zamówisz przez link z **Alibaba**, twoje repliki będą **zawsze** wysy
 
 Pudełko z logo Apple odzwierciedla opakowanie oryginalnych AirPods, zawierając tradycyjny tekst "AirPods" i logo Apple. Instrukcje i kabel ładowania wewnątrz mają oznaczenia Apple. Jednak zamówienie "pudełka Apple" może zwiększyć ryzyko konfiskaty produktu przez celników, co może prowadzić do grzywien lub zniszczenia produktu. Aby zmniejszyć to ryzyko, wielu sprzedawców stosuje technikę podwójnego pudełka, ukrywając rzeczywiste pudełko Apple wewnątrz generycznego pudełka w kształcie słuchawek.
 
-<img src="/applebox.webp" alt="Apple Logo Box" width="300px"/>
+<img src="/applebox.webp" alt="Apple Logo Box" width="300" height="400"/>
 
 ::: danger
 Zamówienie "pudełka Apple" może prowadzić do konfiskaty produktu przez celników. Wielu sprzedawców stosuje technikę podwójnego pudełka, aby zmniejszyć to ryzyko.
@@ -34,7 +34,7 @@ Najlepsza opcja dla większości kupujących. Zewnętrzne, generyczne pudełko p
 
 Gdy wybierzesz opcję Pudełko z Logo Apple przy finalizacji zamówienia, pudełko podwójne jest automatycznie dołączane — sprzedawcy zawsze wysyłają pudełka Apple wewnątrz pudełka-przynęty dla ochrony. Opcja pudełka Apple jest zazwyczaj domyślnie wybrana przy większości metod płatności, choć niektóre mogą pobierać niewielką dodatkową opłatę. Jeśli zamawiasz przez **Alibaba**, pudełko Apple/podwójne **nie jest dostępne** — zawsze otrzymasz Pudełko Bez Logo.
 
-<img src="/doublebox.webp" alt="Double/Decoy Box" width="300px"/>
+<img src="/doublebox.webp" alt="Double/Decoy Box" width="300" height="400"/>
 
 ::: tip
 Pudełko Apple (które zawsze przychodzi jako pudełko podwójne) jest zazwyczaj domyślnie wybrane przy finalizacji zamówienia. Sprawdź, czy jest zaznaczone przed zakończeniem zamówienia.

docs/pt/introduction/packaging.md

@@ -10,7 +10,7 @@ Réplicas de AirPods vêm em diferentes tipos de embalagem, cada uma com caracte
 
 A caixa sem logotipo é branca e tem uma forma semelhante à caixa original dos AirPods. Mostra uma imagem dos AirPods, mas não tem o texto "AirPods", logotipos da Apple ou marcas registradas. O manual e o cabo de carregamento incluídos são genéricos, sem os números de série que normalmente aparecem na embalagem original dos AirPods.
 
-<img src="/nologobox.jpg" alt="Caixa sem logotipo" width="300px"/>
+<img src="/nologobox.webp" alt="Caixa sem logotipo" width="300" height="400"/>
 
 ::: warning
 Se você pedir usando um link do **Alibaba**, suas réplicas serão **sempre** enviadas em uma caixa neutra sem logotipo para evitar apreensões na alfândega e notificações de violação de direitos autorais. Caixas com marca Apple não estão disponíveis via Alibaba.
@@ -21,7 +21,7 @@ Se você pedir usando um link do **Alibaba**, suas réplicas serão **sempre** e
 
 A caixa com logotipo Apple espelha a embalagem dos AirPods legítimos, apresentando o texto tradicional "AirPods" e os logotipos da Apple. Os manuais e o cabo de carregamento no interior trazem marcações da Apple. No entanto, solicitar uma "caixa Apple" pode aumentar o risco de apreensão do produto na alfândega, levando a multas ou destruição do produto. Para reduzir esse risco, muitos vendedores usam a técnica da caixa dupla, escondendo a caixa Apple real dentro de uma caixa genérica em forma de fone.
 
-<img src="/applebox.webp" alt="Caixa com logotipo Apple" width="300px"/>
+<img src="/applebox.webp" alt="Caixa com logotipo Apple" width="300" height="400"/>
 
 ::: danger
 Solicitar uma "caixa Apple" pode levar à apreensão do produto na alfândega. Muitos vendedores usam a técnica da caixa dupla para reduzir esse risco.
@@ -33,7 +33,7 @@ A melhor opção para a maioria dos compradores. Uma caixa externa genérica que
 
 Quando você seleciona a Caixa com logotipo Apple no checkout, a caixa dupla é automaticamente incluída — os vendedores sempre enviam caixas Apple dentro de uma caixa disfarce para proteção. A opção de caixa Apple vem pré-selecionada na maioria dos métodos de pagamento, embora alguns possam cobrar uma pequena taxa extra. Se você estiver pedindo pelo **Alibaba**, a caixa Apple/dupla **não está disponível** — você sempre receberá uma caixa sem logotipo.
 
-<img src="/doublebox.webp" alt="Caixa dupla / de engodo" width="300px"/>
+<img src="/doublebox.webp" alt="Caixa dupla / de engodo" width="300" height="400"/>
 
 ::: tip
 A caixa Apple (que sempre vem como caixa dupla) geralmente vem pré-selecionada no checkout. Verifique se a opção está marcada antes de concluir o pedido.