@stapel/listings-react 0.4.0 → 0.8.0

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

@@ -74,6 +74,7 @@ export const LISTINGS_ERRORS = {
   "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_anonymous_not_allowed": { status: 403, params: [], remediation: "retry", en: "A guest account may not publish a listing" },
   "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" },
@@ -144,6 +145,7 @@ export const LISTINGS_ERROR_CODES: readonly ListingsErrorCode[] = [
   "error.401.unauthorized",
   "error.402.payment_required",
   "error.403.forbidden",
+  "error.403.listing_anonymous_not_allowed",
   "error.403.listing_not_owner",
   "error.403.network_blocked",
   "error.403.verification_enrollment_required",
@@ -216,6 +218,7 @@ export const listingsErrorBundleEn: Record<ListingsErrorCode, string> = {
   "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_anonymous_not_allowed": "A guest account may not publish a listing",
   "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",

package/src/i18n/generated/errors.json

@@ -326,6 +326,13 @@
     "remediation": "retry",
     "en": "You do not have permission to perform this action"
   },
+  {
+    "code": "error.403.listing_anonymous_not_allowed",
+    "status": 403,
+    "params": [],
+    "remediation": "retry",
+    "en": "A guest account may not publish a listing"
+  },
   {
     "code": "error.403.listing_not_owner",
     "status": 403,

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: 22 key(s) owned by
+ * PARTIAL, and deliberately typed to say so: 23 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

@@ -62,7 +62,17 @@ export const LISTINGS_I18N_KEYS = {
   cardPriceAbsent: "listings.card.price_absent",
   cardFavoriteAdd: "listings.card.favorite_add",
   cardFavoriteRemove: "listings.card.favorite_remove",
-  cardOpen: "listings.card.open",
+  /**
+   * The accessible name of a card whose listing has no title.
+   *
+   * The whole card is ONE anchor now, and an anchor's name is its `aria-label`
+   * — so a titleless listing would otherwise be a link announced as nothing at
+   * all, in a list of forty.
+   *
+   * This replaces `listings.card.open` (retired), which named a separate
+   * "Open" control that no longer exists: the card itself is the control.
+   */
+  cardUntitled: "listings.card.untitled",
   /** The door beside a blocked favourite: the container supplies WHERE. */
   cardSignIn: "listings.card.sign_in",
 
@@ -88,6 +98,9 @@ export const LISTINGS_I18N_KEYS = {
    * quantity in the value cell, so this key carries no `{count}` — it used to,
    * and the live page printed the placeholder. */
   detailStock: "listings.detail.stock",
+  /** The owner's two primaries on their own listing page. */
+  detailEdit: "listings.detail.edit",
+  detailTakeDown: "listings.detail.take_down",
 
   // ── composer ─────────────────────────────────────────────────────────────
   composeNewTitle: "listings.compose.new_title",
@@ -103,8 +116,7 @@ export const LISTINGS_I18N_KEYS = {
   composePriceInvalid: "listings.compose.price_invalid",
   composeCurrencyLabel: "listings.compose.currency_label",
   composeLocationLabel: "listings.compose.location_label",
-  composeLatLabel: "listings.compose.lat_label",
-  composeLonLabel: "listings.compose.lon_label",
+  composeLocationHelp: "listings.compose.location_help",
   composeGeoIncomplete: "listings.compose.geo_incomplete",
   composePhotos: "listings.compose.photos",
   composeTooManyImages: "listings.compose.too_many_images",
@@ -132,6 +144,10 @@ export const LISTINGS_I18N_KEYS = {
   composeBlockedNoDraft: "listings.compose.blocked.no_draft",
   composeBlockedBusy: "listings.compose.blocked.busy",
   composeBlockedMirror: "listings.compose.blocked.mirror",
+  /** The same refusal BEFORE anything is marked: "fix the highlighted fields"
+   * pointed at nothing highlighted, because the mirror only becomes visible
+   * once the person has tried to publish. */
+  composeBlockedIncomplete: "listings.compose.blocked.incomplete",
   composeBlockedDetailsUnavailable: "listings.compose.blocked.details_unavailable",
 
   // ── the owner's dashboard ────────────────────────────────────────────────
@@ -158,12 +174,18 @@ export const LISTINGS_I18N_KEYS = {
   mineArchive: "listings.mine.archive",
   mineComplete: "listings.mine.complete",
   mineDelete: "listings.mine.delete",
+  /** Deleting is irreversible, so it asks — through the shared SkinConfirm,
+   * which is a bottom sheet on a phone. */
+  mineDeleteConfirmTitle: "listings.mine.delete_confirm_title",
+  mineDeleteConfirmBody: "listings.mine.delete_confirm_body",
 
   // ── favourites ───────────────────────────────────────────────────────────
   favoritesTitle: "listings.favorites.title",
   favoritesLoading: "listings.favorites.loading",
   favoritesLoadFailed: "listings.favorites.load_failed",
   favoritesEmpty: "listings.favorites.empty",
+  favoritesEmptyHint: "listings.favorites.empty_hint",
+  favoritesSignInHint: "listings.favorites.sign_in_hint",
 
   // ── gates shared by every action a visitor cannot take ───────────────────
   blockedSignIn: "listings.blocked.sign_in",
@@ -174,10 +196,15 @@ export const LISTINGS_I18N_KEYS = {
   blockedTransition: "listings.blocked.transition",
   blockedDeleteActive: "listings.blocked.delete_active",
   blockedInFlight: "listings.blocked.in_flight",
+  /** Editing is a SCREEN, not an endpoint: whether this app has one is the
+   * container's fact, and a host that wires no `onEdit` gets a switched-off
+   * button that says so instead of one that silently does nothing. */
+  blockedNoEditor: "listings.blocked.no_editor",
 
   // ── keyset pagination ────────────────────────────────────────────────────
   pagePrev: "listings.page.prev",
   pageNext: "listings.page.next",
+  pageIndicator: "listings.page.indicator",
 
   // ── nav labels ───────────────────────────────────────────────────────────
   navDetail: "listings.nav.detail",
@@ -229,7 +256,7 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.card.price_absent": "Price on request",
   "listings.card.favorite_add": "Save to favourites",
   "listings.card.favorite_remove": "Remove from favourites",
-  "listings.card.open": "Open",
+  "listings.card.untitled": "Untitled listing",
   "listings.card.sign_in": "Sign in",
 
   "listings.detail.loading": "Loading the listing…",
@@ -252,6 +279,8 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.detail.published_at": "Published {date}",
   "listings.detail.expires_at": "Listed until {date}",
   "listings.detail.stock": "In stock",
+  "listings.detail.edit": "Edit listing",
+  "listings.detail.take_down": "Take it down",
 
   "listings.compose.new_title": "New listing",
   "listings.compose.edit_title": "Edit listing",
@@ -270,8 +299,8 @@ export const listingsI18nBundleEn: Record<string, string> = {
     "Enter a price as a number, with at most two decimals",
   "listings.compose.currency_label": "Currency",
   "listings.compose.location_label": "Where it is",
-  "listings.compose.lat_label": "Latitude",
-  "listings.compose.lon_label": "Longitude",
+  "listings.compose.location_help":
+    "Buyers filter by distance, so a listing with no place is a listing they will not find",
   "listings.compose.geo_incomplete":
     "A latitude needs a longitude beside it — half a coordinate points nowhere",
   "listings.compose.photos": "Photos",
@@ -300,14 +329,18 @@ export const listingsI18nBundleEn: Record<string, string> = {
 
   "listings.compose.blocked.no_category":
     "Choose a category — the rest of the form depends on it",
+  // No `{types}`: the editor type is this build's vocabulary (`size_grid`),
+  // and a seller can do nothing with it. The fact they CAN act on is that
+  // this listing has to be finished somewhere else.
   "listings.compose.blocked.unsupported_type":
-    "This category asks for a kind of detail this app cannot show yet ({types}), so it cannot fill it in for you",
+    "This category asks for a kind of detail this app cannot show yet, so the listing cannot be completed here",
   "listings.compose.blocked.photos_pending":
     "Wait for the photos to finish uploading",
   "listings.compose.blocked.no_draft": "The draft has not been created yet",
   "listings.compose.blocked.busy": "One moment — the last change is still saving",
   "listings.compose.blocked.mirror":
     "Fix the highlighted fields first",
+  "listings.compose.blocked.incomplete": "{count} required details are still empty",
   "listings.compose.blocked.details_unavailable":
     "We could not load what this category asks for, so we cannot check the form",
 
@@ -325,6 +358,10 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.mine.empty.archived": "Nothing archived, paused, expired or sold yet",
   "listings.mine.blocked.title":
     "{count} of your listings were taken down by moderation",
+  "listings.mine.blocked.title.one":
+    "One of your listings was taken down by moderation",
+  "listings.mine.blocked.title.other":
+    "{count} of your listings were taken down by moderation",
   "listings.mine.blocked.load_failed":
     "We could not check whether any of your listings were taken down",
   "listings.mine.live_under_review":
@@ -333,11 +370,18 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.mine.archive": "Archive",
   "listings.mine.complete": "Mark sold",
   "listings.mine.delete": "Delete",
+  "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.favorites.title": "Favourites",
   "listings.favorites.loading": "Loading your favourites…",
   "listings.favorites.load_failed": "We could not load your favourites",
   "listings.favorites.empty": "You have not saved anything yet",
+  "listings.favorites.empty_hint":
+    "Tap the heart on any listing and it will be waiting here.",
+  "listings.favorites.sign_in_hint":
+    "Favourites are kept with your account, so they follow you between devices.",
 
   "listings.blocked.sign_in": "Sign in to do this",
   "listings.blocked.guest":
@@ -349,9 +393,12 @@ export const listingsI18nBundleEn: Record<string, string> = {
   "listings.blocked.delete_active":
     "Archive it first — a listing that is on sale cannot be deleted",
   "listings.blocked.in_flight": "One moment — that is already under way",
+  "listings.blocked.no_editor":
+    "This app has no screen for editing a listing yet",
 
   "listings.page.prev": "Previous",
   "listings.page.next": "Next",
+  "listings.page.indicator": "Page {page}",
 
   "listings.nav.detail": "Listing",
   "listings.nav.compose": "Post a listing",

package/src/i18n/ru.ts

@@ -1,4 +1,5 @@
 import type { I18nDictionary, I18nEngine } from "@stapel/core";
+import { registerAttributesI18nRu } from "@stapel/attributes-react/i18n/ru";
 import { listingsErrorBundleRu } from "./generated/errors.ru.gen.js";
 
 export { listingsErrorBundleRu } from "./generated/errors.ru.gen.js";
@@ -47,6 +48,8 @@ export const listingsI18nBundleRu: I18nDictionary = {
     "Неизвестный статус объявления: «{status}»",
   "error.400.publish_validation_failed":
     "Объявление не прошло проверку и не опубликовано",
+  "error.403.listing_anonymous_not_allowed":
+    "Чтобы подать объявление, войдите или зарегистрируйтесь",
   "error.403.listing_not_owner": "Это не ваше объявление",
   "error.404.listing_not_found": "Объявление не найдено",
   "error.409.already_favorited": "Объявление уже в избранном",
@@ -87,7 +90,7 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.card.price_absent": "Цена по запросу",
   "listings.card.favorite_add": "В избранное",
   "listings.card.favorite_remove": "Убрать из избранного",
-  "listings.card.open": "Открыть",
+  "listings.card.untitled": "Объявление без названия",
   "listings.card.sign_in": "Войти",
 
   "listings.detail.loading": "Загружаем объявление…",
@@ -110,6 +113,8 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.detail.published_at": "Опубликовано {date}",
   "listings.detail.expires_at": "В продаже до {date}",
   "listings.detail.stock": "В наличии",
+  "listings.detail.edit": "Редактировать объявление",
+  "listings.detail.take_down": "Снять с публикации",
 
   "listings.compose.new_title": "Новое объявление",
   "listings.compose.edit_title": "Редактирование объявления",
@@ -128,8 +133,8 @@ export const listingsI18nBundleRu: I18nDictionary = {
     "Введите цену числом, не более двух знаков после запятой",
   "listings.compose.currency_label": "Валюта",
   "listings.compose.location_label": "Где находится",
-  "listings.compose.lat_label": "Широта",
-  "listings.compose.lon_label": "Долгота",
+  "listings.compose.location_help":
+    "Покупатели ищут по расстоянию — объявление без места они просто не найдут",
   "listings.compose.geo_incomplete":
     "Рядом с широтой нужна долгота — половина координаты никуда не указывает",
   "listings.compose.photos": "Фотографии",
@@ -160,12 +165,13 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.compose.blocked.no_category":
     "Выберите категорию — от неё зависит остальная форма",
   "listings.compose.blocked.unsupported_type":
-    "Эта категория спрашивает характеристику, которую приложение пока не умеет показывать ({types}), поэтому заполнить её здесь нельзя",
+    "Эта категория спрашивает характеристику, которую приложение пока не умеет показывать, поэтому закончить объявление здесь нельзя",
   "listings.compose.blocked.photos_pending":
     "Дождитесь окончания загрузки фотографий",
   "listings.compose.blocked.no_draft": "Черновик ещё не создан",
   "listings.compose.blocked.busy":
     "Секунду — предыдущее изменение ещё сохраняется",
+  "listings.compose.blocked.incomplete": "Не заполнено обязательных деталей: {count}",
   "listings.compose.blocked.mirror": "Сначала поправьте отмеченные поля",
   "listings.compose.blocked.details_unavailable":
     "Не удалось загрузить характеристики категории, поэтому проверить форму нельзя",
@@ -184,6 +190,10 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.mine.empty.archived": "Пока ничего не в архиве, не снято, не истекло и не продано",
   "listings.mine.blocked.title":
     "Модерация сняла ваших объявлений: {count}",
+  "listings.mine.blocked.title.one": "Модерация сняла одно ваше объявление",
+  "listings.mine.blocked.title.few": "Модерация сняла {count} ваших объявления",
+  "listings.mine.blocked.title.many": "Модерация сняла {count} ваших объявлений",
+  "listings.mine.blocked.title.other": "Модерация сняла ваших объявлений: {count}",
   "listings.mine.blocked.load_failed":
     "Не удалось проверить, снимала ли модерация ваши объявления",
   "listings.mine.live_under_review": "Опубликовано, правки на проверке",
@@ -191,11 +201,18 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.mine.archive": "В архив",
   "listings.mine.complete": "Отметить проданным",
   "listings.mine.delete": "Удалить",
+  "listings.mine.delete_confirm_title": "Удалить объявление?",
+  "listings.mine.delete_confirm_body":
+    "Оно исчезнет из кабинета, и вернуть его будет нельзя. Архив сохраняет его.",
 
   "listings.favorites.title": "Избранное",
   "listings.favorites.loading": "Загружаем избранное…",
   "listings.favorites.load_failed": "Не удалось загрузить избранное",
   "listings.favorites.empty": "Вы ещё ничего не сохранили",
+  "listings.favorites.empty_hint":
+    "Нажмите на сердечко в любом объявлении — оно будет ждать здесь.",
+  "listings.favorites.sign_in_hint":
+    "Избранное хранится в аккаунте, поэтому переходит с вами на другие устройства.",
 
   "listings.blocked.sign_in": "Войдите, чтобы сделать это",
   "listings.blocked.guest":
@@ -207,9 +224,12 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.blocked.delete_active":
     "Сначала уберите в архив — объявление в продаже удалить нельзя",
   "listings.blocked.in_flight": "Секунду — это уже выполняется",
+  "listings.blocked.no_editor":
+    "В этом приложении пока нет экрана редактирования объявления",
 
   "listings.page.prev": "Назад",
   "listings.page.next": "Дальше",
+  "listings.page.indicator": "Страница {page}",
 
   "listings.nav.detail": "Объявление",
   "listings.nav.compose": "Подать объявление",
@@ -217,7 +237,23 @@ export const listingsI18nBundleRu: I18nDictionary = {
   "listings.nav.favorites": "Избранное",
 };
 
-/** Register the Russian bundle into a core i18n engine. */
+/**
+ * Register the Russian bundle into a core i18n engine — AND the twelve
+ * `stapel_attributes` sentences this pair deliberately does not author.
+ *
+ * The split of ownership is right and stays: two packages must not give one
+ * refusal two sentences. What was wrong was leaving the JOIN to a README. A
+ * host that registered only this bundle got twelve of the composer's most
+ * common refusals ("this value is below the minimum", "the description is too
+ * long") in English on a Russian page, and nothing failed anywhere to say so.
+ *
+ * `@stapel/attributes-react` is a peer of this pair and its editors are what
+ * RAISE those twelve, so a listings-ru host is an attributes-ru host by
+ * construction; chaining the registration states that instead of asking. It is
+ * idempotent — a host that also registers the bundle itself simply writes the
+ * same keys twice.
+ */
 export function registerListingsI18nRu(i18n: I18nEngine): void {
+  registerAttributesI18nRu(i18n);
   i18n.registerBundle("ru", listingsI18nBundleRu);
 }

package/src/index.ts

@@ -214,7 +214,11 @@ export type {
 
 // ── headless (renderless components + their bags) ────────────────────────────
 export { ListingsProvider } from "./headless/ListingsProvider.js";
-export { useMandateGate } from "./headless/useMandateGate.js";
+export {
+  useMandateGate,
+  useElevatableMandateGate,
+  LISTINGS_ELEVATION_ACTIONS,
+} from "./headless/useMandateGate.js";
 export { ListingDetail, useListingDetail } from "./headless/ListingDetail.js";
 export type {
   ListingDetailBag,

package/src/model/draft.ts

@@ -29,12 +29,14 @@ import { DEFAULT_LISTING_CURRENCY } from "../api/types.js";
  * `geohash` that disagrees with the coordinates beside it is worse than no
  * geohash — the pin and the bucket point at different places.
  *
- * The pair does NOT compute `geohash` from `lat`/`lon`, and that is a
- * decision. A geohash is precision-dependent, the indexer's bucketing depends
- * on which precision was used, and a client that picked its own would put
- * listings in neighbouring cells for reasons nobody could see. It is written
- * by whatever resolved the place (a geo picker, `stapel-geo`) and carried
- * verbatim from there to the wire.
+ * `geohash` is SERVER-COMPUTED and read-only since stapel-listings 0.7.1.
+ * `Listing.save()` stamps `geohash_draft` from `lat_draft`/`lon_draft` through
+ * the `geo.geohash_encode` comm function, and `ListingDraftSerializer` marks
+ * the field `readOnly` — a value sent in the request body is silently ignored.
+ * So this member is something the composer READS BACK (a reopened draft, a
+ * published listing) and never something it sends: `draftPatchFromValues`
+ * omits it, and a picker that happens to know a geohash may keep it for its
+ * own display without expecting the wire to carry it.
  */
 export interface ListingLocation {
   /** Opaque id from whatever place directory the deployment uses. */
@@ -45,6 +47,7 @@ export interface ListingLocation {
    * `55.796100` into `55.7961` and change what was submitted. */
   readonly lat: string | null;
   readonly lon: string | null;
+  /** Read-only: the server computes it from `lat`/`lon` (0.7.1). Never sent. */
   readonly geohash: string;
 }
 
@@ -242,7 +245,9 @@ export function draftPatchFromValues(
     images_draft: [...values.images],
     location_id_draft: values.location.locationId,
     location_label_draft: values.location.locationLabel,
-    geohash_draft: values.location.geohash,
+    // No `geohash_draft`: stapel-listings 0.7.1 computes it in `Listing.save()`
+    // from the coordinates and marks the serializer field read-only, so a value
+    // sent here is discarded. Sending one would be a claim the wire ignores.
     lat_draft: values.location.lat,
     lon_draft: values.location.lon,
     features_draft: toWireFeatures(features, values.features),

package/src/model/features.ts

@@ -22,14 +22,28 @@
  * `order`, `title`, `badge`) are simply ignored by every formatter. Copying a
  * hand-picked subset instead would be a list to keep in step with ten types.
  *
- * ── What a DAO does NOT carry ──────────────────────────────────────────────
+ * ── What a DAO does NOT carry, and the one line that repairs it ────────────
  *
- * `select`'s `options`. `normalize_to_dao` stores the chosen VALUES, not the
- * option table, so `formatFeatureValue` falls back to the raw option value —
- * which is a translation KEY when the config is translatable (the default),
- * so a host whose bundle carries the catalogue's option copy still reads a
- * word. A host whose bundle does not sees the key, on purpose: a visible
- * `option.condition.used` gets fixed, an invented "Used" ships wrong.
+ * `select`'s `options`. `SelectType.dto_to_dao` stores the chosen VALUES and
+ * the ui config, never the option table — the table lives on the CATEGORY, and
+ * not needing it is the whole point of the projection.
+ *
+ * The consequence was a defect the visual pass caught on every card and every
+ * spec row: `formatFeatureValue` resolves an option's copy by looking the
+ * value up in `config.options`, and with no table it falls through to
+ * `String(value)`. The stored value of a translatable catalogue IS a
+ * translation key, so a listing page printed `demo.condition.used` and
+ * `demo.brand.bosch` at people. (The server does not have this problem: its
+ * own `format_value` has the category's config in hand.)
+ *
+ * So the split below synthesizes the IDENTITY table — `{value: v, label: v}`
+ * for each stored value — which is exactly the table a translatable catalogue
+ * would have produced, since its labels ARE the keys. `formatFeatureValue`
+ * then runs the value through the host's `t` and a bundle carrying the
+ * catalogue copy reads "Used". A bundle that does not still shows the key, on
+ * purpose: a visible `option.condition.used` gets fixed, an invented "Used"
+ * ships wrong. A NON-translatable catalogue stores literal labels, `t` returns
+ * an unknown key unchanged, and the output is what it always was.
  */
 import type { FeatureDef, FeatureValueDto } from "@stapel/attributes-react";
 import type { ListingFeatureDao, ListingFeatureView } from "../api/types.js";
@@ -37,6 +51,31 @@ import type { ListingFeatureDao, ListingFeatureView } from "../api/types.js";
 /** Keys that belong to the DAO envelope rather than to the type's config. */
 const ENVELOPE = new Set(["slug", "value", "name", "order", "title", "badge"]);
 
+/** The two types whose stored `value` is an option key rather than the thing
+ * itself. `hierarchical_select` is deliberately absent: its formatter joins
+ * the path with " / " and never consults an option table at all. */
+const OPTION_VALUED = new Set(["select"]);
+
+/**
+ * The identity option table for a stored `select` — see the module header.
+ *
+ * Returns `undefined` when there is nothing to add (another type, a config
+ * that already carries a table, a value that is not a list of strings), so the
+ * common path allocates nothing and a DAO that DOES carry options is left
+ * exactly as it arrived.
+ */
+function synthesizedOptions(
+  dao: ListingFeatureDao,
+  config: Readonly<Record<string, unknown>>
+): readonly { value: string; label: string }[] | undefined {
+  if (typeof dao.type !== "string" || !OPTION_VALUED.has(dao.type)) return undefined;
+  if (Array.isArray(config["options"])) return undefined;
+  const raw = Array.isArray(dao.value) ? dao.value : [dao.value];
+  const values = raw.filter((item): item is string => typeof item === "string");
+  if (values.length === 0) return undefined;
+  return values.map((value) => ({ value, label: value }));
+}
+
 /**
  * One DAO row → the definition/value pair the display half consumes.
  *
@@ -54,6 +93,8 @@ export function featureFromDao(
   for (const [key, value] of Object.entries(dao)) {
     if (!ENVELOPE.has(key)) config[key] = value;
   }
+  const options = synthesizedOptions(dao, config);
+  if (options !== undefined) config["options"] = options;
 
   const feature: FeatureDef = {
     slug: dao.slug,

package/dist/default/ErrorAlert.d.ts

@@ -1,9 +0,0 @@
-import type { CSSProperties, ReactElement, ReactNode } from "react";
-import type { FlowErrorDisplay } from "@stapel/core";
-export declare function ErrorAlert(props: {
-    error: FlowErrorDisplay | undefined;
-    style?: CSSProperties | undefined;
-    testId?: string | undefined;
-    action?: ReactNode;
-}): ReactElement | null;
-//# sourceMappingURL=ErrorAlert.d.ts.map

package/dist/default/ErrorAlert.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ErrorAlert.d.ts","sourceRoot":"","sources":["../../src/default/ErrorAlert.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,GAAG,YAAY,GAAG,IAAI,CAsBtB"}

package/dist/default/ErrorAlert.js

@@ -1,27 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * The one error surface this pair's default skin renders, so the split copy
- * core produces reaches a screen the same way everywhere (mirrors the
- * docs/notifications/workspaces etalon).
- *
- * Core's `describeFlowError` splits a failure into the sentence a person
- * reads and the technical detail a support agent quotes (owner report
- * 2026-08-09: the status used to be spliced into the sentence, ending in a
- * bare `" (500)"`). The split only helps if a skin renders both halves at
- * their own weights: `message` at normal weight, `detail` muted and small.
- *
- * `undefined` in — including a `detail` core left `undefined` because there
- * was nothing worth quoting — renders nothing rather than an empty line.
- */
-import { Alert, Typography } from "antd";
-export function ErrorAlert(props) {
-    const { error } = props;
-    if (!error)
-        return null;
-    return (_jsx(Alert, { type: "error", showIcon: true, ...(props.style ? { style: props.style } : {}), ...(props.testId ? { "data-testid": props.testId } : {}), ...(props.action ? { action: props.action } : {}), message: error.message, ...(error.detail
-            ? {
-                description: (_jsx(Typography.Text, { type: "secondary", style: { fontSize: 12 }, children: error.detail })),
-            }
-            : {}) }));
-}
-//# sourceMappingURL=ErrorAlert.js.map

package/dist/default/ErrorAlert.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ErrorAlert.js","sourceRoot":"","sources":["../../src/default/ErrorAlert.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAIzC,MAAM,UAAU,UAAU,CAAC,KAK1B;IACC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,CACL,KAAC,KAAK,IACJ,IAAI,EAAC,OAAO,EACZ,QAAQ,WACJ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAC3C,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACrD,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAClD,OAAO,EAAE,KAAK,CAAC,OAAO,KAClB,CAAC,KAAK,CAAC,MAAM;YACf,CAAC,CAAC;gBACE,WAAW,EAAE,CACX,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,EAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YACtD,KAAK,CAAC,MAAM,GACG,CACnB;aACF;YACH,CAAC,CAAC,EAAE,CAAC,GACP,CACH,CAAC;AACJ,CAAC"}

package/dist/default/theme.d.ts

@@ -1,25 +0,0 @@
-import type { CSSProperties, ReactElement, ReactNode } from "react";
-import type { ThemeMode } from "@stapel/tokens-antd";
-export interface ListingsSkinThemeProps {
-    /**
-     * Light or dark. Defaults to the mode the host's document declares
-     * (`resolveThemeMode()`). Pass explicitly to pin a side.
-     */
-    readonly mode?: ThemeMode;
-    /** Extra styles merged onto the themed root element (layout only — colors
-     * come from the mode). */
-    readonly style?: CSSProperties;
-    readonly children: ReactNode;
-}
-/**
- * `<ListingsSkinTheme/>` — the self-theming wrapper of
- * `@stapel/listings-react/default`. Standalone use is supported (wrap any
- * composition of the skin's parts once); the shipped surfaces
- * (`ListingCard`, `ListingDetailPane`, `ListingComposerPage`,
- * `MyListingsPane`, `FavoritesPane`)
- * each already wrap themselves, and nested antd
- * `ConfigProvider`s merge, so composing them under one `ListingsSkinTheme`
- * stays correct.
- */
-export declare function ListingsSkinTheme(props: ListingsSkinThemeProps): ReactElement;
-//# sourceMappingURL=theme.d.ts.map

package/dist/default/theme.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/default/theme.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B;8BAC0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAmB7E"}

package/dist/default/theme.js

@@ -1,40 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * The default skin's INTERNAL theme provider — every `/default` surface wraps
- * itself in this, so the skin is readable no matter what the host supplies
- * (tracker #26: a skin set with no internal provider once inherited a theme
- * bridge serving light-mode values inside a dark document — text on
- * background at 1.00:1). The theme derives from `@stapel/tokens` via
- * `@stapel/tokens-antd`'s `toAntdThemeConfig(mode)`; `mode` defaults to what
- * the HOST's document declares (`resolveThemeMode()` — the `data-theme`
- * attribute `tokens.css` keys its dark block on), never to a hardcoded side.
- *
- * This is also what "override styles" means for this pair: a storefront
- * retheming through the §68 token JSON regenerates its `--stapel-*` custom
- * properties and the result page follows with zero code — a far better deal
- * than a prop-per-colour API, and the reason the skin has none.
- */
-import { useMemo } from "react";
-import { ConfigProvider } from "antd";
-import { resolveThemeMode, toAntdTheme, toAntdThemeConfig, } from "@stapel/tokens-antd";
-/**
- * `<ListingsSkinTheme/>` — the self-theming wrapper of
- * `@stapel/listings-react/default`. Standalone use is supported (wrap any
- * composition of the skin's parts once); the shipped surfaces
- * (`ListingCard`, `ListingDetailPane`, `ListingComposerPage`,
- * `MyListingsPane`, `FavoritesPane`)
- * each already wrap themselves, and nested antd
- * `ConfigProvider`s merge, so composing them under one `ListingsSkinTheme`
- * stays correct.
- */
-export function ListingsSkinTheme(props) {
-    const mode = props.mode ?? resolveThemeMode();
-    const theme = useMemo(() => toAntdThemeConfig(mode), [mode]);
-    const token = useMemo(() => toAntdTheme(mode), [mode]);
-    return (_jsx(ConfigProvider, { theme: theme, children: _jsx("div", { "data-listings-skin-root": true, "data-listings-skin-mode": mode, style: {
-                color: token.colorText,
-                backgroundColor: token.colorBgContainer,
-                ...props.style,
-            }, children: props.children }) }));
-}
-//# sourceMappingURL=theme.js.map

package/dist/default/theme.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/default/theme.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAe7B;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO,CACL,KAAC,cAAc,IAAC,KAAK,EAAE,KAAK,YAC1B,0EAE2B,IAAI,EAC7B,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,eAAe,EAAE,KAAK,CAAC,gBAAgB;gBACvC,GAAG,KAAK,CAAC,KAAK;aACf,YAEA,KAAK,CAAC,QAAQ,GACX,GACS,CAClB,CAAC;AACJ,CAAC"}