@mohasinac/appkit 4.1.0 → 4.1.3

package/dist/features/seller/components/SellerReviewsView.js

@@ -2,11 +2,18 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
 import { useCallback, useEffect, useMemo, useState } from "react";
-import { Alert, Badge, BulkActionBar, Button, Checkbox, Div, Modal, Row, Select, SideDrawer, Span, Stack, Text, Textarea } from "../../../ui";
+import { Alert, Badge, BulkActionBar, Button, Checkbox, Div, Input, Modal, Row, Select, SideDrawer, Span, Stack, Text, Textarea } from "../../../ui";
 import { StackedViewShell } from "../../../ui";
 import { useBottomActions } from "../../layout";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 import { SELLER_ENDPOINTS } from "../../../constants/api-endpoints";
+import { sortBy } from "../../../constants/sort";
+const SORT_OPTIONS = [
+    { value: sortBy("createdAt", "DESC"), label: "Newest" },
+    { value: sortBy("createdAt", "ASC"), label: "Oldest" },
+    { value: sortBy("rating", "DESC"), label: "Highest rating" },
+    { value: sortBy("rating", "ASC"), label: "Lowest rating" },
+];
 const __P = {
     p3: "p-[var(--appkit-space-3)]",
     p4: "p-[var(--appkit-space-4)]",
@@ -32,6 +39,8 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
     // Filters
     const [rating, setRating] = useState("");
     const [replied, setReplied] = useState("");
+    const [sort, setSort] = useState(SORT_OPTIONS[0].value);
+    const [search, setSearch] = useState("");
     const [page, setPage] = useState(1);
     // Reply drawer
     const [replyTarget, setReplyTarget] = useState(null);
@@ -101,7 +110,7 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
         setLoading(true);
         setError(null);
         try {
-            const params = new URLSearchParams({ page: String(page), pageSize: "20" });
+            const params = new URLSearchParams({ page: String(page), pageSize: "20", sorts: sort });
             if (rating)
                 params.set("rating", rating);
             if (replied)
@@ -120,7 +129,19 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
         finally {
             setLoading(false);
         }
-    }, [reviewsApiBase, rating, replied, page]);
+    }, [reviewsApiBase, rating, replied, sort, page]);
+    // The API route has no ?q= support (only rating/replied/sorts) — filter
+    // the fetched page client-side, same category of post-fetch narrowing the
+    // route itself already does for `replied`.
+    const visibleReviews = useMemo(() => {
+        const q = search.trim().toLowerCase();
+        if (!q)
+            return reviews;
+        return reviews.filter((r) => r.productTitle?.toLowerCase().includes(q) ||
+            r.userName?.toLowerCase().includes(q) ||
+            r.comment?.toLowerCase().includes(q) ||
+            r.title?.toLowerCase().includes(q));
+    }, [reviews, search]);
     useEffect(() => { fetchReviews(); }, [fetchReviews]);
     useEffect(() => { fetchReviewsRef.current = fetchReviews; }, [fetchReviews, fetchReviewsRef]);
     const openReply = (review) => {
@@ -161,7 +182,7 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
                 },
             ] } } : {});
     return (_jsxs(_Fragment, { children: [_jsx(StackedViewShell, { portal: "seller", title: "Reviews", sections: [
-                    _jsxs(Stack, { gap: "lg", children: [_jsxs(Row, { align: "center", gap: "3", wrap: true, children: [_jsx(Select, { value: rating, onChange: (e) => { setRating(e.target.value); setPage(1); }, "aria-label": "Filter by rating", options: [
+                    _jsxs(Stack, { gap: "lg", children: [_jsxs(Row, { align: "center", gap: "3", wrap: true, children: [_jsx(Input, { value: search, onChange: (e) => setSearch(e.target.value), placeholder: "Search product, reviewer, or comment\u2026", "aria-label": "Search reviews", className: "min-w-[220px]" }), _jsx(Select, { value: rating, onChange: (e) => { setRating(e.target.value); setPage(1); }, "aria-label": "Filter by rating", options: [
                                             { value: "", label: "All ratings" },
                                             { value: "5", label: "5 stars" },
                                             { value: "4", label: "4 stars" },
@@ -172,12 +193,12 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
                                             { value: "", label: "All reply statuses" },
                                             { value: "true", label: "Store replied" },
                                             { value: "false", label: "Awaiting reply" },
-                                        ] }), meta && (_jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] ml-auto", size: "sm", children: [meta.total, " review", meta.total !== 1 ? "s" : ""] }))] }), error && _jsx(Alert, { variant: "error", children: error }), selectedIds.size > 0 && (_jsx(BulkActionBar, { selectedCount: selectedIds.size, onClearSelection: clearSelection, actions: [
+                                        ] }), _jsx(Select, { value: sort, onChange: (e) => { setSort(e.target.value); setPage(1); }, "aria-label": "Sort reviews", options: SORT_OPTIONS }), meta && (_jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] ml-auto", size: "sm", children: [meta.total, " review", meta.total !== 1 ? "s" : ""] }))] }), error && _jsx(Alert, { variant: "error", children: error }), selectedIds.size > 0 && (_jsx(BulkActionBar, { selectedCount: selectedIds.size, onClearSelection: clearSelection, actions: [
                                     {
                                         id: "bulk-reply",
                                         label: "Reply to selected",
                                         onClick: () => setBulkReplyOpen(true),
                                     },
-                                ] })), loading ? (_jsx(Div, { className: "text-center", padding: "y-xl", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Loading reviews\u2026" }) })) : reviews.length === 0 ? (_jsx(Div, { className: "text-center", padding: "y-3xl", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "No reviews found." }) })) : (_jsx(Stack, { gap: "md", children: reviews.map((review) => (_jsx(Div, { className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "lg", padding: "md", children: _jsxs(Row, { align: "start", justify: "between", gap: "3", wrap: true, children: [_jsxs(Row, { align: "start", className: "flex-1 min-w-0", gap: "3", children: [_jsx(Checkbox, { checked: selectedIds.has(review.id), onChange: () => toggleSelected(review.id), "aria-label": "Select review" }), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "truncate", weight: "medium", children: review.productTitle }), _jsxs(Row, { className: "mt-1", align: "center", gap: "sm", wrap: true, children: [_jsx(Stars, { rating: review.rating }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: ["by ", review.userName] }), review.verified && _jsx(Badge, { variant: "success", children: "Verified" }), statusBadge(review.status), _jsx(Badge, { variant: review.sellerReply ? "success" : "warning", children: review.sellerReply ? "Store replied" : "Awaiting store reply" })] }), review.title && _jsx(Text, { className: "mt-2", weight: "medium", children: review.title }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-secondary)] line-clamp-3", size: "sm", children: review.comment }), review.sellerReply && (_jsxs(Div, { className: "mt-2 pl-[0.75rem] border-l-2 border-[var(--appkit-color-primary)]", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: "Store reply:" }), _jsx(Text, { size: "sm", children: review.sellerReply })] }))] })] }), _jsxs(Row, { className: "flex-shrink-0", gap: "sm", children: [_jsx(Button, { variant: "outline", size: "sm", onClick: () => openReply(review), children: review.sellerReply ? "Edit Reply" : ACTIONS.STORE["reply-review"].label }), _jsx(Button, { variant: "ghost", size: "sm", onClick: () => setContestTarget(review), children: ACTIONS.STORE["contest-review"].label }), _jsx(Button, { variant: "ghost", size: "sm", onClick: () => setFeedbackTarget(review), children: ACTIONS.STORE["buyer-feedback"].label })] })] }) }, review.id))) })), meta && meta.totalPages > 1 && (_jsxs(Row, { align: "center", justify: "center", gap: "sm", children: [_jsx(Button, { variant: "outline", size: "sm", onClick: () => setPage((p) => Math.max(1, p - 1)), disabled: page <= 1 || loading, children: "Previous" }), _jsxs(Text, { size: "sm", children: ["Page ", meta.page, " of ", meta.totalPages] }), _jsx(Button, { variant: "outline", size: "sm", onClick: () => setPage((p) => p + 1), disabled: !meta.hasMore || loading, children: "Next" })] }))] }, "reviews"),
+                                ] })), loading ? (_jsx(Div, { className: "text-center", padding: "y-xl", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Loading reviews\u2026" }) })) : visibleReviews.length === 0 ? (_jsx(Div, { className: "text-center", padding: "y-3xl", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "No reviews found." }) })) : (_jsx(Stack, { gap: "md", children: visibleReviews.map((review) => (_jsx(Div, { className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "lg", padding: "md", children: _jsxs(Row, { align: "start", justify: "between", gap: "3", wrap: true, children: [_jsxs(Row, { align: "start", className: "flex-1 min-w-0", gap: "3", children: [_jsx(Checkbox, { checked: selectedIds.has(review.id), onChange: () => toggleSelected(review.id), "aria-label": "Select review" }), _jsxs(Div, { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "truncate", weight: "medium", children: review.productTitle }), _jsxs(Row, { className: "mt-1", align: "center", gap: "sm", wrap: true, children: [_jsx(Stars, { rating: review.rating }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: ["by ", review.userName] }), review.verified && _jsx(Badge, { variant: "success", children: "Verified" }), statusBadge(review.status), _jsx(Badge, { variant: review.sellerReply ? "success" : "warning", children: review.sellerReply ? "Store replied" : "Awaiting store reply" })] }), review.title && _jsx(Text, { className: "mt-2", weight: "medium", children: review.title }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-secondary)] line-clamp-3", size: "sm", children: review.comment }), review.sellerReply && (_jsxs(Div, { className: "mt-2 pl-[0.75rem] border-l-2 border-[var(--appkit-color-primary)]", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: "Store reply:" }), _jsx(Text, { size: "sm", children: review.sellerReply })] }))] })] }), _jsxs(Row, { className: "flex-shrink-0", gap: "sm", children: [_jsx(Button, { variant: "outline", size: "sm", onClick: () => openReply(review), children: review.sellerReply ? "Edit Reply" : ACTIONS.STORE["reply-review"].label }), _jsx(Button, { variant: "ghost", size: "sm", onClick: () => setContestTarget(review), children: ACTIONS.STORE["contest-review"].label }), _jsx(Button, { variant: "ghost", size: "sm", onClick: () => setFeedbackTarget(review), children: ACTIONS.STORE["buyer-feedback"].label })] })] }) }, review.id))) })), meta && meta.totalPages > 1 && (_jsxs(Row, { align: "center", justify: "center", gap: "sm", children: [_jsx(Button, { variant: "outline", size: "sm", onClick: () => setPage((p) => Math.max(1, p - 1)), disabled: page <= 1 || loading, children: "Previous" }), _jsxs(Text, { size: "sm", children: ["Page ", meta.page, " of ", meta.totalPages] }), _jsx(Button, { variant: "outline", size: "sm", onClick: () => setPage((p) => p + 1), disabled: !meta.hasMore || loading, children: "Next" })] }))] }, "reviews"),
                 ] }), _jsx(SideDrawer, { isOpen: !!replyTarget, onClose: () => setReplyTarget(null), title: replyTarget?.sellerReply ? "Edit Reply" : "Reply to Review", mode: "create", children: _jsxs(Stack, { gap: "md", className: `${__P.p4}`, children: [replyTarget && (_jsxs(Div, { className: `${__P.p3} bg-[var(--appkit-color-surface-muted)]`, rounded: "default", children: [_jsx(Stars, { rating: replyTarget.rating }), _jsx(Text, { className: "mt-1", size: "sm", children: replyTarget.comment })] })), replyError && _jsx(Alert, { variant: "error", children: replyError }), _jsxs(Div, { children: [_jsx(Text, { className: "mb-1.5", size: "sm", weight: "medium", children: "Store reply" }), _jsx(Textarea, { rows: 5, value: replyText, onChange: (e) => setReplyText(e.target.value), maxLength: 1000, placeholder: "Write your response to this review\u2026" }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] mt-1", size: "xs", align: "end", children: [replyText.length, "/1000"] })] }), _jsxs(Row, { justify: "end", gap: "sm", children: [_jsx(Button, { variant: "outline", onClick: () => setReplyTarget(null), disabled: replySaving, children: "Cancel" }), _jsx(Button, { variant: "primary", onClick: handleReplySave, disabled: replySaving || !replyText.trim(), isLoading: replySaving, children: replyTarget?.sellerReply ? "Update Reply" : "Post Reply" })] })] }) }), _jsx(Modal, { isOpen: bulkReplyOpen, onClose: () => setBulkReplyOpen(false), title: `Bulk reply to ${selectedIds.size} review${selectedIds.size === 1 ? "" : "s"}`, actions: _jsxs(Row, { gap: "sm", children: [_jsx(Button, { variant: "ghost", onClick: () => setBulkReplyOpen(false), disabled: bulkSaving, children: "Cancel" }), _jsx(Button, { variant: "primary", onClick: () => void submitBulkReply(), disabled: !bulkReplyText.trim() || bulkSaving, isLoading: bulkSaving, children: "Send reply" })] }), children: _jsxs(Stack, { gap: "md", padding: "2xs", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "The same reply will be posted on all selected reviews." }), _jsx(Textarea, { value: bulkReplyText, onChange: (e) => setBulkReplyText(e.target.value), rows: 5, placeholder: "Thanks for your review\u2026", label: "Reply" })] }) }), _jsx(Modal, { isOpen: !!contestTarget, onClose: () => setContestTarget(null), title: "Contest this review", actions: _jsxs(Row, { gap: "sm", children: [_jsx(Button, { variant: "ghost", onClick: () => setContestTarget(null), children: "Cancel" }), _jsx(Button, { variant: "primary", onClick: () => void submitContest(), disabled: !contestReason.trim(), children: "Submit" })] }), children: _jsxs(Stack, { gap: "md", padding: "2xs", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Flag this review for admin investigation. Provide a clear reason \u2014 fake, abusive, off-topic, etc." }), _jsx(Textarea, { value: contestReason, onChange: (e) => setContestReason(e.target.value), rows: 4, label: "Reason" })] }) }), _jsx(Modal, { isOpen: !!feedbackTarget, onClose: () => setFeedbackTarget(null), title: "Send feedback to buyer", actions: _jsxs(Row, { gap: "sm", children: [_jsx(Button, { variant: "ghost", onClick: () => setFeedbackTarget(null), children: "Cancel" }), _jsx(Button, { variant: "primary", onClick: () => void submitFeedback(), disabled: !feedbackText.trim(), children: "Send" })] }), children: _jsxs(Stack, { gap: "md", padding: "2xs", children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "sm", children: "Private message sent to the buyer's notification inbox. Does not appear on the public review." }), _jsx(Textarea, { value: feedbackText, onChange: (e) => setFeedbackText(e.target.value), rows: 4, label: "Feedback" })] }) })] }));
 }

package/dist/features/seller/components/index.d.ts

@@ -112,8 +112,6 @@ export { SellerAnalyticsAlertsView as StoreAnalyticsAlertsView } from "./SellerA
 export type { SellerAnalyticsAlertsViewProps as StoreAnalyticsAlertsViewProps } from "./SellerAnalyticsAlertsView";
 export { SellerStoreCategoriesView } from "./SellerStoreCategoriesView";
 export type { SellerStoreCategoriesViewProps } from "./SellerStoreCategoriesView";
-export { SellerTemplatesView } from "./SellerTemplatesView";
-export type { SellerTemplatesViewProps } from "./SellerTemplatesView";
 export { SellerPayoutMethodsView } from "./SellerPayoutMethodsView";
 export type { SellerPayoutMethodsViewProps } from "./SellerPayoutMethodsView";
 export { SellerShippingConfigsView } from "./SellerShippingConfigsView";

package/dist/features/seller/components/index.js

@@ -59,7 +59,6 @@ export { SellerGroupedListingsView as StoreGroupedListingsView } from "./SellerG
 export { SellerAnalyticsAlertsView } from "./SellerAnalyticsAlertsView";
 export { SellerAnalyticsAlertsView as StoreAnalyticsAlertsView } from "./SellerAnalyticsAlertsView";
 export { SellerStoreCategoriesView } from "./SellerStoreCategoriesView";
-export { SellerTemplatesView } from "./SellerTemplatesView";
 export { SellerPayoutMethodsView } from "./SellerPayoutMethodsView";
 export { SellerShippingConfigsView } from "./SellerShippingConfigsView";
 export { SellerGoogleReviewsView } from "./SellerGoogleReviewsView";

package/dist/features/stores/components/StoreListingsGuideView.js

@@ -65,7 +65,8 @@ const STANDARD_STEPS = [
     {
         step: "Pricing",
         items: [
-            "Price — enter in Indian Rupees (₹). Stored in paise internally.",
+            // audit-money-units-ok: instructs sellers there is NO paise conversion, not a stale reference
+            "Price — enter in Indian Rupees (₹). Stored as decimal rupees — no paise conversion.",
             "isOnSale + salePrice — enable the sale badge and show a strikethrough price on the listing.",
             "customFields — add any extra key/value pairs buyers find useful (e.g. PSA cert number, card number, print run).",
         ],

package/dist/features/stores/components/StoreProductsView.js

@@ -13,5 +13,5 @@ export function StoreProductsView({ storeSlug, labels = {}, renderProducts, rend
                     { value: sortBy("createdAt", "ASC"), label: "Oldest" },
                     { value: sortBy("price", "ASC"), label: "Price: Low to High" },
                     { value: sortBy("price", "DESC"), label: "Price: High to Low" },
-                ], className: "min-w-44" })), renderFilters: renderFilters, renderActiveFilters: renderActiveFilters, renderBulkActions: () => renderViewToggle?.(viewMode, setViewMode) ?? null, renderTable: () => renderProducts(items, isLoading), renderPagination: () => renderPagination?.(total) ?? null, total: total, isLoading: isLoading }) }));
+                ], wrapperClassName: "min-w-44" })), renderFilters: renderFilters, renderActiveFilters: renderActiveFilters, renderBulkActions: () => renderViewToggle?.(viewMode, setViewMode) ?? null, renderTable: () => renderProducts(items, isLoading), renderPagination: () => renderPagination?.(total) ?? null, total: total, isLoading: isLoading }) }));
 }

package/dist/features/stores/schemas/firestore.d.ts

@@ -75,6 +75,12 @@ export interface StoreDocument extends BaseDocument {
     isFeatured?: boolean;
     isVacationMode?: boolean;
     vacationMessage?: string;
+    /** Internal admin note, never shown to the store owner or the public. */
+    adminNotes?: string;
+    /** Admin "verified store" badge — distinct from `status`/`isPublic`. */
+    isVerified?: boolean;
+    /** Reason recorded when `status` is set to "suspended". */
+    suspensionReason?: string;
     stats?: {
         totalProducts: number;
         itemsSold: number;
@@ -158,6 +164,11 @@ export declare const STORE_FIELDS: {
     readonly STATS: "stats";
     readonly CREATED_AT: "createdAt";
     readonly UPDATED_AT: "updatedAt";
+    readonly ADMIN_NOTES: "adminNotes";
+    readonly IS_FEATURED: "isFeatured";
+    readonly IS_VERIFIED: "isVerified";
+    readonly SUSPENSION_REASON: "suspensionReason";
+    readonly CAPABILITIES: "capabilities";
     readonly STATUS_VALUES: {
         readonly PENDING: "pending";
         readonly ACTIVE: "active";

package/dist/features/stores/schemas/firestore.js

@@ -35,6 +35,11 @@ export const STORE_FIELDS = {
     STATS: "stats",
     CREATED_AT: "createdAt",
     UPDATED_AT: "updatedAt",
+    ADMIN_NOTES: "adminNotes",
+    IS_FEATURED: "isFeatured",
+    IS_VERIFIED: "isVerified",
+    SUSPENSION_REASON: "suspensionReason",
+    CAPABILITIES: "capabilities",
     STATUS_VALUES: {
         PENDING: "pending",
         ACTIVE: "active",

package/dist/features/stores/schemas/index.d.ts

@@ -458,10 +458,10 @@ export declare const storeFirestoreSchema: z.ZodObject<{
     shippingPolicy?: string | undefined;
     isVacationMode?: boolean | undefined;
     vacationMessage?: string | undefined;
+    capabilities?: string[] | undefined;
     vacationReturnDate?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    capabilities?: string[] | undefined;
     customCommissionRate?: number | undefined;
     googleReviews?: {
         enabled: boolean;
@@ -543,10 +543,10 @@ export declare const storeFirestoreSchema: z.ZodObject<{
     shippingPolicy?: string | undefined;
     isVacationMode?: boolean | undefined;
     vacationMessage?: string | undefined;
+    capabilities?: string[] | undefined;
     vacationReturnDate?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    capabilities?: string[] | undefined;
     customCommissionRate?: number | undefined;
     googleReviews?: {
         enabled: boolean;

package/dist/features/tester/actions/checklist-item-actions.d.ts

@@ -9,6 +9,7 @@ export declare const checklistItemCreateSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     href: z.ZodOptional<z.ZodString>;
     order: z.ZodDefault<z.ZodNumber>;
+    phase: z.ZodDefault<z.ZodNumber>;
     isActive: z.ZodDefault<z.ZodBoolean>;
     adminOnly: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
@@ -17,6 +18,7 @@ export declare const checklistItemCreateSchema: z.ZodObject<{
     isActive: boolean;
     groupKey: string;
     pageKey: string;
+    phase: number;
     groupLabel: string;
     pageLabel: string;
     adminOnly: boolean;
@@ -32,6 +34,7 @@ export declare const checklistItemCreateSchema: z.ZodObject<{
     description?: string | undefined;
     order?: number | undefined;
     isActive?: boolean | undefined;
+    phase?: number | undefined;
     adminOnly?: boolean | undefined;
 }>;
 export declare const checklistItemUpdateSchema: z.ZodObject<{
@@ -43,6 +46,7 @@ export declare const checklistItemUpdateSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     href: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     order: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    phase: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     isActive: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     adminOnly: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
@@ -53,6 +57,7 @@ export declare const checklistItemUpdateSchema: z.ZodObject<{
     isActive?: boolean | undefined;
     groupKey?: string | undefined;
     pageKey?: string | undefined;
+    phase?: number | undefined;
     groupLabel?: string | undefined;
     pageLabel?: string | undefined;
     adminOnly?: boolean | undefined;
@@ -64,6 +69,7 @@ export declare const checklistItemUpdateSchema: z.ZodObject<{
     isActive?: boolean | undefined;
     groupKey?: string | undefined;
     pageKey?: string | undefined;
+    phase?: number | undefined;
     groupLabel?: string | undefined;
     pageLabel?: string | undefined;
     adminOnly?: boolean | undefined;

package/dist/features/tester/actions/checklist-item-actions.js

@@ -11,6 +11,7 @@ const checklistItemBaseSchema = z.object({
     description: z.string().max(2000).optional(),
     href: z.string().max(300).optional(),
     order: z.number().int().min(0).default(0),
+    phase: z.number().int().min(1).default(1),
     isActive: z.boolean().default(true),
     adminOnly: z.boolean().default(false),
 });
@@ -27,6 +28,7 @@ export async function createChecklistItem(input) {
         description: input.description,
         href: input.href,
         order: input.order ?? 0,
+        phase: input.phase ?? 1,
         isActive: input.isActive ?? true,
         adminOnly: input.adminOnly ?? false,
     });

package/dist/features/tester/components/AdminTesterFeedbackIssuesView.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useQuery } from "@tanstack/react-query";
-import { Card, Stack, Text } from "../../../ui";
+import { Card, Details, Div, Stack, Summary, Text } from "../../../ui";
 import { MediaImage } from "../../media/MediaImage";
 import { apiClient } from "../../../http";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -18,5 +18,16 @@ export function AdminTesterFeedbackIssuesView() {
         return _jsx(Text, { color: "muted", children: "Loading issues\u2026" });
     if (issues.length === 0)
         return _jsx(Text, { color: "muted", children: "No \"No\" answers recorded yet." });
-    return (_jsx(Stack, { gap: "sm", children: issues.map((issue) => (_jsx(Card, { padding: "md", variant: "default", children: _jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { weight: "semibold", children: [issue.groupKey, " / ", issue.pageKey] }), _jsxs(Text, { size: "sm", color: "muted", children: ["Reported by ", issue.testerDisplayName] }), issue.comment && _jsx(Text, { size: "sm", children: issue.comment }), issue.screenshotUrl && (_jsx(MediaImage, { src: issue.screenshotUrl, alt: "Tester screenshot", size: "card" }))] }) }, issue.id))) }));
+    const byPhase = new Map();
+    for (const issue of issues) {
+        const phase = issue.phase ?? 0;
+        if (!byPhase.has(phase))
+            byPhase.set(phase, []);
+        byPhase.get(phase).push(issue);
+    }
+    const sortedPhases = Array.from(byPhase.keys()).sort((a, b) => a - b);
+    return (_jsx(Stack, { gap: "md", children: sortedPhases.map((phase) => {
+            const phaseIssues = byPhase.get(phase);
+            return (_jsxs(Details, { tone: "card", defaultOpen: sortedPhases.length === 1, children: [_jsxs(Summary, { size: "lg", weight: "bold", children: ["Phase ", phase, " (", phaseIssues.length, " issue", phaseIssues.length === 1 ? "" : "s", ")"] }), _jsx(Div, { padding: "t-sm", children: _jsx(Stack, { gap: "sm", children: phaseIssues.map((issue) => (_jsx(Card, { padding: "md", variant: "default", children: _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { weight: "semibold", children: issue.label }), _jsxs(Text, { size: "sm", color: "muted", children: [issue.groupLabel, " \u203A ", issue.pageLabel] }), _jsxs(Text, { size: "sm", color: "muted", children: ["Reported by ", issue.testerDisplayName] }), issue.comment && _jsx(Text, { size: "sm", children: issue.comment }), issue.screenshotUrl && (_jsx(MediaImage, { src: issue.screenshotUrl, alt: "Tester screenshot", size: "card" }))] }) }, issue.id))) }) })] }, phase));
+        }) }));
 }

package/dist/features/tester/components/AdminTesterFeedbackListView.js

@@ -59,12 +59,13 @@ export function AdminTesterFeedbackListView(_props) {
         sortOptions: [
             { value: sortBy(TESTER_CHECKLIST_RESPONSE_FIELDS.CREATED_AT, "DESC"), label: "Newest" },
             { value: sortBy(TESTER_CHECKLIST_RESPONSE_FIELDS.CREATED_AT, "ASC"), label: "Oldest" },
+            { value: sortBy(TESTER_CHECKLIST_RESPONSE_FIELDS.PHASE, "ASC"), label: "Phase" },
         ],
         columns: COLUMNS,
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
             id: toStringValue(item.id, `feedback-${index}`),
             primary: toStringValue(item.testerDisplayName, "Unknown tester"),
-            secondary: `${toStringValue(item.groupKey, "")} / ${toStringValue(item.pageKey, "")}${item.comment ? " — " + toStringValue(item.comment, "") : ""}`,
+            secondary: `Phase ${toStringValue(item.phase, "?")} — ${toStringValue(item.groupKey, "")} / ${toStringValue(item.pageKey, "")}${item.comment ? " — " + toStringValue(item.comment, "") : ""}`,
             answer: toStringValue(item.answer, ""),
             status: toStringValue(item.status, "new"),
             updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),

package/dist/features/tester/components/AdminTesterFeedbackReportView.js

@@ -17,14 +17,18 @@ export function AdminTesterFeedbackReportView() {
         return _jsx(Text, { color: "muted", children: "Loading report\u2026" });
     const itemCoverage = query.data?.itemCoverage ?? [];
     const totals = query.data?.totals ?? { totalAnswered: 0, totalYes: 0, totalNo: 0 };
-    const byGroup = new Map();
+    const byPhase = new Map();
     for (const item of itemCoverage) {
-        if (!byGroup.has(item.groupKey)) {
-            byGroup.set(item.groupKey, { groupLabel: item.groupKey, yes: 0, no: 0 });
+        const phase = item.phase ?? 0;
+        if (!byPhase.has(phase)) {
+            byPhase.set(phase, { groupLabel: `Phase ${phase}`, yes: 0, no: 0 });
         }
-        const entry = byGroup.get(item.groupKey);
+        const entry = byPhase.get(phase);
         entry.yes += item.yesCount;
         entry.no += item.noCount;
     }
-    return (_jsx(Stack, { gap: "lg", children: _jsx(TesterFeedbackChart, { data: Array.from(byGroup.values()), totalCases: itemCoverage.length, totalAnswered: totals.totalAnswered, totalYes: totals.totalYes, totalNo: totals.totalNo }) }));
+    const sortedPhaseData = Array.from(byPhase.entries())
+        .sort(([a], [b]) => a - b)
+        .map(([, datum]) => datum);
+    return (_jsx(Stack, { gap: "lg", children: _jsx(TesterFeedbackChart, { data: sortedPhaseData, totalCases: itemCoverage.length, totalAnswered: totals.totalAnswered, totalYes: totals.totalYes, totalNo: totals.totalNo }) }));
 }

package/dist/features/tester/components/TesterHubView.js

@@ -1,5 +1,5 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import React from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { Alert, Details, Div, FieldInput, Heading, Stack, Summary, Text } from "../../../ui";
@@ -15,6 +15,21 @@ function matchesQuery(item, query) {
     const haystack = `${item.label} ${item.description ?? ""} ${item.groupLabel} ${item.pageLabel} ${item.href ?? ""}`.toLowerCase();
     return haystack.includes(query.toLowerCase());
 }
+function TesterChecklistPageSection({ page, testerDisplayName, onAnswer, onSaveNote }) {
+    const answeredCount = page.items.filter((i) => i.answer).length;
+    return (_jsxs(Details, { tone: "card", defaultOpen: false, children: [_jsxs(Summary, { children: [page.pageLabel, " (", answeredCount, "/", page.items.length, " answered)"] }), _jsx(Div, { padding: "t-sm", children: _jsx(Stack, { gap: "sm", children: page.items
+                        .slice()
+                        .sort((a, b) => a.order - b.order)
+                        .map((item) => (_jsx(TesterChecklistStepRow, { testerDisplayName: testerDisplayName, item: {
+                            checklistItemId: item.id,
+                            label: item.label,
+                            description: item.description,
+                            href: item.href,
+                            answer: item.answer,
+                            comment: item.comment,
+                            screenshotUrl: item.screenshotUrl,
+                        }, onAnswer: onAnswer, onSaveNote: onSaveNote }, item.id))) }) })] }));
+}
 export function TesterHubView({ sandboxExpiresAt }) {
     const { user } = useSession();
     const queryClient = useQueryClient();
@@ -35,38 +50,36 @@ export function TesterHubView({ sandboxExpiresAt }) {
     if (!user?.isTester && !isAdminUser(user)) {
         return (_jsx(Alert, { variant: "warning", title: "Testers only", children: "This page is only available to accounts flagged as testers (and admins). Contact an admin if you believe this is a mistake." }));
     }
+    // Items arrive pre-sorted by catalog `order` (listActive() orders by it).
     const items = query.data?.items ?? [];
     const filtered = items.filter((item) => matchesQuery(item, search));
-    const groups = new Map();
+    const phases = new Map();
     for (const item of filtered) {
-        if (!groups.has(item.groupKey)) {
+        if (!phases.has(item.phase))
+            phases.set(item.phase, new Map());
+        const groups = phases.get(item.phase);
+        if (!groups.has(item.groupKey))
             groups.set(item.groupKey, { groupLabel: item.groupLabel, pages: new Map() });
-        }
         const group = groups.get(item.groupKey);
-        if (!group.pages.has(item.pageKey)) {
+        if (!group.pages.has(item.pageKey))
             group.pages.set(item.pageKey, { pageLabel: item.pageLabel, items: [] });
-        }
         group.pages.get(item.pageKey).items.push(item);
     }
+    const sortedPhaseNumbers = Array.from(phases.keys()).sort((a, b) => a - b);
     const handleAnswer = (checklistItemId, answer) => {
         upsertMutation.mutate({ checklistItemId, patch: { answer } });
     };
     const handleSaveNote = async (checklistItemId, comment, screenshotUrl) => {
         await upsertMutation.mutateAsync({ checklistItemId, patch: { comment, screenshotUrl } });
     };
-    return (_jsxs(Stack, { gap: "lg", children: [_jsx(Heading, { level: 1, children: "Tester Hub" }), _jsx(Text, { color: "muted", children: "Work through the checklist below and answer Yes/No for each test case. Add a comment and screenshot wherever something looks off \u2014 colors, styles, readability, bugs. Your answers save automatically." }), sandboxExpiresAt && (_jsxs(Alert, { variant: "info", title: "Shared test sandbox", children: ["The shared test store/products/categories expire on ", new Date(sandboxExpiresAt).toLocaleDateString(), "."] })), _jsx(FieldInput, { name: "checklist-search", label: "Search test cases", value: search, onChange: setSearch, placeholder: "Search by title or route, e.g. checkout, /store/payouts..." }), query.isLoading && _jsx(Text, { color: "muted", children: "Loading checklist\u2026" }), Array.from(groups.entries()).map(([groupKey, group]) => (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 3, children: group.groupLabel }), Array.from(group.pages.entries()).map(([pageKey, page]) => {
-                        const answeredCount = page.items.filter((i) => i.answer).length;
-                        return (_jsxs(Details, { tone: "card", defaultOpen: false, children: [_jsxs(Summary, { children: [page.pageLabel, " (", answeredCount, "/", page.items.length, " answered)"] }), _jsx(Div, { padding: "t-sm", children: _jsx(Stack, { gap: "sm", children: page.items
-                                            .slice()
-                                            .sort((a, b) => a.order - b.order)
-                                            .map((item) => (_jsx(TesterChecklistStepRow, { testerDisplayName: user?.displayName ?? user?.email ?? "tester", item: {
-                                                checklistItemId: item.id,
-                                                label: item.label,
-                                                description: item.description,
-                                                href: item.href,
-                                                answer: item.answer,
-                                                comment: item.comment,
-                                                screenshotUrl: item.screenshotUrl,
-                                            }, onAnswer: handleAnswer, onSaveNote: handleSaveNote }, item.id))) }) })] }, pageKey));
-                    })] }, groupKey)))] }));
+    return (_jsxs(Stack, { gap: "lg", children: [_jsx(Heading, { level: 1, children: "Tester Hub" }), _jsx(Text, { color: "muted", children: "Work through the checklist below and answer Yes/No for each test case. Add a comment and screenshot wherever something looks off \u2014 colors, styles, readability, bugs. Your answers save automatically." }), sandboxExpiresAt && (_jsxs(Alert, { variant: "info", title: "Shared test sandbox", children: ["The shared test store/products/categories expire on ", new Date(sandboxExpiresAt).toLocaleDateString(), "."] })), _jsx(FieldInput, { name: "checklist-search", label: "Search test cases", value: search, onChange: setSearch, placeholder: "Search by title or route, e.g. checkout, /store/payouts..." }), query.isLoading && _jsx(Text, { color: "muted", children: "Loading checklist\u2026" }), sortedPhaseNumbers.map((phaseNumber) => {
+                const groups = phases.get(phaseNumber);
+                const phaseItemCount = Array.from(groups.values())
+                    .flatMap((g) => Array.from(g.pages.values()))
+                    .reduce((sum, page) => sum + page.items.length, 0);
+                const phaseAnswered = Array.from(groups.values())
+                    .flatMap((g) => Array.from(g.pages.values()))
+                    .reduce((sum, page) => sum + page.items.filter((i) => i.answer).length, 0);
+                return (_jsxs(Details, { tone: "card", defaultOpen: false, children: [_jsxs(Summary, { size: "lg", weight: "bold", children: ["Phase ", phaseNumber, " (", phaseAnswered, "/", phaseItemCount, " answered)"] }), _jsx(Div, { padding: "t-sm", children: _jsx(Stack, { gap: "md", children: Array.from(groups.entries()).map(([groupKey, group]) => (_jsxs(Stack, { gap: "sm", children: [_jsx(Heading, { level: 4, children: group.groupLabel }), Array.from(group.pages.entries()).map(([pageKey, page]) => (_jsx(TesterChecklistPageSection, { page: page, testerDisplayName: user?.displayName ?? user?.email ?? "tester", onAnswer: handleAnswer, onSaveNote: handleSaveNote }, pageKey)))] }, groupKey))) }) })] }, phaseNumber));
+            })] }));
 }

package/dist/features/tester/repository/tester-checklist-item.repository.js

@@ -48,6 +48,7 @@ TesterChecklistItemRepository.SIEVE_FIELDS = {
     pageKey: { canFilter: true, canSort: true },
     label: { canFilter: true, canSort: false },
     order: { canFilter: true, canSort: true },
+    phase: { canFilter: true, canSort: true },
     isActive: { canFilter: true, canSort: false },
     searchTokens: { canFilter: true, canSort: false },
     createdAt: { canFilter: true, canSort: true },

package/dist/features/tester/repository/tester-checklist-response.repository.d.ts

@@ -7,6 +7,7 @@ export interface UpsertResponseInput {
     checklistItemId: string;
     groupKey: string;
     pageKey: string;
+    phase: number;
     answer?: TesterAnswer | null;
     comment?: string;
     screenshotUrl?: string;
@@ -14,14 +15,22 @@ export interface UpsertResponseInput {
 export interface ChecklistItemCoverage {
     checklistItemId: string;
     groupKey: string;
+    groupLabel: string;
     pageKey: string;
+    pageLabel: string;
+    phase: number;
     yesCount: number;
     noCount: number;
     totalAnswered: number;
 }
+export type CoverageIssue = TesterChecklistResponseDocument & {
+    groupLabel: string;
+    pageLabel: string;
+    label: string;
+};
 export interface CoverageReport {
     itemCoverage: ChecklistItemCoverage[];
-    issues: TesterChecklistResponseDocument[];
+    issues: CoverageIssue[];
     totals: {
         totalAnswered: number;
         totalYes: number;
@@ -36,14 +45,19 @@ export declare class TesterChecklistResponseRepository extends BaseRepository<Te
     listForTester(testerId: string): Promise<TesterChecklistResponseDocument[]>;
     list(model: SieveModel): Promise<FirebaseSieveResult<TesterChecklistResponseDocument>>;
     markReviewed(id: string): Promise<TesterChecklistResponseDocument>;
-    /** Single collection scan (small table: testers x cases) — no join needed. */
+    /** Joins responses against the checklist catalog for human labels
+     * (groupLabel/pageLabel) — small tables (testers x cases, and the
+     * ~300-item catalog), so the extra read is cheap. `phase` itself is
+     * already denormalized onto the response doc, no join needed for it. */
     getCoverageReport(): Promise<CoverageReport>;
     /**
      * Markdown dump of every answered case, joined against the checklist item
      * catalog for the human-readable label/href — optimized for a future dev
      * (or Claude session) to read directly and go fix the reported issues.
-     * Mirrors appkit/scripts/export-tester-feedback.mjs's CLI output exactly;
-     * keep the two in sync.
+     * Grouped by phase (ascending), then group, then page — mirrors how the
+     * Tester Hub itself is organized. Mirrors
+     * appkit/scripts/export-tester-feedback.mjs's CLI output exactly; keep
+     * the two in sync.
      */
     getMarkdownReport(siteOrigin: string): Promise<string>;
 }