@pocket-trash/localizations 0.7.0 → 0.8.0

package/README.md

@@ -236,3 +236,16 @@ pnpm localization:sync
 ```
 
 Publishing notes live in [docs/publishing.md](docs/publishing.md).
+
+## Help documents
+
+Localized help sources are published unchanged under
+`@pocket-trash/localizations/help/<locale>/<slug>.mdx`. They contain frontmatter
+and Markdown; consumers handle parsing and rendering. The package does not
+compile MDX or execute JSX.
+
+For example, a Vite app can load the English image guide as text:
+
+```ts
+import source from "@pocket-trash/localizations/help/en-US/image-size-and-resolution-guide.mdx?raw";
+```

package/help/en-US/image-size-and-resolution-guide.mdx

@@ -0,0 +1,23 @@
+---
+title: Image size and resolution guide
+datePublished: 2026-09-23
+category: Images
+---
+
+## Products, collections, and collection items
+
+Pocket Trash uses the same image for both the card preview and the main detail image for a product, collection, or collection item.
+
+## Aspect ratio
+
+Use a **4:3 landscape image** so the complete image appears consistently in both places. Examples include 1200 × 900, 1600 × 1200, and 2000 × 1500 pixels.
+
+Images with a different aspect ratio can still be uploaded, but Pocket Trash crops them to fill the 4:3 frame. Keep the subject and other important details away from the edges.
+
+## Size and quality
+
+- Use at least **1200 × 900 pixels** to avoid visible softness or degraded image quality.
+- **2000 × 1500 pixels** is recommended for a sharper result on high-density displays.
+- Upload the highest-quality original available. Pocket Trash stores the original and can create appropriately sized versions when displaying it.
+- Supported formats are JPEG, PNG, and WebP.
+- Each image can be up to 25 MiB. A single upload can contain up to 20 images and total up to 200 MiB.

package/help/es-MX/image-size-and-resolution-guide.mdx

@@ -0,0 +1,23 @@
+---
+title: Guía de tamaño y resolución de imágenes
+datePublished: 2026-09-23
+category: Imágenes
+---
+
+## Productos, colecciones y artículos de colección
+
+Pocket Trash usa la misma imagen tanto para la vista previa de la tarjeta como para la imagen principal de los detalles de un producto, una colección o un artículo de colección.
+
+## Relación de aspecto
+
+Usa una **imagen horizontal con una relación de aspecto de 4:3** para que la imagen completa aparezca de manera uniforme en ambos lugares. Algunos ejemplos son 1200 × 900, 1600 × 1200 y 2000 × 1500 píxeles.
+
+Las imágenes con una relación de aspecto diferente también se pueden subir, pero Pocket Trash las recorta para llenar el marco de 4:3. Mantén el sujeto y otros detalles importantes alejados de los bordes.
+
+## Tamaño y calidad
+
+- Usa al menos **1200 × 900 píxeles** para evitar que la imagen se vea borrosa o pierda calidad.
+- Se recomienda usar **2000 × 1500 píxeles** para obtener un resultado más nítido en pantallas de alta densidad.
+- Sube la imagen original de la mejor calidad disponible. Pocket Trash almacena el archivo original y puede crear versiones del tamaño adecuado al mostrarlo.
+- Los formatos compatibles son JPEG, PNG y WebP.
+- Cada imagen puede tener un tamaño máximo de 25 MiB. Una sola carga puede contener hasta 20 imágenes y tener un tamaño total máximo de 200 MiB.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pocket-trash/localizations",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Shared localization utilities and message catalogs for Pocket Trash.",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,10 +9,12 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    }
+    },
+    "./help/*.mdx": "./help/*.mdx"
   },
   "files": [
-    "dist"
+    "dist",
+    "help"
   ],
   "repository": {
     "type": "git",