@stapel/reviews-react 0.1.0

package/dist/i18n/keys.d.ts

@@ -0,0 +1,59 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+/**
+ * reviews-react's own translation KEYS (frontend-standard §4.2): headless
+ * components never render literal strings — hosts resolve these through core's
+ * i18n engine (`useT`). Backend error codes flow through the SAME contour: a
+ * `StapelApiError.code` is already a key, so the default bundle below ships
+ * English for both the backend's codes (generated) and the pair's own UI keys.
+ */
+export declare const REVIEWS_I18N_KEYS: {
+    readonly unknownError: "reviews.error.unknown";
+    readonly listHeading: "reviews.list.heading";
+    readonly listEmpty: "reviews.list.empty";
+    readonly listLoadMore: "reviews.list.load_more";
+    readonly listRefresh: "reviews.list.refresh";
+    readonly moreBlockedEnd: "reviews.list.more.blocked.end";
+    readonly moreBlockedPending: "reviews.list.more.blocked.pending";
+    readonly authorFallback: "reviews.review.author_fallback";
+    readonly responseHeading: "reviews.review.response_heading";
+    readonly statusPending: "reviews.status.pending";
+    readonly statusHidden: "reviews.status.hidden";
+    readonly statusUnknown: "reviews.status.unknown";
+    readonly ratingNone: "reviews.rating.none";
+    readonly ratingValue: "reviews.rating.value";
+    readonly ratingCount: "reviews.rating.count";
+    readonly ratingStarLabel: "reviews.rating.star_label";
+    readonly formHeading: "reviews.form.heading";
+    readonly formRatingLabel: "reviews.form.rating_label";
+    readonly formBodyLabel: "reviews.form.body_label";
+    readonly formBodyPlaceholder: "reviews.form.body_placeholder";
+    readonly formSubmit: "reviews.form.submit";
+    readonly formSentPublished: "reviews.form.sent.published";
+    readonly formSentPending: "reviews.form.sent.pending";
+    readonly formSentHidden: "reviews.form.sent.hidden";
+    readonly formSentUnknown: "reviews.form.sent.unknown";
+    readonly formSignInRequired: "reviews.form.sign_in_required";
+    readonly submitBlockedNoRating: "reviews.submit.blocked.no_rating";
+    readonly submitBlockedPending: "reviews.submit.blocked.pending";
+    readonly submitBlockedDuplicate: "reviews.submit.blocked.duplicate";
+    readonly submitBlockedSubmitted: "reviews.submit.blocked.submitted";
+    readonly submitBlockedForbidden: "reviews.submit.blocked.forbidden";
+    readonly errorDuplicateReview: "error.400.reviews_duplicate_review";
+    readonly errorInvalidModerationAction: "error.400.reviews_invalid_moderation_action";
+    readonly errorInvalidRating: "error.400.reviews_invalid_rating";
+    readonly errorResponseNotAllowed: "error.400.reviews_response_not_allowed";
+    readonly errorUnknownTargetType: "error.400.reviews_unknown_target_type";
+    readonly errorCannotModerate: "error.403.reviews_cannot_moderate";
+    readonly errorCannotReview: "error.403.reviews_cannot_review";
+    readonly errorReviewNotFound: "error.404.reviews_review_not_found";
+    readonly errorAlreadyResponded: "error.409.reviews_already_responded";
+};
+/**
+ * The English bundle: the generated backend fallbacks first, this pair's own
+ * UI copy over them. English is INLINE (not a separate subpath) so a host that
+ * registers nothing still renders sentences instead of raw keys.
+ */
+export declare const reviewsI18nBundleEn: I18nDictionary;
+/** Register the English bundle into a core i18n engine. */
+export declare function registerReviewsI18n(engine: I18nEngine, locale?: string): void;
+//# sourceMappingURL=keys.d.ts.map

package/dist/i18n/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/i18n/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEpB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAyCjC,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,SAAO,GAAG,IAAI,CAE3E"}

package/dist/i18n/keys.js

@@ -0,0 +1,115 @@
+import { reviewsErrorBundleEn } from "./generated/errors.gen.js";
+/**
+ * reviews-react's own translation KEYS (frontend-standard §4.2): headless
+ * components never render literal strings — hosts resolve these through core's
+ * i18n engine (`useT`). Backend error codes flow through the SAME contour: a
+ * `StapelApiError.code` is already a key, so the default bundle below ships
+ * English for both the backend's codes (generated) and the pair's own UI keys.
+ */
+export const REVIEWS_I18N_KEYS = {
+    unknownError: "reviews.error.unknown",
+    // The list
+    listHeading: "reviews.list.heading",
+    listEmpty: "reviews.list.empty",
+    listLoadMore: "reviews.list.load_more",
+    listRefresh: "reviews.list.refresh",
+    moreBlockedEnd: "reviews.list.more.blocked.end",
+    moreBlockedPending: "reviews.list.more.blocked.pending",
+    // One row. The wire carries `author_id` and NOTHING else about the person —
+    // no name, no avatar — so the skin renders this unless the host passes a
+    // `renderAuthor` slot. Printing the raw id would be both useless and a
+    // gratuitous disclosure.
+    authorFallback: "reviews.review.author_fallback",
+    responseHeading: "reviews.review.response_heading",
+    // Visibility, said out loud. A row that is not published is only ever on
+    // screen because a moderator asked for `include=all`, and it must not look
+    // like an ordinary review.
+    statusPending: "reviews.status.pending",
+    statusHidden: "reviews.status.hidden",
+    statusUnknown: "reviews.status.unknown",
+    // The rating
+    ratingNone: "reviews.rating.none",
+    ratingValue: "reviews.rating.value",
+    ratingCount: "reviews.rating.count",
+    ratingStarLabel: "reviews.rating.star_label",
+    // The form. `formSignInRequired` is the ONLY sign-in key left: since
+    // stapel-reviews 0.3.0 both reads are anonymous and only the POST refuses a
+    // guest, so "sign in" is copy for the write and never a wall in front of
+    // the content.
+    formHeading: "reviews.form.heading",
+    formRatingLabel: "reviews.form.rating_label",
+    formBodyLabel: "reviews.form.body_label",
+    formBodyPlaceholder: "reviews.form.body_placeholder",
+    formSubmit: "reviews.form.submit",
+    formSentPublished: "reviews.form.sent.published",
+    formSentPending: "reviews.form.sent.pending",
+    formSentHidden: "reviews.form.sent.hidden",
+    formSentUnknown: "reviews.form.sent.unknown",
+    formSignInRequired: "reviews.form.sign_in_required",
+    // Blocked controls — every one of these is the `code` of an
+    // ActionAvailability, so a switched-off button always has a sentence.
+    submitBlockedNoRating: "reviews.submit.blocked.no_rating",
+    submitBlockedPending: "reviews.submit.blocked.pending",
+    submitBlockedDuplicate: "reviews.submit.blocked.duplicate",
+    submitBlockedSubmitted: "reviews.submit.blocked.submitted",
+    submitBlockedForbidden: "reviews.submit.blocked.forbidden",
+    // Backend error keys the pair OWNS the localization of. stapel-reviews ships
+    // English only (no `translations/` directory at all), so its 9 keys are
+    // absent from the generated ru/es bundles and are authored in `./i18n/<lang>`
+    // instead — the stapel-forms/`stapel_attributes` precedent, applied before
+    // this by forms, chat, cdn and categories. Listed here so `i18n-key-exists`
+    // knows them and `test/i18n.test.ts` can prove all three locales carry them.
+    errorDuplicateReview: "error.400.reviews_duplicate_review",
+    errorInvalidModerationAction: "error.400.reviews_invalid_moderation_action",
+    errorInvalidRating: "error.400.reviews_invalid_rating",
+    errorResponseNotAllowed: "error.400.reviews_response_not_allowed",
+    errorUnknownTargetType: "error.400.reviews_unknown_target_type",
+    errorCannotModerate: "error.403.reviews_cannot_moderate",
+    errorCannotReview: "error.403.reviews_cannot_review",
+    errorReviewNotFound: "error.404.reviews_review_not_found",
+    errorAlreadyResponded: "error.409.reviews_already_responded",
+};
+/**
+ * The English bundle: the generated backend fallbacks first, this pair's own
+ * UI copy over them. English is INLINE (not a separate subpath) so a host that
+ * registers nothing still renders sentences instead of raw keys.
+ */
+export const reviewsI18nBundleEn = {
+    ...reviewsErrorBundleEn,
+    "reviews.error.unknown": "Something went wrong with the reviews",
+    "reviews.list.heading": "Reviews",
+    "reviews.list.empty": "No reviews yet",
+    "reviews.list.load_more": "Show more",
+    "reviews.list.refresh": "Refresh",
+    "reviews.list.more.blocked.end": "That is all of them",
+    "reviews.list.more.blocked.pending": "Loading…",
+    "reviews.review.author_fallback": "A customer",
+    "reviews.review.response_heading": "Reply from the seller",
+    "reviews.status.pending": "Awaiting moderation",
+    "reviews.status.hidden": "Hidden by moderation",
+    "reviews.status.unknown": "Unknown state: {status}",
+    "reviews.rating.none": "No reviews yet",
+    "reviews.rating.value": "{avg} out of {max}",
+    "reviews.rating.count": "{count} reviews",
+    "reviews.rating.star_label": "{index} out of {max}",
+    "reviews.form.heading": "Rate this",
+    "reviews.form.rating_label": "Your rating",
+    "reviews.form.body_label": "Your review",
+    "reviews.form.body_placeholder": "What was the deal like? (optional)",
+    "reviews.form.submit": "Send",
+    "reviews.form.sent.published": "Thank you — your review is published",
+    "reviews.form.sent.pending": "Thank you — your review will appear once it has been checked",
+    "reviews.form.sent.hidden": "Your review was saved but is not shown",
+    "reviews.form.sent.unknown": "Your review was saved",
+    "reviews.form.sign_in_required": "Sign in to leave a review",
+    "reviews.submit.blocked.no_rating": "Choose a rating first",
+    "reviews.submit.blocked.pending": "Sending…",
+    "reviews.submit.blocked.duplicate": "You have already rated this",
+    "reviews.submit.blocked.submitted": "Your review has been sent",
+    "reviews.submit.blocked.forbidden": "You cannot review this",
+};
+/** Register the English bundle into a core i18n engine. */
+export function registerReviewsI18n(engine, locale = "en") {
+    engine.registerBundle(locale, reviewsI18nBundleEn);
+}
+//# sourceMappingURL=keys.js.map

package/dist/i18n/keys.js.map

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

package/dist/i18n/ru.d.ts

@@ -0,0 +1,22 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+export { reviewsErrorBundleRu } from "./generated/errors.ru.gen.js";
+/**
+ * Russian bundle for reviews-react — shipped as the
+ * `@stapel/reviews-react/i18n/ru` subpath (i18n-shipping.md §2) so the locale
+ * is opt-in: hosts that don't register it never carry these strings (the main
+ * entry does not import this module — gated by size-limit and the
+ * bundle-purity test).
+ *
+ * TWO SOURCES, ON PURPOSE. The generated `reviewsErrorBundleRu` covers the 42
+ * cross-cutting keys stapel-core owns and localizes. The 9 keys stapel-reviews
+ * owns are NOT in it, and cannot be: the module ships no `translations/`
+ * directory at all, so the generator emits a `Partial` bundle and says so in
+ * its own header (`ERRORS_LOCALE_EXEMPT_OWNERS`, the stapel-forms precedent).
+ * They are authored below, beside the UI copy. When upstream ships
+ * `translations/errors.ru.json`, these nine lines are deleted and the
+ * generated bundle covers them — the keys and the texts do not move.
+ */
+export declare const reviewsI18nBundleRu: I18nDictionary;
+/** Register the Russian bundle into a core i18n engine. */
+export declare function registerReviewsI18nRu(engine: I18nEngine, locale?: string): void;
+//# sourceMappingURL=ru.d.ts.map

package/dist/i18n/ru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ru.d.ts","sourceRoot":"","sources":["../../src/i18n/ru.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,EAAE,cA0DjC,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,SAAO,GAAG,IAAI,CAE7E"}

package/dist/i18n/ru.js

@@ -0,0 +1,70 @@
+import { reviewsErrorBundleRu } from "./generated/errors.ru.gen.js";
+export { reviewsErrorBundleRu } from "./generated/errors.ru.gen.js";
+/**
+ * Russian bundle for reviews-react — shipped as the
+ * `@stapel/reviews-react/i18n/ru` subpath (i18n-shipping.md §2) so the locale
+ * is opt-in: hosts that don't register it never carry these strings (the main
+ * entry does not import this module — gated by size-limit and the
+ * bundle-purity test).
+ *
+ * TWO SOURCES, ON PURPOSE. The generated `reviewsErrorBundleRu` covers the 42
+ * cross-cutting keys stapel-core owns and localizes. The 9 keys stapel-reviews
+ * owns are NOT in it, and cannot be: the module ships no `translations/`
+ * directory at all, so the generator emits a `Partial` bundle and says so in
+ * its own header (`ERRORS_LOCALE_EXEMPT_OWNERS`, the stapel-forms precedent).
+ * They are authored below, beside the UI copy. When upstream ships
+ * `translations/errors.ru.json`, these nine lines are deleted and the
+ * generated bundle covers them — the keys and the texts do not move.
+ */
+export const reviewsI18nBundleRu = {
+    // Backend error codes — generated ru texts for every key core owns.
+    ...reviewsErrorBundleRu,
+    // Backend error codes stapel-reviews owns — authored here (see the note
+    // above).
+    "error.400.reviews_duplicate_review": "Вы уже оценили это",
+    "error.400.reviews_invalid_moderation_action": "Действие модерации должно быть одним из: скрыть, опубликовать",
+    "error.400.reviews_invalid_rating": "Оценка вне допустимого диапазона",
+    "error.400.reviews_response_not_allowed": "Для этого типа объекта ответы отключены",
+    "error.400.reviews_unknown_target_type": "Неизвестный тип объекта отзыва",
+    "error.403.reviews_cannot_moderate": "Вы не можете модерировать отзывы об этом объекте",
+    "error.403.reviews_cannot_review": "Вы не можете оставить отзыв об этом объекте",
+    "error.404.reviews_review_not_found": "Отзыв не найден",
+    "error.409.reviews_already_responded": "На этот отзыв уже есть ответ",
+    // UI copy.
+    "reviews.error.unknown": "С отзывами что-то пошло не так",
+    "reviews.list.heading": "Отзывы",
+    "reviews.list.empty": "Отзывов пока нет",
+    "reviews.list.load_more": "Показать ещё",
+    "reviews.list.refresh": "Обновить",
+    "reviews.list.more.blocked.end": "Это все отзывы",
+    "reviews.list.more.blocked.pending": "Загружаем…",
+    "reviews.review.author_fallback": "Покупатель",
+    "reviews.review.response_heading": "Ответ продавца",
+    "reviews.status.pending": "Ожидает модерации",
+    "reviews.status.hidden": "Скрыт модерацией",
+    "reviews.status.unknown": "Неизвестное состояние: {status}",
+    "reviews.rating.none": "Отзывов пока нет",
+    "reviews.rating.value": "{avg} из {max}",
+    "reviews.rating.count": "Отзывов: {count}",
+    "reviews.rating.star_label": "{index} из {max}",
+    "reviews.form.heading": "Оцените",
+    "reviews.form.rating_label": "Ваша оценка",
+    "reviews.form.body_label": "Ваш отзыв",
+    "reviews.form.body_placeholder": "Как прошла сделка? (необязательно)",
+    "reviews.form.submit": "Отправить",
+    "reviews.form.sent.published": "Спасибо — ваш отзыв опубликован",
+    "reviews.form.sent.pending": "Спасибо — отзыв появится после проверки модератором",
+    "reviews.form.sent.hidden": "Отзыв сохранён, но не показывается",
+    "reviews.form.sent.unknown": "Отзыв сохранён",
+    "reviews.form.sign_in_required": "Войдите, чтобы оставить отзыв",
+    "reviews.submit.blocked.no_rating": "Сначала выберите оценку",
+    "reviews.submit.blocked.pending": "Отправляем…",
+    "reviews.submit.blocked.duplicate": "Вы уже оценили это",
+    "reviews.submit.blocked.submitted": "Ваш отзыв отправлен",
+    "reviews.submit.blocked.forbidden": "Вы не можете оставить здесь отзыв",
+};
+/** Register the Russian bundle into a core i18n engine. */
+export function registerReviewsI18nRu(engine, locale = "ru") {
+    engine.registerBundle(locale, reviewsI18nBundleRu);
+}
+//# 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":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,oEAAoE;IACpE,GAAG,oBAAoB;IAEvB,wEAAwE;IACxE,UAAU;IACV,oCAAoC,EAAE,oBAAoB;IAC1D,6CAA6C,EAC3C,+DAA+D;IACjE,kCAAkC,EAAE,kCAAkC;IACtE,wCAAwC,EACtC,yCAAyC;IAC3C,uCAAuC,EAAE,gCAAgC;IACzE,mCAAmC,EACjC,kDAAkD;IACpD,iCAAiC,EAAE,6CAA6C;IAChF,oCAAoC,EAAE,iBAAiB;IACvD,qCAAqC,EAAE,8BAA8B;IAErE,WAAW;IACX,uBAAuB,EAAE,gCAAgC;IAEzD,sBAAsB,EAAE,QAAQ;IAChC,oBAAoB,EAAE,kBAAkB;IACxC,wBAAwB,EAAE,cAAc;IACxC,sBAAsB,EAAE,UAAU;IAClC,+BAA+B,EAAE,gBAAgB;IACjD,mCAAmC,EAAE,YAAY;IAEjD,gCAAgC,EAAE,YAAY;IAC9C,iCAAiC,EAAE,gBAAgB;IAEnD,wBAAwB,EAAE,mBAAmB;IAC7C,uBAAuB,EAAE,kBAAkB;IAC3C,wBAAwB,EAAE,iCAAiC;IAE3D,qBAAqB,EAAE,kBAAkB;IACzC,sBAAsB,EAAE,gBAAgB;IACxC,sBAAsB,EAAE,kBAAkB;IAC1C,2BAA2B,EAAE,kBAAkB;IAE/C,sBAAsB,EAAE,SAAS;IACjC,2BAA2B,EAAE,aAAa;IAC1C,yBAAyB,EAAE,WAAW;IACtC,+BAA+B,EAAE,oCAAoC;IACrE,qBAAqB,EAAE,WAAW;IAClC,6BAA6B,EAAE,iCAAiC;IAChE,2BAA2B,EACzB,qDAAqD;IACvD,0BAA0B,EAAE,oCAAoC;IAChE,2BAA2B,EAAE,gBAAgB;IAC7C,+BAA+B,EAAE,+BAA+B;IAEhE,kCAAkC,EAAE,yBAAyB;IAC7D,gCAAgC,EAAE,aAAa;IAC/C,kCAAkC,EAAE,oBAAoB;IACxD,kCAAkC,EAAE,qBAAqB;IACzD,kCAAkC,EAAE,mCAAmC;CACxE,CAAC;AAEF,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB,CAAC,MAAkB,EAAE,MAAM,GAAG,IAAI;IACrE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AACrD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * `@stapel/reviews-react` — the headless React pair for stapel-reviews
+ * (frontend-standard §2). Business + state only, zero visual opinion; the antd
+ * skin lives behind the `./default` subpath, so a host that renders its own
+ * review block carries none of it.
+ *
+ * ── The one-liner ──────────────────────────────────────────────────────────
+ *
+ * ```tsx
+ * const runtime = createReviewsRuntime({ baseUrl: "/reviews/api/v1" });
+ * const target = { targetType: "listing", targetKey: listingId };
+ * <ReviewsProvider runtime={runtime}>
+ *   <ReviewAggregate target={target}>{(bag) => <YourStars bag={bag} />}</ReviewAggregate>
+ *   <ReviewList target={target}>{(bag) => <YourRows bag={bag} />}</ReviewList>
+ *   <ReviewForm target={target}>{(bag) => <YourForm bag={bag} />}</ReviewForm>
+ * </ReviewsProvider>
+ * ```
+ *
+ * `"listing"` in that snippet is the HOST's registry key, not this library's:
+ * stapel-reviews ships an EMPTY `TARGET_TYPES` registry and this package
+ * exports no target-type constants (see `api/types.ts`, `ReviewTarget`).
+ *
+ * ── The four properties this pair exists to guarantee ──────────────────────
+ *
+ * 1. **A zero average is not a zero rating.** `avg` is `0.0` when `count` is
+ *    `0`, by the module's own contract. `ratingSummary()` answers
+ *    `rated: false` there and gives a skin nothing to draw a star row from, so
+ *    "nobody has rated this yet" can never be rendered as the worst possible
+ *    score. Same class as `data ?? []`.
+ * 2. **The refusal is read by CODE, never by status.** "You have already
+ *    reviewed this" is `error.400.reviews_duplicate_review` — a 400 — while
+ *    the module's only 409 says the owner's reply already exists. Branching on
+ *    the number would miss the first and mishandle the second
+ *    (`model/refusals.ts`).
+ * 3. **A 401 is not an empty list.** Every stapel-reviews endpoint is
+ *    `IsAuthenticated`, including both reads, so a signed-out visitor to a
+ *    public listing page gets 401 — and the empty state would tell them a
+ *    well-reviewed seller has never been reviewed. `signInRequired` is a
+ *    named state on both read bags.
+ * 4. **A review that is not published says so.** `status` is carried to the
+ *    screen (`pending` / `hidden`, plus an explicit `unknown` arm for a state
+ *    a future backend adds), and the submit outcome reports the created row's
+ *    status, so a pre-moderating deployment tells the author their review is
+ *    waiting instead of leaving them to look for it.
+ *
+ * ── What this pair does NOT do ─────────────────────────────────────────────
+ *
+ * No moderation and no owner reply. `POST {id}/moderate` and
+ * `POST {id}/response` are both gated on the target type's fail-closed
+ * `can_moderate` callback and belong to consoles this pair does not ship
+ * (storefront spec §4.4: the reply is DISPLAYED, and the button to write one
+ * does not exist rather than existing switched off). Both stay in
+ * `manifest.json`, which lists the whole contract.
+ *
+ * No seller-wide rating fetch. The product model (spec fork F5) reviews the
+ * SELLER for a specific listing, so a seller's rating is a roll-up across
+ * their listings — which stapel-reviews cannot compute (one
+ * `(target_type, target_key)` per call) and the shop composite can
+ * (`shop.listing_review_summary`). `<ReviewAggregate aggregate={…}>` renders
+ * those two numbers from wherever the host got them; it does not invent an
+ * N+1 loop to fake the roll-up.
+ *
+ * No nav manifest: this pair has no route of its own. It renders INSIDE the
+ * listing detail page and the public seller profile, both of which belong to
+ * other pairs (the cdn-react precedent — a menu entry leading nowhere is
+ * worse than no entry).
+ *
+ * Layers: api → model → headless → i18n. Generated surfaces (the typed schema,
+ * the error map, the manifest, llms.txt) are produced by the monorepo `gen:*`
+ * drivers from stapel-reviews' own `docs/` artifacts and stand under drift
+ * gates.
+ */
+export { createReviewsApi } from "./api/reviewsApi.js";
+export type { ReviewsApi } from "./api/reviewsApi.js";
+export type { RatingAggregate, Review, ReviewAggregate as ReviewAggregateResponse, ReviewAnchorDirection, ReviewCreateRequest, ReviewListParams, ReviewOwnerResponse, ReviewPage, ReviewStatus, ReviewTarget, Schemas, } from "./api/types.js";
+export { createReviewsRuntime, DEFAULT_RATING_BOUNDS } from "./model/runtime.js";
+export type { CreateReviewsRuntimeOptions, ReviewRatingBounds, ReviewsRuntime, } from "./model/runtime.js";
+export { ReviewsRuntimeContext, useReviewsAnalytics, useReviewsApi, useReviewsRuntime, } from "./model/context.js";
+export { reviewsQueryKeys } from "./model/queryKeys.js";
+export { REVIEWS_PAGE, useReviewAggregate, useReviewList } from "./model/queries.js";
+export type { UseReviewListOptions } from "./model/queries.js";
+export { useSubmitReview } from "./model/mutations.js";
+export type { SubmitReviewVariables } from "./model/mutations.js";
+export { ratingSummary, starBreakdown } from "./model/rating.js";
+export type { RatingSummary, StarBreakdown } from "./model/rating.js";
+export { findOwnReview, isModeratedOut, reviewsFromPages, reviewVisibility, } from "./model/list.js";
+export { isDuplicateReview, isReviewingForbidden, isSignInRequired, isUnknownTargetType, REVIEWS_ERROR_ALREADY_RESPONDED, REVIEWS_ERROR_CANNOT_MODERATE, REVIEWS_ERROR_CANNOT_REVIEW, REVIEWS_ERROR_DUPLICATE, REVIEWS_ERROR_INVALID_RATING, REVIEWS_ERROR_NOT_FOUND, REVIEWS_ERROR_RESPONSE_NOT_ALLOWED, REVIEWS_ERROR_UNKNOWN_TARGET_TYPE, toReviewsError, } from "./model/refusals.js";
+export { ReviewsProvider } from "./headless/ReviewsProvider.js";
+export { ReviewList } from "./headless/ReviewList.js";
+export type { ReviewListBag, ReviewListProps } from "./headless/ReviewList.js";
+export { ReviewAggregate } from "./headless/ReviewAggregate.js";
+export type { ReviewAggregateBag, ReviewAggregateProps, } from "./headless/ReviewAggregate.js";
+export { ReviewForm } from "./headless/ReviewForm.js";
+export type { ReviewFormBag, ReviewFormProps } from "./headless/ReviewForm.js";
+export { REVIEWS_I18N_KEYS, registerReviewsI18n, reviewsI18nBundleEn, } from "./i18n/keys.js";
+export { explainReviewsError, REVIEWS_ERROR_CODES, REVIEWS_ERRORS, reviewsErrorBundleEn, } from "./i18n/errorsMap.js";
+export type { Remediation, ReviewsErrorCode, ReviewsErrorSpec, } 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,eAAe,EACf,MAAM,EACN,eAAe,IAAI,uBAAuB,EAC1C,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,OAAO,GACR,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACjF,YAAY,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,kCAAkC,EAClC,iCAAiC,EACjC,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG/E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,92 @@
+/**
+ * `@stapel/reviews-react` — the headless React pair for stapel-reviews
+ * (frontend-standard §2). Business + state only, zero visual opinion; the antd
+ * skin lives behind the `./default` subpath, so a host that renders its own
+ * review block carries none of it.
+ *
+ * ── The one-liner ──────────────────────────────────────────────────────────
+ *
+ * ```tsx
+ * const runtime = createReviewsRuntime({ baseUrl: "/reviews/api/v1" });
+ * const target = { targetType: "listing", targetKey: listingId };
+ * <ReviewsProvider runtime={runtime}>
+ *   <ReviewAggregate target={target}>{(bag) => <YourStars bag={bag} />}</ReviewAggregate>
+ *   <ReviewList target={target}>{(bag) => <YourRows bag={bag} />}</ReviewList>
+ *   <ReviewForm target={target}>{(bag) => <YourForm bag={bag} />}</ReviewForm>
+ * </ReviewsProvider>
+ * ```
+ *
+ * `"listing"` in that snippet is the HOST's registry key, not this library's:
+ * stapel-reviews ships an EMPTY `TARGET_TYPES` registry and this package
+ * exports no target-type constants (see `api/types.ts`, `ReviewTarget`).
+ *
+ * ── The four properties this pair exists to guarantee ──────────────────────
+ *
+ * 1. **A zero average is not a zero rating.** `avg` is `0.0` when `count` is
+ *    `0`, by the module's own contract. `ratingSummary()` answers
+ *    `rated: false` there and gives a skin nothing to draw a star row from, so
+ *    "nobody has rated this yet" can never be rendered as the worst possible
+ *    score. Same class as `data ?? []`.
+ * 2. **The refusal is read by CODE, never by status.** "You have already
+ *    reviewed this" is `error.400.reviews_duplicate_review` — a 400 — while
+ *    the module's only 409 says the owner's reply already exists. Branching on
+ *    the number would miss the first and mishandle the second
+ *    (`model/refusals.ts`).
+ * 3. **A 401 is not an empty list.** Every stapel-reviews endpoint is
+ *    `IsAuthenticated`, including both reads, so a signed-out visitor to a
+ *    public listing page gets 401 — and the empty state would tell them a
+ *    well-reviewed seller has never been reviewed. `signInRequired` is a
+ *    named state on both read bags.
+ * 4. **A review that is not published says so.** `status` is carried to the
+ *    screen (`pending` / `hidden`, plus an explicit `unknown` arm for a state
+ *    a future backend adds), and the submit outcome reports the created row's
+ *    status, so a pre-moderating deployment tells the author their review is
+ *    waiting instead of leaving them to look for it.
+ *
+ * ── What this pair does NOT do ─────────────────────────────────────────────
+ *
+ * No moderation and no owner reply. `POST {id}/moderate` and
+ * `POST {id}/response` are both gated on the target type's fail-closed
+ * `can_moderate` callback and belong to consoles this pair does not ship
+ * (storefront spec §4.4: the reply is DISPLAYED, and the button to write one
+ * does not exist rather than existing switched off). Both stay in
+ * `manifest.json`, which lists the whole contract.
+ *
+ * No seller-wide rating fetch. The product model (spec fork F5) reviews the
+ * SELLER for a specific listing, so a seller's rating is a roll-up across
+ * their listings — which stapel-reviews cannot compute (one
+ * `(target_type, target_key)` per call) and the shop composite can
+ * (`shop.listing_review_summary`). `<ReviewAggregate aggregate={…}>` renders
+ * those two numbers from wherever the host got them; it does not invent an
+ * N+1 loop to fake the roll-up.
+ *
+ * No nav manifest: this pair has no route of its own. It renders INSIDE the
+ * listing detail page and the public seller profile, both of which belong to
+ * other pairs (the cdn-react precedent — a menu entry leading nowhere is
+ * worse than no entry).
+ *
+ * Layers: api → model → headless → i18n. Generated surfaces (the typed schema,
+ * the error map, the manifest, llms.txt) are produced by the monorepo `gen:*`
+ * drivers from stapel-reviews' own `docs/` artifacts and stand under drift
+ * gates.
+ */
+// ── api ──────────────────────────────────────────────────────────────────────
+export { createReviewsApi } from "./api/reviewsApi.js";
+// ── model ────────────────────────────────────────────────────────────────────
+export { createReviewsRuntime, DEFAULT_RATING_BOUNDS } from "./model/runtime.js";
+export { ReviewsRuntimeContext, useReviewsAnalytics, useReviewsApi, useReviewsRuntime, } from "./model/context.js";
+export { reviewsQueryKeys } from "./model/queryKeys.js";
+export { REVIEWS_PAGE, useReviewAggregate, useReviewList } from "./model/queries.js";
+export { useSubmitReview } from "./model/mutations.js";
+export { ratingSummary, starBreakdown } from "./model/rating.js";
+export { findOwnReview, isModeratedOut, reviewsFromPages, reviewVisibility, } from "./model/list.js";
+export { isDuplicateReview, isReviewingForbidden, isSignInRequired, isUnknownTargetType, REVIEWS_ERROR_ALREADY_RESPONDED, REVIEWS_ERROR_CANNOT_MODERATE, REVIEWS_ERROR_CANNOT_REVIEW, REVIEWS_ERROR_DUPLICATE, REVIEWS_ERROR_INVALID_RATING, REVIEWS_ERROR_NOT_FOUND, REVIEWS_ERROR_RESPONSE_NOT_ALLOWED, REVIEWS_ERROR_UNKNOWN_TARGET_TYPE, toReviewsError, } from "./model/refusals.js";
+// ── headless ─────────────────────────────────────────────────────────────────
+export { ReviewsProvider } from "./headless/ReviewsProvider.js";
+export { ReviewList } from "./headless/ReviewList.js";
+export { ReviewAggregate } from "./headless/ReviewAggregate.js";
+export { ReviewForm } from "./headless/ReviewForm.js";
+// ── i18n ─────────────────────────────────────────────────────────────────────
+export { REVIEWS_I18N_KEYS, registerReviewsI18n, reviewsI18nBundleEn, } from "./i18n/keys.js";
+export { explainReviewsError, REVIEWS_ERROR_CODES, REVIEWS_ERRORS, reviewsErrorBundleEn, } 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AAEH,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAgBvD,gFAAgF;AAChF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAMjF,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,kCAAkC,EAClC,iCAAiC,EACjC,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAKhE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,gFAAgF;AAChF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/model/context.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "react";
+import type { Analytics, ModuleContextKit } from "@stapel/core";
+import type { ReviewsApi } from "../api/reviewsApi.js";
+import type { ReviewsRuntime } from "./runtime.js";
+export declare const ReviewsRuntimeContext: Context<ReviewsRuntime | null>;
+export declare const useReviewsRuntime: () => ReviewsRuntime;
+export declare const useReviewsApi: () => ReviewsApi;
+export declare const useReviewsAnalytics: () => Analytics | null;
+/** @internal Re-exported as `<ReviewsProvider>` from `headless/`. */
+export declare const ModuleProvider: ModuleContextKit<ReviewsRuntime>["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,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAYnD,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,cAAc,GAAG,IAAI,CAC7C,CAAC;AAErB,eAAO,MAAM,iBAAiB,EAAE,MAAM,cAA+B,CAAC;AAEtE,eAAO,MAAM,aAAa,EAAE,MAAM,UAAuB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,EAAE,MAAM,SAAS,GAAG,IAAuB,CAAC;AAE5E,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC,UAAU,CAC1D,CAAC"}

package/dist/model/context.js

@@ -0,0 +1,16 @@
+import { createModuleContext } from "@stapel/core";
+/**
+ * The wired ReviewsRuntime shared through React context by
+ * `<ReviewsProvider>`. 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("Reviews");
+export const ReviewsRuntimeContext = kit.RuntimeContext;
+export const useReviewsRuntime = kit.useRuntime;
+export const useReviewsApi = kit.useApi;
+export const useReviewsAnalytics = kit.useAnalytics;
+/** @internal Re-exported as `<ReviewsProvider>` 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,CAAiB,SAAS,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAChC,GAAG,CAAC,cAAc,CAAC;AAErB,MAAM,CAAC,MAAM,iBAAiB,GAAyB,GAAG,CAAC,UAAU,CAAC;AAEtE,MAAM,CAAC,MAAM,aAAa,GAAqB,GAAG,CAAC,MAAM,CAAC;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAA2B,GAAG,CAAC,YAAY,CAAC;AAE5E,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GACzB,GAAG,CAAC,QAAQ,CAAC"}

package/dist/model/list.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Pure readers over a loaded list of reviews — no React, no queries, so a
+ * card, a test and a server-rendered page can all use them.
+ */
+import type { InfiniteData } from "@tanstack/react-query";
+import type { Review, ReviewPage, ReviewStatus } from "../api/types.js";
+/**
+ * Flatten the pages of the infinite list into one newest-first run.
+ *
+ * Deliberately takes `InfiniteData | undefined` and answers `undefined` for
+ * "not loaded", never `[]`: an empty array here is a claim that the target
+ * has no reviews, and the caller must get that claim from a READY load state
+ * (`stapel/no-flattened-load-state` — the rule exists because a total outage
+ * once rendered as "you have no workspaces").
+ */
+export declare function reviewsFromPages(data: InfiniteData<ReviewPage, string | undefined> | undefined): readonly Review[] | undefined;
+/**
+ * A review's visibility, narrowed — with a fourth arm for a state this build
+ * does not know.
+ *
+ * `status` is a bare `string` on the wire. A build that met a new upstream
+ * state and silently rendered it as published would be showing something the
+ * server may have hidden; one that crashed on it would take the page down.
+ * `"unknown"` is neither: the skin shows the row with an explicit "this
+ * version does not know this state" badge, the same shape attributes-react
+ * uses for an unsupported feature type.
+ */
+export declare function reviewVisibility(status: string): ReviewStatus | "unknown";
+/** Is this row one a moderator sees only because they asked for `include=all`? */
+export declare function isModeratedOut(review: Review): boolean;
+/**
+ * The viewer's own review of this target, if it is in the loaded rows.
+ *
+ * THIS IS AN OPTIMISTIC PRE-CHECK, AND IT HAS A KNOWN HOLE — recorded here
+ * because the hole is in the contract, not in the code. The list a
+ * non-moderator reads is published-only, so under `moderation: "pre"` the
+ * author's own review is INVISIBLE TO ITS AUTHOR while it waits: this
+ * function answers `undefined`, the form offers itself again, and the server
+ * refuses the second attempt with `error.400.reviews_duplicate_review`.
+ *
+ * That is why the refusal is a first-class outcome of the form
+ * (`headless/ReviewForm.tsx`) rather than something the pre-check was
+ * supposed to prevent. The pre-check saves a pointless round trip in the
+ * common (post-moderation) case; it is never the authority.
+ *
+ * `viewerId` must be the id the backend puts in `author_id` — the user id,
+ * NOT a profile id. A host that passes the wrong one gets `undefined`, i.e.
+ * the form offered where it need not have been, and the server still holds
+ * the line.
+ */
+export declare function findOwnReview(reviews: readonly Review[] | undefined, viewerId: string | null | undefined): Review | undefined;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/model/list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GAC7D,SAAS,MAAM,EAAE,GAAG,SAAS,CAG/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GACb,YAAY,GAAG,SAAS,CAI1B;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,GAAG,SAAS,CAGpB"}