@mohasinac/appkit 4.31.1 → 4.32.1

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

@@ -1,9 +1,14 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
-import { useCallback, useState } from "react";
+import React, { useCallback, useState } from "react";
+import { reviewReplySchema, reviewBulkReplySchema, reviewContestSchema, reviewFeedbackSchema, } from "../schemas/review-forms";
+import { SectionForm, useSectionFormNav, buildSectionsFromSchema, visibleValues, } from "../../shell";
+import { useFormShellState, FormShellContext } from "../../../ui/forms";
+import { applyZodIssues } from "../../../ui/forms/apply-zod-issues";
+import { FormErrorSummary } from "../../../ui/forms/FormErrorSummary";
 import { useQueryClient } from "@tanstack/react-query";
-import { Alert, Badge, Button, Checkbox, Div, Modal, Row, Select, SideDrawer, Span, Stack, Text, Textarea, useToast } from "../../../ui";
+import { Alert, Badge, Button, Checkbox, Div, Modal, Row, Select, SideDrawer, Span, Stack, Text, useToast } from "../../../ui";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 import { SELLER_BULK_ACTIONS, ROW_ACTION_META } from "../../products/constants/action-defs";
 import { SELLER_ENDPOINTS } from "../../../constants/api-endpoints";
@@ -32,28 +37,58 @@ function statusBadge(status) {
     };
     return _jsx(Badge, { variant: map[status] ?? "default", children: status });
 }
+/**
+ * The four write surfaces on this page are each ONE textarea, and four
+ * copies of the same twenty lines of SectionForm wiring is exactly the Rule of
+ * Three trigger. It stays local: the shape is "a single-field modal form", not
+ * a generally useful primitive, and `QuickFormDrawer` already owns the
+ * generalised version for drawers.
+ *
+ * `hideActions` is deliberately NOT used — each modal's own footer buttons are
+ * removed in favour of this row, so there is one Save and one Cancel per form.
+ */
+function ReviewTextForm({ schema, values, onChange, onSubmit, submitLabel, onCancel, isLoading, scope, }) {
+    const sections = React.useMemo(() => buildSectionsFromSchema(schema), [schema]);
+    const nav = useSectionFormNav(sections, values, { scope });
+    const form = useFormShellState(schema, {
+        sections: nav.sectionMeta,
+        onGoToSection: nav.goToSection,
+        fieldToSectionIndex: nav.fieldToSectionIndex,
+    });
+    return (_jsxs(FormShellContext.Provider, { value: form.shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: values, onChange: onChange, onSubmit: () => {
+                    // SectionForm scrolls to the first erroring section and then submits
+                    // regardless, so the guard lives here.
+                    form.clearErrors();
+                    const parsed = schema.safeParse(visibleValues(schema, values));
+                    if (!parsed.success) {
+                        applyZodIssues(parsed.error.issues, form.setFieldError);
+                        return;
+                    }
+                    onSubmit();
+                }, onValidationChange: () => form.validate(values), schema: schema, openIds: nav.openIds, onOpenChange: nav.setOpenIds, submitLabel: submitLabel, cancelLabel: "Cancel", onCancel: onCancel, isLoading: isLoading })] }));
+}
 export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, replyApiBase = SELLER_ENDPOINTS.REVIEWS, }) {
     const queryClient = useQueryClient();
     const { showToast } = useToast();
     const refetchReviews = useCallback(() => queryClient.invalidateQueries({ queryKey: ["seller", "reviews", "listing"] }), [queryClient]);
     // Reply drawer
     const [replyTarget, setReplyTarget] = useState(null);
-    const [replyText, setReplyText] = useState("");
+    const [replyDraft, setReplyDraft] = useState({ reply: "" });
     const [replySaving, setReplySaving] = useState(false);
     const [replyError, setReplyError] = useState(null);
     // S-STORE-4-C — bulk reply + contest + feedback selection
     const [bulkReplyOpen, setBulkReplyOpen] = useState(false);
-    const [bulkReplyText, setBulkReplyText] = useState("");
+    const [bulkDraft, setBulkDraft] = useState({ reply: "" });
     const [bulkSaving, setBulkSaving] = useState(false);
     const [bulkTargetIds, setBulkTargetIds] = useState([]);
     const [bulkClearSelection, setBulkClearSelection] = useState(null);
     const [contestTarget, setContestTarget] = useState(null);
-    const [contestReason, setContestReason] = useState("");
+    const [contestDraft, setContestDraft] = useState({ reason: "" });
     const [feedbackTarget, setFeedbackTarget] = useState(null);
-    const [feedbackText, setFeedbackText] = useState("");
+    const [feedbackDraft, setFeedbackDraft] = useState({ feedback: "" });
     const openReply = (review) => {
         setReplyTarget(review);
-        setReplyText(review.sellerReply ?? "");
+        setReplyDraft({ reply: review.sellerReply ?? "" });
         setReplyError(null);
     };
     const handleReplySave = async (onDone) => {
@@ -65,7 +100,7 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
             const res = await fetch(`${replyApiBase}/${replyTarget.id}/reply`, {
                 method: "POST",
                 headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({ reply: replyText }),
+                body: JSON.stringify({ reply: replyDraft.reply }),
             });
             const json = await res.json();
             if (!res.ok)
@@ -91,7 +126,7 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
             const res = await fetch(SELLER_ENDPOINTS.REVIEW_CONTEST(contestTarget.id), {
                 method: "POST",
                 headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({ reason: contestReason }),
+                body: JSON.stringify({ reason: contestDraft.reason }),
             });
             if (!res.ok)
                 throw new Error(`Could not submit the contest (${res.status})`);
@@ -101,9 +136,9 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
             return;
         }
         setContestTarget(null);
-        setContestReason("");
+        setContestDraft({ reason: "" });
         onDone();
-    }, [contestTarget, contestReason, showToast]);
+    }, [contestTarget, contestDraft, showToast]);
     const submitFeedback = useCallback(async () => {
         if (!feedbackTarget)
             return;
@@ -111,7 +146,7 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
             const res = await fetch(SELLER_ENDPOINTS.REVIEW_FEEDBACK(feedbackTarget.id), {
                 method: "POST",
                 headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({ feedback: feedbackText }),
+                body: JSON.stringify({ feedback: feedbackDraft.feedback }),
             });
             if (!res.ok)
                 throw new Error(`Could not send the feedback (${res.status})`);
@@ -121,10 +156,10 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
             return;
         }
         setFeedbackTarget(null);
-        setFeedbackText("");
-    }, [feedbackTarget, feedbackText, showToast]);
+        setFeedbackDraft({ feedback: "" });
+    }, [feedbackTarget, feedbackDraft, showToast]);
     const submitBulkReply = useCallback(async () => {
-        if (!bulkReplyText.trim() || bulkTargetIds.length === 0)
+        if (!bulkDraft.reply.trim() || bulkTargetIds.length === 0)
             return;
         setBulkSaving(true);
         // Partial success is the normal outcome of a bulk write, so report the
@@ -132,7 +167,7 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
         const outcomes = await Promise.all(bulkTargetIds.map((id) => fetch(`${replyApiBase}/${id}/reply`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ reply: bulkReplyText }),
+            body: JSON.stringify({ reply: bulkDraft.reply }),
         })
             .then((res) => res.ok)
             .catch((err) => {
@@ -145,11 +180,11 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
         }
         setBulkSaving(false);
         setBulkReplyOpen(false);
-        setBulkReplyText("");
+        setBulkDraft({ reply: "" });
         bulkClearSelection?.();
         setBulkTargetIds([]);
         await refetchReviews();
-    }, [bulkReplyText, bulkTargetIds, replyApiBase, bulkClearSelection, refetchReviews, showToast]);
+    }, [bulkDraft, bulkTargetIds, replyApiBase, bulkClearSelection, refetchReviews, showToast]);
     const config = {
         portal: "seller",
         title: "Reviews",
@@ -193,5 +228,5 @@ export function SellerReviewsView({ reviewsApiBase = SELLER_ENDPOINTS.REVIEWS, r
         })),
         renderCards: (rows, _view, selection, isLoading) => (_jsx(Stack, { gap: "md", children: isLoading ? (_jsx(Div, { className: "text-center", padding: "y-xl", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Loading reviews\u2026" }) })) : rows.length === 0 ? (_jsx(Div, { className: "text-center", padding: "y-3xl", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "No reviews found." }) })) : (rows.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: selection.selectedIds.includes(review.id), onChange: () => selection.toggleSelect(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)))) })),
     };
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _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(refetchReviews), disabled: replySaving || !replyText.trim(), isLoading: replySaving, children: replyTarget?.sellerReply ? "Update Reply" : "Post Reply" })] })] }) }), _jsx(Modal, { isOpen: bulkReplyOpen, onClose: () => setBulkReplyOpen(false), title: "Bulk reply to selected reviews", 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(refetchReviews), 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" })] }) })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _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 }), _jsx(ReviewTextForm, { schema: reviewReplySchema, values: replyDraft, onChange: (partial) => setReplyDraft((d) => ({ ...d, ...partial })), onSubmit: () => void handleReplySave(refetchReviews), submitLabel: replyTarget?.sellerReply ? "Update Reply" : "Post Reply", onCancel: () => setReplyTarget(null), isLoading: replySaving, scope: "store:review-reply" })] }) }), _jsx(Modal, { isOpen: bulkReplyOpen, onClose: () => setBulkReplyOpen(false), title: "Bulk reply to selected reviews", children: _jsx(Stack, { gap: "md", padding: "2xs", children: _jsx(ReviewTextForm, { schema: reviewBulkReplySchema, values: bulkDraft, onChange: (partial) => setBulkDraft((d) => ({ ...d, ...partial })), onSubmit: () => void submitBulkReply(), submitLabel: "Send reply", onCancel: () => setBulkReplyOpen(false), isLoading: bulkSaving, scope: "store:review-bulk-reply" }) }) }), _jsx(Modal, { isOpen: !!contestTarget, onClose: () => setContestTarget(null), title: "Contest this review", 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." }), _jsx(ReviewTextForm, { schema: reviewContestSchema, values: contestDraft, onChange: (partial) => setContestDraft((d) => ({ ...d, ...partial })), onSubmit: () => void submitContest(refetchReviews), submitLabel: "Submit", onCancel: () => setContestTarget(null), scope: "store:review-contest" })] }) }), _jsx(Modal, { isOpen: !!feedbackTarget, onClose: () => setFeedbackTarget(null), title: "Send feedback to buyer", children: _jsx(Stack, { gap: "md", padding: "2xs", children: _jsx(ReviewTextForm, { schema: reviewFeedbackSchema, values: feedbackDraft, onChange: (partial) => setFeedbackDraft((d) => ({ ...d, ...partial })), onSubmit: () => void submitFeedback(), submitLabel: "Send", onCancel: () => setFeedbackTarget(null), scope: "store:review-feedback" }) }) })] }));
 }

package/dist/features/seller/constants/store-tabs.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 🛑 `StoreDashboardTab`, not `StoreTab` — that name is already taken by
+ * `features/stores`, which uses it for a tab on the PUBLIC store detail page.
+ * Two same-named types in one package is the defect Root Cause #36 records, and
+ * the barrel's choice between them would be invisible at every call site.
+ */
+export interface StoreDashboardTab {
+    id: string;
+    label: string;
+    /** What lives in here, for anyone who does not know the tab's name. */
+    description: string;
+}
+/** "Get paid": what I am owed, where it goes, on what schedule. */
+export declare const PAYOUTS_TABS: readonly [{
+    readonly id: "payouts";
+    readonly label: "Payouts";
+    readonly description: "What you have been paid, and what is still due.";
+}, {
+    readonly id: "methods";
+    readonly label: "Methods";
+    readonly description: "Where your money goes — bank or UPI.";
+}, {
+    readonly id: "settings";
+    readonly label: "Settings";
+    readonly description: "How often you get paid, and the minimum.";
+}];
+export type PayoutsTabId = (typeof PAYOUTS_TABS)[number]["id"];
+export declare function isPayoutsTabId(value: string | null | undefined): value is PayoutsTabId;
+/** Shipping defaults, plus the reusable named presets built on top of them. */
+export declare const SHIPPING_TABS: readonly [{
+    readonly id: "rates";
+    readonly label: "Rates & zones";
+    readonly description: "What you charge to ship, and where you ship to.";
+}, {
+    readonly id: "configs";
+    readonly label: "Named configs";
+    readonly description: "Named shipping rules you can reuse per listing.";
+}];
+export type ShippingTabId = (typeof SHIPPING_TABS)[number]["id"];
+export declare function isShippingTabId(value: string | null | undefined): value is ShippingTabId;
+/** The pack-and-dispatch loop: the queue, then the paperwork it needs. */
+export declare const FULFILLMENT_TABS: readonly [{
+    readonly id: "queue";
+    readonly label: "Queue";
+    readonly description: "Orders waiting to be packed or handed over.";
+}, {
+    readonly id: "print";
+    readonly label: "Print centre";
+    readonly description: "Print labels, invoices and barcodes in a batch.";
+}];
+export type FulfillmentTabId = (typeof FULFILLMENT_TABS)[number]["id"];
+export declare function isFulfillmentTabId(value: string | null | undefined): value is FulfillmentTabId;
+/** The shop's identity — its look, and the address buyers reach it at. */
+export declare const STOREFRONT_TABS: readonly [{
+    readonly id: "profile";
+    readonly label: "Profile";
+    readonly description: "Your shop's name, logo, banner and description.";
+}, {
+    readonly id: "slug";
+    readonly label: "Web address";
+    readonly description: "The web address buyers reach your shop at.";
+}];
+export type StorefrontTabId = (typeof STOREFRONT_TABS)[number]["id"];
+export declare function isStorefrontTabId(value: string | null | undefined): value is StorefrontTabId;

package/dist/features/seller/constants/store-tabs.js

@@ -0,0 +1,60 @@
+/*
+ * WHY: W8's C2 folds sibling store pages that are one task into one tabbed
+ *      page. Each absorbed page keeps a `?tab=` deep link so it stays findable
+ *      from the command palette and from a bookmark, and the action index's
+ *      `AIX_DEAD_DEEPLINK` check needs a union to validate those links
+ *      against — a deep link naming a tab that does not exist opens the page
+ *      on its default tab and reads as the search having missed.
+ *
+ * ## 🛑 Tab ids are NOT nav hrefs
+ *
+ * `navItemId(portal, href)` strips the query, so `/store/payouts` and
+ * `/store/payouts?tab=methods` produce the SAME nav id — which is at once the
+ * `navConfig` toggle key, the gate that makes `requiredPermission` run, and the
+ * action-index entry id. So the absorbed pages keep their own hrefs (as
+ * redirect shells) and these ids live only in `?tab=`.
+ *
+ * EXPORTS:
+ *   PAYOUTS_TABS / isPayoutsTabId, SHIPPING_TABS / isShippingTabId,
+ *   FULFILLMENT_TABS / isFulfillmentTabId, STOREFRONT_TABS / isStorefrontTabId
+ *
+ * @tag domain:seller
+ * @tag layer:constants
+ * @tag pattern:registry
+ * @tag access:isomorphic
+ * @tag consumers:store payouts/shipping/fulfillment/storefront pages,action index
+ * @tag sideEffects:none
+ */
+/** "Get paid": what I am owed, where it goes, on what schedule. */
+export const PAYOUTS_TABS = [
+    { id: "payouts", label: "Payouts", description: "What you have been paid, and what is still due." },
+    { id: "methods", label: "Methods", description: "Where your money goes — bank or UPI." },
+    { id: "settings", label: "Settings", description: "How often you get paid, and the minimum." },
+];
+export function isPayoutsTabId(value) {
+    return !!value && PAYOUTS_TABS.some((t) => t.id === value);
+}
+/** Shipping defaults, plus the reusable named presets built on top of them. */
+export const SHIPPING_TABS = [
+    { id: "rates", label: "Rates & zones", description: "What you charge to ship, and where you ship to." },
+    { id: "configs", label: "Named configs", description: "Named shipping rules you can reuse per listing." },
+];
+export function isShippingTabId(value) {
+    return !!value && SHIPPING_TABS.some((t) => t.id === value);
+}
+/** The pack-and-dispatch loop: the queue, then the paperwork it needs. */
+export const FULFILLMENT_TABS = [
+    { id: "queue", label: "Queue", description: "Orders waiting to be packed or handed over." },
+    { id: "print", label: "Print centre", description: "Print labels, invoices and barcodes in a batch." },
+];
+export function isFulfillmentTabId(value) {
+    return !!value && FULFILLMENT_TABS.some((t) => t.id === value);
+}
+/** The shop's identity — its look, and the address buyers reach it at. */
+export const STOREFRONT_TABS = [
+    { id: "profile", label: "Profile", description: "Your shop's name, logo, banner and description." },
+    { id: "slug", label: "Web address", description: "The web address buyers reach your shop at." },
+];
+export function isStorefrontTabId(value) {
+    return !!value && STOREFRONT_TABS.some((t) => t.id === value);
+}

package/dist/features/seller/schemas/order-forms.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+/**
+ * 🛑 `""` is a real, meaningful value here — it is "keep the current status",
+ * which is what the panel's first option means and what its diff-against-the-
+ * loaded-order payload relies on. It is not an empty required field.
+ */
+export declare const sellerOrderUpdateSchema: z.ZodEffects<z.ZodObject<{
+    status: z.ZodEnum<["", "confirmed", "processing", "shipped", "delivered", "cancelled"]>;
+    trackingNumber: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    carrier: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    trackingUrl: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+}, "strip", z.ZodTypeAny, {
+    status: "" | "cancelled" | "processing" | "delivered" | "confirmed" | "shipped";
+    trackingNumber?: string | undefined;
+    trackingUrl?: string | undefined;
+    carrier?: string | undefined;
+}, {
+    status: "" | "cancelled" | "processing" | "delivered" | "confirmed" | "shipped";
+    trackingNumber?: string | undefined;
+    trackingUrl?: string | undefined;
+    carrier?: string | undefined;
+}>, {
+    status: "" | "cancelled" | "processing" | "delivered" | "confirmed" | "shipped";
+    trackingNumber?: string | undefined;
+    trackingUrl?: string | undefined;
+    carrier?: string | undefined;
+}, {
+    status: "" | "cancelled" | "processing" | "delivered" | "confirmed" | "shipped";
+    trackingNumber?: string | undefined;
+    trackingUrl?: string | undefined;
+    carrier?: string | undefined;
+}>;
+export type SellerOrderUpdateValues = z.infer<typeof sellerOrderUpdateSchema>;

package/dist/features/seller/schemas/order-forms.js

@@ -0,0 +1,75 @@
+/*
+ * WHY: The seller's "Update order" panel wrote a status change, a tracking
+ *      number, a carrier and a tracking URL with no schema at all — the one
+ *      form in the seller dashboard that changes what a BUYER sees about a
+ *      shipment they are waiting on.
+ *
+ *      Two rules were missing, both invisible until a buyer complained. A
+ *      tracking URL was a free string, so a typo'd or non-http value went
+ *      straight into the tracking link a buyer clicks. And a status could move
+ *      to `shipped` with no tracking number at all — the seller's own carrier
+ *      fields sat right there, empty, and nothing said so.
+ *
+ * WHAT: The four fields the panel offers, annotated for
+ *       `buildSectionsFromSchema`.
+ *
+ * EXPORTS:
+ *   sellerOrderUpdateSchema, type SellerOrderUpdateValues
+ *
+ * @tag domain:seller,orders
+ * @tag layer:schema
+ * @tag pattern:none
+ * @tag access:isomorphic
+ * @tag consumers:SellerOrderDetailPanel
+ * @tag sideEffects:none
+ */
+import { z } from "zod";
+import { annotate } from "../../shell/field-ui-meta";
+import { normalizeError } from "../../../errors/normalize";
+/**
+ * 🛑 `""` is a real, meaningful value here — it is "keep the current status",
+ * which is what the panel's first option means and what its diff-against-the-
+ * loaded-order payload relies on. It is not an empty required field.
+ */
+export const sellerOrderUpdateSchema = z
+    .object({
+    status: annotate(z.enum(["", "confirmed", "processing", "shipped", "delivered", "cancelled"]), {
+        section: "status", sectionLabel: "Update order", sectionRequired: true,
+        quick: true, order: 1, row: "full", kind: "select", label: "New status",
+    }),
+    trackingNumber: annotate(z.string().trim().max(120).optional().or(z.literal("")), {
+        section: "shipping", sectionLabel: "Shipment", order: 1, row: "pair",
+        label: "Tracking number",
+    }),
+    carrier: annotate(z.string().trim().max(80).optional().or(z.literal("")), {
+        section: "shipping", order: 2, row: "pair",
+    }),
+    trackingUrl: annotate(z.string().trim().max(2000).optional().or(z.literal("")), {
+        section: "shipping", order: 3, row: "full", inputType: "url",
+        label: "Tracking URL (optional)",
+    }),
+})
+    .superRefine((v, ctx) => {
+    const issue = (path, message) => ctx.addIssue({ code: z.ZodIssueCode.custom, path: [path], message });
+    // Marking an order shipped is what starts the buyer's "where is it"
+    // question, and the field that answers it is on this same panel.
+    if (v.status === "shipped" && !v.trackingNumber?.trim()) {
+        issue("trackingNumber", "A shipped order needs a tracking number.");
+    }
+    const url = v.trackingUrl?.trim();
+    if (url) {
+        let parsed = null;
+        try {
+            parsed = new URL(url);
+        }
+        catch (err) {
+            void normalizeError(err);
+            parsed = null;
+        }
+        if (!parsed)
+            issue("trackingUrl", "That is not a valid URL.");
+        else if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            issue("trackingUrl", "A tracking URL must start with http or https.");
+        }
+    }
+});

package/dist/features/seller/schemas/review-forms.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+/** Matches `replySchema` on `POST /api/store/reviews/[id]/reply`. */
+export declare const reviewReplySchema: z.ZodObject<{
+    reply: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reply: string;
+}, {
+    reply: string;
+}>;
+export type ReviewReplyValues = z.infer<typeof reviewReplySchema>;
+/** The same reply, posted on every selected review. */
+export declare const reviewBulkReplySchema: z.ZodObject<{
+    reply: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reply: string;
+}, {
+    reply: string;
+}>;
+export type ReviewBulkReplyValues = z.infer<typeof reviewBulkReplySchema>;
+/** Flags a review for admin investigation. */
+export declare const reviewContestSchema: z.ZodObject<{
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+}, {
+    reason: string;
+}>;
+export type ReviewContestValues = z.infer<typeof reviewContestSchema>;
+/** A private note to the buyer, never shown on the public review. */
+export declare const reviewFeedbackSchema: z.ZodObject<{
+    feedback: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    feedback: string;
+}, {
+    feedback: string;
+}>;
+export type ReviewFeedbackValues = z.infer<typeof reviewFeedbackSchema>;

package/dist/features/seller/schemas/review-forms.js

@@ -0,0 +1,82 @@
+/*
+ * WHY: The seller's reviews page has FOUR write surfaces — reply, bulk reply,
+ *      contest, send-feedback — and not one of them had a schema. Every guard
+ *      was a `disabled={!text.trim()}` on the button, which is a UI hint, not a
+ *      rule: it says nothing about the ceiling the route enforces, and it
+ *      cannot say anything at all about content.
+ *
+ *      The reply route caps at 1000 characters. The textarea carried
+ *      `maxLength={1000}`, so the browser truncated silently rather than
+ *      saying so — a seller writing a long reply lost the tail with no message.
+ *      A schema puts the same number where it can be reported.
+ *
+ *      The contest route trims and requires a non-empty `reason` and nothing
+ *      more, so "x" filed a moderation request a human then has to interpret.
+ *      A ten-character floor matches the admin offer-cancel reason, which is
+ *      the same kind of record: the only durable account of why.
+ *
+ * WHAT: One schema per surface. Each is a single field, and that is the point —
+ *       they are the same shape as `hardBanReasonSchema`, and they get the same
+ *       error summary and section badge as every other form.
+ *
+ * EXPORTS:
+ *   reviewReplySchema, reviewBulkReplySchema, reviewContestSchema,
+ *   reviewFeedbackSchema, and their value types
+ *
+ * @tag domain:seller,reviews
+ * @tag layer:schema
+ * @tag pattern:none
+ * @tag access:isomorphic
+ * @tag consumers:SellerReviewsView
+ * @tag sideEffects:none
+ */
+import { z } from "zod";
+import { annotate } from "../../shell/field-ui-meta";
+/** Matches `replySchema` on `POST /api/store/reviews/[id]/reply`. */
+export const reviewReplySchema = z.object({
+    reply: annotate(z
+        .string()
+        .trim()
+        .min(1, "Write a reply before posting it.")
+        .max(1000, "A reply is capped at 1000 characters."), {
+        section: "reply", sectionLabel: "Store reply", sectionRequired: true,
+        quick: true, order: 1, row: "full", kind: "textarea",
+        help: "Shown publicly beneath the buyer's review.",
+    }),
+});
+/** The same reply, posted on every selected review. */
+export const reviewBulkReplySchema = z.object({
+    reply: annotate(z
+        .string()
+        .trim()
+        .min(1, "Write a reply before sending it.")
+        .max(1000, "A reply is capped at 1000 characters."), {
+        section: "reply", sectionLabel: "Reply", sectionRequired: true,
+        quick: true, order: 1, row: "full", kind: "textarea",
+        help: "The same reply will be posted on all selected reviews.",
+    }),
+});
+/** Flags a review for admin investigation. */
+export const reviewContestSchema = z.object({
+    reason: annotate(z
+        .string()
+        .trim()
+        .min(10, "Say why this review should be investigated — at least 10 characters.")
+        .max(1000), {
+        section: "contest", sectionLabel: "Reason", sectionRequired: true,
+        quick: true, order: 1, row: "full", kind: "textarea",
+        help: "Fake, abusive, off-topic — be specific; a moderator reads this.",
+    }),
+});
+/** A private note to the buyer, never shown on the public review. */
+export const reviewFeedbackSchema = z.object({
+    feedback: annotate(z
+        .string()
+        .trim()
+        .min(1, "Write your message before sending it.")
+        .max(1000, "Keep the message under 1000 characters."), {
+        section: "feedback", sectionLabel: "Feedback", sectionRequired: true,
+        quick: true, order: 1, row: "full", kind: "textarea",
+        help: "Sent to the buyer's notification inbox. Does not appear on the review.",
+    }),
+});

package/dist/features/shell/index.d.ts

@@ -11,6 +11,6 @@ export { deriveQuickFields, deriveQuickFieldNames, allDefinitionFields, applyDer
 export type { FieldUiMeta, FieldRow, FieldKind, CalculatedTier, } from "./field-ui-meta";
 export { ui, annotate, ROW_COLUMNS, inferFieldUiMeta, resolveFieldUiMeta, unwrapSchema, schemaEnumOptions, schemaIsOptional, objectShape, } from "./field-ui-meta";
 export type { ResolvedField, FieldRenderer, BuildSectionsOptions, } from "./build-sections";
-export { buildSectionsFromSchema, resolveFields, groupFieldsBySection, packRows, } from "./build-sections";
+export { buildSectionsFromSchema, resolveFields, groupFieldsBySection, packRows, visibleValues, } from "./build-sections";
 export type { TitleDescriptionGroupProps, ImageFieldGroupProps, SeoFieldGroupProps, StatusFieldGroupProps, StatusFieldGroupOption, } from "./field-groups";
 export { TitleDescriptionGroup, ImageFieldGroup, SeoFieldGroup, StatusFieldGroup, } from "./field-groups";

package/dist/features/shell/index.js

@@ -4,5 +4,9 @@ export { QuickFormDrawer } from "./QuickFormDrawer";
 export { SectionForm, useSectionFormNav, orderSections, buildFieldToSectionIndex, sectionAnchorId, } from "./SectionForm";
 export { deriveQuickFields, deriveQuickFieldNames, allDefinitionFields, applyDerive, assertNoDeriveCollision, humaniseFieldName, } from "./entity-form";
 export { ui, annotate, ROW_COLUMNS, inferFieldUiMeta, resolveFieldUiMeta, unwrapSchema, schemaEnumOptions, schemaIsOptional, objectShape, } from "./field-ui-meta";
-export { buildSectionsFromSchema, resolveFields, groupFieldsBySection, packRows, } from "./build-sections";
+export { buildSectionsFromSchema, resolveFields, groupFieldsBySection, packRows, 
+// The payload builder. A `when` predicate hides a CONTROL, not a VALUE, so a
+// draft can still carry a field the user can no longer see — build the
+// submitted object from this, never from the raw draft.
+visibleValues, } from "./build-sections";
 export { TitleDescriptionGroup, ImageFieldGroup, SeoFieldGroup, StatusFieldGroup, } from "./field-groups";