@stapel/listings-react 0.1.0

package/src/i18n/es.ts

@@ -0,0 +1,198 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+import { listingsErrorBundleEs } from "./generated/errors.es.gen.js";
+
+export { listingsErrorBundleEs } from "./generated/errors.es.gen.js";
+
+/**
+ * Spanish bundle for listings-react — the `@stapel/listings-react/i18n/es`
+ * subpath (i18n-shipping.md §2), opt-in exactly like `./i18n/ru`.
+ *
+ * It carries the UI copy too, not only the nine module-owned error keys. The
+ * composer and the owner's dashboard are the surfaces a seller works in for
+ * minutes at a time; a half-translated form there is visible immediately, in
+ * the way a half-translated settings pane is not. Same call chat-react made
+ * for the buyer↔seller thread.
+ *
+ * Provenance and the owner split are as in `./ru.ts`: 42 cross-cutting codes
+ * generated from stapel-core's catalogue, 9 `stapel_listings` codes authored
+ * here until upstream ships `translations/`, and the 12 `stapel_attributes`
+ * codes deliberately left to `@stapel/attributes-react`.
+ */
+export const listingsI18nBundleEs: I18nDictionary = {
+  ...listingsErrorBundleEs,
+
+  // ── the 9 stapel_listings-owned codes, pair-authored ─────────────────────
+  "error.400.category_required": "Hay que elegir una categoría",
+  "error.400.image_required":
+    "Para publicar el anuncio hace falta al menos una foto",
+  "error.400.listing_feature_not_allowed":
+    "El detalle «{feature}» no pertenece a esta categoría",
+  "error.400.publish_validation_failed":
+    "El anuncio no pasó la revisión y no se publicó",
+  "error.403.listing_not_owner": "Este anuncio no es tuyo",
+  "error.404.listing_not_found": "No se encontró el anuncio",
+  "error.409.already_favorited": "El anuncio ya está en favoritos",
+  "error.409.invalid_listing_transition":
+    "Un anuncio en estado «{from_status}» no se puede mover así",
+  "error.409.listing_cannot_delete_active":
+    "Archívalo primero — un anuncio a la venta no se puede borrar",
+
+  "listings.error.unknown": "Algo salió mal con este anuncio",
+
+  "listings.status.draft": "Borrador",
+  "listings.status.pending": "En revisión",
+  "listings.status.published": "Publicado",
+  "listings.status.paused": "En pausa",
+  "listings.status.expired": "Caducado",
+  "listings.status.sold": "Vendido",
+  "listings.status.rejected": "Rechazado",
+  "listings.status.blocked": "Retirado",
+  "listings.status.archived": "Archivado",
+
+  "listings.moderation.first_review":
+    "Enviado a revisión. Saldrá a la venta cuando un moderador lo apruebe.",
+  "listings.moderation.live_edit_pending":
+    "Tu anuncio sigue publicado mientras revisamos los cambios — la gente lo ve ahora mismo.",
+  "listings.moderation.pending_offline":
+    "Se pidió una revisión, pero este anuncio ya no está a la venta.",
+  "listings.moderation.needs_review":
+    "Un moderador lo está mirando a mano.",
+  "listings.moderation.live_needs_review":
+    "Publicado, y un moderador está mirando los cambios a mano.",
+  "listings.moderation.rejected":
+    "Un moderador rechazó este anuncio. Edítalo y vuelve a enviarlo.",
+  "listings.moderation.rejected_still_live":
+    "Un moderador rechazó este anuncio; sigue visible mientras se aplica.",
+
+  "listings.card.no_photo": "Sin foto",
+  "listings.card.photo_unavailable": "Foto no disponible",
+  "listings.card.price_absent": "Precio a consultar",
+  "listings.card.favorite_add": "Guardar en favoritos",
+  "listings.card.favorite_remove": "Quitar de favoritos",
+  "listings.card.open": "Abrir",
+
+  "listings.detail.loading": "Cargando el anuncio…",
+  "listings.detail.load_failed": "No pudimos cargar este anuncio",
+  "listings.detail.retry": "Reintentar",
+  "listings.detail.not_found": "No hay ningún anuncio en esta dirección",
+  "listings.detail.removed": "Este anuncio fue eliminado",
+  "listings.detail.not_published":
+    "Este anuncio no está a la venta ahora, así que lo que ves puede estar desactualizado",
+  "listings.detail.owner_only_view":
+    "Solo tú ves esto — todavía no está publicado",
+  "listings.detail.description": "Descripción",
+  "listings.detail.specs": "Detalles",
+  "listings.detail.no_specs": "El vendedor no indicó más detalles",
+  "listings.detail.unreadable_features":
+    "Detalles que esta versión no pudo leer: {count}",
+  "listings.detail.photos_unavailable":
+    "Aquí no se pueden mostrar las fotos — la aplicación no sabe resolverlas",
+  "listings.detail.photo_alt": "Foto {index} de {total}",
+  "listings.detail.published_at": "Publicado el {date}",
+  "listings.detail.expires_at": "A la venta hasta el {date}",
+  "listings.detail.stock": "Disponibles: {count}",
+
+  "listings.compose.new_title": "Anuncio nuevo",
+  "listings.compose.edit_title": "Editar el anuncio",
+  "listings.compose.category": "Categoría",
+  "listings.compose.category_help":
+    "La categoría decide qué detalles se le piden al vendedor",
+  "listings.compose.category_required": "Elige una categoría primero",
+  "listings.compose.category_changed_dropped":
+    "Respuestas que no aplican a esta categoría y se han borrado: {count}",
+  "listings.compose.title_label": "Título",
+  "listings.compose.title_too_long":
+    "El título debe tener como mucho {max_length} caracteres",
+  "listings.compose.description_label": "Descripción",
+  "listings.compose.price_label": "Precio",
+  "listings.compose.price_invalid":
+    "Escribe el precio como un número, con dos decimales como mucho",
+  "listings.compose.currency_label": "Moneda",
+  "listings.compose.location_label": "Dónde está",
+  "listings.compose.lat_label": "Latitud",
+  "listings.compose.lon_label": "Longitud",
+  "listings.compose.geo_incomplete":
+    "Una latitud necesita su longitud al lado — media coordenada no apunta a ningún sitio",
+  "listings.compose.photos": "Fotos",
+  "listings.compose.too_many_images":
+    "Un anuncio admite como mucho {max} fotos",
+  "listings.compose.details": "Detalles",
+  "listings.compose.details_loading": "Cargando lo que pide esta categoría…",
+  "listings.compose.details_failed":
+    "No pudimos cargar lo que pide esta categoría",
+  "listings.compose.details_empty": "Esta categoría no pide más detalles",
+  "listings.compose.countable": "Vendo un artículo contable",
+  "listings.compose.stock": "Cuántas unidades",
+  "listings.compose.auto_republish": "Volver a publicar cuando caduque",
+  "listings.compose.save": "Guardar borrador",
+  "listings.compose.saving": "Guardando…",
+  "listings.compose.saved": "Borrador guardado",
+  "listings.compose.publish": "Publicar",
+  "listings.compose.republish": "Enviar los cambios",
+  "listings.compose.publishing": "Enviando…",
+  "listings.compose.published_first":
+    "Enviado a revisión. Saldrá a la venta cuando un moderador lo apruebe.",
+  "listings.compose.published_live":
+    "Cambios enviados. Tu anuncio sigue publicado mientras los revisamos.",
+  "listings.compose.invalid_summary":
+    "Antes de enviarlo, revisa estos detalles: {count}",
+
+  "listings.compose.blocked.no_category":
+    "Elige una categoría — el resto del formulario depende de ella",
+  "listings.compose.blocked.unsupported_type":
+    "Esta categoría pide un tipo de detalle que la aplicación todavía no sabe mostrar ({types}), así que aquí no se puede rellenar",
+  "listings.compose.blocked.photos_pending":
+    "Espera a que terminen de subirse las fotos",
+  "listings.compose.blocked.no_draft": "El borrador todavía no está creado",
+  "listings.compose.blocked.busy":
+    "Un momento — el último cambio se está guardando",
+  "listings.compose.blocked.mirror": "Corrige primero los campos marcados",
+  "listings.compose.blocked.details_unavailable":
+    "No pudimos cargar lo que pide esta categoría, así que no podemos revisar el formulario",
+
+  "listings.mine.title": "Mis anuncios",
+  "listings.mine.tab.active": "Activos",
+  "listings.mine.tab.drafts": "Borradores",
+  "listings.mine.tab.archived": "Archivo",
+  "listings.mine.loading": "Cargando tus anuncios…",
+  "listings.mine.load_failed": "No pudimos cargar tus anuncios",
+  "listings.mine.empty": "Aquí todavía no hay nada",
+  "listings.mine.retry": "Reintentar",
+  "listings.mine.counters_failed": "No pudimos contar tus anuncios",
+  "listings.mine.source_missing":
+    "Esta aplicación todavía no puede enumerar tus anuncios: el servicio de anuncios no tiene una lista limitada al propietario. Los contadores de abajo sí son reales.",
+  "listings.mine.live_under_review": "Publicado, cambios en revisión",
+  "listings.mine.edit": "Editar",
+  "listings.mine.archive": "Archivar",
+  "listings.mine.complete": "Marcar como vendido",
+  "listings.mine.delete": "Borrar",
+
+  "listings.favorites.title": "Favoritos",
+  "listings.favorites.loading": "Cargando tus favoritos…",
+  "listings.favorites.load_failed": "No pudimos cargar tus favoritos",
+  "listings.favorites.empty": "Todavía no has guardado nada",
+
+  "listings.blocked.sign_in": "Inicia sesión para hacer esto",
+  "listings.blocked.guest":
+    "Esta cuenta todavía no puede hacerlo — termina de configurarla primero",
+  "listings.blocked.mandate_unknown":
+    "No pudimos comprobar tu cuenta, así que no adivinamos si puedes hacerlo",
+  "listings.blocked.transition":
+    "Un anuncio en estado «{from_status}» no se puede mover así",
+  "listings.blocked.delete_active":
+    "Archívalo primero — un anuncio a la venta no se puede borrar",
+  "listings.blocked.in_flight": "Un momento — eso ya está en marcha",
+
+  "listings.page.prev": "Anterior",
+  "listings.page.next": "Siguiente",
+
+  "listings.nav.detail": "Anuncio",
+  "listings.nav.compose": "Poner un anuncio",
+  "listings.nav.mine": "Mis anuncios",
+  "listings.nav.favorites": "Favoritos",
+};
+
+/** Register the Spanish bundle into a core i18n engine. */
+export function registerListingsI18nEs(i18n: I18nEngine): void {
+  i18n.registerBundle("es", listingsI18nBundleEs);
+}

package/src/i18n/generated/errors.es.gen.ts

@@ -0,0 +1,64 @@
+// AUTO-GENERATED by scripts/gen-errors.mjs — do not edit by hand.
+// Source: stapel-auth canonical errors.json (backend codegen artifact).
+// Regenerate: pnpm gen:errors   ·   Drift gate: pnpm gen:errors:check
+// Locale source: backend translations/errors.es.json (locale catalog
+// beside the canonical errors.json — i18n-shipping.md §1).
+import type { ListingsErrorCode } from "./errors.gen.js";
+
+/**
+ * `es` texts for the backend error codes this catalog carries.
+ *
+ * PARTIAL, and deliberately typed to say so: 21 key(s) owned by
+ * stapel_attributes, stapel_listings are absent, because that owner ships no locale catalog
+ * (ERRORS_LOCALE_EXEMPT_OWNERS). English for them still comes from the registry
+ * artifact via the en bundle; the pair layers its own authored `es`
+ * strings over this one until upstream ships translations. `Partial` is what
+ * makes the gap visible to TypeScript instead of a silent English fallback.
+ *
+ * Import from the pair's `./i18n/es` subpath, NOT the main entry, so
+ * the locale stays out of hosts that don't ship it.
+ */
+export const listingsErrorBundleEs: Partial<Record<ListingsErrorCode, string>> = {
+  "error.400.bad_request": "Solicitud incorrecta",
+  "error.400.captcha_invalid": "La verificación del captcha ha fallado. Inténtalo de nuevo.",
+  "error.400.captcha_required": "Se requiere el token del captcha.",
+  "error.400.expected_list": "Se esperaba una lista de elementos",
+  "error.400.field.blank": "{field} no puede estar vacío",
+  "error.400.field.does_not_exist": "{field} no existe",
+  "error.400.field.invalid": "{field} no es válido",
+  "error.400.field.invalid_choice": "{field} no es una opción válida",
+  "error.400.field.max_length": "{field} debe tener como máximo {max_length} caracteres",
+  "error.400.field.max_value": "{field} debe ser como máximo {max_value}",
+  "error.400.field.min_length": "{field} debe tener al menos {min_length} caracteres",
+  "error.400.field.min_value": "{field} debe ser como mínimo {min_value}",
+  "error.400.field.null": "{field} no puede ser nulo",
+  "error.400.field.required": "{field} es obligatorio",
+  "error.400.field.unique": "{field} debe ser único",
+  "error.400.invalid_ad_id": "ID de anuncio no válido",
+  "error.400.validation_error": "Error de validación",
+  "error.400.verification_failed": "La verificación ha fallado",
+  "error.400.verification_invalid_factor": "Este factor de verificación no está disponible",
+  "error.401.unauthorized": "Se requiere autenticación",
+  "error.402.payment_required": "Se requiere pago",
+  "error.403.forbidden": "No tienes permiso para realizar esta acción",
+  "error.403.network_blocked": "No se permiten solicitudes desde esta red.",
+  "error.403.verification_enrollment_required": "Es necesario registrar un factor de verificación.",
+  "error.403.verification_required": "Se requiere verificación adicional",
+  "error.404.ad_not_found": "Anuncio no encontrado",
+  "error.404.not_found": "Recurso solicitado no encontrado",
+  "error.404.verification_challenge_not_found": "Desafío de verificación no encontrado o caducado",
+  "error.405.method_not_allowed": "Método no permitido",
+  "error.406.not_acceptable": "No aceptable",
+  "error.408.request_timeout": "Tiempo de espera de la solicitud agotado",
+  "error.409.conflict": "El recurso ya existe",
+  "error.410.gone": "El recurso se ha eliminado permanentemente",
+  "error.413.payload_too_large": "El cuerpo de la solicitud es demasiado grande",
+  "error.415.unsupported_media_type": "Tipo de contenido no compatible",
+  "error.422.unprocessable_entity": "Entidad no procesable",
+  "error.423.locked": "El recurso está bloqueado",
+  "error.423.verification_locked": "Demasiados intentos fallidos — verificación bloqueada",
+  "error.429.rate_limit": "Demasiados intentos. Inténtalo de nuevo en {retry_after_minutes} minutos.",
+  "error.429.too_many_requests": "Demasiadas solicitudes. Inténtalo de nuevo más tarde.",
+  "error.500.internal": "Algo salió mal",
+  "error.503.mandate_unavailable": "No se puede verificar el mandato del espacio de trabajo",
+};

package/src/i18n/generated/errors.gen.ts

@@ -0,0 +1,241 @@
+// AUTO-GENERATED by scripts/gen-errors.mjs — do not edit by hand.
+// Source: stapel-auth canonical errors.json (backend codegen artifact).
+// Regenerate: pnpm gen:errors   ·   Drift gate: pnpm gen:errors:check
+
+/**
+ * Remediation vocabulary (frontend-core-architecture §2.5). Declared by the
+ * backend on the error registry and consumed verbatim from its `errors.json`
+ * artifact. A host maps it to UX — retryable → "try again"; `wait_and_retry` →
+ * timer from `params.retry_after_minutes`; `verify` → the step-up seam;
+ * `fix_input` → highlight the offending field.
+ */
+export type Remediation =
+  | "retry"
+  | "wait_and_retry"
+  | "reauthenticate"
+  | "verify"
+  | "fix_input"
+  | "contact_support"
+  | "bug";
+
+export interface ListingsErrorSpec {
+  /** HTTP status the backend raises this key with. */
+  readonly status: number;
+  /** `{param}` interpolation slots present in the message. */
+  readonly params: readonly string[];
+  /** Remediation hint declared by the backend (see {@link Remediation}). */
+  readonly remediation: Remediation;
+  /** English fallback (source: stapel-auth errors.json). */
+  readonly en: string;
+}
+
+/**
+ * The LISTINGS_ERRORS map — every `error.*` key stapel-auth can raise, keyed by its
+ * canonical code. The single source of truth behind the en fallback bundle, the
+ * remediation lookup, and the manifest `errors` block.
+ */
+export const LISTINGS_ERRORS = {
+  "error.400.bad_request": { status: 400, params: [], remediation: "fix_input", en: "Bad request" },
+  "error.400.captcha_invalid": { status: 400, params: [], remediation: "retry", en: "Captcha verification failed. Please try again." },
+  "error.400.captcha_required": { status: 400, params: [], remediation: "retry", en: "Captcha token is required." },
+  "error.400.category_required": { status: 400, params: [], remediation: "fix_input", en: "Category is required" },
+  "error.400.description_too_long": { status: 400, params: ["max_length"], remediation: "fix_input", en: "Description must be at most {max_length} characters" },
+  "error.400.description_too_short": { status: 400, params: ["min_length"], remediation: "fix_input", en: "Description must be at least {min_length} characters" },
+  "error.400.expected_list": { status: 400, params: [], remediation: "fix_input", en: "Expected a list of items" },
+  "error.400.feature_above_maximum": { status: 400, params: ["feature"], remediation: "fix_input", en: "Value is above maximum for {feature}" },
+  "error.400.feature_below_minimum": { status: 400, params: ["feature"], remediation: "fix_input", en: "Value is below minimum for {feature}" },
+  "error.400.feature_invalid_config": { status: 400, params: ["feature"], remediation: "fix_input", en: "Invalid config for {feature}" },
+  "error.400.feature_invalid_format": { status: 400, params: ["feature"], remediation: "fix_input", en: "Invalid format for {feature}" },
+  "error.400.feature_invalid_type": { status: 400, params: ["feature"], remediation: "fix_input", en: "Invalid type for {feature}" },
+  "error.400.feature_mandatory_missing": { status: 400, params: ["feature"], remediation: "fix_input", en: "Mandatory feature {feature} is required" },
+  "error.400.feature_not_allowed": { status: 400, params: ["feature"], remediation: "fix_input", en: "Feature {feature} is not allowed here" },
+  "error.400.feature_not_in_options": { status: 400, params: ["feature"], remediation: "fix_input", en: "Value is not in allowed options for {feature}" },
+  "error.400.feature_unknown": { status: 400, params: ["feature"], remediation: "fix_input", en: "Unknown feature {feature}" },
+  "error.400.feature_unknown_type": { status: 400, params: ["feature"], remediation: "fix_input", en: "Unknown feature type for {feature}" },
+  "error.400.field.blank": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} may not be blank" },
+  "error.400.field.does_not_exist": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} does not exist" },
+  "error.400.field.invalid": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} is invalid" },
+  "error.400.field.invalid_choice": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} is not a valid choice" },
+  "error.400.field.max_length": { status: 400, params: ["field","max_length"], remediation: "fix_input", en: "{field} must be at most {max_length} characters" },
+  "error.400.field.max_value": { status: 400, params: ["field","max_value"], remediation: "fix_input", en: "{field} must be at most {max_value}" },
+  "error.400.field.min_length": { status: 400, params: ["field","min_length"], remediation: "fix_input", en: "{field} must be at least {min_length} characters" },
+  "error.400.field.min_value": { status: 400, params: ["field","min_value"], remediation: "fix_input", en: "{field} must be at least {min_value}" },
+  "error.400.field.null": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} may not be null" },
+  "error.400.field.required": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} is required" },
+  "error.400.field.unique": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} must be unique" },
+  "error.400.image_required": { status: 400, params: [], remediation: "fix_input", en: "At least one image is required to publish" },
+  "error.400.invalid_ad_id": { status: 400, params: [], remediation: "fix_input", en: "Invalid advertisement ID" },
+  "error.400.listing_feature_not_allowed": { status: 400, params: ["feature"], remediation: "fix_input", en: "Feature '{feature}' is not allowed for this category" },
+  "error.400.publish_validation_failed": { status: 400, params: [], remediation: "fix_input", en: "Listing validation failed" },
+  "error.400.validation_error": { status: 400, params: [], remediation: "fix_input", en: "Validation error" },
+  "error.400.verification_failed": { status: 400, params: [], remediation: "verify", en: "Verification failed" },
+  "error.400.verification_invalid_factor": { status: 400, params: [], remediation: "verify", en: "This verification factor is not available" },
+  "error.401.unauthorized": { status: 401, params: [], remediation: "reauthenticate", en: "Authentication required" },
+  "error.402.payment_required": { status: 402, params: [], remediation: "retry", en: "Payment required" },
+  "error.403.forbidden": { status: 403, params: [], remediation: "retry", en: "You do not have permission to perform this action" },
+  "error.403.listing_not_owner": { status: 403, params: [], remediation: "retry", en: "Not your listing" },
+  "error.403.network_blocked": { status: 403, params: [], remediation: "contact_support", en: "Requests from this network are not allowed" },
+  "error.403.verification_enrollment_required": { status: 403, params: [], remediation: "verify", en: "Verification factor enrollment required" },
+  "error.403.verification_required": { status: 403, params: [], remediation: "verify", en: "Additional verification required" },
+  "error.404.ad_not_found": { status: 404, params: [], remediation: "retry", en: "Listing not found" },
+  "error.404.listing_not_found": { status: 404, params: [], remediation: "retry", en: "Listing not found" },
+  "error.404.not_found": { status: 404, params: [], remediation: "retry", en: "Requested resource not found" },
+  "error.404.verification_challenge_not_found": { status: 404, params: [], remediation: "verify", en: "Verification challenge not found or expired" },
+  "error.405.method_not_allowed": { status: 405, params: [], remediation: "retry", en: "Method not allowed" },
+  "error.406.not_acceptable": { status: 406, params: [], remediation: "retry", en: "Not acceptable" },
+  "error.408.request_timeout": { status: 408, params: [], remediation: "retry", en: "Request timeout" },
+  "error.409.already_favorited": { status: 409, params: [], remediation: "fix_input", en: "Listing already favorited" },
+  "error.409.conflict": { status: 409, params: [], remediation: "fix_input", en: "Resource already exists" },
+  "error.409.invalid_listing_transition": { status: 409, params: ["from_status"], remediation: "fix_input", en: "Invalid status transition for {from_status}" },
+  "error.409.listing_cannot_delete_active": { status: 409, params: [], remediation: "fix_input", en: "Cannot delete an active listing. Archive it first." },
+  "error.410.gone": { status: 410, params: [], remediation: "retry", en: "Resource has been permanently removed" },
+  "error.413.payload_too_large": { status: 413, params: [], remediation: "retry", en: "Request body is too large" },
+  "error.415.unsupported_media_type": { status: 415, params: [], remediation: "retry", en: "Unsupported media type" },
+  "error.422.unprocessable_entity": { status: 422, params: [], remediation: "wait_and_retry", en: "Unprocessable entity" },
+  "error.423.locked": { status: 423, params: [], remediation: "wait_and_retry", en: "Resource is locked" },
+  "error.423.verification_locked": { status: 423, params: [], remediation: "wait_and_retry", en: "Too many failed attempts — verification locked" },
+  "error.429.rate_limit": { status: 429, params: ["retry_after_minutes"], remediation: "wait_and_retry", en: "Too many attempts. Try again in {retry_after_minutes} minutes." },
+  "error.429.too_many_requests": { status: 429, params: [], remediation: "wait_and_retry", en: "Too many requests. Please try again later." },
+  "error.500.internal": { status: 500, params: [], remediation: "contact_support", en: "Something went wrong" },
+  "error.503.mandate_unavailable": { status: 503, params: [], remediation: "retry", en: "Cannot verify workspace mandate right now" },
+} as const;
+
+export type ListingsErrorCode = keyof typeof LISTINGS_ERRORS;
+
+/** Every backend error code this module can surface, sorted. */
+export const LISTINGS_ERROR_CODES: readonly ListingsErrorCode[] = [
+  "error.400.bad_request",
+  "error.400.captcha_invalid",
+  "error.400.captcha_required",
+  "error.400.category_required",
+  "error.400.description_too_long",
+  "error.400.description_too_short",
+  "error.400.expected_list",
+  "error.400.feature_above_maximum",
+  "error.400.feature_below_minimum",
+  "error.400.feature_invalid_config",
+  "error.400.feature_invalid_format",
+  "error.400.feature_invalid_type",
+  "error.400.feature_mandatory_missing",
+  "error.400.feature_not_allowed",
+  "error.400.feature_not_in_options",
+  "error.400.feature_unknown",
+  "error.400.feature_unknown_type",
+  "error.400.field.blank",
+  "error.400.field.does_not_exist",
+  "error.400.field.invalid",
+  "error.400.field.invalid_choice",
+  "error.400.field.max_length",
+  "error.400.field.max_value",
+  "error.400.field.min_length",
+  "error.400.field.min_value",
+  "error.400.field.null",
+  "error.400.field.required",
+  "error.400.field.unique",
+  "error.400.image_required",
+  "error.400.invalid_ad_id",
+  "error.400.listing_feature_not_allowed",
+  "error.400.publish_validation_failed",
+  "error.400.validation_error",
+  "error.400.verification_failed",
+  "error.400.verification_invalid_factor",
+  "error.401.unauthorized",
+  "error.402.payment_required",
+  "error.403.forbidden",
+  "error.403.listing_not_owner",
+  "error.403.network_blocked",
+  "error.403.verification_enrollment_required",
+  "error.403.verification_required",
+  "error.404.ad_not_found",
+  "error.404.listing_not_found",
+  "error.404.not_found",
+  "error.404.verification_challenge_not_found",
+  "error.405.method_not_allowed",
+  "error.406.not_acceptable",
+  "error.408.request_timeout",
+  "error.409.already_favorited",
+  "error.409.conflict",
+  "error.409.invalid_listing_transition",
+  "error.409.listing_cannot_delete_active",
+  "error.410.gone",
+  "error.413.payload_too_large",
+  "error.415.unsupported_media_type",
+  "error.422.unprocessable_entity",
+  "error.423.locked",
+  "error.423.verification_locked",
+  "error.429.rate_limit",
+  "error.429.too_many_requests",
+  "error.500.internal",
+  "error.503.mandate_unavailable",
+];
+
+/**
+ * English fallback bundle — one string per backend key, so a `StapelApiError.code`
+ * never renders as a raw key. Merged UNDER the hand-polished UI copy in
+ * {@link authI18nBundleEn} (polish wins; this guarantees coverage).
+ */
+export const listingsErrorBundleEn: Record<ListingsErrorCode, string> = {
+  "error.400.bad_request": "Bad request",
+  "error.400.captcha_invalid": "Captcha verification failed. Please try again.",
+  "error.400.captcha_required": "Captcha token is required.",
+  "error.400.category_required": "Category is required",
+  "error.400.description_too_long": "Description must be at most {max_length} characters",
+  "error.400.description_too_short": "Description must be at least {min_length} characters",
+  "error.400.expected_list": "Expected a list of items",
+  "error.400.feature_above_maximum": "Value is above maximum for {feature}",
+  "error.400.feature_below_minimum": "Value is below minimum for {feature}",
+  "error.400.feature_invalid_config": "Invalid config for {feature}",
+  "error.400.feature_invalid_format": "Invalid format for {feature}",
+  "error.400.feature_invalid_type": "Invalid type for {feature}",
+  "error.400.feature_mandatory_missing": "Mandatory feature {feature} is required",
+  "error.400.feature_not_allowed": "Feature {feature} is not allowed here",
+  "error.400.feature_not_in_options": "Value is not in allowed options for {feature}",
+  "error.400.feature_unknown": "Unknown feature {feature}",
+  "error.400.feature_unknown_type": "Unknown feature type for {feature}",
+  "error.400.field.blank": "{field} may not be blank",
+  "error.400.field.does_not_exist": "{field} does not exist",
+  "error.400.field.invalid": "{field} is invalid",
+  "error.400.field.invalid_choice": "{field} is not a valid choice",
+  "error.400.field.max_length": "{field} must be at most {max_length} characters",
+  "error.400.field.max_value": "{field} must be at most {max_value}",
+  "error.400.field.min_length": "{field} must be at least {min_length} characters",
+  "error.400.field.min_value": "{field} must be at least {min_value}",
+  "error.400.field.null": "{field} may not be null",
+  "error.400.field.required": "{field} is required",
+  "error.400.field.unique": "{field} must be unique",
+  "error.400.image_required": "At least one image is required to publish",
+  "error.400.invalid_ad_id": "Invalid advertisement ID",
+  "error.400.listing_feature_not_allowed": "Feature '{feature}' is not allowed for this category",
+  "error.400.publish_validation_failed": "Listing validation failed",
+  "error.400.validation_error": "Validation error",
+  "error.400.verification_failed": "Verification failed",
+  "error.400.verification_invalid_factor": "This verification factor is not available",
+  "error.401.unauthorized": "Authentication required",
+  "error.402.payment_required": "Payment required",
+  "error.403.forbidden": "You do not have permission to perform this action",
+  "error.403.listing_not_owner": "Not your listing",
+  "error.403.network_blocked": "Requests from this network are not allowed",
+  "error.403.verification_enrollment_required": "Verification factor enrollment required",
+  "error.403.verification_required": "Additional verification required",
+  "error.404.ad_not_found": "Listing not found",
+  "error.404.listing_not_found": "Listing not found",
+  "error.404.not_found": "Requested resource not found",
+  "error.404.verification_challenge_not_found": "Verification challenge not found or expired",
+  "error.405.method_not_allowed": "Method not allowed",
+  "error.406.not_acceptable": "Not acceptable",
+  "error.408.request_timeout": "Request timeout",
+  "error.409.already_favorited": "Listing already favorited",
+  "error.409.conflict": "Resource already exists",
+  "error.409.invalid_listing_transition": "Invalid status transition for {from_status}",
+  "error.409.listing_cannot_delete_active": "Cannot delete an active listing. Archive it first.",
+  "error.410.gone": "Resource has been permanently removed",
+  "error.413.payload_too_large": "Request body is too large",
+  "error.415.unsupported_media_type": "Unsupported media type",
+  "error.422.unprocessable_entity": "Unprocessable entity",
+  "error.423.locked": "Resource is locked",
+  "error.423.verification_locked": "Too many failed attempts — verification locked",
+  "error.429.rate_limit": "Too many attempts. Try again in {retry_after_minutes} minutes.",
+  "error.429.too_many_requests": "Too many requests. Please try again later.",
+  "error.500.internal": "Something went wrong",
+  "error.503.mandate_unavailable": "Cannot verify workspace mandate right now",
+};