@pocket-trash/localizations 0.23.1 → 0.24.0

package/README.md

@@ -249,3 +249,15 @@ 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";
 ```
+
+## Product changelog
+
+Changelog entries are published under
+`@pocket-trash/localizations/changelog/<locale>/<dated-slug>.mdx`. English files
+define `title`, `datePublished`, optional `dateModified`, and `categories`
+frontmatter. Translations use the same filename and define only `title`; missing
+translations fall back to English in the consuming app.
+
+Run `pnpm changelog:validate` after editing entries. On pull requests, CI also
+requires every existing translation to change or be removed when its English
+source changes.

package/changelog/en-US/2027-10-02-introducing-the-pocket-trash-changelog.mdx

@@ -0,0 +1,8 @@
+---
+title: Introducing the Pocket Trash changelog
+datePublished: 2027-10-02
+categories:
+  - feature
+---
+
+You can now follow customer-facing Pocket Trash updates in the product changelog. Browse updates by category and share a direct link to any entry.

package/changelog/es-MX/2027-10-02-introducing-the-pocket-trash-changelog.mdx

@@ -0,0 +1,5 @@
+---
+title: Presentamos el registro de cambios de Pocket Trash
+---
+
+Ahora puedes consultar las novedades de Pocket Trash en el registro de cambios del producto. Explora las novedades por categoría y comparte un enlace directo a cualquier entrada.

package/dist/changelog-categories.d.ts

@@ -0,0 +1,30 @@
+export const changelogCategories: Readonly<{
+    feature: Readonly<{
+        slug: "feature";
+        titles: Readonly<{
+            "en-US": "New Feature";
+            "es-MX": "Nueva funcionalidad";
+        }>;
+    }>;
+    bug: Readonly<{
+        slug: "bug";
+        titles: Readonly<{
+            "en-US": "Bug";
+            "es-MX": "Error";
+        }>;
+    }>;
+    "product-support": Readonly<{
+        slug: "product-support";
+        titles: Readonly<{
+            "en-US": "Product Support";
+            "es-MX": "Compatibilidad con productos";
+        }>;
+    }>;
+    improvement: Readonly<{
+        slug: "improvement";
+        titles: Readonly<{
+            "en-US": "Improvement";
+            "es-MX": "Mejora";
+        }>;
+    }>;
+}>;

package/dist/changelog-categories.js

@@ -0,0 +1,24 @@
+export const changelogCategories = Object.freeze({
+    feature: Object.freeze({
+        slug: "feature",
+        titles: Object.freeze({
+            "en-US": "New Feature",
+            "es-MX": "Nueva funcionalidad",
+        }),
+    }),
+    bug: Object.freeze({
+        slug: "bug",
+        titles: Object.freeze({ "en-US": "Bug", "es-MX": "Error" }),
+    }),
+    "product-support": Object.freeze({
+        slug: "product-support",
+        titles: Object.freeze({
+            "en-US": "Product Support",
+            "es-MX": "Compatibilidad con productos",
+        }),
+    }),
+    improvement: Object.freeze({
+        slug: "improvement",
+        titles: Object.freeze({ "en-US": "Improvement", "es-MX": "Mejora" }),
+    }),
+});

package/dist/index.d.ts

@@ -1,4 +1,6 @@
+import { changelogCategories } from "./changelog-categories.js";
 import type { TranslationKey, Translations } from "./types/localization.js";
+export { changelogCategories } from "./changelog-categories.js";
 export { enUS } from "./localizations/en-US.js";
 export { esMX } from "./localizations/es-MX.js";
 export type { CompleteLocalizationResource, LocalizationResource, TranslationKey, Translations, } from "./types/localization.js";
@@ -6,6 +8,18 @@ export type SupportedLocale = "en-US" | "es-MX";
 export type MessageKey = TranslationKey;
 export type Messages = Translations;
 export type LocalePreference = string | readonly string[] | null | undefined;
+export type ChangelogCategorySlug = keyof typeof changelogCategories;
+export type ChangelogCategory = (typeof changelogCategories)[ChangelogCategorySlug];
+export type ChangelogEntryMetadata = Readonly<{
+    title: string;
+    datePublished: string;
+    dateModified?: string;
+    categories: readonly ChangelogCategorySlug[];
+}>;
+export type ChangelogTranslationMetadata = Readonly<{
+    title: string;
+}>;
+export declare function getChangelogCategoryTitle(slug: ChangelogCategorySlug, locale: string): string;
 export declare const DEFAULT_LOCALE = "en-US";
 export declare const SUPPORTED_LOCALES: readonly ["en-US", "es-MX"];
 export declare const localizations: Readonly<{
@@ -27,6 +41,19 @@ export declare const localizations: Readonly<{
             site: {
                 name: string;
             };
+            changelog: {
+                allCategories: string;
+                copyFailed: string;
+                copyLink: string;
+                dateModified: string;
+                datePublished: string;
+                empty: string;
+                emptyCategory: string;
+                linkCopied: string;
+                nextPage: string;
+                pageStatus: string;
+                previousPage: string;
+            };
             action: {
                 addCollection: string;
                 addColor: string;
@@ -221,6 +248,19 @@ export declare const localizations: Readonly<{
                 };
             };
             catalog: {
+                approval: {
+                    approve: string;
+                    reasonLabel: string;
+                    reasonPlaceholder: string;
+                    reject: string;
+                    reverse: string;
+                    status: {
+                        approved: string;
+                        pending: string;
+                        rejected: string;
+                    };
+                    title: string;
+                };
                 collectionsWithProduct: string;
                 colorEffect: {
                     fade: string;
@@ -674,6 +714,7 @@ export declare const localizations: Readonly<{
                 accountMenu: string;
                 admin: string;
                 betaFeatures: string;
+                changelog: string;
                 collections: string;
                 contact: string;
                 help: string;
@@ -978,6 +1019,19 @@ export declare const localizations: Readonly<{
             site: {
                 name: string;
             };
+            changelog: {
+                allCategories: string;
+                copyFailed: string;
+                copyLink: string;
+                dateModified: string;
+                datePublished: string;
+                empty: string;
+                emptyCategory: string;
+                linkCopied: string;
+                nextPage: string;
+                pageStatus: string;
+                previousPage: string;
+            };
             action: {
                 addCollection: string;
                 addColor: string;
@@ -1172,6 +1226,19 @@ export declare const localizations: Readonly<{
                 };
             };
             catalog: {
+                approval: {
+                    approve: string;
+                    reasonLabel: string;
+                    reasonPlaceholder: string;
+                    reject: string;
+                    reverse: string;
+                    status: {
+                        approved: string;
+                        pending: string;
+                        rejected: string;
+                    };
+                    title: string;
+                };
                 collectionsWithProduct: string;
                 colorEffect: {
                     fade: string;
@@ -1625,6 +1692,7 @@ export declare const localizations: Readonly<{
                 accountMenu: string;
                 admin: string;
                 betaFeatures: string;
+                changelog: string;
                 collections: string;
                 contact: string;
                 help: string;

package/dist/index.js

@@ -1,7 +1,13 @@
+import { changelogCategories } from "./changelog-categories.js";
 import { enUS } from "./localizations/en-US.js";
 import { esMX } from "./localizations/es-MX.js";
+export { changelogCategories } from "./changelog-categories.js";
 export { enUS } from "./localizations/en-US.js";
 export { esMX } from "./localizations/es-MX.js";
+export function getChangelogCategoryTitle(slug, locale) {
+    const titles = changelogCategories[slug].titles;
+    return titles[locale] ?? titles[DEFAULT_LOCALE];
+}
 export const DEFAULT_LOCALE = "en-US";
 export const SUPPORTED_LOCALES = Object.freeze(["en-US", "es-MX"]);
 const localeAliases = new Map([

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

@@ -25,6 +25,19 @@ export declare const enUS: {
         site: {
             name: string;
         };
+        changelog: {
+            allCategories: string;
+            copyFailed: string;
+            copyLink: string;
+            dateModified: string;
+            datePublished: string;
+            empty: string;
+            emptyCategory: string;
+            linkCopied: string;
+            nextPage: string;
+            pageStatus: string;
+            previousPage: string;
+        };
         action: {
             addCollection: string;
             addColor: string;
@@ -219,6 +232,19 @@ export declare const enUS: {
             };
         };
         catalog: {
+            approval: {
+                approve: string;
+                reasonLabel: string;
+                reasonPlaceholder: string;
+                reject: string;
+                reverse: string;
+                status: {
+                    approved: string;
+                    pending: string;
+                    rejected: string;
+                };
+                title: string;
+            };
             collectionsWithProduct: string;
             colorEffect: {
                 fade: string;
@@ -672,6 +698,7 @@ export declare const enUS: {
             accountMenu: string;
             admin: string;
             betaFeatures: string;
+            changelog: string;
             collections: string;
             contact: string;
             help: string;

package/dist/localizations/en-US.js

@@ -25,6 +25,19 @@ export const enUS = {
         site: {
             name: "Pocket Trash",
         },
+        changelog: {
+            allCategories: "All categories",
+            copyFailed: "Couldn’t copy link",
+            copyLink: "Copy link",
+            dateModified: "Date Modified",
+            datePublished: "Date",
+            empty: "No changelog entries yet.",
+            emptyCategory: "No entries in this category.",
+            linkCopied: "Link copied",
+            nextPage: "Next page",
+            pageStatus: "Page {page} of {pageCount}",
+            previousPage: "Previous page",
+        },
         action: {
             addCollection: "Add collection",
             addColor: "Add colour",
@@ -219,6 +232,19 @@ export const enUS = {
             },
         },
         catalog: {
+            approval: {
+                approve: "Approve product",
+                reasonLabel: "Decision reason",
+                reasonPlaceholder: "Explain this approval decision",
+                reject: "Reject product",
+                reverse: "Return to pending",
+                status: {
+                    approved: "Approved",
+                    pending: "Pending review",
+                    rejected: "Rejected",
+                },
+                title: "Product approval",
+            },
             collectionsWithProduct: "Collections with this product",
             colorEffect: {
                 fade: "Fade",
@@ -672,6 +698,7 @@ export const enUS = {
             accountMenu: "Account menu",
             admin: "Admin",
             betaFeatures: "Beta features",
+            changelog: "Changelog",
             collections: "Collections",
             contact: "Contact",
             help: "Help",

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

@@ -25,6 +25,19 @@ export declare const esMX: {
         site: {
             name: string;
         };
+        changelog: {
+            allCategories: string;
+            copyFailed: string;
+            copyLink: string;
+            dateModified: string;
+            datePublished: string;
+            empty: string;
+            emptyCategory: string;
+            linkCopied: string;
+            nextPage: string;
+            pageStatus: string;
+            previousPage: string;
+        };
         action: {
             addCollection: string;
             addColor: string;
@@ -219,6 +232,19 @@ export declare const esMX: {
             };
         };
         catalog: {
+            approval: {
+                approve: string;
+                reasonLabel: string;
+                reasonPlaceholder: string;
+                reject: string;
+                reverse: string;
+                status: {
+                    approved: string;
+                    pending: string;
+                    rejected: string;
+                };
+                title: string;
+            };
             collectionsWithProduct: string;
             colorEffect: {
                 fade: string;
@@ -672,6 +698,7 @@ export declare const esMX: {
             accountMenu: string;
             admin: string;
             betaFeatures: string;
+            changelog: string;
             collections: string;
             contact: string;
             help: string;

package/dist/localizations/es-MX.js

@@ -25,6 +25,19 @@ export const esMX = {
         site: {
             name: "",
         },
+        changelog: {
+            allCategories: "Todas las categorías",
+            copyFailed: "No se pudo copiar el enlace",
+            copyLink: "Copiar enlace",
+            dateModified: "Fecha de modificación",
+            datePublished: "Fecha",
+            empty: "Aún no hay entradas en el registro de cambios.",
+            emptyCategory: "No hay entradas en esta categoría.",
+            linkCopied: "Enlace copiado",
+            nextPage: "Página siguiente",
+            pageStatus: "Página {page} de {pageCount}",
+            previousPage: "Página anterior",
+        },
         action: {
             addCollection: "",
             addColor: "Agregar color",
@@ -219,6 +232,19 @@ export const esMX = {
             },
         },
         catalog: {
+            approval: {
+                approve: "Aprobar producto",
+                reasonLabel: "Motivo de la decisión",
+                reasonPlaceholder: "Explica esta decisión de aprobación",
+                reject: "Rechazar producto",
+                reverse: "Devolver a pendiente",
+                status: {
+                    approved: "Aprobado",
+                    pending: "Pendiente de revisión",
+                    rejected: "Rechazado",
+                },
+                title: "Aprobación del producto",
+            },
             collectionsWithProduct: "Colecciones con este producto",
             colorEffect: {
                 fade: "Degradado",
@@ -672,6 +698,7 @@ export const esMX = {
             accountMenu: "Menu de cuenta",
             admin: "Administración",
             betaFeatures: "Funciones beta",
+            changelog: "Registro de cambios",
             collections: "Colecciones",
             contact: "Contacto",
             help: "Ayuda",

package/dist/types/localization.d.ts

@@ -22,6 +22,19 @@ export type CompleteLocalizationResource = Readonly<{
         site: {
             name: string;
         };
+        changelog: {
+            allCategories: string;
+            copyFailed: string;
+            copyLink: string;
+            dateModified: string;
+            datePublished: string;
+            empty: string;
+            emptyCategory: string;
+            linkCopied: string;
+            nextPage: string;
+            pageStatus: string;
+            previousPage: string;
+        };
         action: {
             addCollection: string;
             addColor: string;
@@ -216,6 +229,19 @@ export type CompleteLocalizationResource = Readonly<{
             };
         };
         catalog: {
+            approval: {
+                approve: string;
+                reasonLabel: string;
+                reasonPlaceholder: string;
+                reject: string;
+                reverse: string;
+                status: {
+                    approved: string;
+                    pending: string;
+                    rejected: string;
+                };
+                title: string;
+            };
             collectionsWithProduct: string;
             colorEffect: {
                 fade: string;
@@ -669,6 +695,7 @@ export type CompleteLocalizationResource = Readonly<{
             accountMenu: string;
             admin: string;
             betaFeatures: string;
+            changelog: string;
             collections: string;
             contact: string;
             help: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pocket-trash/localizations",
-  "version": "0.23.1",
+  "version": "0.24.0",
   "description": "Shared localization utilities and message catalogs for Pocket Trash.",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,11 +10,13 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./changelog/*.mdx": "./changelog/*.mdx",
     "./help/*.mdx": "./help/*.mdx",
     "./legal/*.mdx": "./legal/*.mdx"
   },
   "files": [
     "dist",
+    "changelog",
     "help",
     "legal"
   ],
@@ -53,6 +55,7 @@
     "agent-skills:update": "npx skills add pocket-trash/skills --skill '*' --agent codex claude-code -y",
     "build": "tsc -p tsconfig.json",
     "check": "biome check --write .",
+    "changelog:validate": "node scripts/validate-changelog.mjs",
     "changeset": "changeset",
     "changeset:version": "changeset version && node scripts/stamp-changelog-release-date.mjs",
     "dev": "tsc -p tsconfig.json --watch",
@@ -61,6 +64,6 @@
     "localization:create": "node scripts/localizations.mjs create",
     "localization:sync": "node scripts/localizations.mjs sync",
     "release": "npm whoami && pnpm run changeset:version && pnpm install --lockfile-only && git add package.json pnpm-lock.yaml CHANGELOG.md .changeset && git commit -m \"chore: version packages [skip ci]\" && changeset publish && git push --follow-tags && VERSION=$(node -p \"require('./package.json').version\") && gh release create \"v$VERSION\" --title \"v$VERSION\" --generate-notes --verify-tag",
-    "test": "pnpm run build && node --test"
+    "test": "pnpm changelog:validate && pnpm run build && node --test"
   }
 }