@stapel/listings-react 0.25.10 → 0.26.0

package/src/headless/Share.tsx

@@ -0,0 +1,278 @@
+/**
+ * Sharing a listing — the verb a classified is judged on and this pair did
+ * not have.
+ *
+ * Measured on the live storefront (owner, 2026-09-06): **no share control of
+ * any kind**, on any surface. A person who wanted to send an offer to whoever
+ * they are buying it with had the address bar and nothing else, on a phone,
+ * where the address bar is the hardest thing on the screen to reach. Every
+ * reference classified answers this with one button.
+ *
+ * ── Two arms, and the device decides which ────────────────────────────────
+ *
+ * `navigator.share` is the whole answer where it exists: the platform's own
+ * sheet, with the person's own apps in it, in their own order. It exists on
+ * essentially every phone and on almost no desktop, which is why the second
+ * arm is not a fallback for old browsers but the DESKTOP rendering — a small
+ * menu with "copy the link" and the three networks a Russian-speaking
+ * marketplace actually gets traffic from.
+ *
+ * `native` is resolved in an EFFECT rather than during render, for the reason
+ * `cardGallery.ts`'s `useFinePointer` gives at length: a server render has no
+ * `navigator`, and a first client render that disagreed with it is a
+ * hydration mismatch on every listing page in the app. It opens `false` — the
+ * menu arm — because a menu that appears for one frame and is replaced by a
+ * button is invisible, while the reverse is a sheet that fails to open.
+ *
+ * ── The URL is the HOST'S, never `window.location` ────────────────────────
+ *
+ * A pair does not own routing (`@stapel/core`'s `ui.ts` argues it). The
+ * canonical address of a listing is a route the container built, so it
+ * arrives as {@link UseShareOptions.url} and is used verbatim. `location.href`
+ * is consulted ONLY when the host supplied nothing — which is honest for a
+ * bare mount and wrong the moment an app has a canonical URL, because the
+ * address bar on a SERP carries the query, the page, the scroll anchor and
+ * whatever tracking parameters the visitor arrived with, and none of that
+ * belongs in a link somebody sends to a friend.
+ *
+ * A RELATIVE `url` ("/l/7" — what every route seam in this fleet speaks) is
+ * resolved against the document's own base, so a host hands in the same path
+ * it hands `<ListingCard href>` and gets an absolute link out.
+ *
+ * ── Nothing here renders ──────────────────────────────────────────────────
+ *
+ * The hook returns hrefs and channel identifiers; the copy lives in the skin.
+ * A host drawing its own share menu gets the same three links and the same
+ * clipboard write without importing antd.
+ */
+import { useCallback, useEffect, useMemo, useState } from "react";
+import type { ReactElement, ReactNode } from "react";
+
+/**
+ * Where a share went. `"native"` is the platform sheet (which never says
+ * WHICH app the person picked — that is the sheet's privacy property, not a
+ * gap here), `"copy"` is the clipboard, and the three networks are the
+ * explicit links.
+ */
+export type ShareChannel = "native" | "copy" | "telegram" | "whatsapp" | "vk";
+
+/** The three networks, in the order the menu draws them. */
+export const SHARE_NETWORKS = ["telegram", "whatsapp", "vk"] as const;
+
+export type ShareNetwork = (typeof SHARE_NETWORKS)[number];
+
+/** One network's ready-made link. */
+export interface ShareLink {
+  readonly channel: ShareNetwork;
+  /** Absolute, already encoded. Rendered `target="_blank"` with
+   * `rel="noopener noreferrer"` — see `<ShareAction>` for why both. */
+  readonly href: string;
+}
+
+export interface ShareTarget {
+  /** The canonical, ABSOLUTE address of what is being shared. */
+  readonly url: string;
+  /** The listing's title. Empty is a real answer — an untitled listing is
+   * still shareable — and then the networks carry the link alone. */
+  readonly title?: string | undefined;
+}
+
+/**
+ * The three networks' share endpoints, as pure functions of the target.
+ *
+ * Separate from the hook and exported so the encoding is a thing a test can
+ * read rather than a thing a rendered `<a href>` implies. Each is the
+ * network's own documented endpoint:
+ *
+ *   Telegram  https://t.me/share/url?url=…&text=…
+ *   WhatsApp  https://wa.me/?text=…              (one field: title + url)
+ *   VK        https://vk.com/share.php?url=…&title=…
+ *
+ * `encodeURIComponent` on every field, without exception. A listing title is
+ * seller-supplied text — it contains `&`, `#`, `?` and emoji in the wild —
+ * and a title pasted raw into a query string does not merely render oddly, it
+ * silently truncates the URL the recipient receives at the first `&`.
+ */
+export function shareLinks(target: ShareTarget): readonly ShareLink[] {
+  const url = encodeURIComponent(target.url);
+  const title = target.title ?? "";
+  const text = encodeURIComponent(title);
+  // WhatsApp takes ONE field, so the title and the link travel together in
+  // it; the other two carry the address in its own parameter.
+  const whatsapp = encodeURIComponent(
+    title.length > 0 ? `${title} ${target.url}` : target.url
+  );
+  return [
+    { channel: "telegram", href: `https://t.me/share/url?url=${url}&text=${text}` },
+    { channel: "whatsapp", href: `https://wa.me/?text=${whatsapp}` },
+    { channel: "vk", href: `https://vk.com/share.php?url=${url}&title=${text}` },
+  ];
+}
+
+/**
+ * Resolve what the host handed in into an absolute address.
+ *
+ * Three cases and no guessing: an absolute URL is returned as it came, a path
+ * is resolved against the document's base, and nothing at all falls back to
+ * the address bar (see the file header for why that is the last resort and
+ * not the default).
+ */
+export function resolveShareUrl(url: string | undefined): string | undefined {
+  if (typeof window === "undefined") return url;
+  const base = window.document.baseURI;
+  if (url === undefined || url.length === 0) return window.location.href;
+  try {
+    return new URL(url, base).href;
+  } catch {
+    return url;
+  }
+}
+
+/** Is this environment able to open the platform's own share sheet? */
+export function hasNativeShare(): boolean {
+  if (typeof navigator === "undefined") return false;
+  return typeof navigator.share === "function";
+}
+
+export interface UseShareOptions {
+  /** The canonical address, absolute or a path. Absent: the address bar,
+   * which is the honest answer only for a host with no route seam. */
+  readonly url?: string | undefined;
+  /** The listing's title — the sheet's heading and the networks' text. */
+  readonly title?: string | undefined;
+  /** A sentence under the title in the platform sheet (the price, say). */
+  readonly text?: string | undefined;
+  /** Analytics. Fired once per completed share, with the channel it went
+   * through; `"native"` never says which app, because the sheet does not
+   * tell the page. */
+  readonly onShared?: ((channel: ShareChannel) => void) | undefined;
+}
+
+export interface ShareBag {
+  /** The absolute address every arm shares. `undefined` only on a server. */
+  readonly url: string | undefined;
+  /** Does this device have the platform's own sheet? Settles in an effect —
+   * see the file header. */
+  readonly native: boolean;
+  /** The three networks' links, already encoded. */
+  readonly links: readonly ShareLink[];
+  /**
+   * The clipboard write LANDED, and this is what the confirmation is drawn
+   * from. It clears itself after {@link SHARE_COPIED_MS} so a menu reopened a
+   * minute later is not still congratulating the person.
+   */
+  readonly copied: boolean;
+  /** The clipboard refused (no permission, an insecure origin, a browser
+   * without the API). Stated, never swallowed: a person who pressed "copy"
+   * and pastes nothing has to be told the press did not work. */
+  readonly copyFailed: boolean;
+  /** Open the platform sheet. A no-op where there is none — callers branch on
+   * {@link ShareBag.native} rather than discovering it here. */
+  shareNatively(): void;
+  /** Write the address to the clipboard. */
+  copy(): void;
+  /** Report a network link the person actually followed. The anchor does the
+   * navigating; this is the analytics half. */
+  report(channel: ShareChannel): void;
+}
+
+/** How long the "copied" confirmation stands. Long enough to read, short
+ * enough that a reopened menu is not still showing it. */
+export const SHARE_COPIED_MS = 2400;
+
+export function useShare(options: UseShareOptions = {}): ShareBag {
+  const { url: given, title, text, onShared } = options;
+  const [native, setNative] = useState(false);
+  const [copied, setCopied] = useState(false);
+  const [copyFailed, setCopyFailed] = useState(false);
+
+  // See the header: resolved in an effect so a server render and the
+  // hydration pass that must agree with it draw the same arm.
+  useEffect(() => {
+    setNative(hasNativeShare());
+  }, []);
+
+  const url = useMemo(() => resolveShareUrl(given), [given]);
+  const links = useMemo(
+    () => (url === undefined ? [] : shareLinks({ url, title })),
+    [url, title]
+  );
+
+  useEffect(() => {
+    if (!copied) return undefined;
+    const timer = setTimeout(() => {
+      setCopied(false);
+    }, SHARE_COPIED_MS);
+    return () => {
+      clearTimeout(timer);
+    };
+  }, [copied]);
+
+  const report = useCallback(
+    (channel: ShareChannel): void => {
+      onShared?.(channel);
+    },
+    [onShared]
+  );
+
+  const shareNatively = useCallback((): void => {
+    if (url === undefined) return;
+    const share = typeof navigator === "undefined" ? undefined : navigator.share;
+    if (typeof share !== "function") return;
+    // The rejection a share sheet ALWAYS produces is `AbortError` — the
+    // person closed it — and that is not a failure to report. Nothing is
+    // said either way; the sheet is the feedback.
+    void Promise.resolve(
+      share.call(navigator, {
+        url,
+        ...(title !== undefined && title.length > 0 ? { title } : {}),
+        ...(text !== undefined && text.length > 0 ? { text } : {}),
+      })
+    )
+      .then(() => {
+        report("native");
+      })
+      .catch(() => undefined);
+  }, [url, title, text, report]);
+
+  const copy = useCallback((): void => {
+    if (url === undefined) return;
+    setCopyFailed(false);
+    const clipboard =
+      typeof navigator === "undefined" ? undefined : navigator.clipboard;
+    if (clipboard === undefined || typeof clipboard.writeText !== "function") {
+      setCopyFailed(true);
+      return;
+    }
+    void Promise.resolve(clipboard.writeText(url))
+      .then(() => {
+        setCopied(true);
+        report("copy");
+      })
+      .catch(() => {
+        setCopyFailed(true);
+      });
+  }, [url, report]);
+
+  return {
+    url,
+    native,
+    links,
+    copied,
+    copyFailed,
+    shareNatively,
+    copy,
+    report,
+  };
+}
+
+/** Renderless: the bag, handed to a render prop — the shape every headless
+ * component in this pair takes. */
+export function Share(
+  props: UseShareOptions & {
+    children: (bag: ShareBag) => ReactNode;
+  }
+): ReactElement {
+  const bag = useShare(props);
+  return <>{props.children(bag)}</>;
+}

package/src/i18n/es.ts

@@ -77,10 +77,23 @@ export const listingsI18nBundleEs: I18nDictionary = {
   "listings.card.untitled": "Anuncio sin título",
   "listings.card.sign_in": "Iniciar sesión",
   "listings.card.photos": "Fotos de este anuncio",
+  "listings.card.photo_counter": "{index} de {total}",
   "listings.card.price_was": "Antes",
   "listings.card.price_dropped": "El precio ha bajado",
   "listings.card.price_raised": "El precio ha subido",
 
+  "listings.share.action": "Compartir",
+  "listings.share.copy": "Copiar enlace",
+  "listings.share.copied": "Enlace copiado",
+  "listings.share.copy_failed":
+    "No pudimos copiar el enlace — cópialo de la barra de direcciones",
+  "listings.share.telegram": "Telegram",
+  "listings.share.whatsapp": "WhatsApp",
+  "listings.share.vk": "VK",
+  "listings.favorite.added": "Añadido a favoritos",
+  "listings.favorite.removed": "Quitado de favoritos",
+  "listings.favorite.count": "{count} lo han guardado",
+
   "listings.detail.loading": "Cargando el anuncio…",
   "listings.detail.load_failed": "No pudimos cargar este anuncio",
   "listings.detail.retry": "Reintentar",
@@ -175,6 +188,7 @@ export const listingsI18nBundleEs: I18nDictionary = {
   "listings.mine.tab.active": "Activos",
   "listings.mine.tab.drafts": "Borradores",
   "listings.mine.tab.archived": "Archivo",
+  "listings.mine.tab.removed": "Retirados",
   "listings.mine.loading": "Cargando tus anuncios…",
   "listings.mine.load_failed": "No pudimos cargar tus anuncios",
   "listings.mine.empty": "Aquí todavía no hay nada",
@@ -183,6 +197,7 @@ export const listingsI18nBundleEs: I18nDictionary = {
   "listings.mine.empty.active": "No tienes nada publicado ni en revisión",
   "listings.mine.empty.drafts": "Sin borradores: lo que empieces aparecerá aquí",
   "listings.mine.empty.archived": "Nada archivado, pausado, caducado ni vendido todavía",
+  "listings.mine.empty.removed": "Moderación no ha retirado nada tuyo",
   "listings.mine.blocked.title":
     "Moderación retiró {count} de tus anuncios",
   "listings.mine.blocked.title.one": "Moderación retiró uno de tus anuncios",
@@ -203,6 +218,8 @@ export const listingsI18nBundleEs: I18nDictionary = {
   "listings.mine.delete_confirm_title": "¿Borrar este anuncio?",
   "listings.mine.delete_confirm_body":
     "Desaparece de tu panel y no se puede recuperar. Archivarlo lo conserva.",
+  "listings.mine.delete_confirm_body.final":
+    "Desaparece de tu panel y no se puede recuperar.",
 
   "listings.favorites.title": "Favoritos",
   "listings.favorites.loading": "Cargando tus favoritos…",
@@ -222,6 +239,17 @@ export const listingsI18nBundleEs: I18nDictionary = {
   "error.400.listing_draft_meta_too_large":
     "El borrador es demasiado grande (máximo {max_bytes} bytes). Quita parte de los datos y guarda de nuevo.",
 
+  // stapel-listings 0.22.3: the features_draft WRITE now accepts the shape a
+  // listing READ returns. These three are the refusals for a body that is
+  // neither — read by whoever is wiring the integration, so each names the
+  // shape it wanted instead of advising "try again".
+  "error.400.listing_features_draft_shape":
+    "features_draft debe ser un objeto con los slugs de las características como claves, o la lista de objetos de característica que devuelve la lectura del anuncio (cada uno con su propio «slug»). Llegó: {got_type}. Ejemplo de la forma de objeto aceptada: {example}",
+  "error.400.listing_features_draft_unknown_slug":
+    "Cada elemento de una lista features_draft debe llevar su propio «slug» no vacío — el que la lectura del anuncio guarda en ese elemento — para poder archivarlo bajo la característica correcta. El elemento en el índice {index} no lo tiene. Ejemplo: {example}",
+  "error.400.listing_features_draft_value_shape":
+    "features_draft['{slug}'] debe ser a su vez un objeto de la forma {{\"type\": <tipo de característica>, \"value\": <valor de característica>}}. Llegó: {got_type}. Ejemplo: {example}",
+
   "listings.blocked.sign_in": "Inicia sesión para hacer esto",
   "listings.blocked.guest":
     "Esta cuenta todavía no puede hacerlo — termina de configurarla primero",

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

@@ -8,7 +8,7 @@ import type { ListingsErrorCode } from "./errors.gen.js";
 /**
  * `es` texts for the backend error codes this catalog carries.
  *
- * PARTIAL, and deliberately typed to say so: 27 key(s) owned by
+ * PARTIAL, and deliberately typed to say so: 30 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`

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

@@ -68,6 +68,9 @@ export const LISTINGS_ERRORS = {
   "error.400.invalid_ad_id": { status: 400, params: [], remediation: "fix_input", en: "Invalid advertisement ID" },
   "error.400.listing_draft_meta_too_large": { status: 400, params: ["max_bytes"], remediation: "fix_input", en: "draft_meta is too large ({max_bytes} bytes max)" },
   "error.400.listing_feature_not_allowed": { status: 400, params: ["feature"], remediation: "fix_input", en: "Feature '{feature}' is not allowed for this category" },
+  "error.400.listing_features_draft_shape": { status: 400, params: ["got_type","example"], remediation: "fix_input", en: "features_draft must be an object keyed by feature slug, or the list of feature objects a listing read returns (each carrying its own 'slug') — got {got_type}. Example of the accepted object form: {example}" },
+  "error.400.listing_features_draft_unknown_slug": { status: 400, params: ["index","example"], remediation: "fix_input", en: "Every entry of a features_draft list must carry its own non-empty 'slug' string (the slug a listing read stores on that element) so it can be filed back under the right feature — entry at index {index} has none. Example: {example}" },
+  "error.400.listing_features_draft_value_shape": { status: 400, params: ["slug","got_type","example"], remediation: "fix_input", en: "features_draft['{slug}'] must itself be an object of the form {{\"type\": <feature type>, \"value\": <feature value>}} — got {got_type}. Example: {example}" },
   "error.400.listing_invalid_status_filter": { status: 400, params: ["status"], remediation: "fix_input", en: "Unknown listing status '{status}'" },
   "error.400.listing_location_required": { status: 400, params: [], remediation: "fix_input", en: "Choose where the item is before publishing" },
   "error.400.listing_zero_price_not_allowed": { status: 400, params: [], remediation: "fix_input", en: "A price of 0 is not allowed in this category. Leave the price empty for \"price not stated\"." },
@@ -143,6 +146,9 @@ export const LISTINGS_ERROR_CODES: readonly ListingsErrorCode[] = [
   "error.400.invalid_ad_id",
   "error.400.listing_draft_meta_too_large",
   "error.400.listing_feature_not_allowed",
+  "error.400.listing_features_draft_shape",
+  "error.400.listing_features_draft_unknown_slug",
+  "error.400.listing_features_draft_value_shape",
   "error.400.listing_invalid_status_filter",
   "error.400.listing_location_required",
   "error.400.listing_zero_price_not_allowed",
@@ -220,6 +226,9 @@ export const listingsErrorBundleEn: Record<ListingsErrorCode, string> = {
   "error.400.invalid_ad_id": "Invalid advertisement ID",
   "error.400.listing_draft_meta_too_large": "draft_meta is too large ({max_bytes} bytes max)",
   "error.400.listing_feature_not_allowed": "Feature '{feature}' is not allowed for this category",
+  "error.400.listing_features_draft_shape": "features_draft must be an object keyed by feature slug, or the list of feature objects a listing read returns (each carrying its own 'slug') — got {got_type}. Example of the accepted object form: {example}",
+  "error.400.listing_features_draft_unknown_slug": "Every entry of a features_draft list must carry its own non-empty 'slug' string (the slug a listing read stores on that element) so it can be filed back under the right feature — entry at index {index} has none. Example: {example}",
+  "error.400.listing_features_draft_value_shape": "features_draft['{slug}'] must itself be an object of the form {{\"type\": <feature type>, \"value\": <feature value>}} — got {got_type}. Example: {example}",
   "error.400.listing_invalid_status_filter": "Unknown listing status '{status}'",
   "error.400.listing_location_required": "Choose where the item is before publishing",
   "error.400.listing_zero_price_not_allowed": "A price of 0 is not allowed in this category. Leave the price empty for \"price not stated\".",

package/src/i18n/generated/errors.json

@@ -286,6 +286,37 @@
     "remediation": "fix_input",
     "en": "Feature '{feature}' is not allowed for this category"
   },
+  {
+    "code": "error.400.listing_features_draft_shape",
+    "status": 400,
+    "params": [
+      "got_type",
+      "example"
+    ],
+    "remediation": "fix_input",
+    "en": "features_draft must be an object keyed by feature slug, or the list of feature objects a listing read returns (each carrying its own 'slug') — got {got_type}. Example of the accepted object form: {example}"
+  },
+  {
+    "code": "error.400.listing_features_draft_unknown_slug",
+    "status": 400,
+    "params": [
+      "index",
+      "example"
+    ],
+    "remediation": "fix_input",
+    "en": "Every entry of a features_draft list must carry its own non-empty 'slug' string (the slug a listing read stores on that element) so it can be filed back under the right feature — entry at index {index} has none. Example: {example}"
+  },
+  {
+    "code": "error.400.listing_features_draft_value_shape",
+    "status": 400,
+    "params": [
+      "slug",
+      "got_type",
+      "example"
+    ],
+    "remediation": "fix_input",
+    "en": "features_draft['{slug}'] must itself be an object of the form {{\"type\": <feature type>, \"value\": <feature value>}} — got {got_type}. Example: {example}"
+  },
   {
     "code": "error.400.listing_invalid_status_filter",
     "status": 400,

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

@@ -8,7 +8,7 @@ import type { ListingsErrorCode } from "./errors.gen.js";
 /**
  * `ru` texts for the backend error codes this catalog carries.
  *
- * PARTIAL, and deliberately typed to say so: 27 key(s) owned by
+ * PARTIAL, and deliberately typed to say so: 30 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 `ru`

package/src/i18n/keys.ts

@@ -79,6 +79,10 @@ export const LISTINGS_I18N_KEYS = {
    * requires one — an unnamed scrollable region is announced as nothing — and
    * the token bridge owns no i18n engine, so the copy is this pair's. */
   cardPhotos: "listings.card.photos",
+  /** "3 of 16" over a card's photo strip. The dots say WHERE in the strip a
+   * reader is; only a counter says how much of it there is, and the reference
+   * classifieds all carry one. */
+  cardPhotoCounter: "listings.card.photo_counter",
   /** The label on the struck-through previous price. The strike is styling and
    * a screen reader announces none of it, so the word is on the line. */
   cardPriceWas: "listings.card.price_was",
@@ -87,6 +91,35 @@ export const LISTINGS_I18N_KEYS = {
   cardPriceDropped: "listings.card.price_dropped",
   cardPriceRaised: "listings.card.price_raised",
 
+  // ── the action cluster: sharing, and what favouriting says back ──────────
+  /** The share control's caption AND its accessible name — one string, so a
+   * phone (icon only) and a desktop (icon + word) announce the same verb. */
+  shareAction: "listings.share.action",
+  /** The menu's first row: put the address on the clipboard. */
+  shareCopy: "listings.share.copy",
+  /** Stated INLINE in the menu and repeated as a toast — a confirmation that
+   * only ever appears in a toast is a confirmation a person who looked away
+   * never receives. */
+  shareCopied: "listings.share.copied",
+  /** The clipboard refused: no permission, an insecure origin, a browser
+   * without the API. Never swallowed — see `useShare`. */
+  shareCopyFailed: "listings.share.copy_failed",
+  /** The three networks. Proper nouns, and identical in every locale — they
+   * are keys all the same, because a pair that writes one literal string in
+   * a skin has written the next twenty somewhere else. */
+  shareTelegram: "listings.share.telegram",
+  shareWhatsapp: "listings.share.whatsapp",
+  shareVk: "listings.share.vk",
+  /** What the heart says back. The icon fill is the state; these two are the
+   * OUTCOME, spoken once, and they are what a person who pressed a small
+   * glyph at the corner of a photograph has to hear. */
+  favoriteAdded: "listings.favorite.added",
+  favoriteRemoved: "listings.favorite.removed",
+  /** How many people saved this one, when the surface was handed a number.
+   * The wire carries no such aggregate today (see `<ListingActions>`), so it
+   * is a host's fact and never a zero this pair invented. */
+  favoriteCount: "listings.favorite.count",
+
   // ── detail ───────────────────────────────────────────────────────────────
   detailLoading: "listings.detail.loading",
   detailLoadFailed: "listings.detail.load_failed",
@@ -192,6 +225,10 @@ export const LISTINGS_I18N_KEYS = {
   mineTabActive: "listings.mine.tab.active",
   mineTabDrafts: "listings.mine.tab.drafts",
   mineTabArchived: "listings.mine.tab.archived",
+  /** The fourth tab: the rows `my/counters` counts in none of the three
+   * (D407). Drawn only where there is something in it — see
+   * `model/status.ts`. */
+  mineTabRemoved: "listings.mine.tab.removed",
   mineLoading: "listings.mine.loading",
   mineLoadFailed: "listings.mine.load_failed",
   mineEmpty: "listings.mine.empty",
@@ -202,6 +239,10 @@ export const LISTINGS_I18N_KEYS = {
   mineEmptyActive: "listings.mine.empty.active",
   mineEmptyDrafts: "listings.mine.empty.drafts",
   mineEmptyArchived: "listings.mine.empty.archived",
+  /** Reachable by address (`?tab=removed`) rather than by clicking, since the
+   * tab is not drawn when it is empty — so the sentence is the good news it
+   * is, not a shrug. */
+  mineEmptyRemoved: "listings.mine.empty.removed",
   /** The takedowns — the rows no tab folds in (`my/counters` counts them in
    * none), shown outside the tabs so they cannot be missed. */
   mineBlockedTitle: "listings.mine.blocked.title",
@@ -234,7 +275,13 @@ export const LISTINGS_I18N_KEYS = {
   /** Deleting is irreversible, so it asks — through the shared SkinConfirm,
    * which is a bottom sheet on a phone. */
   mineDeleteConfirmTitle: "listings.mine.delete_confirm_title",
+  /** …offering the archive as the alternative, which it only is while
+   * `archived` is a move the listing still has. */
   mineDeleteConfirmBody: "listings.mine.delete_confirm_body",
+  /** The same warning for a row that has already spent that alternative — an
+   * archived, sold or taken-down listing. The archive tab's dialog used to
+   * promise the archive to a person standing in it. */
+  mineDeleteConfirmBodyFinal: "listings.mine.delete_confirm_body.final",
 
   // ── favourites ───────────────────────────────────────────────────────────
   favoritesTitle: "listings.favorites.title",
@@ -320,10 +367,22 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.card.untitled": "Untitled listing",
   "listings.card.sign_in": "Sign in",
   "listings.card.photos": "Photos of this listing",
+  "listings.card.photo_counter": "{index} of {total}",
   "listings.card.price_was": "Was",
   "listings.card.price_dropped": "The price went down",
   "listings.card.price_raised": "The price went up",
 
+  "listings.share.action": "Share",
+  "listings.share.copy": "Copy link",
+  "listings.share.copied": "Link copied",
+  "listings.share.copy_failed": "We could not copy the link — copy it from the address bar",
+  "listings.share.telegram": "Telegram",
+  "listings.share.whatsapp": "WhatsApp",
+  "listings.share.vk": "VK",
+  "listings.favorite.added": "Added to favourites",
+  "listings.favorite.removed": "Removed from favourites",
+  "listings.favorite.count": "{count} saved this",
+
   "listings.detail.loading": "Loading the listing…",
   "listings.detail.load_failed": "We could not load this listing",
   "listings.detail.retry": "Try again",
@@ -421,6 +480,7 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.mine.tab.active": "Active",
   "listings.mine.tab.drafts": "Drafts",
   "listings.mine.tab.archived": "Archived",
+  "listings.mine.tab.removed": "Taken down",
   "listings.mine.loading": "Loading your listings…",
   "listings.mine.load_failed": "We could not load your listings",
   "listings.mine.empty": "Nothing here yet",
@@ -429,6 +489,7 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.mine.empty.active": "Nothing of yours is live or awaiting review",
   "listings.mine.empty.drafts": "No drafts — anything you start appears here",
   "listings.mine.empty.archived": "Nothing archived, paused, expired or sold yet",
+  "listings.mine.empty.removed": "Nothing of yours has been taken down",
   "listings.mine.blocked.title":
     "{count} of your listings were taken down by moderation",
   "listings.mine.blocked.title.one":
@@ -452,6 +513,8 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.mine.delete_confirm_title": "Delete this listing?",
   "listings.mine.delete_confirm_body":
     "It disappears from your dashboard and cannot be brought back. Archiving keeps it.",
+  "listings.mine.delete_confirm_body.final":
+    "It disappears from your dashboard and cannot be brought back.",
 
   "listings.favorites.title": "Favourites",
   "listings.favorites.loading": "Loading your favourites…",

package/src/i18n/ru.ts

@@ -97,10 +97,23 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.card.untitled": "Объявление без названия",
   "listings.card.sign_in": "Войти",
   "listings.card.photos": "Фотографии объявления",
+  "listings.card.photo_counter": "{index} из {total}",
   "listings.card.price_was": "Было",
   "listings.card.price_dropped": "Цена снизилась",
   "listings.card.price_raised": "Цена выросла",
 
+  "listings.share.action": "Поделиться",
+  "listings.share.copy": "Скопировать ссылку",
+  "listings.share.copied": "Ссылка скопирована",
+  "listings.share.copy_failed":
+    "Не удалось скопировать ссылку — скопируйте её из адресной строки",
+  "listings.share.telegram": "Telegram",
+  "listings.share.whatsapp": "WhatsApp",
+  "listings.share.vk": "ВКонтакте",
+  "listings.favorite.added": "Добавлено в избранное",
+  "listings.favorite.removed": "Убрано из избранного",
+  "listings.favorite.count": "В избранном у {count}",
+
   "listings.detail.loading": "Загружаем объявление…",
   "listings.detail.load_failed": "Не удалось загрузить объявление",
   "listings.detail.retry": "Повторить",
@@ -196,6 +209,7 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.mine.tab.active": "Активные",
   "listings.mine.tab.drafts": "Черновики",
   "listings.mine.tab.archived": "Архив",
+  "listings.mine.tab.removed": "Снятые",
   "listings.mine.loading": "Загружаем ваши объявления…",
   "listings.mine.load_failed": "Не удалось загрузить ваши объявления",
   "listings.mine.empty": "Здесь пока пусто",
@@ -204,6 +218,7 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.mine.empty.active": "Ни одно ваше объявление не опубликовано и не ждёт проверки",
   "listings.mine.empty.drafts": "Черновиков нет — всё начатое появится здесь",
   "listings.mine.empty.archived": "Пока ничего не в архиве, не снято, не истекло и не продано",
+  "listings.mine.empty.removed": "Модерация ничего у вас не снимала",
   "listings.mine.blocked.title":
     "Модерация сняла ваших объявлений: {count}",
   "listings.mine.blocked.title.one": "Модерация сняла одно ваше объявление",
@@ -226,6 +241,8 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.mine.delete_confirm_title": "Удалить объявление?",
   "listings.mine.delete_confirm_body":
     "Оно исчезнет из кабинета, и вернуть его будет нельзя. Архив сохраняет его.",
+  "listings.mine.delete_confirm_body.final":
+    "Оно исчезнет из кабинета, и вернуть его будет нельзя.",
 
   "listings.favorites.title": "Избранное",
   "listings.favorites.loading": "Загружаем избранное…",
@@ -249,6 +266,17 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "error.400.listing_draft_meta_too_large":
     "Черновик слишком большой (не больше {max_bytes} байт). Уберите часть данных и сохраните ещё раз.",
 
+  // stapel-listings 0.22.3: the features_draft WRITE now accepts the shape a
+  // listing READ returns. These three are the refusals for a body that is
+  // neither — read by whoever is wiring the integration, so each names the
+  // shape it wanted instead of advising "try again".
+  "error.400.listing_features_draft_shape":
+    "features_draft должен быть объектом со слагами признаков в ключах — или тем списком объектов признаков, который возвращает чтение объявления (у каждого свой «slug»). Пришло: {got_type}. Пример принимаемой формы объекта: {example}",
+  "error.400.listing_features_draft_unknown_slug":
+    "У каждого элемента списка features_draft должен быть свой непустой «slug» — тот, который чтение объявления хранит на этом элементе, иначе значение некуда положить. У элемента с индексом {index} его нет. Пример: {example}",
+  "error.400.listing_features_draft_value_shape":
+    "features_draft['{slug}'] сам должен быть объектом вида {{\"type\": <тип признака>, \"value\": <значение признака>}}. Пришло: {got_type}. Пример: {example}",
+
   "listings.blocked.sign_in": "Войдите, чтобы сделать это",
   "listings.blocked.guest":
     "Этот аккаунт пока так не может — сначала завершите настройку",