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

@@ -53,6 +53,10 @@ export declare const localizations: Readonly<{
                 search: string;
                 selectCover: string;
                 signIn: string;
+                view: string;
+                viewCollection: string;
+                viewItem: string;
+                viewProductDetails: string;
                 visitProductPage: string;
             };
             admin: {
@@ -145,6 +149,7 @@ export declare const localizations: Readonly<{
                 };
             };
             catalog: {
+                collectionsWithProduct: string;
                 colorEffect: {
                     fade: string;
                     solid: string;
@@ -191,6 +196,10 @@ export declare const localizations: Readonly<{
                     moreOptions: string;
                     productTypeAll: string;
                 };
+                images: {
+                    aspectRatioGuideLink: string;
+                    aspectRatioWarning: string;
+                };
                 finishOptionCount: string;
                 finishPreview: string;
                 materialCount: string;
@@ -236,6 +245,7 @@ export declare const localizations: Readonly<{
                     collection: string;
                     cover: string;
                     description: string;
+                    displayName: string;
                     name: string;
                 };
                 finishChoice: {
@@ -276,11 +286,20 @@ export declare const localizations: Readonly<{
                 settingsSaveFailed: string;
                 userSettingsObject: string;
             };
+            help: {
+                comingSoon: string;
+                contact: string;
+                dateModified: string;
+                datePublished: string;
+                developmentCallout: string;
+                topics: string;
+            };
             navigation: {
                 account: string;
                 accountMenu: string;
                 betaFeatures: string;
                 collections: string;
+                help: string;
                 language: string;
                 logOut: string;
                 products: string;
@@ -585,6 +604,10 @@ export declare const localizations: Readonly<{
                 search: string;
                 selectCover: string;
                 signIn: string;
+                view: string;
+                viewCollection: string;
+                viewItem: string;
+                viewProductDetails: string;
                 visitProductPage: string;
             };
             admin: {
@@ -677,6 +700,7 @@ export declare const localizations: Readonly<{
                 };
             };
             catalog: {
+                collectionsWithProduct: string;
                 colorEffect: {
                     fade: string;
                     solid: string;
@@ -723,6 +747,10 @@ export declare const localizations: Readonly<{
                     moreOptions: string;
                     productTypeAll: string;
                 };
+                images: {
+                    aspectRatioGuideLink: string;
+                    aspectRatioWarning: string;
+                };
                 finishOptionCount: string;
                 finishPreview: string;
                 materialCount: string;
@@ -768,6 +796,7 @@ export declare const localizations: Readonly<{
                     collection: string;
                     cover: string;
                     description: string;
+                    displayName: string;
                     name: string;
                 };
                 finishChoice: {
@@ -808,11 +837,20 @@ export declare const localizations: Readonly<{
                 settingsSaveFailed: string;
                 userSettingsObject: string;
             };
+            help: {
+                comingSoon: string;
+                contact: string;
+                dateModified: string;
+                datePublished: string;
+                developmentCallout: string;
+                topics: string;
+            };
             navigation: {
                 account: string;
                 accountMenu: string;
                 betaFeatures: string;
                 collections: string;
+                help: string;
                 language: string;
                 logOut: string;
                 products: string;

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

@@ -51,6 +51,10 @@ export declare const enUS: {
             search: string;
             selectCover: string;
             signIn: string;
+            view: string;
+            viewCollection: string;
+            viewItem: string;
+            viewProductDetails: string;
             visitProductPage: string;
         };
         admin: {
@@ -143,6 +147,7 @@ export declare const enUS: {
             };
         };
         catalog: {
+            collectionsWithProduct: string;
             colorEffect: {
                 fade: string;
                 solid: string;
@@ -189,6 +194,10 @@ export declare const enUS: {
                 moreOptions: string;
                 productTypeAll: string;
             };
+            images: {
+                aspectRatioGuideLink: string;
+                aspectRatioWarning: string;
+            };
             finishOptionCount: string;
             finishPreview: string;
             materialCount: string;
@@ -234,6 +243,7 @@ export declare const enUS: {
                 collection: string;
                 cover: string;
                 description: string;
+                displayName: string;
                 name: string;
             };
             finishChoice: {
@@ -274,11 +284,20 @@ export declare const enUS: {
             settingsSaveFailed: string;
             userSettingsObject: string;
         };
+        help: {
+            comingSoon: string;
+            contact: string;
+            dateModified: string;
+            datePublished: string;
+            developmentCallout: string;
+            topics: string;
+        };
         navigation: {
             account: string;
             accountMenu: string;
             betaFeatures: string;
             collections: string;
+            help: string;
             language: string;
             logOut: string;
             products: string;

package/dist/localizations/en-US.js

@@ -51,6 +51,10 @@ export const enUS = {
             search: "Search",
             selectCover: "Use this cover",
             signIn: "Sign in",
+            view: "View",
+            viewCollection: "View collection",
+            viewItem: "View item",
+            viewProductDetails: "View product details",
             visitProductPage: "Visit product page",
         },
         admin: {
@@ -143,6 +147,7 @@ export const enUS = {
             },
         },
         catalog: {
+            collectionsWithProduct: "Collections with this product",
             colorEffect: {
                 fade: "Fade",
                 solid: "Solid",
@@ -189,6 +194,10 @@ export const enUS = {
                 moreOptions: "More {label}",
                 productTypeAll: "All product types",
             },
+            images: {
+                aspectRatioGuideLink: "Read the image size and resolution guide",
+                aspectRatioWarning: "This image is not 4:3 and will be cropped when displayed.",
+            },
             finishOptionCount: "Finish options: {count}",
             finishPreview: "Preview: {finish}",
             materialCount: "Materials: {count}",
@@ -234,6 +243,7 @@ export const enUS = {
                 collection: "Collection",
                 cover: "Cover image",
                 description: "Description",
+                displayName: "Display name",
                 name: "Name",
             },
             finishChoice: {
@@ -274,11 +284,20 @@ export const enUS = {
             settingsSaveFailed: "We couldn't save your settings. Please try again.",
             userSettingsObject: "Expected a user settings object.",
         },
+        help: {
+            comingSoon: "Coming soon.",
+            contact: "Contact",
+            dateModified: "Date Modified",
+            datePublished: "Date",
+            developmentCallout: "This page is still in development.",
+            topics: "Help Topics",
+        },
         navigation: {
             account: "Account",
             accountMenu: "Account menu",
             betaFeatures: "Beta features",
             collections: "Collections",
+            help: "Help",
             language: "Language",
             logOut: "Log out",
             products: "Products",

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

@@ -51,6 +51,10 @@ export declare const esMX: {
             search: string;
             selectCover: string;
             signIn: string;
+            view: string;
+            viewCollection: string;
+            viewItem: string;
+            viewProductDetails: string;
             visitProductPage: string;
         };
         admin: {
@@ -143,6 +147,7 @@ export declare const esMX: {
             };
         };
         catalog: {
+            collectionsWithProduct: string;
             colorEffect: {
                 fade: string;
                 solid: string;
@@ -189,6 +194,10 @@ export declare const esMX: {
                 moreOptions: string;
                 productTypeAll: string;
             };
+            images: {
+                aspectRatioGuideLink: string;
+                aspectRatioWarning: string;
+            };
             finishOptionCount: string;
             finishPreview: string;
             materialCount: string;
@@ -234,6 +243,7 @@ export declare const esMX: {
                 collection: string;
                 cover: string;
                 description: string;
+                displayName: string;
                 name: string;
             };
             finishChoice: {
@@ -274,11 +284,20 @@ export declare const esMX: {
             settingsSaveFailed: string;
             userSettingsObject: string;
         };
+        help: {
+            comingSoon: string;
+            contact: string;
+            dateModified: string;
+            datePublished: string;
+            developmentCallout: string;
+            topics: string;
+        };
         navigation: {
             account: string;
             accountMenu: string;
             betaFeatures: string;
             collections: string;
+            help: string;
             language: string;
             logOut: string;
             products: string;

package/dist/localizations/es-MX.js

@@ -51,6 +51,10 @@ export const esMX = {
             search: "Buscar",
             selectCover: "",
             signIn: "Iniciar sesion",
+            view: "Ver",
+            viewCollection: "Ver colección",
+            viewItem: "Ver artículo",
+            viewProductDetails: "Ver detalles del producto",
             visitProductPage: "Visitar pagina del producto",
         },
         admin: {
@@ -143,6 +147,7 @@ export const esMX = {
             },
         },
         catalog: {
+            collectionsWithProduct: "Colecciones con este producto",
             colorEffect: {
                 fade: "Degradado",
                 solid: "Sólido",
@@ -189,6 +194,10 @@ export const esMX = {
                 moreOptions: "Más opciones de {label}",
                 productTypeAll: "Todos los tipos de producto",
             },
+            images: {
+                aspectRatioGuideLink: "Leer la guía de tamaño y resolución de imágenes",
+                aspectRatioWarning: "Esta imagen no tiene una relación de aspecto de 4:3 y se recortará al mostrarse.",
+            },
             finishOptionCount: "Opciones de acabado: {count}",
             finishPreview: "Vista previa: {finish}",
             materialCount: "Materiales: {count}",
@@ -234,6 +243,7 @@ export const esMX = {
                 collection: "",
                 cover: "",
                 description: "",
+                displayName: "Nombre para mostrar",
                 name: "",
             },
             finishChoice: {
@@ -274,11 +284,20 @@ export const esMX = {
             settingsSaveFailed: "",
             userSettingsObject: "",
         },
+        help: {
+            comingSoon: "Próximamente.",
+            contact: "Contacto",
+            dateModified: "Fecha de modificación",
+            datePublished: "Fecha",
+            developmentCallout: "Esta página todavía está en desarrollo.",
+            topics: "Temas de ayuda",
+        },
         navigation: {
             account: "Cuenta",
             accountMenu: "Menu de cuenta",
             betaFeatures: "Funciones beta",
             collections: "Colecciones",
+            help: "Ayuda",
             language: "Idioma",
             logOut: "Cerrar sesion",
             products: "",

package/dist/types/localization.d.ts

@@ -48,6 +48,10 @@ export type CompleteLocalizationResource = Readonly<{
             search: string;
             selectCover: string;
             signIn: string;
+            view: string;
+            viewCollection: string;
+            viewItem: string;
+            viewProductDetails: string;
             visitProductPage: string;
         };
         admin: {
@@ -140,6 +144,7 @@ export type CompleteLocalizationResource = Readonly<{
             };
         };
         catalog: {
+            collectionsWithProduct: string;
             colorEffect: {
                 fade: string;
                 solid: string;
@@ -186,6 +191,10 @@ export type CompleteLocalizationResource = Readonly<{
                 moreOptions: string;
                 productTypeAll: string;
             };
+            images: {
+                aspectRatioGuideLink: string;
+                aspectRatioWarning: string;
+            };
             finishOptionCount: string;
             finishPreview: string;
             materialCount: string;
@@ -231,6 +240,7 @@ export type CompleteLocalizationResource = Readonly<{
                 collection: string;
                 cover: string;
                 description: string;
+                displayName: string;
                 name: string;
             };
             finishChoice: {
@@ -271,11 +281,20 @@ export type CompleteLocalizationResource = Readonly<{
             settingsSaveFailed: string;
             userSettingsObject: string;
         };
+        help: {
+            comingSoon: string;
+            contact: string;
+            dateModified: string;
+            datePublished: string;
+            developmentCallout: string;
+            topics: string;
+        };
         navigation: {
             account: string;
             accountMenu: string;
             betaFeatures: string;
             collections: string;
+            help: string;
             language: string;
             logOut: string;
             products: string;

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