@stapel/reviews-react 0.1.0

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":""}

package/dist/default/ErrorAlert.d.ts

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

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

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

package/dist/default/ErrorAlert.js

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

package/dist/default/ErrorAlert.js.map

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

package/dist/default/RatingBadge.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `<RatingBadge>` — the stars-and-count line, over either source of the two
+ * numbers.
+ *
+ * The whole component is built around one refusal: when `count` is `0` there
+ * is no star row at all, only the "no reviews yet" sentence. antd's `<Rate>`
+ * given `value={0}` draws five empty stars, which is a perfectly good
+ * rendering of the worst possible score and a completely wrong rendering of
+ * "nobody has rated this". `ratingSummary()` makes the distinction, and this
+ * skin honours it by not reaching `<Rate>` at all in that arm.
+ */
+import type { ReactElement } from "react";
+import type { ReviewAggregateProps } from "../headless/ReviewAggregate.js";
+import type { ThemeModeProp } from "./types.js";
+export type RatingBadgeProps = ThemeModeProp & Omit<ReviewAggregateProps, "children">;
+export declare function RatingBadge(props: RatingBadgeProps): ReactElement;
+//# sourceMappingURL=RatingBadge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RatingBadge.d.ts","sourceRoot":"","sources":["../../src/default/RatingBadge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAI3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAC1C,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAEzC,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAwDjE"}

package/dist/default/RatingBadge.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Flex, Rate, Skeleton, Typography } from "antd";
+import { matchLoad, toFlowError, useDescribeFlowError, useT } from "@stapel/core";
+import { ReviewAggregate } from "../headless/ReviewAggregate.js";
+import { REVIEWS_I18N_KEYS } from "../i18n/keys.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { ReviewsSkinTheme } from "./theme.js";
+export function RatingBadge(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    const { mode, ...aggregateProps } = props;
+    return (_jsx(ReviewsSkinTheme, { ...(mode !== undefined ? { mode } : {}), children: _jsx(ReviewAggregate, { ...aggregateProps, children: (bag) => (_jsx(Flex, { align: "center", gap: 8, "data-testid": "reviews-rating", children: matchLoad(bag.state, {
+                    loading: () => (_jsx(Skeleton.Button, { active: true, "data-testid": "reviews-rating-loading" })),
+                    failed: (error) => (_jsx(ErrorAlert, { testId: "reviews-rating-failed", error: describe(toFlowError(error)) })),
+                    ready: (summary) => summary.rated ? (_jsxs(_Fragment, { children: [_jsx(Rate, { disabled: true, allowHalf: true, count: bag.max, value: summary.rounded, "data-testid": "reviews-rating-stars" }), _jsx(Typography.Text, { strong: true, children: t(REVIEWS_I18N_KEYS.ratingValue, {
+                                    avg: summary.rounded,
+                                    max: bag.max,
+                                }) }), _jsx(Typography.Text, { type: "secondary", children: t(REVIEWS_I18N_KEYS.ratingCount, {
+                                    count: summary.count,
+                                }) })] })) : (_jsx(Typography.Text, { type: "secondary", "data-testid": "reviews-rating-none", children: t(REVIEWS_I18N_KEYS.ratingNone) })),
+                }) })) }) }));
+}
+//# sourceMappingURL=RatingBadge.js.map

package/dist/default/RatingBadge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RatingBadge.js","sourceRoot":"","sources":["../../src/default/RatingBadge.tsx"],"names":[],"mappings":";AAYA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC;IAE1C,OAAO,CACL,KAAC,gBAAgB,OAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YACxD,KAAC,eAAe,OAAK,cAAc,YAChC,CAAC,GAAG,EAAE,EAAE,CAAC,CACR,KAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,EAAC,GAAG,EAAE,CAAC,iBAAc,gBAAgB,YACtD,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE;oBACpB,OAAO,EAAE,GAAG,EAAE,CAAC,CACb,KAAC,QAAQ,CAAC,MAAM,IAAC,MAAM,uBAAa,wBAAwB,GAAG,CAChE;oBACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CACjB,KAAC,UAAU,IACT,MAAM,EAAC,uBAAuB,EAC9B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GACnC,CACH;oBACD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CACd,8BACE,KAAC,IAAI,IACH,QAAQ,QACR,SAAS,QACT,KAAK,EAAE,GAAG,CAAC,GAAG,EACd,KAAK,EAAE,OAAO,CAAC,OAAO,iBACV,sBAAsB,GAClC,EACF,KAAC,UAAU,CAAC,IAAI,IAAC,MAAM,kBACpB,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE;oCAChC,GAAG,EAAE,OAAO,CAAC,OAAO;oCACpB,GAAG,EAAE,GAAG,CAAC,GAAG;iCACb,CAAC,GACc,EAClB,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,YAC9B,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE;oCAChC,KAAK,EAAE,OAAO,CAAC,KAAK;iCACrB,CAAC,GACc,IACjB,CACJ,CAAC,CAAC,CAAC,CACF,KAAC,UAAU,CAAC,IAAI,IACd,IAAI,EAAC,WAAW,iBACJ,qBAAqB,YAEhC,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAChB,CACnB;iBACJ,CAAC,GACG,CACR,GACe,GACD,CACpB,CAAC;AACJ,CAAC"}

package/dist/default/ReviewFormCard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `<ReviewFormCard>` — "rate this", in antd.
+ *
+ * Two outcomes get their own sentence rather than a red banner, because
+ * neither is a fault of the person in front of the screen:
+ *
+ * - **already rated** (`error.400.reviews_duplicate_review`, a 400 — see
+ *   `model/refusals.ts`): the form collapses into a note. The same note shows
+ *   when the host told us up front via `alreadyReviewed`, so the two paths to
+ *   the same fact look the same;
+ * - **sent but not visible**: under pre-moderation the created row comes back
+ *   `pending`, and the author is told it will appear once checked. Saying
+ *   "published" there, or saying nothing, leaves them hunting for a review
+ *   that is deliberately invisible to them.
+ */
+import type { ReactElement } from "react";
+import type { ReviewTarget } from "../api/types.js";
+import type { ThemeModeProp } from "./types.js";
+export interface ReviewFormCardProps extends ThemeModeProp {
+    readonly target: ReviewTarget;
+    /** The host already knows this author has reviewed the target (optimistic). */
+    readonly alreadyReviewed?: boolean;
+}
+export declare function ReviewFormCard(props: ReviewFormCardProps): ReactElement;
+//# sourceMappingURL=ReviewFormCard.d.ts.map

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

@@ -0,0 +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"}

package/dist/default/ReviewFormCard.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Button, Card, Flex, Input, Rate, Typography } from "antd";
+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 { ReviewsSkinTheme } from "./theme.js";
+/** The sentence for a review that exists but may not be on the page. */
+function sentKey(bag) {
+    switch (bag.submittedVisibility) {
+        case "published":
+            return REVIEWS_I18N_KEYS.formSentPublished;
+        case "pending":
+            return REVIEWS_I18N_KEYS.formSentPending;
+        case "hidden":
+            return REVIEWS_I18N_KEYS.formSentHidden;
+        default:
+            return REVIEWS_I18N_KEYS.formSentUnknown;
+    }
+}
+function FormBody(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    const { bag } = props;
+    const gate = useActionGate(bag.canSubmit);
+    if (bag.submitted !== null) {
+        return (_jsx(Alert, { type: "success", showIcon: true, "data-testid": "reviews-form-sent", message: t(sentKey(bag)) }));
+    }
+    if (bag.alreadyReviewed) {
+        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(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 }) })] }) }) }));
+}
+//# sourceMappingURL=ReviewFormCard.js.map

package/dist/default/ReviewFormCard.js.map

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

package/dist/default/ReviewListPanel.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `<ReviewListPanel>` — the antd rendering of the review list.
+ *
+ * Two things it says out loud that a naive list would swallow:
+ *
+ * 1. A row that is not `published` carries a badge naming its state. It is on
+ *    screen only because a moderator asked for `include=all`, and a pending
+ *    or hidden review that looked like an ordinary one would misrepresent
+ *    what the public can see.
+ * 2. The author is a SLOT. The wire carries `author_id` and nothing else — no
+ *    name, no avatar — so the skin renders a neutral label unless the host
+ *    passes `renderAuthor`. Printing a raw user id would be both useless to a
+ *    reader and a gratuitous disclosure.
+ */
+import type { ReactElement, ReactNode } from "react";
+import type { Review, ReviewTarget } from "../api/types.js";
+import type { ThemeModeProp } from "./types.js";
+export interface ReviewListPanelProps extends ThemeModeProp {
+    readonly target: ReviewTarget;
+    /** Ask for pending/hidden rows (granted only to a moderator of the target). */
+    readonly include?: "all";
+    readonly limit?: number;
+    /** Turn `author_id` into something a reader recognises. See the header. */
+    readonly renderAuthor?: (review: Review) => ReactNode;
+    /** Format `created_at`. Absent means the raw ISO string is NOT shown. */
+    readonly renderDate?: (review: Review) => ReactNode;
+}
+export declare function ReviewListPanel(props: ReviewListPanelProps): ReactElement;
+//# sourceMappingURL=ReviewListPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewListPanel.d.ts","sourceRoot":"","sources":["../../src/default/ReviewListPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASrD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQ5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC;IACtD,yEAAyE;IACzE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC;CACrD;AAiGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAgEzE"}

package/dist/default/ReviewListPanel.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, Card, Empty, Flex, List, Rate, Skeleton, Tag, Typography } from "antd";
+import { matchLoad, toFlowError, useActionGate, useDescribeFlowError, useT, } from "@stapel/core";
+import { ReviewList } from "../headless/ReviewList.js";
+import { REVIEWS_I18N_KEYS } from "../i18n/keys.js";
+import { reviewVisibility } from "../model/list.js";
+import { useReviewsRuntime } from "../model/context.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { ReviewsSkinTheme } from "./theme.js";
+/** The badge a non-published row carries. `null` for an ordinary review. */
+function VisibilityTag(props) {
+    const t = useT();
+    const visibility = reviewVisibility(props.status);
+    if (visibility === "published")
+        return null;
+    if (visibility === "pending") {
+        return (_jsx(Tag, { color: "warning", "data-testid": "reviews-row-pending", children: t(REVIEWS_I18N_KEYS.statusPending) }));
+    }
+    if (visibility === "hidden") {
+        return (_jsx(Tag, { color: "error", "data-testid": "reviews-row-hidden", children: t(REVIEWS_I18N_KEYS.statusHidden) }));
+    }
+    // A state this build does not know. Naming it beats rendering it as an
+    // ordinary review (it may be one the server hides) and beats crashing.
+    return (_jsx(Tag, { "data-testid": "reviews-row-unknown", children: t(REVIEWS_I18N_KEYS.statusUnknown, { status: props.status }) }));
+}
+function ReviewRow(props) {
+    const t = useT();
+    const { review } = props;
+    return (_jsx(List.Item, { "data-testid": "reviews-row", "data-review-id": review.id, children: _jsxs(Flex, { vertical: true, gap: 4, style: { width: "100%" }, children: [_jsxs(Flex, { align: "center", gap: 8, wrap: true, children: [_jsx(Rate, { disabled: true, count: props.max, value: review.rating }), _jsx(Typography.Text, { strong: true, children: props.renderAuthor?.(review) ?? t(REVIEWS_I18N_KEYS.authorFallback) }), props.renderDate ? (_jsx(Typography.Text, { type: "secondary", children: props.renderDate(review) })) : null, _jsx(VisibilityTag, { status: review.status })] }), review.body.length > 0 ? (_jsx(Typography.Paragraph, { style: { margin: 0 }, children: review.body })) : null, review.response ? (_jsxs(Card, { size: "small", "data-testid": "reviews-row-response", children: [_jsx(Typography.Text, { type: "secondary", children: t(REVIEWS_I18N_KEYS.responseHeading) }), _jsx(Typography.Paragraph, { style: { margin: 0 }, children: review.response.body })] })) : null] }) }));
+}
+function MoreButton(props) {
+    const t = useT();
+    const gate = useActionGate(props.bag.more);
+    return (_jsxs(Flex, { vertical: true, align: "center", gap: 4, children: [_jsx(Button, { onClick: props.bag.loadMore, disabled: gate.disabled, loading: props.bag.loadingMore, "data-testid": "reviews-load-more", "data-analytics": "none", "data-analytics-reason": "paging further into a read \u2014 the host app wraps this with its own tracked(); pairs carry no @stapel/analytics runtime dependency by architecture", children: t(REVIEWS_I18N_KEYS.listLoadMore) }), gate.reason ? (_jsx(Typography.Text, { type: "secondary", "data-testid": "reviews-load-more-reason", children: gate.reason })) : null] }));
+}
+export function ReviewListPanel(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    const runtime = useReviewsRuntime();
+    const { mode, target, renderAuthor, renderDate, ...listOptions } = props;
+    return (_jsx(ReviewsSkinTheme, { ...(mode !== undefined ? { mode } : {}), children: _jsx(ReviewList, { target: target, ...listOptions, children: (bag) => (_jsxs(Flex, { vertical: true, gap: 8, "data-testid": "reviews-list", children: [_jsx(Typography.Title, { level: 5, style: { margin: 0 }, children: t(REVIEWS_I18N_KEYS.listHeading) }), matchLoad(bag.state, {
+                        loading: () => (_jsx(Skeleton, { active: true, "data-testid": "reviews-list-loading" })),
+                        failed: (error) => (_jsx(ErrorAlert, { testId: "reviews-list-failed", error: describe(toFlowError(error)), action: _jsx(Button, { size: "small", onClick: bag.refresh, "data-analytics": "none", "data-analytics-reason": "recovery affordance for a failed read \u2014 host app wraps with its own tracked()", children: t(REVIEWS_I18N_KEYS.listRefresh) }) })),
+                        ready: (reviews) => reviews.length === 0 ? (_jsx(Empty, { "data-testid": "reviews-list-empty", description: t(REVIEWS_I18N_KEYS.listEmpty) })) : (_jsxs(_Fragment, { children: [_jsx(List, { dataSource: [...reviews], "data-testid": "reviews-list-rows", renderItem: (review) => (_jsx(ReviewRow, { review: review, max: runtime.ratingBounds.max, renderAuthor: renderAuthor, renderDate: renderDate })) }), _jsx(MoreButton, { bag: bag })] })),
+                    })] })) }) }));
+}
+//# sourceMappingURL=ReviewListPanel.js.map

package/dist/default/ReviewListPanel.js.map

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

package/dist/default/ReviewsPanel.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `<ReviewsPanel>` — the composed block a listing detail page drops in: the
+ * rating line, the list, and (for a signed-in reader who has not rated yet)
+ * the form.
+ *
+ * The pre-check is the interesting part, and its LIMIT is the reason it lives
+ * here rather than inside the form. Given `viewerId`, the panel looks for the
+ * viewer's own review among the loaded rows and, finding one, tells the form
+ * not to offer itself. That list is published-only, so under pre-moderation
+ * the viewer's pending review is invisible even to them: the form is offered,
+ * the server refuses with `error.400.reviews_duplicate_review`, and the form
+ * shows the same "you have already rated this" sentence. One fact, two
+ * discoveries, one sentence — which is why the refusal is a first-class
+ * outcome and the pre-check is only an optimisation.
+ */
+import type { ReactElement, ReactNode } from "react";
+import type { Review, ReviewTarget } from "../api/types.js";
+import type { ThemeModeProp } from "./types.js";
+export interface ReviewsPanelProps extends ThemeModeProp {
+    readonly target: ReviewTarget;
+    /**
+     * The reader's user id — the value the backend puts in `author_id`, NOT a
+     * profile id. Absent means no pre-check: the form is offered and the server
+     * is the only judge.
+     */
+    readonly viewerId?: string | null;
+    /** Hide the form entirely (a seller looking at their own listing). */
+    readonly canReview?: boolean;
+    readonly renderAuthor?: (review: Review) => ReactNode;
+    readonly renderDate?: (review: Review) => ReactNode;
+}
+export declare function ReviewsPanel(props: ReviewsPanelProps): ReactElement;
+//# sourceMappingURL=ReviewsPanel.d.ts.map

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

@@ -0,0 +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"}

package/dist/default/ReviewsPanel.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Flex } from "antd";
+import { ReviewList } from "../headless/ReviewList.js";
+import { findOwnReview } from "../model/list.js";
+import { RatingBadge } from "./RatingBadge.js";
+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;
+    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] }) }));
+}
+//# sourceMappingURL=ReviewsPanel.js.map

package/dist/default/ReviewsPanel.js.map

@@ -0,0 +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"}

package/dist/default/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `@stapel/reviews-react/default` — the antd skin over the headless pair.
+ *
+ * A separate entry point (the convention every pair's `/default` follows) so a
+ * host rendering its own review block never pulls `antd` into its bundle. The
+ * main entry has no visual opinion at all and no import path from it reaches
+ * this directory — size-limit and the bundle-purity test are the teeth on
+ * that.
+ *
+ * ```tsx
+ * import { createReviewsRuntime, ReviewsProvider } from "@stapel/reviews-react";
+ * import { ReviewsPanel } from "@stapel/reviews-react/default";
+ * ```
+ *
+ * `<RatingBadge aggregate={…}>` is the seller-rating half: it renders two
+ * numbers the composite's projection produced, because stapel-reviews cannot
+ * roll a seller's listings up itself (main entry header).
+ */
+export { ReviewsPanel } from "./ReviewsPanel.js";
+export type { ReviewsPanelProps } from "./ReviewsPanel.js";
+export { ReviewListPanel } from "./ReviewListPanel.js";
+export type { ReviewListPanelProps } from "./ReviewListPanel.js";
+export { ReviewFormCard } from "./ReviewFormCard.js";
+export type { ReviewFormCardProps } from "./ReviewFormCard.js";
+export { RatingBadge } from "./RatingBadge.js";
+export type { RatingBadgeProps } from "./RatingBadge.js";
+export { ReviewsSkinTheme } from "./theme.js";
+export type { ReviewsSkinThemeProps } from "./theme.js";
+export { ErrorAlert } from "./ErrorAlert.js";
+export type { ThemeModeProp } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/default/index.js

@@ -0,0 +1,25 @@
+/**
+ * `@stapel/reviews-react/default` — the antd skin over the headless pair.
+ *
+ * A separate entry point (the convention every pair's `/default` follows) so a
+ * host rendering its own review block never pulls `antd` into its bundle. The
+ * main entry has no visual opinion at all and no import path from it reaches
+ * this directory — size-limit and the bundle-purity test are the teeth on
+ * that.
+ *
+ * ```tsx
+ * import { createReviewsRuntime, ReviewsProvider } from "@stapel/reviews-react";
+ * import { ReviewsPanel } from "@stapel/reviews-react/default";
+ * ```
+ *
+ * `<RatingBadge aggregate={…}>` is the seller-rating half: it renders two
+ * numbers the composite's projection produced, because stapel-reviews cannot
+ * roll a seller's listings up itself (main entry header).
+ */
+export { ReviewsPanel } from "./ReviewsPanel.js";
+export { ReviewListPanel } from "./ReviewListPanel.js";
+export { ReviewFormCard } from "./ReviewFormCard.js";
+export { RatingBadge } from "./RatingBadge.js";
+export { ReviewsSkinTheme } from "./theme.js";
+export { ErrorAlert } from "./ErrorAlert.js";
+//# sourceMappingURL=index.js.map

package/dist/default/index.js.map

@@ -0,0 +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"}

package/dist/default/theme.d.ts

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

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

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

package/dist/default/theme.js

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

package/dist/default/theme.js.map

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

package/dist/default/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Small shared types for the `/default` skin — kept in one place so every
+ * surface takes the same `mode` prop and re-exports the same error dialect.
+ */
+export type { FlowError } from "@stapel/core";
+import type { ThemeMode } from "@stapel/tokens-antd";
+/** Every `/default` surface accepts a theme mode; absent means "whatever the
+ * host document declares" (`resolveThemeMode()`), never a hardcoded side. */
+export interface ThemeModeProp {
+    readonly mode?: ThemeMode;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/default/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;6EAC6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC3B"}

package/dist/default/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/default/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/default/types.ts"],"names":[],"mappings":""}

package/dist/headless/ReviewAggregate.d.ts

@@ -0,0 +1,63 @@
+import type { ReactElement, ReactNode } from "react";
+import type { LoadState } from "@stapel/core";
+import type { RatingAggregate, ReviewTarget } from "../api/types.js";
+import type { RatingSummary } from "../model/rating.js";
+/** What `<ReviewAggregate>` hands its render prop. */
+export interface ReviewAggregateBag {
+    /**
+     * The rating, READ — `rated: false` when nobody has rated the target, so a
+     * skin can never print the zero the wire carries in that case.
+     */
+    readonly state: LoadState<RatingSummary>;
+    /** Where the number came from. */
+    readonly source: "fetched" | "supplied";
+    /** The deployment's rating ceiling, for a star row that draws `max` stars. */
+    readonly max: number;
+}
+export interface ReviewAggregateProps {
+    /**
+     * What this rating is ABOUT. Always required, even when {@link aggregate}
+     * is supplied and nothing is fetched: it is the identity of the thing being
+     * rated, it keys the cache, and a rating rendered without one is a number
+     * nobody can trace back to a subject.
+     */
+    readonly target: ReviewTarget;
+    /**
+     * Numbers somebody else computed. Supplying them makes this component a
+     * pure display: no request is made, and `source` reports `"supplied"`.
+     */
+    readonly aggregate?: RatingAggregate;
+    readonly children: (bag: ReviewAggregateBag) => ReactNode;
+}
+/**
+ * The headless rating display — the same bag whether the number came from
+ * this module or from the composite. `AllowAny` upstream since 0.3.0, so a
+ * guest sees the rating and there is no "sign in" state here.
+ *
+ * ── Why `aggregate` is a prop, and not a second endpoint ───────────────────
+ *
+ * stapel-reviews can aggregate exactly ONE `(target_type, target_key)` per
+ * call. The storefront's product decision (spec fork F5) is that a review
+ * targets the SELLER for a specific listing — `target_type: "listing"`, one
+ * per author per listing — and the seller's own rating is therefore a ROLL-UP
+ * across every listing they own. No endpoint computes that: the composite
+ * does, server-side, as `shop.listing_review_summary`
+ * (`stapel_shop/projections.py`), and the roll-up over a seller's keys is the
+ * composite's projection to publish, on its own route.
+ *
+ * So this pair does the half it can honestly do: it renders `{avg, count}` —
+ * the projection's own field names, chosen upstream precisely so both modes
+ * answer one shape — from wherever the host got them. `source` says which,
+ * so a skin that wants to (a demo, an admin view) can show it. A seller
+ * header therefore reads
+ * `<ReviewAggregate target={{targetType: "seller", targetKey: id}}
+ * aggregate={rollup}>`: the target names the subject, the numbers come from
+ * the composite, and no request is made against an endpoint that could not
+ * have answered it.
+ *
+ * The gap is real and is recorded in the README rather than papered over with
+ * N+1 requests: a page that wants a seller rating today must be served the
+ * two numbers by its own backend.
+ */
+export declare function ReviewAggregate(props: ReviewAggregateProps): ReactElement;
+//# sourceMappingURL=ReviewAggregate.d.ts.map

package/dist/headless/ReviewAggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewAggregate.d.ts","sourceRoot":"","sources":["../../src/headless/ReviewAggregate.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACzC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,SAAS,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAyBzE"}