@pocket-trash/localizations 0.7.0 → 0.9.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/dist/index.d.ts

@@ -558,6 +558,13 @@ export declare const localizations: Readonly<{
                 enabled: string;
                 failedToLoad: string;
             };
+            storage: {
+                sizeMiB: string;
+            };
+            upload: {
+                finalizationFailure: string;
+                saveFailed: string;
+            };
         };
     };
     "es-MX": {
@@ -1109,6 +1116,13 @@ export declare const localizations: Readonly<{
                 enabled: string;
                 failedToLoad: string;
             };
+            storage: {
+                sizeMiB: string;
+            };
+            upload: {
+                finalizationFailure: string;
+                saveFailed: string;
+            };
         };
     };
 }>;

package/dist/localizations/en-US.d.ts

@@ -556,5 +556,12 @@ export declare const enUS: {
             enabled: string;
             failedToLoad: string;
         };
+        storage: {
+            sizeMiB: string;
+        };
+        upload: {
+            finalizationFailure: string;
+            saveFailed: string;
+        };
     };
 };

package/dist/localizations/en-US.js

@@ -479,7 +479,7 @@ export const enUS = {
                 expired: "This upload session expired. Start the upload again.",
                 fileFailure: "{filename} couldn't be uploaded. Retry this file.",
                 fileHelp: "Choose 1–{maxFiles} files. Each file can be up to {maxFileSize}; the complete upload can be up to {maxSessionSize}.",
-                fileTypes: "Allowed file types: STL, 3MF, STEP, STP, PDF, TXT, and ZIP.",
+                fileTypes: "Allowed file types: STL, 3MF, STEP, STP, PDF, TXT, ZIP, JPEG, PNG, and WebP.",
                 filesLabel: "Resource files",
                 finalizationFailure: "Your files were uploaded, but the resource could not be finalized. Retry to finish the upload.",
                 finalizing: "Finishing your upload…",
@@ -556,5 +556,12 @@ export const enUS = {
             enabled: "Enabled",
             failedToLoad: "Failed to load.",
         },
+        storage: {
+            sizeMiB: "{value} MiB",
+        },
+        upload: {
+            finalizationFailure: "Your files were uploaded, but the upload could not be finalized. Try again.",
+            saveFailed: "We couldn't save your upload. Try again.",
+        },
     },
 };

package/dist/localizations/es-MX.d.ts

@@ -556,5 +556,12 @@ export declare const esMX: {
             enabled: string;
             failedToLoad: string;
         };
+        storage: {
+            sizeMiB: string;
+        };
+        upload: {
+            finalizationFailure: string;
+            saveFailed: string;
+        };
     };
 };

package/dist/localizations/es-MX.js

@@ -479,7 +479,7 @@ export const esMX = {
                 expired: "Esta sesión de carga venció. Inicia la carga de nuevo.",
                 fileFailure: "No se pudo subir {filename}. Vuelve a intentar este archivo.",
                 fileHelp: "Elige de 1 a {maxFiles} archivos. Cada archivo puede pesar hasta {maxFileSize}; la carga completa puede pesar hasta {maxSessionSize}.",
-                fileTypes: "Tipos de archivo permitidos: STL, 3MF, STEP, STP, PDF, TXT y ZIP.",
+                fileTypes: "Tipos de archivo permitidos: STL, 3MF, STEP, STP, PDF, TXT, ZIP, JPEG, PNG y WebP.",
                 filesLabel: "Archivos del recurso",
                 finalizationFailure: "Tus archivos se subieron, pero no se pudo finalizar el recurso. Vuelve a intentarlo para completar la carga.",
                 finalizing: "Finalizando tu carga…",
@@ -556,5 +556,12 @@ export const esMX = {
             enabled: "Activada",
             failedToLoad: "No se pudo cargar.",
         },
+        storage: {
+            sizeMiB: "{value} MiB",
+        },
+        upload: {
+            finalizationFailure: "Tus archivos se cargaron, pero no se pudo finalizar la carga. Inténtalo de nuevo.",
+            saveFailed: "No pudimos guardar tu carga. Inténtalo de nuevo.",
+        },
     },
 };

package/dist/types/localization.d.ts

@@ -553,6 +553,13 @@ export type CompleteLocalizationResource = Readonly<{
             enabled: string;
             failedToLoad: string;
         };
+        storage: {
+            sizeMiB: string;
+        };
+        upload: {
+            finalizationFailure: string;
+            saveFailed: string;
+        };
     };
 }>;
 export type TranslationKey = DotPaths<CompleteLocalizationResource>;

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.9.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",