@stapel/listings-react 0.1.0

package/dist/i18n/ru.js

@@ -0,0 +1,162 @@
+import { listingsErrorBundleRu } from "./generated/errors.ru.gen.js";
+export { listingsErrorBundleRu } from "./generated/errors.ru.gen.js";
+/**
+ * Russian bundle for listings-react — the `@stapel/listings-react/i18n/ru`
+ * subpath (i18n-shipping.md §2) so the locale is opt-in: hosts that do not
+ * register it never carry these strings (the main entry does not import this
+ * module — gated by size-limit + the bundle-purity test).
+ *
+ * This is the storefront's DEFAULT language (darom-storefront verdict F1:
+ * ru-first), which is why the UI copy is here in full and not only the error
+ * keys: a seller filling in a listing is the surface where a half-translated
+ * form is most obvious.
+ *
+ * ── What comes from where ──────────────────────────────────────────────────
+ *
+ * `stapel-listings` ships **no `translations/` directory at all**, so 21 of
+ * the 63 registry codes can never come from an upstream catalogue. They split
+ * by owner:
+ *
+ *  - the 42 cross-cutting `stapel_core` codes are GENERATED, merged in from
+ *    stapel-core's own catalogue by `pnpm gen:errors` (spread first below);
+ *  - the **9 `stapel_listings` codes** are authored here — and when upstream
+ *    ships a catalogue, nine lines are deleted and no key or text moves;
+ *  - the **12 `stapel_attributes` codes** are NOT here. They belong to
+ *    `@stapel/attributes-react`, which already translates them and which is a
+ *    peer of this pair anyway. Two packages must not give one refusal two
+ *    sentences (spec §13.2, note 3). A host registers both bundles;
+ *    `test/i18n.test.ts` proves the union covers the registry.
+ *
+ * PROVENANCE, stated rather than implied: the core catalogue ships
+ * `origin=seed:authored` and is UNREVIEWED; the pair-authored strings below
+ * are the same grade. Neither is a claim of review.
+ */
+export const listingsI18nBundleRu = {
+    ...listingsErrorBundleRu,
+    // ── the 9 stapel_listings-owned codes, pair-authored ─────────────────────
+    "error.400.category_required": "Нужно выбрать категорию",
+    "error.400.image_required": "Чтобы опубликовать объявление, добавьте хотя бы одно фото",
+    "error.400.listing_feature_not_allowed": "Характеристика «{feature}» не относится к этой категории",
+    "error.400.publish_validation_failed": "Объявление не прошло проверку и не опубликовано",
+    "error.403.listing_not_owner": "Это не ваше объявление",
+    "error.404.listing_not_found": "Объявление не найдено",
+    "error.409.already_favorited": "Объявление уже в избранном",
+    "error.409.invalid_listing_transition": "Объявление в статусе «{from_status}» так перевести нельзя",
+    "error.409.listing_cannot_delete_active": "Сначала снимите объявление с публикации — активное удалить нельзя",
+    "listings.error.unknown": "Что-то пошло не так с этим объявлением",
+    "listings.status.draft": "Черновик",
+    "listings.status.pending": "На проверке",
+    "listings.status.published": "Опубликовано",
+    "listings.status.paused": "Приостановлено",
+    "listings.status.expired": "Срок вышел",
+    "listings.status.sold": "Продано",
+    "listings.status.rejected": "Отклонено",
+    "listings.status.blocked": "Снято модератором",
+    "listings.status.archived": "В архиве",
+    "listings.moderation.first_review": "Отправлено на проверку. Объявление появится в продаже после одобрения модератора.",
+    "listings.moderation.live_edit_pending": "Объявление остаётся опубликованным, пока мы проверяем правки — покупатели видят его прямо сейчас.",
+    "listings.moderation.pending_offline": "Проверка была запрошена, но объявление уже не в продаже.",
+    "listings.moderation.needs_review": "Объявление смотрит модератор вручную.",
+    "listings.moderation.live_needs_review": "Опубликовано, правки смотрит модератор вручную.",
+    "listings.moderation.rejected": "Модератор отклонил объявление. Исправьте и отправьте снова.",
+    "listings.moderation.rejected_still_live": "Модератор отклонил объявление; пока решение применяется, оно ещё видно.",
+    "listings.card.no_photo": "Без фото",
+    "listings.card.photo_unavailable": "Фото недоступно",
+    "listings.card.price_absent": "Цена по запросу",
+    "listings.card.favorite_add": "В избранное",
+    "listings.card.favorite_remove": "Убрать из избранного",
+    "listings.card.open": "Открыть",
+    "listings.detail.loading": "Загружаем объявление…",
+    "listings.detail.load_failed": "Не удалось загрузить объявление",
+    "listings.detail.retry": "Повторить",
+    "listings.detail.not_found": "По этому адресу объявления нет",
+    "listings.detail.removed": "Это объявление удалено",
+    "listings.detail.not_published": "Объявление сейчас не в продаже, и то, что вы видите, может быть неактуальным",
+    "listings.detail.owner_only_view": "Это видите только вы — объявление ещё не опубликовано",
+    "listings.detail.description": "Описание",
+    "listings.detail.specs": "Характеристики",
+    "listings.detail.no_specs": "Продавец не указал дополнительных характеристик",
+    "listings.detail.unreadable_features": "Характеристик, которые эта версия не смогла прочитать: {count}",
+    "listings.detail.photos_unavailable": "Фото здесь показать нельзя — приложению нечем их разрешить",
+    "listings.detail.photo_alt": "Фото {index} из {total}",
+    "listings.detail.published_at": "Опубликовано {date}",
+    "listings.detail.expires_at": "В продаже до {date}",
+    "listings.detail.stock": "В наличии: {count}",
+    "listings.compose.new_title": "Новое объявление",
+    "listings.compose.edit_title": "Редактирование объявления",
+    "listings.compose.category": "Категория",
+    "listings.compose.category_help": "От категории зависит, какие характеристики спросят у продавца",
+    "listings.compose.category_required": "Сначала выберите категорию",
+    "listings.compose.category_changed_dropped": "Ответов, которые не относятся к этой категории и были очищены: {count}",
+    "listings.compose.title_label": "Заголовок",
+    "listings.compose.title_too_long": "Заголовок должен быть не длиннее {max_length} символов",
+    "listings.compose.description_label": "Описание",
+    "listings.compose.price_label": "Цена",
+    "listings.compose.price_invalid": "Введите цену числом, не более двух знаков после запятой",
+    "listings.compose.currency_label": "Валюта",
+    "listings.compose.location_label": "Где находится",
+    "listings.compose.lat_label": "Широта",
+    "listings.compose.lon_label": "Долгота",
+    "listings.compose.geo_incomplete": "Рядом с широтой нужна долгота — половина координаты никуда не указывает",
+    "listings.compose.photos": "Фотографии",
+    "listings.compose.too_many_images": "К объявлению можно приложить не больше {max} фото",
+    "listings.compose.details": "Характеристики",
+    "listings.compose.details_loading": "Загружаем характеристики категории…",
+    "listings.compose.details_failed": "Не удалось загрузить характеристики категории",
+    "listings.compose.details_empty": "Эта категория не спрашивает дополнительных характеристик",
+    "listings.compose.countable": "Продаю штучный товар",
+    "listings.compose.stock": "Сколько штук",
+    "listings.compose.auto_republish": "Публиковать заново, когда истечёт срок",
+    "listings.compose.save": "Сохранить черновик",
+    "listings.compose.saving": "Сохраняем…",
+    "listings.compose.saved": "Черновик сохранён",
+    "listings.compose.publish": "Опубликовать",
+    "listings.compose.republish": "Отправить правки",
+    "listings.compose.publishing": "Отправляем…",
+    "listings.compose.published_first": "Отправлено на проверку. Объявление появится в продаже после одобрения модератора.",
+    "listings.compose.published_live": "Правки отправлены. Объявление остаётся опубликованным, пока мы их проверяем.",
+    "listings.compose.invalid_summary": "Прежде чем отправить, поправьте характеристик: {count}",
+    "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.mirror": "Сначала поправьте отмеченные поля",
+    "listings.compose.blocked.details_unavailable": "Не удалось загрузить характеристики категории, поэтому проверить форму нельзя",
+    "listings.mine.title": "Мои объявления",
+    "listings.mine.tab.active": "Активные",
+    "listings.mine.tab.drafts": "Черновики",
+    "listings.mine.tab.archived": "Архив",
+    "listings.mine.loading": "Загружаем ваши объявления…",
+    "listings.mine.load_failed": "Не удалось загрузить ваши объявления",
+    "listings.mine.empty": "Здесь пока пусто",
+    "listings.mine.retry": "Повторить",
+    "listings.mine.counters_failed": "Не удалось посчитать ваши объявления",
+    "listings.mine.source_missing": "Приложение пока не может перечислить ваши объявления: у сервиса объявлений нет списка, ограниченного владельцем. Счётчики ниже — настоящие.",
+    "listings.mine.live_under_review": "Опубликовано, правки на проверке",
+    "listings.mine.edit": "Редактировать",
+    "listings.mine.archive": "В архив",
+    "listings.mine.complete": "Отметить проданным",
+    "listings.mine.delete": "Удалить",
+    "listings.favorites.title": "Избранное",
+    "listings.favorites.loading": "Загружаем избранное…",
+    "listings.favorites.load_failed": "Не удалось загрузить избранное",
+    "listings.favorites.empty": "Вы ещё ничего не сохранили",
+    "listings.blocked.sign_in": "Войдите, чтобы сделать это",
+    "listings.blocked.guest": "Этот аккаунт пока так не может — сначала завершите настройку",
+    "listings.blocked.mandate_unknown": "Не удалось проверить ваш аккаунт, поэтому мы не угадываем, можно ли вам это",
+    "listings.blocked.transition": "Объявление в статусе «{from_status}» так перевести нельзя",
+    "listings.blocked.delete_active": "Сначала уберите в архив — объявление в продаже удалить нельзя",
+    "listings.blocked.in_flight": "Секунду — это уже выполняется",
+    "listings.page.prev": "Назад",
+    "listings.page.next": "Дальше",
+    "listings.nav.detail": "Объявление",
+    "listings.nav.compose": "Подать объявление",
+    "listings.nav.mine": "Мои объявления",
+    "listings.nav.favorites": "Избранное",
+};
+/** Register the Russian bundle into a core i18n engine. */
+export function registerListingsI18nRu(i18n) {
+    i18n.registerBundle("ru", listingsI18nBundleRu);
+}
+//# sourceMappingURL=ru.js.map

package/dist/i18n/ru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ru.js","sourceRoot":"","sources":["../../src/i18n/ru.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * `@stapel/listings-react` — the headless React pair for stapel-listings
+ * (frontend-standard §2). Business + state only, zero visual opinion; the
+ * antd skin lives behind the `./default` subpath, so a host that renders its
+ * own shop window carries none of it.
+ *
+ * ── The one-liner ──────────────────────────────────────────────────────────
+ *
+ * ```tsx
+ * const runtime = createListingsRuntime({
+ *   baseUrl: "/listings/api/v1/",
+ *   resolveImage: (ref) => myCdn.describe(ref),
+ * });
+ * <ListingsProvider runtime={runtime}>
+ *   <ListingDetailPane id={id} />
+ * </ListingsProvider>
+ * ```
+ *
+ * ── The four properties this pair exists to guarantee ──────────────────────
+ *
+ * 1. **Two axes, both on screen, neither standing in for the other.**
+ *    `status` decides visibility and nothing else does; `moderation_status`
+ *    decides nothing about it. Since stapel-listings 0.5.0 they genuinely
+ *    diverge — an edit to a LIVE listing keeps `status: published` and moves
+ *    only the moderation axis — so "published, changes under review" is a
+ *    sentence this pair can say, and a dashboard that computed either field
+ *    from the other could not. `model/status.ts` produces both halves from
+ *    both fields, once, and the 9 × 4 table is asserted.
+ * 2. **A refusal lands on the control that caused it.** `publish` answers an
+ *    invalid draft with a BARE `ValidationBatchResult` (not an error
+ *    envelope), and the engine's rows carry `{feature, slug}` and never
+ *    `field`. `model/validation.ts` splits the two kinds of 400 apart and
+ *    `featureErrorsBySlug` adds the routing key, so "this box is wrong" never
+ *    degrades into "something is wrong".
+ * 3. **Every switched-off control states its reason.** Signing in, waiting
+ *    for photos, a type this build cannot draw, a lifecycle move the server
+ *    would refuse — each is an `ActionAvailability` with a named block, never
+ *    a grey button and never a hidden one.
+ * 4. **An absence is never rendered as a zero.** A soft-deleted listing says
+ *    it was removed rather than 404-ing like a typo; a stored feature this
+ *    build cannot read is counted rather than dropped; and the owner's own
+ *    listings — which stapel-listings 0.6.1 has NO endpoint for — arrive as a
+ *    named failure rather than an empty grid (`headless/MyListings.tsx`).
+ *
+ * ── The seams, and why they are not imports ────────────────────────────────
+ *
+ * `@stapel/cdn-react` and `@stapel/categories-react` are L2 pairs, and L2
+ * pairs never import each other. The gallery therefore arrives as a
+ * structural {@link ListingImagesBag} (satisfied by cdn's upload bag: its
+ * `refs` IS `images_draft` and its `settled` is the submit gate), the
+ * category schema arrives as a plain `FeatureDef[]`, and a stored image
+ * reference is resolved by a host-supplied {@link ListingImageResolver} —
+ * because no contract in this fleet resolves a stranger's CDN reference, and
+ * a pair that invented a URL convention would be writing a contract nobody
+ * agreed to. `@stapel/attributes-react` IS a dependency; it is L0.
+ *
+ * Layers: api → model → flows → headless → i18n. Generated surfaces (the
+ * typed schema, the error map, the manifest, the nav manifest, llms.txt) are
+ * produced by the monorepo `gen:*` drivers from stapel-listings' own `docs/`
+ * artifacts and stand under drift gates.
+ */
+export { createListingsApi } from "./api/listingsApi.js";
+export type { ListingsApi } from "./api/listingsApi.js";
+export { DEFAULT_LISTING_CURRENCY, LISTING_STATUSES, MODERATION_STATUSES, } from "./api/types.js";
+export type { DeleteResponse, FavoriteToggleResponse, FeatureConfig, FeatureDef, FeatureValueDto, ListingActionResponse, ListingCard, ListingDetail as ListingDetailData, ListingDraft, ListingDraftPatch, ListingFeatureDao, ListingFeatureDaoUnion, ListingFeatureType, ListingFeatureView, ListingLifecycleStatus, ListingModerationStatus, ListingPageParams, ListingStatusInfo, MyCounters, PaginatedListingCards, PublishResponse, Schemas, } from "./api/types.js";
+export { MY_LISTINGS_TABS, MY_LISTINGS_TAB_STATUSES, isPubliclyVisible, lifecycleCaption, listingStatusView, moderationNotice, tabOf, } from "./model/status.js";
+export type { LifecycleCaption, ListingStatusTone, ListingStatusView, ModerationNotice, MyListingsTab, } from "./model/status.js";
+export { LISTING_TRANSITIONS, canDelete, canTransition } from "./model/transitions.js";
+export { MY_LISTINGS_SOURCE_MISSING } from "./model/mineSource.js";
+export type { MyListingsSource } from "./model/mineSource.js";
+export { EMPTY_LOCATION, createDraftBody, draftPatchFromValues, draftValuesFromDetail, draftValuesFromWire, droppedFeatureSlugs, emptyDraftValues, retainKnownFeatureValues, } from "./model/draft.js";
+export type { EmptyDraftOptions, ListingDraftValues, ListingLocation, } from "./model/draft.js";
+export { asFeatureDaoList, featureFromDao, featuresDtoFromDaoList, featuresFromDaoList, unreadableFeatureCount, } from "./model/features.js";
+export { CATEGORY_FIELD, DEFAULT_DRAFT_LIMITS, DESCRIPTION_FIELD, IMAGES_FIELD, PRICE_FIELD, TITLE_FIELD, failedResults, isBatchValid, listingFieldErrors, mirrorDraft, mirrorListingFields, publishRefusal, } from "./model/validation.js";
+export type { ListingDraftLimits, PublishRefusal } from "./model/validation.js";
+export { createListingsRuntime } from "./model/runtime.js";
+export type { CreateListingsRuntimeOptions, ListingImageResolver, ListingsRuntime, } from "./model/runtime.js";
+export { ListingsRuntimeContext, useListingsAnalytics, useListingsApi, useListingsRuntime, } from "./model/context.js";
+export { listingsQueryKeys, pageKey } from "./model/queryKeys.js";
+export type { ListingPageKey } from "./model/queryKeys.js";
+export { useListing, useListingCards, useListingStatus, useMyCounters, useMyFavorites, useValidateDraft, } from "./model/queries.js";
+export { useArchiveListing, useCompleteListing, useCreateDraft, useDeleteListing, useFavoriteListing, usePublishListing, useSaveDraft, } from "./model/mutations.js";
+export type { FavoriteInput, SaveDraftInput } from "./model/mutations.js";
+export { LISTINGS_FLOWS, flowEndpoints } from "./flows/registry.js";
+export type { FlowEndpoint, ListingsFlowId, ListingsFlowSpec, } from "./flows/registry.js";
+export { ListingsProvider } from "./headless/ListingsProvider.js";
+export { useMandateGate } from "./headless/useMandateGate.js";
+export { ListingDetail, useListingDetail } from "./headless/ListingDetail.js";
+export type { ListingDetailBag, UseListingDetailOptions, } from "./headless/ListingDetail.js";
+export { ListingComposer, useListingComposer } from "./headless/ListingComposer.js";
+export type { ComposeStage, ListingComposerBag, ListingImagesBag, PublishOutcome, UseListingComposerOptions, } from "./headless/ListingComposer.js";
+export { MyListings, useMyListings } from "./headless/MyListings.js";
+export type { MyListingsBag, UseMyListingsOptions, } from "./headless/MyListings.js";
+export { Favorites, useFavorites, useFavoriteToggle } from "./headless/Favorites.js";
+export type { FavoriteToggleBag, FavoritesBag, UseFavoritesOptions, } from "./headless/Favorites.js";
+export { useListingActions } from "./headless/ListingActions.js";
+export type { ListingActionsBag } from "./headless/ListingActions.js";
+export { ACCOUNT_ROOT_ID, navEntries } from "./nav/manifest.js";
+export { LISTINGS_I18N_KEYS, listingsI18nBundleEn, registerListingsI18n, } from "./i18n/keys.js";
+export type { ListingsI18nKey } from "./i18n/keys.js";
+export { LISTINGS_ERRORS, LISTINGS_ERROR_CODES, LISTING_CANNOT_DELETE_ACTIVE, LISTING_INVALID_TRANSITION, LISTING_NOT_OWNER, LISTING_PUBLISH_VALIDATION_FAILED, explainListingsError, listingsErrorBundleEn, } from "./i18n/errorsMap.js";
+export type { ListingsErrorCode, ListingsErrorSpec, Remediation, } from "./i18n/errorsMap.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,98 @@
+/**
+ * `@stapel/listings-react` — the headless React pair for stapel-listings
+ * (frontend-standard §2). Business + state only, zero visual opinion; the
+ * antd skin lives behind the `./default` subpath, so a host that renders its
+ * own shop window carries none of it.
+ *
+ * ── The one-liner ──────────────────────────────────────────────────────────
+ *
+ * ```tsx
+ * const runtime = createListingsRuntime({
+ *   baseUrl: "/listings/api/v1/",
+ *   resolveImage: (ref) => myCdn.describe(ref),
+ * });
+ * <ListingsProvider runtime={runtime}>
+ *   <ListingDetailPane id={id} />
+ * </ListingsProvider>
+ * ```
+ *
+ * ── The four properties this pair exists to guarantee ──────────────────────
+ *
+ * 1. **Two axes, both on screen, neither standing in for the other.**
+ *    `status` decides visibility and nothing else does; `moderation_status`
+ *    decides nothing about it. Since stapel-listings 0.5.0 they genuinely
+ *    diverge — an edit to a LIVE listing keeps `status: published` and moves
+ *    only the moderation axis — so "published, changes under review" is a
+ *    sentence this pair can say, and a dashboard that computed either field
+ *    from the other could not. `model/status.ts` produces both halves from
+ *    both fields, once, and the 9 × 4 table is asserted.
+ * 2. **A refusal lands on the control that caused it.** `publish` answers an
+ *    invalid draft with a BARE `ValidationBatchResult` (not an error
+ *    envelope), and the engine's rows carry `{feature, slug}` and never
+ *    `field`. `model/validation.ts` splits the two kinds of 400 apart and
+ *    `featureErrorsBySlug` adds the routing key, so "this box is wrong" never
+ *    degrades into "something is wrong".
+ * 3. **Every switched-off control states its reason.** Signing in, waiting
+ *    for photos, a type this build cannot draw, a lifecycle move the server
+ *    would refuse — each is an `ActionAvailability` with a named block, never
+ *    a grey button and never a hidden one.
+ * 4. **An absence is never rendered as a zero.** A soft-deleted listing says
+ *    it was removed rather than 404-ing like a typo; a stored feature this
+ *    build cannot read is counted rather than dropped; and the owner's own
+ *    listings — which stapel-listings 0.6.1 has NO endpoint for — arrive as a
+ *    named failure rather than an empty grid (`headless/MyListings.tsx`).
+ *
+ * ── The seams, and why they are not imports ────────────────────────────────
+ *
+ * `@stapel/cdn-react` and `@stapel/categories-react` are L2 pairs, and L2
+ * pairs never import each other. The gallery therefore arrives as a
+ * structural {@link ListingImagesBag} (satisfied by cdn's upload bag: its
+ * `refs` IS `images_draft` and its `settled` is the submit gate), the
+ * category schema arrives as a plain `FeatureDef[]`, and a stored image
+ * reference is resolved by a host-supplied {@link ListingImageResolver} —
+ * because no contract in this fleet resolves a stranger's CDN reference, and
+ * a pair that invented a URL convention would be writing a contract nobody
+ * agreed to. `@stapel/attributes-react` IS a dependency; it is L0.
+ *
+ * Layers: api → model → flows → headless → i18n. Generated surfaces (the
+ * typed schema, the error map, the manifest, the nav manifest, llms.txt) are
+ * produced by the monorepo `gen:*` drivers from stapel-listings' own `docs/`
+ * artifacts and stand under drift gates.
+ */
+// ── api ──────────────────────────────────────────────────────────────────────
+export { createListingsApi } from "./api/listingsApi.js";
+export { DEFAULT_LISTING_CURRENCY, LISTING_STATUSES, MODERATION_STATUSES, } from "./api/types.js";
+// ── model: the two axes ──────────────────────────────────────────────────────
+export { MY_LISTINGS_TABS, MY_LISTINGS_TAB_STATUSES, isPubliclyVisible, lifecycleCaption, listingStatusView, moderationNotice, tabOf, } from "./model/status.js";
+export { LISTING_TRANSITIONS, canDelete, canTransition } from "./model/transitions.js";
+// ── model: the owner-list gap, named ─────────────────────────────────────────
+export { MY_LISTINGS_SOURCE_MISSING } from "./model/mineSource.js";
+// ── model: the draft twin ────────────────────────────────────────────────────
+export { EMPTY_LOCATION, createDraftBody, draftPatchFromValues, draftValuesFromDetail, draftValuesFromWire, droppedFeatureSlugs, emptyDraftValues, retainKnownFeatureValues, } from "./model/draft.js";
+// ── model: the stored feature projection ─────────────────────────────────────
+export { asFeatureDaoList, featureFromDao, featuresDtoFromDaoList, featuresFromDaoList, unreadableFeatureCount, } from "./model/features.js";
+// ── model: validation, the mirror and the publish-400 split ──────────────────
+export { CATEGORY_FIELD, DEFAULT_DRAFT_LIMITS, DESCRIPTION_FIELD, IMAGES_FIELD, PRICE_FIELD, TITLE_FIELD, failedResults, isBatchValid, listingFieldErrors, mirrorDraft, mirrorListingFields, publishRefusal, } from "./model/validation.js";
+// ── model: runtime wiring, query keys, context, hooks ────────────────────────
+export { createListingsRuntime } from "./model/runtime.js";
+export { ListingsRuntimeContext, useListingsAnalytics, useListingsApi, useListingsRuntime, } from "./model/context.js";
+export { listingsQueryKeys, pageKey } from "./model/queryKeys.js";
+export { useListing, useListingCards, useListingStatus, useMyCounters, useMyFavorites, useValidateDraft, } from "./model/queries.js";
+export { useArchiveListing, useCompleteListing, useCreateDraft, useDeleteListing, useFavoriteListing, usePublishListing, useSaveDraft, } from "./model/mutations.js";
+// ── flows (zero-flow shim — stapel-listings annotates none) ──────────────────
+export { LISTINGS_FLOWS, flowEndpoints } from "./flows/registry.js";
+// ── headless (renderless components + their bags) ────────────────────────────
+export { ListingsProvider } from "./headless/ListingsProvider.js";
+export { useMandateGate } from "./headless/useMandateGate.js";
+export { ListingDetail, useListingDetail } from "./headless/ListingDetail.js";
+export { ListingComposer, useListingComposer } from "./headless/ListingComposer.js";
+export { MyListings, useMyListings } from "./headless/MyListings.js";
+export { Favorites, useFavorites, useFavoriteToggle } from "./headless/Favorites.js";
+export { useListingActions } from "./headless/ListingActions.js";
+// ── nav manifest (the pair's public surface declaration) ─────────────────────
+export { ACCOUNT_ROOT_ID, navEntries } from "./nav/manifest.js";
+// ── i18n ─────────────────────────────────────────────────────────────────────
+export { LISTINGS_I18N_KEYS, listingsI18nBundleEn, registerListingsI18n, } from "./i18n/keys.js";
+// ── errors map (code → status/params/remediation/en; generated) ──────────────
+export { LISTINGS_ERRORS, LISTINGS_ERROR_CODES, LISTING_CANNOT_DELETE_ACTIVE, LISTING_INVALID_TRANSITION, LISTING_NOT_OWNER, LISTING_PUBLISH_VALIDATION_FAILED, explainListingsError, listingsErrorBundleEn, } from "./i18n/errorsMap.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/model/context.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "react";
+import type { Analytics, ModuleContextKit } from "@stapel/core";
+import type { ListingsApi } from "../api/listingsApi.js";
+import type { ListingsRuntime } from "./runtime.js";
+export declare const ListingsRuntimeContext: Context<ListingsRuntime | null>;
+export declare const useListingsRuntime: () => ListingsRuntime;
+export declare const useListingsApi: () => ListingsApi;
+export declare const useListingsAnalytics: () => Analytics | null;
+/** @internal Re-exported as `<ListingsProvider>` from `headless/`. */
+export declare const ModuleProvider: ModuleContextKit<ListingsRuntime>["Provider"];
+//# sourceMappingURL=context.d.ts.map

package/dist/model/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/model/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAYpD,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,eAAe,GAAG,IAAI,CAC/C,CAAC;AAErB,eAAO,MAAM,kBAAkB,EAAE,MAAM,eAAgC,CAAC;AAExE,eAAO,MAAM,cAAc,EAAE,MAAM,WAAwB,CAAC;AAE5D,eAAO,MAAM,oBAAoB,EAAE,MAAM,SAAS,GAAG,IAAuB,CAAC;AAE7E,sEAAsE;AACtE,eAAO,MAAM,cAAc,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC,UAAU,CAC3D,CAAC"}

package/dist/model/context.js

@@ -0,0 +1,16 @@
+import { createModuleContext } from "@stapel/core";
+/**
+ * The wired ListingsRuntime shared through React context by
+ * `<ListingsProvider>`. Hooks in `model/` and `headless/` read the singletons
+ * from here. One reviewed copy of this plumbing lives in `@stapel/core`
+ * (`createModuleContext`, slim wave §21/S2); this module binds it under the
+ * pair's public names.
+ */
+const kit = createModuleContext("Listings");
+export const ListingsRuntimeContext = kit.RuntimeContext;
+export const useListingsRuntime = kit.useRuntime;
+export const useListingsApi = kit.useApi;
+export const useListingsAnalytics = kit.useAnalytics;
+/** @internal Re-exported as `<ListingsProvider>` from `headless/`. */
+export const ModuleProvider = kit.Provider;
+//# sourceMappingURL=context.js.map

package/dist/model/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/model/context.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAKnD;;;;;;GAMG;AACH,MAAM,GAAG,GACP,mBAAmB,CAAkB,UAAU,CAAC,CAAC;AAEnD,MAAM,CAAC,MAAM,sBAAsB,GACjC,GAAG,CAAC,cAAc,CAAC;AAErB,MAAM,CAAC,MAAM,kBAAkB,GAA0B,GAAG,CAAC,UAAU,CAAC;AAExE,MAAM,CAAC,MAAM,cAAc,GAAsB,GAAG,CAAC,MAAM,CAAC;AAE5D,MAAM,CAAC,MAAM,oBAAoB,GAA2B,GAAG,CAAC,YAAY,CAAC;AAE7E,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GACzB,GAAG,CAAC,QAAQ,CAAC"}

package/dist/model/draft.d.ts

@@ -0,0 +1,138 @@
+/**
+ * The draft a composer holds, and its two conversions to the wire.
+ *
+ * stapel-listings stores every user-editable field TWICE: `title_draft` beside
+ * `title`, `images_draft` beside `images`, and so on. `publish` promotes the
+ * draft half onto the published half; nothing else does. So a composer edits
+ * exactly one side of that twin, and this module is where the browser's
+ * shape (plain values keyed the way a form keys them) meets the wire's
+ * (`*_draft` fields plus the `{slug: {type, value}}` feature envelope).
+ *
+ * Everything here is PURE — no React, no fetch — so the round trip is
+ * testable without mounting anything, and so `test/compose.test.tsx` can
+ * assert the BODY a save sends rather than the fact that it sent one.
+ */
+import type { FeatureDef, FeaturesDto } from "@stapel/attributes-react";
+import type { ListingDetail, ListingDraft, ListingDraftPatch } from "../api/types.js";
+/**
+ * Where the listing is, as ONE value.
+ *
+ * A composite because the four members only make sense together: a `lat`
+ * without a `lon` is not "half a location", it is a broken one, and a
+ * `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.
+ */
+export interface ListingLocation {
+    /** Opaque id from whatever place directory the deployment uses. */
+    readonly locationId: string;
+    /** What a person reads: "Kazan, Vahitovsky district". */
+    readonly locationLabel: string;
+    /** Decimal STRING, as the wire spells it — a float here would round-trip
+     * `55.796100` into `55.7961` and change what was submitted. */
+    readonly lat: string | null;
+    readonly lon: string | null;
+    readonly geohash: string;
+}
+export declare const EMPTY_LOCATION: ListingLocation;
+/**
+ * Everything a composer edits.
+ *
+ * `features` holds PLAIN values keyed by slug — what a value editor's
+ * `onChange` produces — never the DTO envelope. The envelope is built at send
+ * time by `toFeaturesDto`, which tags each value with its type from the
+ * category schema; a composer that stored tagged values would have to
+ * re-tag them on every category change.
+ */
+export interface ListingDraftValues {
+    readonly categoryId: string;
+    readonly title: string;
+    readonly description: string;
+    /** Decimal string, or `""` for "no price yet". */
+    readonly price: string;
+    readonly currency: string;
+    readonly language: string;
+    /** CDN references (`<type>/<hash>`) — ORDER IS THE GALLERY ORDER, and the
+     * first one is the cover. This is exactly `bag.refs` from
+     * `@stapel/cdn-react`'s upload queue; see `headless/ListingComposer.tsx`. */
+    readonly images: readonly string[];
+    readonly location: ListingLocation;
+    readonly features: Readonly<Record<string, unknown>>;
+    /** A countable good (a quantity applies) vs a service. */
+    readonly countable: boolean;
+    readonly stockQuantity: number | null;
+    readonly autoRepublish: boolean;
+}
+export interface EmptyDraftOptions {
+    readonly categoryId?: string;
+    readonly currency?: string;
+    readonly language?: string;
+}
+/** A blank draft. `currency` defaults to the storefront's (owner verdict F6 —
+ * RUB), overridable per runtime and per call. */
+export declare function emptyDraftValues(options?: EmptyDraftOptions): ListingDraftValues;
+/**
+ * A reopened draft: the server's `*_draft` fields → the composer's values.
+ *
+ * `features_draft` is `null` on a listing nobody has filled in yet, which is
+ * not the same as `{}` on the wire but is the same thing to a composer.
+ */
+export declare function draftValuesFromWire(draft: ListingDraft, options?: EmptyDraftOptions): ListingDraftValues;
+/**
+ * Editing something already PUBLISHED: the published half → the composer.
+ *
+ * A live listing's `*_draft` fields hold whatever was last submitted, which
+ * after a publish is the same content — but a listing published before this
+ * pair existed, or one whose draft was cleared, would open empty. Seeding
+ * from the PUBLISHED fields is what makes "edit" show the listing a person
+ * can actually see. Feature values come back from the DAO projection, which
+ * is the one place the published values live.
+ */
+export declare function draftValuesFromDetail(detail: ListingDetail, featuresDto: FeaturesDto, options?: EmptyDraftOptions): ListingDraftValues;
+/**
+ * The composer's values → the `save-draft` body.
+ *
+ * `features` needs the category schema to be tagged, so it is passed in. A
+ * feature the schema no longer declares is dropped by `toFeaturesDto` only if
+ * it is absent from `features`; keeping a stale slug in the payload would be
+ * refused per-feature by 0.6.0's M-7 rule
+ * (`error.400.listing_feature_not_allowed`), which is why
+ * {@link retainKnownFeatureValues} prunes on the way in rather than letting
+ * the server explain it.
+ */
+export declare function draftPatchFromValues(values: ListingDraftValues, features: readonly FeatureDef[]): ListingDraftPatch;
+/**
+ * The body for CREATING a draft: `category_id` and nothing else.
+ *
+ * `perform_create` forces `owner` and `status`, and everything else has a
+ * model default, so a create that also carried the form's current contents
+ * would be a second write of data the very next `save-draft` sends anyway —
+ * and would fail the whole submission on a field the person could still fix.
+ * Create the row, then save into it.
+ */
+export declare function createDraftBody(categoryId: string): ListingDraftPatch;
+/**
+ * Switching category: keep the answers whose slug the new schema also
+ * declares, drop the rest.
+ *
+ * Spec §4.1 asks for exactly this, and the reason is the same one the forms
+ * spec gives for `error.409.forms_version_superseded`: a person who picked
+ * "Phones", filled in Brand and Condition, then realised they meant "Used
+ * phones" should not retype what both categories ask for. A value whose slug
+ * is gone IS dropped, because 0.6.0 rejects an unknown slug per feature —
+ * carrying it would turn a category change into a publish refusal about a
+ * field the composer no longer draws.
+ */
+export declare function retainKnownFeatureValues(values: Readonly<Record<string, unknown>>, features: readonly FeatureDef[]): Readonly<Record<string, unknown>>;
+/** Slugs that were answered and are NOT in the new schema — what
+ * {@link retainKnownFeatureValues} just dropped. A composer tells the person
+ * ("2 answers do not apply to this category") instead of losing them
+ * silently. */
+export declare function droppedFeatureSlugs(values: Readonly<Record<string, unknown>>, features: readonly FeatureDef[]): readonly string[];
+//# sourceMappingURL=draft.d.ts.map

package/dist/model/draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../src/model/draft.ts"],"names":[],"mappings":"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"}