@stapel/reviews-react 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1 +1,114 @@
 # @stapel/reviews-react
+
+## 0.3.0
+
+### Minor Changes
+
+- 3e2e2a3: A blocked control now carries the door, not just the reason: `signIn`
+
+  `actionBlocked` ended the grey-rectangle incident by making every switched-off
+  control state its reason. It did not end the next one. "Sign in to save this",
+  "sign in to leave a review", "sign in to message the seller" are reasons whose
+  next action is a LINK, and no pair took one — so the storefront had to put its
+  own notice a screen away from each of the three controls it was about, and
+  named it a gap rather than shipping it (Wave D, G-3).
+
+  All three now take the same prop, core's `SignInCta`:
+
+  ```tsx
+  <ListingCard listing={row} signIn={{ href: `/login?next=${here}` }} />
+  <ReviewsPanel target={target} signIn={{ href: `/login?next=${here}` }} />
+  <StartChatButton sellerId={sellerId} signIn={{ onSignIn: () => openModal() }} />
+  ```
+
+  `{href}` **or** `{onSignIn}`, never both. Omit it and the reason renders alone,
+  with no trailing whitespace where the link is not — a host with no sign-in
+  route is a supported host.
+
+  Two more things each pair had to fix to make the door reachable:
+
+  - **listings**: the favourite's reason lived only in a `title` on a DISABLED
+    button, which receives no pointer events in any browser — core's own
+    `actionGate.ts` calls that "a reason nobody can read". It is now text beside
+    the heart (`listings-card-favorite-blocked`), with the link inside it. The
+    heart is still never hidden from a visitor.
+  - **chat**: `StartDirectChat` had no mandate gate at all, so a visitor could
+    press "message the seller" and collect a 401 — a refusal delivered at the one
+    moment it is useless. The axis is now the first arm of its `firstBlock`, read
+    through core's `MandateSource` seam. `member` may write; `guest`/`anonymous`
+    are told to sign in; `asking` says we are still asking. `unavailable` stays
+    AVAILABLE on purpose: that is what core answers outside a `<MandateProvider>`
+    too, and a host that never wired the axis must not lose its button — "we
+    could not ask" is not "you may not". This raises chat-react's `@stapel/core`
+    floor to `>=0.15.0`, where `useMandate`/`matchMandate` shipped.
+
+  The link's LABEL is each pair's own (`listings.card.sign_in`,
+  `reviews.form.sign_in`, `chat.start.sign_in`), in all three locales — core
+  floors `en` and `ru`, and these pairs also ship `es`.
+
+## 0.2.0
+
+### Minor Changes
+
+- 23eeaff: New pair: `@stapel/reviews-react` — ratings and reviews of an opaque
+  `(target_type, target_key)`, with the four lies the contract makes easy
+  refused once, here, instead of being rediscovered per host.
+
+  - **A zero average is not a zero rating.** `GET /reviews/aggregate` answers
+    `{"avg": 0.0, "count": 0}` for a target nobody has rated, and its own schema
+    says so. `ratingSummary()` reports `rated: false` there — and has no `avg` on
+    that branch of the type — so a star row cannot be drawn from it. Same class
+    as `data ?? []`: a number that was never measured, displayed as if it had
+    been measured and found to be the worst possible score.
+  - **"You have already reviewed this" is a 400.** It is
+    `error.400.reviews_duplicate_review`, while the module's ONLY 409
+    (`error.409.reviews_already_responded`) is about the seller's reply — so a
+    form branching on the status misses the first and mishandles the second.
+    Every refusal here is read by CODE. The optimistic pre-check
+    (`findOwnReview`) exists and its hole is written down: the list is
+    published-only, so under pre-moderation the author's own pending review is
+    invisible to its author and the server is the one that says no.
+  - **A guest reads the reviews; only the write asks them to sign in.** Both
+    reads are anonymous (`IsAuthenticatedOrReadOnly` on the list class — GET
+    open, POST still needs an author to attribute the review to — and `AllowAny`
+    on the aggregate, both throttled from the module's own settings). So
+    `signInRequired` lives on the form bag alone, where a 401 is still the honest
+    answer, and an empty list means what it says to everybody. Nothing new became
+    visible to a guest: both endpoints were already published-only for a
+    non-moderator.
+  - **A review that is not published says so.** `pending` / `hidden` rows carry a
+    badge, a status this build does not know is named rather than rendered as an
+    ordinary review, and the submit outcome reports the created row's status so a
+    pre-moderating deployment can say "it will appear once checked".
+
+  The list envelope comes from codegen. `GET /reviews` returns core's
+  `AnchorPagination` envelope and always did, but `ReviewListCreateView`
+  instantiates its paginator inside `get()` instead of declaring a
+  `pagination_class`, so drf-spectacular used to render the response as a bare
+  array and its `anchor`/`limit`/`direction` parameters not at all.
+  stapel-reviews 0.3.0 declares both (`components/ReviewPage`, and `direction`
+  with an enum), so `ReviewPage`, `ReviewListParams` and `ReviewAnchorDirection`
+  are projections of the generated schema rather than copies this package
+  maintains.
+
+  The seller-level rating is a DISPLAY, not a fetch: reviews target the seller
+  for a specific listing, so a seller's rating is a roll-up the module cannot
+  compute (one `(target_type, target_key)` per call) and the shop composite can
+  (`shop.listing_review_summary` → `{avg, count}`, the owner's field names on
+  purpose). `<RatingBadge aggregate={…}>` renders those two numbers with no
+  request; publishing them over HTTP is the composite's job and is recorded as an
+  open gap rather than faked with an N+1 loop.
+
+  Surface: `createReviewsRuntime`/`ReviewsProvider`, three read/write hooks, the
+  pure `rating`/`list`/`refusals` readers, three headless bags, and an opt-in
+  `./default` antd skin (`ReviewsPanel`, `ReviewListPanel`, `ReviewFormCard`,
+  `RatingBadge`). en/ru/es, with the 9 module-owned error keys authored by the
+  pair because stapel-reviews ships no `translations/`. Pinned to stapel-reviews
+  0.3.0 (`>=0.3 <0.4`).
+
+  Not in scope, and not by omission: `POST {id}/moderate` and
+  `POST {id}/response` are both gated on the fail-closed `can_moderate` callback
+  and belong to a moderator console and a seller console; the reply is displayed
+  and the button to write one does not exist rather than existing switched off.
+  No nav manifest either — the pair renders inside somebody else's route.
+  `manifest.json` still lists the whole contract.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stapel contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MODULE.md

@@ -46,6 +46,22 @@ author) and `AllowAny` on the aggregate, both with
 than the project's `DEFAULT_THROTTLE_RATES`. Nothing new became visible to a
 guest: both endpoints were already published-only for a non-moderator.
 
+## The sentence and the door
+
+`signInRequired` is true at exactly the right moment — the reads are anonymous
+and the POST is not, so the author learns it when there is something to attach
+to a name. What it did not have was a next action: the skin printed "sign in to
+leave a review" and stopped, and the storefront had to put its own notice a
+screen away from the control it was about (Wave D, G-3).
+
+`<ReviewFormCard signIn={…}>` (and `<ReviewsPanel signIn={…}>`, which passes it
+down) renders the link INSIDE the element that carries the sentence.
+`SignInCta` is core's — `{href}` or `{onSignIn}`, never both — so the prop is
+spelled identically in `@stapel/chat-react` and `@stapel/listings-react`; the
+LABEL is this pair's (`reviews.form.sign_in`, all three locales), because core
+floors only `en` and `ru`. Omitted, the sentence renders alone and carries no
+trailing whitespace where the link is not.
+
 ## The three contract facts this package still absorbs
 
 ### 1. The list body is the pagination envelope — now declared

package/README.md

@@ -36,6 +36,14 @@ export function ListingReviews({ listingId, me }) {
 }
 ```
 
+`<ReviewsPanel signIn={{ href: `/login?next=${here}` }}>` (and
+`<ReviewFormCard>` directly) puts the door beside "sign in to leave a review":
+the reads are anonymous, the POST is not, so the sentence is true at exactly
+the moment it appears — and until 0.4.0 it dead-ended, because no pair took a
+sign-in href. `signIn` is core's `SignInCta`, `{href}` **or** `{onSignIn}`,
+the same prop `@stapel/chat-react` and `@stapel/listings-react` take. Omit it
+and the sentence renders alone.
+
 `"listing"` is **your** registry key, not this library's. stapel-reviews ships
 an empty `TARGET_TYPES` registry and knows nothing about listings; the shop
 composite registers that name in `stapel_shop/preset.py`. This package

package/dist/api/generated/schema.d.ts

@@ -11,7 +11,7 @@ export interface paths {
          *     non-moderators), or create a review.
          *
          *     ``GET`` is anonymously readable (storefront F5 verdict,
-         *     darom-storefront-design.md §13.8 note 2) — published-only filtering
+         *     the storefront spec §13.8 note 2) — published-only filtering
          *     already guarantees a guest sees nothing a moderator would need to hide.
          *     ``POST`` still requires a real identity (there is an author to attribute
          *     the review to), so the class gate is DRF's own
@@ -28,7 +28,7 @@ export interface paths {
          *     non-moderators), or create a review.
          *
          *     ``GET`` is anonymously readable (storefront F5 verdict,
-         *     darom-storefront-design.md §13.8 note 2) — published-only filtering
+         *     the storefront spec §13.8 note 2) — published-only filtering
          *     already guarantees a guest sees nothing a moderator would need to hide.
          *     ``POST`` still requires a real identity (there is an author to attribute
          *     the review to), so the class gate is DRF's own
@@ -101,7 +101,7 @@ export interface paths {
          *     for a target.
          *
          *     Anonymously readable for the same reason as the list's ``GET``
-         *     (storefront F5 verdict, darom-storefront-design.md §13.8 note 2): the
+         *     (storefront F5 verdict, the storefront spec §13.8 note 2): the
          *     aggregate is computed over published reviews only, so a guest learns
          *     nothing a moderator would need withheld.
          *
@@ -178,7 +178,7 @@ export interface components {
          *     only fires for ``GenericAPIView.pagination_class`` — never sees
          *     ``ReviewAnchorPagination``, and the envelope has to be declared by hand
          *     or spectacular renders the response as a bare array
-         *     (darom-storefront-design.md §13.8 note 3).
+         *     (the storefront spec §13.8 note 3).
          */
         ReviewPage: {
             items: components["schemas"]["ReviewResponse"][];

package/dist/default/ReviewFormCard.d.ts

@@ -14,9 +14,10 @@
  *   that is deliberately invisible to them.
  */
 import type { ReactElement } from "react";
+import type { SignInCtaProp } from "@stapel/core";
 import type { ReviewTarget } from "../api/types.js";
 import type { ThemeModeProp } from "./types.js";
-export interface ReviewFormCardProps extends ThemeModeProp {
+export interface ReviewFormCardProps extends ThemeModeProp, SignInCtaProp {
     readonly target: ReviewTarget;
     /** The host already knows this author has reviewed the target (optimistic). */
     readonly alreadyReviewed?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"ReviewFormCard.d.ts","sourceRoot":"","sources":["../../src/default/ReviewFormCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AA2FD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAiBvE"}
+{"version":3,"file":"ReviewFormCard.d.ts","sourceRoot":"","sources":["../../src/default/ReviewFormCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,mBAAoB,SAAQ,aAAa,EAAE,aAAa;IACvE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AA+FD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAmBvE"}

package/dist/default/ReviewFormCard.js

@@ -4,6 +4,7 @@ import { useActionGate, useDescribeFlowError, useT } from "@stapel/core";
 import { ReviewForm } from "../headless/ReviewForm.js";
 import { REVIEWS_I18N_KEYS } from "../i18n/keys.js";
 import { ErrorAlert } from "./ErrorAlert.js";
+import { SignInLink } from "./SignInLink.js";
 import { ReviewsSkinTheme } from "./theme.js";
 /** The sentence for a review that exists but may not be on the page. */
 function sentKey(bag) {
@@ -30,13 +31,15 @@ function FormBody(props) {
         return (_jsx(Typography.Text, { type: "secondary", "data-testid": "reviews-form-duplicate", children: t(REVIEWS_I18N_KEYS.submitBlockedDuplicate) }));
     }
     if (bag.signInRequired) {
-        return (_jsx(Typography.Text, { type: "secondary", "data-testid": "reviews-form-sign-in", children: t(REVIEWS_I18N_KEYS.formSignInRequired) }));
+        return (_jsxs(Typography.Text, { type: "secondary", "data-testid": "reviews-form-sign-in", children: [t(REVIEWS_I18N_KEYS.formSignInRequired), _jsx(SignInLink, { cta: props.signIn, testId: "reviews-form-sign-in-cta" })] }));
     }
     return (_jsxs(Flex, { vertical: true, gap: 8, children: [_jsx(Typography.Text, { children: t(REVIEWS_I18N_KEYS.formRatingLabel) }), _jsx(Rate, { count: bag.bounds.max, value: bag.rating ?? 0, onChange: bag.setRating, "data-testid": "reviews-form-rate" }), _jsx(Typography.Text, { children: t(REVIEWS_I18N_KEYS.formBodyLabel) }), _jsx(Input.TextArea, { value: bag.body, onChange: (event) => bag.setBody(event.target.value), placeholder: t(REVIEWS_I18N_KEYS.formBodyPlaceholder), rows: 3, "data-testid": "reviews-form-body" }), bag.error ? (_jsx(ErrorAlert, { testId: "reviews-form-failed", error: describe(bag.error) })) : null, _jsxs(Flex, { vertical: true, gap: 4, align: "flex-start", children: [_jsx(Button, { type: "primary", onClick: bag.submit, disabled: gate.disabled, loading: bag.submitting, "data-testid": "reviews-form-submit", "data-analytics": "none", "data-analytics-reason": "business action \u2014 the host app wraps this with its own tracked(); the pair ships no analytics runtime and no flow machine for a single POST", children: t(REVIEWS_I18N_KEYS.formSubmit) }), gate.reason ? (_jsx(Typography.Text, { type: "secondary", "data-testid": "reviews-form-blocked", children: gate.reason })) : null] })] }));
 }
 export function ReviewFormCard(props) {
     const t = useT();
-    const { mode, ...formProps } = props;
-    return (_jsx(ReviewsSkinTheme, { ...(mode !== undefined ? { mode } : {}), children: _jsx(Card, { size: "small", "data-testid": "reviews-form", children: _jsxs(Flex, { vertical: true, gap: 8, children: [_jsx(Typography.Title, { level: 5, style: { margin: 0 }, children: t(REVIEWS_I18N_KEYS.formHeading) }), _jsx(ReviewForm, { ...formProps, children: (bag) => _jsx(FormBody, { bag: bag }) })] }) }) }));
+    // `signIn` is this card's, not the headless form's: the form knows THAT the
+    // author must sign in, the container knows WHERE.
+    const { mode, signIn, ...formProps } = props;
+    return (_jsx(ReviewsSkinTheme, { ...(mode !== undefined ? { mode } : {}), children: _jsx(Card, { size: "small", "data-testid": "reviews-form", children: _jsxs(Flex, { vertical: true, gap: 8, children: [_jsx(Typography.Title, { level: 5, style: { margin: 0 }, children: t(REVIEWS_I18N_KEYS.formHeading) }), _jsx(ReviewForm, { ...formProps, children: (bag) => _jsx(FormBody, { bag: bag, signIn: signIn }) })] }) }) }));
 }
 //# sourceMappingURL=ReviewFormCard.js.map

package/dist/default/ReviewFormCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReviewFormCard.js","sourceRoot":"","sources":["../../src/default/ReviewFormCard.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReviewFormCard.js","sourceRoot":"","sources":["../../src/default/ReviewFormCard.tsx"],"names":[],"mappings":";AAgBA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGzE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAS9C,wEAAwE;AACxE,SAAS,OAAO,CAAC,GAAkB;IACjC,QAAQ,GAAG,CAAC,mBAAmB,EAAE,CAAC;QAChC,KAAK,WAAW;YACd,OAAO,iBAAiB,CAAC,iBAAiB,CAAC;QAC7C,KAAK,SAAS;YACZ,OAAO,iBAAiB,CAAC,eAAe,CAAC;QAC3C,KAAK,QAAQ;YACX,OAAO,iBAAiB,CAAC,cAAc,CAAC;QAC1C;YACE,OAAO,iBAAiB,CAAC,eAAe,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAGjB;IACC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IACtB,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAE1C,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,CACL,KAAC,KAAK,IACJ,IAAI,EAAC,SAAS,EACd,QAAQ,uBACI,mBAAmB,EAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GACxB,CACH,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxB,OAAO,CACL,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,iBAAa,wBAAwB,YACnE,CAAC,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,GAC5B,CACnB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;QACvB,OAAO,CACL,MAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,iBAAa,sBAAsB,aACjE,CAAC,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EACxC,KAAC,UAAU,IAAC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAC,0BAA0B,GAAG,IACnD,CACnB,CAAC;IACJ,CAAC;IAED,OAAO,CACL,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,CAAC,aACnB,KAAC,UAAU,CAAC,IAAI,cAAE,CAAC,CAAC,iBAAiB,CAAC,eAAe,CAAC,GAAmB,EACzE,KAAC,IAAI,IACH,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,EACrB,KAAK,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,EACtB,QAAQ,EAAE,GAAG,CAAC,SAAS,iBACX,mBAAmB,GAC/B,EACF,KAAC,UAAU,CAAC,IAAI,cAAE,CAAC,CAAC,iBAAiB,CAAC,aAAa,CAAC,GAAmB,EACvE,KAAC,KAAK,CAAC,QAAQ,IACb,KAAK,EAAE,GAAG,CAAC,IAAI,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EACpD,WAAW,EAAE,CAAC,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,EACrD,IAAI,EAAE,CAAC,iBACK,mBAAmB,GAC/B,EACD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CACX,KAAC,UAAU,IAAC,MAAM,EAAC,qBAAqB,EAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAI,CACxE,CAAC,CAAC,CAAC,IAAI,EACR,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAC,YAAY,aACvC,KAAC,MAAM,IACL,IAAI,EAAC,SAAS,EACd,OAAO,EAAE,GAAG,CAAC,MAAM,EACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,EACvB,OAAO,EAAE,GAAG,CAAC,UAAU,iBACX,qBAAqB,oBAClB,MAAM,2BACC,kJAA6I,YAElK,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,GACzB,EACR,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CACb,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,iBAAa,sBAAsB,YACjE,IAAI,CAAC,MAAM,GACI,CACnB,CAAC,CAAC,CAAC,IAAI,IACH,IACF,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,4EAA4E;IAC5E,kDAAkD;IAClD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IAC7C,OAAO,CACL,KAAC,gBAAgB,OAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YACxD,KAAC,IAAI,IAAC,IAAI,EAAC,OAAO,iBAAa,cAAc,YAC3C,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,CAAC,aACnB,KAAC,UAAU,CAAC,KAAK,IAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,YAC7C,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,GAChB,EACnB,KAAC,UAAU,OAAK,SAAS,YACtB,CAAC,GAAG,EAAE,EAAE,CAAC,KAAC,QAAQ,IAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAI,GACrC,IACR,GACF,GACU,CACpB,CAAC;AACJ,CAAC"}

package/dist/default/ReviewsPanel.d.ts

@@ -14,9 +14,10 @@
  * outcome and the pre-check is only an optimisation.
  */
 import type { ReactElement, ReactNode } from "react";
+import type { SignInCtaProp } from "@stapel/core";
 import type { Review, ReviewTarget } from "../api/types.js";
 import type { ThemeModeProp } from "./types.js";
-export interface ReviewsPanelProps extends ThemeModeProp {
+export interface ReviewsPanelProps extends ThemeModeProp, SignInCtaProp {
     readonly target: ReviewTarget;
     /**
      * The reader's user id — the value the backend puts in `author_id`, NOT a

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

@@ -1 +1 @@
-{"version":3,"file":"ReviewsPanel.d.ts","sourceRoot":"","sources":["../../src/default/ReviewsPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC;CACrD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAiCnE"}
+{"version":3,"file":"ReviewsPanel.d.ts","sourceRoot":"","sources":["../../src/default/ReviewsPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,iBAAkB,SAAQ,aAAa,EAAE,aAAa;IACrE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC;CACrD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAkCnE"}

package/dist/default/ReviewsPanel.js

@@ -7,11 +7,11 @@ import { ReviewFormCard } from "./ReviewFormCard.js";
 import { ReviewListPanel } from "./ReviewListPanel.js";
 import { ReviewsSkinTheme } from "./theme.js";
 export function ReviewsPanel(props) {
-    const { mode, target, viewerId, canReview = true, ...rows } = props;
+    const { mode, target, viewerId, canReview = true, signIn, ...rows } = props;
     return (_jsx(ReviewsSkinTheme, { ...(mode !== undefined ? { mode } : {}), children: _jsxs(Flex, { vertical: true, gap: 16, "data-testid": "reviews-panel", children: [_jsx(RatingBadge, { target: target, ...(mode !== undefined ? { mode } : {}) }), _jsx(ReviewListPanel, { target: target, ...(mode !== undefined ? { mode } : {}), ...rows }), canReview ? (
                 // The list is read a second time here, from the SAME query key, so
                 // this is a cache hit rather than a second request — the own-review
                 // pre-check needs the rows and the panel needs them rendered.
-                _jsx(ReviewList, { target: target, children: (bag) => (_jsx(ReviewFormCard, { target: target, ...(mode !== undefined ? { mode } : {}), alreadyReviewed: findOwnReview(bag.state.status === "ready" ? bag.state.data : undefined, viewerId) !== undefined })) })) : null] }) }));
+                _jsx(ReviewList, { target: target, children: (bag) => (_jsx(ReviewFormCard, { target: target, ...(mode !== undefined ? { mode } : {}), ...(signIn !== undefined ? { signIn } : {}), alreadyReviewed: findOwnReview(bag.state.status === "ready" ? bag.state.data : undefined, viewerId) !== undefined })) })) : null] }) }));
 }
 //# sourceMappingURL=ReviewsPanel.js.map

package/dist/default/ReviewsPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReviewsPanel.js","sourceRoot":"","sources":["../../src/default/ReviewsPanel.tsx"],"names":[],"mappings":";AAgBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiB9C,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACpE,OAAO,CACL,KAAC,gBAAgB,OAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YACxD,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,EAAE,iBAAc,eAAe,aACjD,KAAC,WAAW,IAAC,MAAM,EAAE,MAAM,KAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAI,EACzE,KAAC,eAAe,IACd,MAAM,EAAE,MAAM,KACV,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACpC,IAAI,GACR,EACD,SAAS,CAAC,CAAC,CAAC;gBACX,mEAAmE;gBACnE,oEAAoE;gBACpE,8DAA8D;gBAC9D,KAAC,UAAU,IAAC,MAAM,EAAE,MAAM,YACvB,CAAC,GAAG,EAAE,EAAE,CAAC,CACR,KAAC,cAAc,IACb,MAAM,EAAE,MAAM,KACV,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACxC,eAAe,EACb,aAAa,CACX,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EACzD,QAAQ,CACT,KAAK,SAAS,GAEjB,CACH,GACU,CACd,CAAC,CAAC,CAAC,IAAI,IACH,GACU,CACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ReviewsPanel.js","sourceRoot":"","sources":["../../src/default/ReviewsPanel.tsx"],"names":[],"mappings":";AAgBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiB9C,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAC5E,OAAO,CACL,KAAC,gBAAgB,OAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YACxD,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,EAAE,iBAAc,eAAe,aACjD,KAAC,WAAW,IAAC,MAAM,EAAE,MAAM,KAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAI,EACzE,KAAC,eAAe,IACd,MAAM,EAAE,MAAM,KACV,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACpC,IAAI,GACR,EACD,SAAS,CAAC,CAAC,CAAC;gBACX,mEAAmE;gBACnE,oEAAoE;gBACpE,8DAA8D;gBAC9D,KAAC,UAAU,IAAC,MAAM,EAAE,MAAM,YACvB,CAAC,GAAG,EAAE,EAAE,CAAC,CACR,KAAC,cAAc,IACb,MAAM,EAAE,MAAM,KACV,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACpC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC5C,eAAe,EACb,aAAa,CACX,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EACzD,QAAQ,CACT,KAAK,SAAS,GAEjB,CACH,GACU,CACd,CAAC,CAAC,CAAC,IAAI,IACH,GACU,CACpB,CAAC;AACJ,CAAC"}

package/dist/default/SignInLink.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The door beside a blocked control.
+ *
+ * `actionBlocked` ended the grey-rectangle incident by making every
+ * switched-off control state its reason. It did not end the next problem:
+ * "sign in to leave a review" is a reason whose next action is a LINK, and
+ * this pair rendered the sentence and stopped there — leaving the visitor to
+ * find the header themselves (storefront Wave D, G-3).
+ *
+ * WHERE that link goes is the container's business, never the pair's: the
+ * storefront's is `/login?next=<current>`, a tenant app's may be a modal. So
+ * the shape is core's `SignInCta` — `{href}` or `{onSignIn}`, never both — and
+ * the copy is this pair's, because core floors `en` and `ru` while this pair
+ * also ships `es`.
+ *
+ * A host that routes internally passes `onSignIn`; the `href` arm renders a
+ * plain anchor on purpose, because arriving at a sign-in page is one of the
+ * few navigations a full load costs nothing.
+ */
+import type { ReactElement } from "react";
+import type { SignInCta } from "@stapel/core";
+export interface SignInLinkProps {
+    /** Absent: no link — a host with no sign-in route shows the reason alone. */
+    readonly cta: SignInCta | undefined;
+    readonly testId: string;
+}
+export declare function SignInLink(props: SignInLinkProps): ReactElement | null;
+//# sourceMappingURL=SignInLink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SignInLink.d.ts","sourceRoot":"","sources":["../../src/default/SignInLink.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,GAAG,IAAI,CAsBtE"}

package/dist/default/SignInLink.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Typography } from "antd";
+import { useT } from "@stapel/core";
+import { REVIEWS_I18N_KEYS } from "../i18n/keys.js";
+export function SignInLink(props) {
+    const t = useT();
+    const { cta } = props;
+    if (cta === undefined)
+        return null;
+    // The separating space belongs HERE, not at the call site: a reason with no
+    // door must render as exactly its own sentence, and a `{" "}` left behind by
+    // an absent link is a trailing space in every caller's assertion.
+    return (_jsxs(_Fragment, { children: [" ", _jsx(Typography.Link, { "data-testid": props.testId, "data-analytics": "none", "data-analytics-reason": "business action \u2014 host app wraps with its own tracked()", ...(cta.href !== undefined
+                    ? { href: cta.href }
+                    : { onClick: cta.onSignIn }), children: t(REVIEWS_I18N_KEYS.formSignIn) })] }));
+}
+//# sourceMappingURL=SignInLink.js.map

package/dist/default/SignInLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignInLink.js","sourceRoot":"","sources":["../../src/default/SignInLink.tsx"],"names":[],"mappings":";AAoBA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAQpD,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IACtB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,4EAA4E;IAC5E,6EAA6E;IAC7E,kEAAkE;IAClE,OAAO,CACL,8BACG,GAAG,EACJ,KAAC,UAAU,CAAC,IAAI,mBACD,KAAK,CAAC,MAAM,oBACV,MAAM,2BACC,8DAAyD,KAC3E,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS;oBACzB,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;oBACpB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,YAE7B,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAChB,IACjB,CACJ,CAAC;AACJ,CAAC"}

package/dist/default/index.d.ts

@@ -28,4 +28,6 @@ export { ReviewsSkinTheme } from "./theme.js";
 export type { ReviewsSkinThemeProps } from "./theme.js";
 export { ErrorAlert } from "./ErrorAlert.js";
 export type { ThemeModeProp } from "./types.js";
+export { SignInLink } from "./SignInLink.js";
+export type { SignInLinkProps } from "./SignInLink.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/default/index.js

@@ -22,4 +22,5 @@ export { ReviewFormCard } from "./ReviewFormCard.js";
 export { RatingBadge } from "./RatingBadge.js";
 export { ReviewsSkinTheme } from "./theme.js";
 export { ErrorAlert } from "./ErrorAlert.js";
+export { SignInLink } from "./SignInLink.js";
 //# sourceMappingURL=index.js.map

package/dist/default/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/i18n/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAyDjC,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,SAAO,GAAG,IAAI,CAE7E"}
+{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/i18n/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;GAYG;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/es.js

@@ -53,6 +53,7 @@ export const reviewsI18nBundleEs = {
     "reviews.form.sent.hidden": "Tu reseña se ha guardado, pero no se muestra",
     "reviews.form.sent.unknown": "Tu reseña se ha guardado",
     "reviews.form.sign_in_required": "Inicia sesión para dejar una reseña",
+    "reviews.form.sign_in": "Iniciar sesión",
     "reviews.submit.blocked.no_rating": "Elige primero una valoración",
     "reviews.submit.blocked.pending": "Enviando…",
     "reviews.submit.blocked.duplicate": "Ya has valorado esto",

package/dist/i18n/es.js.map

@@ -1 +1 @@
-{"version":3,"file":"es.js","sourceRoot":"","sources":["../../src/i18n/es.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,oEAAoE;IACpE,GAAG,oBAAoB;IAEvB,2DAA2D;IAC3D,oCAAoC,EAAE,sBAAsB;IAC5D,6CAA6C,EAC3C,4DAA4D;IAC9D,kCAAkC,EAAE,8CAA8C;IAClF,wCAAwC,EACtC,4DAA4D;IAC9D,uCAAuC,EAAE,sCAAsC;IAC/E,mCAAmC,EACjC,8CAA8C;IAChD,iCAAiC,EAAE,+BAA+B;IAClE,oCAAoC,EAAE,sBAAsB;IAC5D,qCAAqC,EAAE,oCAAoC;IAE3E,WAAW;IACX,uBAAuB,EAAE,iCAAiC;IAE1D,sBAAsB,EAAE,SAAS;IACjC,oBAAoB,EAAE,wBAAwB;IAC9C,wBAAwB,EAAE,SAAS;IACnC,sBAAsB,EAAE,YAAY;IACpC,+BAA+B,EAAE,aAAa;IAC9C,mCAAmC,EAAE,WAAW;IAEhD,gCAAgC,EAAE,YAAY;IAC9C,iCAAiC,EAAE,wBAAwB;IAE3D,wBAAwB,EAAE,yBAAyB;IACnD,uBAAuB,EAAE,uBAAuB;IAChD,wBAAwB,EAAE,8BAA8B;IAExD,qBAAqB,EAAE,wBAAwB;IAC/C,sBAAsB,EAAE,gBAAgB;IACxC,sBAAsB,EAAE,iBAAiB;IACzC,2BAA2B,EAAE,kBAAkB;IAE/C,sBAAsB,EAAE,aAAa;IACrC,2BAA2B,EAAE,eAAe;IAC5C,yBAAyB,EAAE,WAAW;IACtC,+BAA+B,EAAE,mCAAmC;IACpE,qBAAqB,EAAE,QAAQ;IAC/B,6BAA6B,EAAE,oCAAoC;IACnE,2BAA2B,EACzB,uDAAuD;IACzD,0BAA0B,EAAE,8CAA8C;IAC1E,2BAA2B,EAAE,0BAA0B;IACvD,+BAA+B,EAAE,qCAAqC;IAEtE,kCAAkC,EAAE,8BAA8B;IAClE,gCAAgC,EAAE,WAAW;IAC7C,kCAAkC,EAAE,sBAAsB;IAC1D,kCAAkC,EAAE,yBAAyB;IAC7D,kCAAkC,EAAE,wBAAwB;CAC7D,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"}
+{"version":3,"file":"es.js","sourceRoot":"","sources":["../../src/i18n/es.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,oEAAoE;IACpE,GAAG,oBAAoB;IAEvB,2DAA2D;IAC3D,oCAAoC,EAAE,sBAAsB;IAC5D,6CAA6C,EAC3C,4DAA4D;IAC9D,kCAAkC,EAAE,8CAA8C;IAClF,wCAAwC,EACtC,4DAA4D;IAC9D,uCAAuC,EAAE,sCAAsC;IAC/E,mCAAmC,EACjC,8CAA8C;IAChD,iCAAiC,EAAE,+BAA+B;IAClE,oCAAoC,EAAE,sBAAsB;IAC5D,qCAAqC,EAAE,oCAAoC;IAE3E,WAAW;IACX,uBAAuB,EAAE,iCAAiC;IAE1D,sBAAsB,EAAE,SAAS;IACjC,oBAAoB,EAAE,wBAAwB;IAC9C,wBAAwB,EAAE,SAAS;IACnC,sBAAsB,EAAE,YAAY;IACpC,+BAA+B,EAAE,aAAa;IAC9C,mCAAmC,EAAE,WAAW;IAEhD,gCAAgC,EAAE,YAAY;IAC9C,iCAAiC,EAAE,wBAAwB;IAE3D,wBAAwB,EAAE,yBAAyB;IACnD,uBAAuB,EAAE,uBAAuB;IAChD,wBAAwB,EAAE,8BAA8B;IAExD,qBAAqB,EAAE,wBAAwB;IAC/C,sBAAsB,EAAE,gBAAgB;IACxC,sBAAsB,EAAE,iBAAiB;IACzC,2BAA2B,EAAE,kBAAkB;IAE/C,sBAAsB,EAAE,aAAa;IACrC,2BAA2B,EAAE,eAAe;IAC5C,yBAAyB,EAAE,WAAW;IACtC,+BAA+B,EAAE,mCAAmC;IACpE,qBAAqB,EAAE,QAAQ;IAC/B,6BAA6B,EAAE,oCAAoC;IACnE,2BAA2B,EACzB,uDAAuD;IACzD,0BAA0B,EAAE,8CAA8C;IAC1E,2BAA2B,EAAE,0BAA0B;IACvD,+BAA+B,EAAE,qCAAqC;IACtE,sBAAsB,EAAE,gBAAgB;IAExC,kCAAkC,EAAE,8BAA8B;IAClE,gCAAgC,EAAE,WAAW;IAC7C,kCAAkC,EAAE,sBAAsB;IAC1D,kCAAkC,EAAE,yBAAyB;IAC7D,kCAAkC,EAAE,wBAAwB;CAC7D,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/i18n/keys.d.ts

@@ -33,6 +33,8 @@ export declare const REVIEWS_I18N_KEYS: {
     readonly formSentHidden: "reviews.form.sent.hidden";
     readonly formSentUnknown: "reviews.form.sent.unknown";
     readonly formSignInRequired: "reviews.form.sign_in_required";
+    /** The door beside that sentence — the container supplies WHERE it leads. */
+    readonly formSignIn: "reviews.form.sign_in";
     readonly submitBlockedNoRating: "reviews.submit.blocked.no_rating";
     readonly submitBlockedPending: "reviews.submit.blocked.pending";
     readonly submitBlockedDuplicate: "reviews.submit.blocked.duplicate";

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6C5B,6EAA6E;;;;;;;;;;;;;;;;CA0BrE,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,cA0CjC,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,SAAO,GAAG,IAAI,CAE3E"}

package/dist/i18n/keys.js

@@ -46,6 +46,8 @@ export const REVIEWS_I18N_KEYS = {
     formSentHidden: "reviews.form.sent.hidden",
     formSentUnknown: "reviews.form.sent.unknown",
     formSignInRequired: "reviews.form.sign_in_required",
+    /** The door beside that sentence — the container supplies WHERE it leads. */
+    formSignIn: "reviews.form.sign_in",
     // 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",
@@ -102,6 +104,7 @@ export const reviewsI18nBundleEn = {
     "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.form.sign_in": "Sign in",
     "reviews.submit.blocked.no_rating": "Choose a rating first",
     "reviews.submit.blocked.pending": "Sending…",
     "reviews.submit.blocked.duplicate": "You have already rated this",

package/dist/i18n/keys.js.map

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

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

@@ -1 +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"}
+{"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,cA2DjC,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,SAAO,GAAG,IAAI,CAE7E"}

package/dist/i18n/ru.js

@@ -57,6 +57,7 @@ export const reviewsI18nBundleRu = {
     "reviews.form.sent.hidden": "Отзыв сохранён, но не показывается",
     "reviews.form.sent.unknown": "Отзыв сохранён",
     "reviews.form.sign_in_required": "Войдите, чтобы оставить отзыв",
+    "reviews.form.sign_in": "Войти",
     "reviews.submit.blocked.no_rating": "Сначала выберите оценку",
     "reviews.submit.blocked.pending": "Отправляем…",
     "reviews.submit.blocked.duplicate": "Вы уже оценили это",

package/dist/i18n/ru.js.map

@@ -1 +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"}
+{"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;IAChE,sBAAsB,EAAE,OAAO;IAE/B,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/llms.txt

@@ -1,4 +1,4 @@
-# @stapel/reviews-react 0.1.0
+# @stapel/reviews-react 0.3.0
 
 Headless React flow pair for stapel-reviews (contract >=0.3 <0.4) — business + state, zero visual opinion.
 Built on @stapel/core: typed client + StapelApiError envelope, auth token refresh,

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "$generated": "by scripts/gen-manifest.mjs — do not edit; drift-gated (pnpm gen:manifest:check)",
   "package": "@stapel/reviews-react",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "backend": {
     "module": "stapel-reviews",
     "contract": ">=0.3 <0.4"
@@ -475,6 +475,7 @@
     "reviews.form.sent.pending",
     "reviews.form.sent.published",
     "reviews.form.sent.unknown",
+    "reviews.form.sign_in",
     "reviews.form.sign_in_required",
     "reviews.form.submit",
     "reviews.list.empty",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stapel/reviews-react",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Headless React pair for stapel-reviews: ratings and reviews addressed the way the module addresses them — by an opaque (target_type, target_key) pair, never by a foreign key. An anchor-paginated list a guest can read, an aggregate that renders `no reviews yet` instead of a zero-star rating when count is 0, a submit form that reads the duplicate refusal by CODE (the module answers 400, not 409) and asks for a sign-in only where the write actually needs one, and moderation states shown as they are rather than hidden. The seller-level rating is a display over the composite's projection, because reviews itself cannot roll one up. Zero visual opinion in the main entry; an opt-in /default subpath ships the antd skin.",
   "license": "MIT",
   "repository": {
@@ -44,13 +44,6 @@
     "manifest.json",
     "llms.txt"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "tsc -p tsconfig.test.json && vitest run --exclude test/prodBundlePurity.test.ts",
-    "test:pack": "vitest run test/prodBundlePurity.test.ts",
-    "lint": "eslint .",
-    "size": "size-limit"
-  },
   "size-limit": [
     {
       "name": "index — the headless pair (client + list window + aggregate + submit): no antd",
@@ -90,10 +83,6 @@
   },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^11.2.0",
-    "@stapel/core": "workspace:^",
-    "@stapel/showcase": "workspace:^",
-    "@stapel/tokens": "workspace:^",
-    "@stapel/tokens-antd": "workspace:^",
     "@tanstack/react-query": "^5.81.0",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.1.0",
@@ -104,12 +93,23 @@
     "react-dom": "^19.1.0",
     "size-limit": "^11.2.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@stapel/core": "^0.16.0",
+    "@stapel/showcase": "^0.2.0",
+    "@stapel/tokens": "^0.5.0",
+    "@stapel/tokens-antd": "^0.5.0"
   },
   "engines": {
     "node": ">=22"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsc -p tsconfig.test.json && vitest run --exclude test/prodBundlePurity.test.ts",
+    "test:pack": "vitest run test/prodBundlePurity.test.ts",
+    "lint": "eslint .",
+    "size": "size-limit"
   }
-}
+}

package/src/analytics/generated/events.json

@@ -1,7 +1,7 @@
 {
   "$generated": "by scripts/gen-events.mjs — do not edit; drift-gated (pnpm gen:events:check)",
   "package": "@stapel/reviews-react",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "defined": [],
   "flows": []
 }

package/src/default/ReviewFormCard.tsx

@@ -16,15 +16,17 @@
 import type { ReactElement } from "react";
 import { Alert, Button, Card, Flex, Input, Rate, Typography } from "antd";
 import { useActionGate, useDescribeFlowError, useT } from "@stapel/core";
+import type { SignInCta, SignInCtaProp } from "@stapel/core";
 import type { ReviewTarget } from "../api/types.js";
 import { ReviewForm } from "../headless/ReviewForm.js";
 import type { ReviewFormBag } from "../headless/ReviewForm.js";
 import { REVIEWS_I18N_KEYS } from "../i18n/keys.js";
 import { ErrorAlert } from "./ErrorAlert.js";
+import { SignInLink } from "./SignInLink.js";
 import { ReviewsSkinTheme } from "./theme.js";
 import type { ThemeModeProp } from "./types.js";
 
-export interface ReviewFormCardProps extends ThemeModeProp {
+export interface ReviewFormCardProps extends ThemeModeProp, SignInCtaProp {
   readonly target: ReviewTarget;
   /** The host already knows this author has reviewed the target (optimistic). */
   readonly alreadyReviewed?: boolean;
@@ -44,7 +46,10 @@ function sentKey(bag: ReviewFormBag): string {
   }
 }
 
-function FormBody(props: { bag: ReviewFormBag }): ReactElement {
+function FormBody(props: {
+  bag: ReviewFormBag;
+  signIn: SignInCta | undefined;
+}): ReactElement {
   const t = useT();
   const describe = useDescribeFlowError();
   const { bag } = props;
@@ -73,6 +78,7 @@ function FormBody(props: { bag: ReviewFormBag }): ReactElement {
     return (
       <Typography.Text type="secondary" data-testid="reviews-form-sign-in">
         {t(REVIEWS_I18N_KEYS.formSignInRequired)}
+        <SignInLink cta={props.signIn} testId="reviews-form-sign-in-cta" />
       </Typography.Text>
     );
   }
@@ -121,7 +127,9 @@ function FormBody(props: { bag: ReviewFormBag }): ReactElement {
 
 export function ReviewFormCard(props: ReviewFormCardProps): ReactElement {
   const t = useT();
-  const { mode, ...formProps } = props;
+  // `signIn` is this card's, not the headless form's: the form knows THAT the
+  // author must sign in, the container knows WHERE.
+  const { mode, signIn, ...formProps } = props;
   return (
     <ReviewsSkinTheme {...(mode !== undefined ? { mode } : {})}>
       <Card size="small" data-testid="reviews-form">
@@ -130,7 +138,7 @@ export function ReviewFormCard(props: ReviewFormCardProps): ReactElement {
             {t(REVIEWS_I18N_KEYS.formHeading)}
           </Typography.Title>
           <ReviewForm {...formProps}>
-            {(bag) => <FormBody bag={bag} />}
+            {(bag) => <FormBody bag={bag} signIn={signIn} />}
           </ReviewForm>
         </Flex>
       </Card>

package/src/default/ReviewsPanel.tsx

@@ -15,6 +15,7 @@
  */
 import type { ReactElement, ReactNode } from "react";
 import { Flex } from "antd";
+import type { SignInCtaProp } from "@stapel/core";
 import type { Review, ReviewTarget } from "../api/types.js";
 import { ReviewList } from "../headless/ReviewList.js";
 import { findOwnReview } from "../model/list.js";
@@ -24,7 +25,7 @@ import { ReviewListPanel } from "./ReviewListPanel.js";
 import { ReviewsSkinTheme } from "./theme.js";
 import type { ThemeModeProp } from "./types.js";
 
-export interface ReviewsPanelProps extends ThemeModeProp {
+export interface ReviewsPanelProps extends ThemeModeProp, SignInCtaProp {
   readonly target: ReviewTarget;
   /**
    * The reader's user id — the value the backend puts in `author_id`, NOT a
@@ -39,7 +40,7 @@ export interface ReviewsPanelProps extends ThemeModeProp {
 }
 
 export function ReviewsPanel(props: ReviewsPanelProps): ReactElement {
-  const { mode, target, viewerId, canReview = true, ...rows } = props;
+  const { mode, target, viewerId, canReview = true, signIn, ...rows } = props;
   return (
     <ReviewsSkinTheme {...(mode !== undefined ? { mode } : {})}>
       <Flex vertical gap={16} data-testid="reviews-panel">
@@ -58,6 +59,7 @@ export function ReviewsPanel(props: ReviewsPanelProps): ReactElement {
               <ReviewFormCard
                 target={target}
                 {...(mode !== undefined ? { mode } : {})}
+                {...(signIn !== undefined ? { signIn } : {})}
                 alreadyReviewed={
                   findOwnReview(
                     bag.state.status === "ready" ? bag.state.data : undefined,

package/src/default/SignInLink.tsx

@@ -0,0 +1,54 @@
+/**
+ * The door beside a blocked control.
+ *
+ * `actionBlocked` ended the grey-rectangle incident by making every
+ * switched-off control state its reason. It did not end the next problem:
+ * "sign in to leave a review" is a reason whose next action is a LINK, and
+ * this pair rendered the sentence and stopped there — leaving the visitor to
+ * find the header themselves (storefront Wave D, G-3).
+ *
+ * WHERE that link goes is the container's business, never the pair's: the
+ * storefront's is `/login?next=<current>`, a tenant app's may be a modal. So
+ * the shape is core's `SignInCta` — `{href}` or `{onSignIn}`, never both — and
+ * the copy is this pair's, because core floors `en` and `ru` while this pair
+ * also ships `es`.
+ *
+ * A host that routes internally passes `onSignIn`; the `href` arm renders a
+ * plain anchor on purpose, because arriving at a sign-in page is one of the
+ * few navigations a full load costs nothing.
+ */
+import type { ReactElement } from "react";
+import { Typography } from "antd";
+import { useT } from "@stapel/core";
+import type { SignInCta } from "@stapel/core";
+import { REVIEWS_I18N_KEYS } from "../i18n/keys.js";
+
+export interface SignInLinkProps {
+  /** Absent: no link — a host with no sign-in route shows the reason alone. */
+  readonly cta: SignInCta | undefined;
+  readonly testId: string;
+}
+
+export function SignInLink(props: SignInLinkProps): ReactElement | null {
+  const t = useT();
+  const { cta } = props;
+  if (cta === undefined) return null;
+  // The separating space belongs HERE, not at the call site: a reason with no
+  // door must render as exactly its own sentence, and a `{" "}` left behind by
+  // an absent link is a trailing space in every caller's assertion.
+  return (
+    <>
+      {" "}
+      <Typography.Link
+        data-testid={props.testId}
+        data-analytics="none"
+        data-analytics-reason="business action — host app wraps with its own tracked()"
+        {...(cta.href !== undefined
+          ? { href: cta.href }
+          : { onClick: cta.onSignIn })}
+      >
+        {t(REVIEWS_I18N_KEYS.formSignIn)}
+      </Typography.Link>
+    </>
+  );
+}

package/src/default/index.ts

@@ -28,3 +28,5 @@ export { ReviewsSkinTheme } from "./theme.js";
 export type { ReviewsSkinThemeProps } from "./theme.js";
 export { ErrorAlert } from "./ErrorAlert.js";
 export type { ThemeModeProp } from "./types.js";
+export { SignInLink } from "./SignInLink.js";
+export type { SignInLinkProps } from "./SignInLink.js";

package/src/i18n/es.ts

@@ -67,6 +67,7 @@ export const reviewsI18nBundleEs: I18nDictionary = {
   "reviews.form.sent.hidden": "Tu reseña se ha guardado, pero no se muestra",
   "reviews.form.sent.unknown": "Tu reseña se ha guardado",
   "reviews.form.sign_in_required": "Inicia sesión para dejar una reseña",
+  "reviews.form.sign_in": "Iniciar sesión",
 
   "reviews.submit.blocked.no_rating": "Elige primero una valoración",
   "reviews.submit.blocked.pending": "Enviando…",

package/src/i18n/keys.ts

@@ -53,6 +53,8 @@ export const REVIEWS_I18N_KEYS = {
   formSentHidden: "reviews.form.sent.hidden",
   formSentUnknown: "reviews.form.sent.unknown",
   formSignInRequired: "reviews.form.sign_in_required",
+  /** The door beside that sentence — the container supplies WHERE it leads. */
+  formSignIn: "reviews.form.sign_in",
 
   // Blocked controls — every one of these is the `code` of an
   // ActionAvailability, so a switched-off button always has a sentence.
@@ -119,6 +121,7 @@ export const reviewsI18nBundleEn: I18nDictionary = {
   "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.form.sign_in": "Sign in",
 
   "reviews.submit.blocked.no_rating": "Choose a rating first",
   "reviews.submit.blocked.pending": "Sending…",

package/src/i18n/ru.ts

@@ -71,6 +71,7 @@ export const reviewsI18nBundleRu: I18nDictionary = {
   "reviews.form.sent.hidden": "Отзыв сохранён, но не показывается",
   "reviews.form.sent.unknown": "Отзыв сохранён",
   "reviews.form.sign_in_required": "Войдите, чтобы оставить отзыв",
+  "reviews.form.sign_in": "Войти",
 
   "reviews.submit.blocked.no_rating": "Сначала выберите оценку",
   "reviews.submit.blocked.pending": "Отправляем…",