@mohasinac/appkit 4.61.0 → 4.62.1

package/dist/features/shipping-boxes/schemas/firestore.d.ts

@@ -0,0 +1,82 @@
+/**
+ * `shippingBoxes` — a GLOBAL library of named carton presets.
+ *
+ * ## Why global rather than per-store
+ *
+ * A box is a real physical carton size. Scoping presets per store would give
+ * every seller their own private copy of "Medium", each with slightly
+ * different numbers, and the second seller to ship a Beyblade in a standard
+ * carton would re-measure instead of picking what already exists.
+ *
+ * `createdByName` is what keeps a shared library accountable: a wrong preset
+ * has an author, and the next seller can see who added the one they are about
+ * to trust.
+ *
+ * ## 🛑 A preset is a DEFAULT, never a lock
+ *
+ * The dimensions are COPIED onto the shipment when a seller uses one. Editing
+ * a preset later must not retroactively change what an already-dispatched
+ * parcel was declared as — the courier billed against the figures at dispatch,
+ * and a stored reference would make a past declaration mutable. Same snapshot
+ * discipline as the checkout's fee terms (D61).
+ *
+ * ## 🛑 Weight is not a formality
+ *
+ * An understated weight is re-billed by the courier AFTER delivery as a
+ * weight-discrepancy adjustment — real money, arriving on a reconciliation we
+ * cannot dispute without the parcel. The form says so rather than treating it
+ * as a required field to get past.
+ */
+/** `box-` prefixed slug, so the id reads as what it is. */
+export declare const SHIPPING_BOX_COLLECTION = "shippingBoxes";
+export interface ShippingBoxDocument {
+    id: string;
+    /** What a seller picks it by: "Standard Beyblade carton", "Poly mailer S". */
+    name: string;
+    /** cm. */
+    length: number;
+    width: number;
+    height: number;
+    /**
+     * kg, the EMPTY box. The parcel's weight is this plus contents, entered on
+     * the dispatch form — a preset cannot know what went inside it.
+     *
+     * 🛑 Separate from the shipment's `weight` for exactly that reason. Storing
+     * one "weight" on a preset and reusing it as the parcel weight is how every
+     * parcel gets declared at the same figure regardless of contents.
+     */
+    tareWeight?: number;
+    /** Who added it. Display name, so a seller can see whose preset this is. */
+    createdByName: string;
+    /** The uid, for moderation. Never rendered. */
+    createdByUid: string;
+    /**
+     * Soft-retire rather than delete. A preset in use by a draft shipment must
+     * not vanish mid-dispatch, and a deleted row takes its author with it.
+     */
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const SHIPPING_BOX_FIELDS: {
+    readonly ID: "id";
+    readonly NAME: "name";
+    readonly IS_ACTIVE: "isActive";
+    readonly CREATED_BY_UID: "createdByUid";
+    readonly CREATED_AT: "createdAt";
+};
+/**
+ * Bounds, so a typo cannot reach a courier API as a 4-metre parcel.
+ *
+ * 🛑 Generous on purpose — these are a sanity check, not a tariff. India Post
+ * and most couriers cap a single parcel well below these, and the right place
+ * to learn a real limit is `checkServiceability`, which quotes against the
+ * actual weight. A client-side rule that refuses a legitimate large parcel is
+ * worse than one that lets it through to be priced.
+ */
+export declare const SHIPPING_BOX_LIMITS: {
+    readonly minCm: 1;
+    readonly maxCm: 200;
+    readonly minKg: 0;
+    readonly maxKg: 50;
+};

package/dist/features/shipping-boxes/schemas/firestore.js

@@ -0,0 +1,53 @@
+/**
+ * `shippingBoxes` — a GLOBAL library of named carton presets.
+ *
+ * ## Why global rather than per-store
+ *
+ * A box is a real physical carton size. Scoping presets per store would give
+ * every seller their own private copy of "Medium", each with slightly
+ * different numbers, and the second seller to ship a Beyblade in a standard
+ * carton would re-measure instead of picking what already exists.
+ *
+ * `createdByName` is what keeps a shared library accountable: a wrong preset
+ * has an author, and the next seller can see who added the one they are about
+ * to trust.
+ *
+ * ## 🛑 A preset is a DEFAULT, never a lock
+ *
+ * The dimensions are COPIED onto the shipment when a seller uses one. Editing
+ * a preset later must not retroactively change what an already-dispatched
+ * parcel was declared as — the courier billed against the figures at dispatch,
+ * and a stored reference would make a past declaration mutable. Same snapshot
+ * discipline as the checkout's fee terms (D61).
+ *
+ * ## 🛑 Weight is not a formality
+ *
+ * An understated weight is re-billed by the courier AFTER delivery as a
+ * weight-discrepancy adjustment — real money, arriving on a reconciliation we
+ * cannot dispute without the parcel. The form says so rather than treating it
+ * as a required field to get past.
+ */
+/** `box-` prefixed slug, so the id reads as what it is. */
+export const SHIPPING_BOX_COLLECTION = "shippingBoxes";
+export const SHIPPING_BOX_FIELDS = {
+    ID: "id",
+    NAME: "name",
+    IS_ACTIVE: "isActive",
+    CREATED_BY_UID: "createdByUid",
+    CREATED_AT: "createdAt",
+};
+/**
+ * Bounds, so a typo cannot reach a courier API as a 4-metre parcel.
+ *
+ * 🛑 Generous on purpose — these are a sanity check, not a tariff. India Post
+ * and most couriers cap a single parcel well below these, and the right place
+ * to learn a real limit is `checkServiceability`, which quotes against the
+ * actual weight. A client-side rule that refuses a legitimate large parcel is
+ * worse than one that lets it through to be priced.
+ */
+export const SHIPPING_BOX_LIMITS = {
+    minCm: 1,
+    maxCm: 200,
+    minKg: 0,
+    maxKg: 50,
+};

package/dist/features/sticker-trace/components/StickerCommitPanel.js

@@ -37,6 +37,7 @@ import { Alert, Button, Card, Form, Heading, Stack, Text } from "../../../ui/ind
 import { FieldInput } from "../../../ui/forms/FieldInput.js";
 import { FieldSelect } from "../../../ui/forms/FieldSelect.js";
 import { TIER_HELP } from "../constants/help-content.js";
+import { toUserMessage } from "../../../errors/error-display-map.js";
 /** Every tier, unlike the studio — see the header. */
 const TIERS = ["draft", "standard", "precise", "max"];
 export function StickerCommitPanel({ file, dimensions, onCommit, onCommitted, }) {
@@ -80,7 +81,7 @@ export function StickerCommitPanel({ file, dimensions, onCommit, onCommitted, })
              * buyer, which this is not — and the routes already map their own
              * failures to user-safe text.
              */
-            setError(n.message);
+            setError(toUserMessage(n.code, undefined, { fallback: "We couldn't commit that sheet. Please try again." }));
         }
         finally {
             setPending(false);

package/dist/features/sticker-trace/components/StickerPrintPanel.js

@@ -32,6 +32,7 @@ import { useCallback, useEffect, useState } from "react";
 import { normalizeError } from "../../../errors/normalize.js";
 import { Alert, Badge, Button, Card, Heading, Row, Span, Stack, Text, } from "../../../ui/index.js";
 import { FieldSelect } from "../../../ui/forms/FieldSelect.js";
+import { toUserMessage } from "../../../errors/error-display-map.js";
 const PROFILES = [
     { value: "print-shop", label: "Print shop (Roland / Graphtec)" },
     { value: "cricut-cut", label: "Cricut Joy 2 — cut only" },
@@ -83,7 +84,7 @@ export function StickerPrintPanel({ loadReport, onDownloadCutFile, onDownloadMos
              * Rendering both the same way would have an operator confirming a DPI to
              * fix a lapsed session.
              */
-            setError(n.message);
+            setError(toUserMessage(n.code, undefined, { fallback: "We couldn't prepare that print. Please try again." }));
             setReport(null);
         }
         finally {

package/dist/features/sticker-trace/components/StickerRetryPanel.js

@@ -23,11 +23,18 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * belongs to which stage.
  *
  * 🛑 Built on `<SectionForm>`, not a hand-rolled `<Form>`. Three controls is
- * where a form stops being trivial, and sectionising is what buys the error
- * summary, the jump-to-field link and the pinned mobile action bar for free —
+ * where a form stops being trivial, and sectionising is what buys the
+ * jump-to-field link and the pinned mobile action bar —
  * audit-form-sectionised is strict-zero on exactly this, and its grandfather
  * list is empty and closed.
  *
+ * 🛑 The error summary is NOT free, and this comment used to claim it was.
+ * `SectionForm` deliberately does not own a `FormShellContext` — it consumes
+ * whichever one the owning view mounts, and tolerates none. So a view that
+ * only renders `<SectionForm schema={…}>` gets section badges and no readable
+ * message at all. The view must mount the context and render
+ * `<FormErrorSummary>` itself, which is what the bottom of this file now does.
+ *
  * EXPORTS: StickerRetryPanel
  *
  * @tag domain:sticker-trace
@@ -43,11 +50,14 @@ import { normalizeError } from "../../../errors/normalize.js";
 import { Alert, Card, Stack, Text } from "../../../ui/index.js";
 import { FieldInput } from "../../../ui/forms/FieldInput.js";
 import { FieldSelect } from "../../../ui/forms/FieldSelect.js";
+import { FormErrorSummary } from "../../../ui/forms/FormErrorSummary.js";
+import { FormShellContext, useFormShellState } from "../../../ui/forms/FormShell.js";
 import { SectionForm } from "../../shell/SectionForm.js";
 import { TRACE_STAGES } from "../../../_internal/shared/features/sticker-trace/types.js";
 import { resolveResumeStage, explainResume, } from "../../../_internal/shared/features/sticker-trace/resume.js";
 import { paramsForTier } from "../../../_internal/shared/features/sticker-trace/config.js";
 import { TIER_HELP } from "../constants/help-content.js";
+import { toUserMessage } from "../../../errors/error-display-map.js";
 const TIERS = ["draft", "standard", "precise", "max"];
 /**
  * 🛑 `.min(1)` on the name, mirroring `requireName` on the server.
@@ -103,7 +113,7 @@ export function StickerRetryPanel({ source, artifactsPruned = false, onSubmit, o
              * operator looking at a form that did nothing — and the likeliest causes,
              * a lapsed session or a rejected name, are both named by the message.
              */
-            setError(n.message);
+            setError(toUserMessage(n.code, undefined, { fallback: "We couldn't retry that run. Please try again." }));
         }
         finally {
             setPending(false);
@@ -124,5 +134,15 @@ export function StickerRetryPanel({ source, artifactsPruned = false, onSubmit, o
             render: ({ values: v, onChange: set }) => (_jsxs(Stack, { gap: "comfortable", children: [_jsx(FieldSelect, { name: "requested", label: "Resume from", value: v.requested, options: TRACE_STAGES.map((s) => ({ value: s, label: s })), onChange: (next) => set({ requested: next }) }), notice ? _jsx(Alert, { variant: "warning", children: notice }) : null, artifactsPruned ? (_jsx(Alert, { variant: "warning", children: "This run's artifacts have been cleared, so the retry starts from the beginning whatever you pick here." })) : null, !source.params ? (_jsx(Text, { size: "xs", color: "muted", children: "This run predates parameter recording, so the resume point cannot be checked ahead of time \u2014 the server will decide and tell you." })) : null] })),
         },
     ], [source.name, source.params, notice, artifactsPruned]);
-    return (_jsx(Card, { variant: "default", children: _jsxs(Stack, { gap: "comfortable", children: [error ? _jsx(Alert, { variant: "error", children: error }) : null, _jsx(SectionForm, { sections: sections, values: values, onChange: onChange, onSubmit: submit, schema: retrySchema, submitLabel: "Start retry", isLoading: pending, onCancel: onCancel, cancelLabel: "Cancel" })] }) }));
+    /*
+     * 🛑 `SectionForm` does NOT provide a FormShellContext — it reads whichever
+     * one the owning view mounts, and may legitimately get none. The header of
+     * this file says sectionising buys "the error summary … for free", and that
+     * was wrong: nothing here mounted a context or rendered a summary, so a
+     * schema rejection set the section badge and produced no readable message
+     * anywhere. The file passed `audit-form-error-summary` only because a bare
+     * `<SectionForm schema=>` was not a recognised call site.
+     */
+    const { shellCtx } = useFormShellState(retrySchema);
+    return (_jsx(Card, { variant: "default", children: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsxs(Stack, { gap: "comfortable", children: [error ? _jsx(Alert, { variant: "error", children: error }) : null, _jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: values, onChange: onChange, onSubmit: submit, schema: retrySchema, submitLabel: "Start retry", isLoading: pending, onCancel: onCancel, cancelLabel: "Cancel" })] }) }) }));
 }

package/dist/features/sticker-trace/components/StickerTraceStudio.js

@@ -30,6 +30,7 @@ import { PARAM_HELP, TIER_HELP } from "../constants/help-content.js";
 import { useLiveTrace } from "../hooks/useLiveTrace.js";
 import { canvasCodec } from "../../../_internal/client/features/sticker-trace/canvas-codec.js";
 import { normalizeError } from "../../../errors/normalize.js";
+import { toUserMessage } from "../../../errors/error-display-map.js";
 /*
  * Only `draft` is offered. The hook runs on the main thread and draft's
  * 1200px cap is what keeps one trace near a second; `standard`'s 3000 would
@@ -103,7 +104,7 @@ export function StickerTraceStudio({ renderCommit }) {
             // the operator is the one who needs to know the commit is blocked.
             if (live) {
                 setNatural(null);
-                setProbeError(n.message);
+                setProbeError(toUserMessage(n.code, undefined, { fallback: "That probe could not be run." }));
             }
         });
         return () => {

package/dist/features/store-extensions/schemas/report-create-form.d.ts

@@ -12,14 +12,14 @@ export declare const reportCreateSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     entityId: string;
     entityType: import("./firestore").ReportEntityType;
-    detail: string;
     reason: import("./firestore").ReportReason;
+    detail: string;
     evidenceUrls?: string[] | undefined;
 }, {
     entityId: string;
     entityType: import("./firestore").ReportEntityType;
-    detail: string;
     reason: import("./firestore").ReportReason;
+    detail: string;
     evidenceUrls?: string[] | undefined;
 }>;
 export type ReportCreateValues = z.infer<typeof reportCreateSchema>;

package/dist/features/store-extensions/schemas/shipping-config-form.d.ts

@@ -133,8 +133,8 @@ export declare const shippingConfigUpdateSchema: z.ZodObject<{
     label?: string | undefined;
     isActive?: boolean | undefined;
     isDefault?: boolean | undefined;
-    method?: ShippingMethod | undefined;
     estimatedDays?: number | undefined;
+    method?: ShippingMethod | undefined;
     flatRate?: number | undefined;
     pricePerKg?: number | undefined;
     freeAbove?: number | undefined;
@@ -144,8 +144,8 @@ export declare const shippingConfigUpdateSchema: z.ZodObject<{
     label?: string | undefined;
     isActive?: boolean | undefined;
     isDefault?: boolean | undefined;
-    method?: ShippingMethod | undefined;
     estimatedDays?: number | undefined;
+    method?: ShippingMethod | undefined;
     flatRate?: number | undefined;
     pricePerKg?: number | undefined;
     freeAbove?: number | undefined;

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

@@ -2,6 +2,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ArrowLeft } from "lucide-react";
 import { Accordion, Alert, Code, Div, Heading, Li, Ol, Row, Section, Span, Stack, Table, Tbody, Td, Text, TextLink, Th, Thead, Tr, Ul } from "../../../ui/index.js";
 import { ROUTES } from "../../../next/routing/route-map.js";
+import { resolvePublishedValues } from "../../../_internal/shared/content/published-values.js";
+/* Phase 9 — one definition of the refund timeline. */
+const { refundBusinessDaysMin: REFUND_DAYS_MIN, refundBusinessDaysMax: REFUND_DAYS_MAX } = resolvePublishedValues();
 const SUBHEADING = "mb-1 font-semibold text-[var(--appkit-color-text)]";
 const LIST_DISC = "list-disc leading-relaxed";
 const SECTION_BODY = "space-y-4 text-[length:var(--appkit-text-sm)] text-[var(--appkit-color-text-muted)]";
@@ -41,7 +44,9 @@ const STATUS_ROWS = [
     {
         status: "CANCELLED",
         meaning: "Order was cancelled before shipping (by buyer or seller).",
-        action: "Refund is automatic via Razorpay (3–7 business days).",
+        // Phase 9 — one definition, and no gateway name. See the identical note in
+        // AdminOrdersGuideView.
+        action: `Refund is automatic (${REFUND_DAYS_MIN}–${REFUND_DAYS_MAX} business days).`,
     },
     {
         status: "RETURN_REQUESTED",

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

@@ -233,6 +233,77 @@ export interface StoreDocument extends BaseDocument {
      */
     supportsShippingProtection?: boolean;
     supportsSaleProtection?: boolean;
+    /**
+     * This store accepts buyer points as part-payment.
+     *
+     * ## 🛑 OPT-IN, because the accepting store ABSORBS the redemption
+     *
+     * Decision 3: a redeemed point reduces THAT store's payout for THAT order.
+     * Earning is mandatory (it costs the seller nothing at issue time); accepting
+     * is optional, because accepting is where the money actually moves. So this
+     * follows `supportsSaleProtection` above exactly — **absent means NOT
+     * accepted, never "unknown"** — and for the identical reason: defaulting it
+     * `true` would enrol every existing seller in funding discounts they never
+     * agreed to, and retrofitting consent later means switching a working feature
+     * off for them.
+     *
+     * 🛑 Live currently has ONE store, so this flag is inert today. It is still
+     * built now rather than later: the day a second seller exists, enabling
+     * redemption for them without asking is taking their money, and the cost of
+     * the field today is one boolean and one check.
+     *
+     * `store-letitrip-official` is always treated as accepting — the platform's
+     * own storefront cannot decline to fund its own programme. That is resolved
+     * in code rather than seeded, so it cannot be switched off by an edit.
+     */
+    acceptsPoints?: boolean;
+    /**
+     * ── S5a: this store allows a SHARED PURCHASE (one payer, N destinations) ──
+     *
+     * The coordinator buys everything and assigns a destination per item, so the
+     * seller packs one order into several parcels. That is real extra work —
+     * picking, packing and labelling N shipments instead of one — which is why
+     * it is an opt-in with its own fees rather than a free platform behaviour.
+     *
+     * 🛑 **Absent means NOT allowed**, matching `supportsSaleProtection` and
+     * `acceptsPoints` above, and for the same reason: the cost falls on the
+     * seller, so enrolling them without asking is taking their labour. Every
+     * existing store therefore starts with it off, which is the correct state
+     * rather than a migration problem.
+     *
+     * 🛑 This is S5a ONLY — one payer. It is NOT the N-party flow (S5b), which
+     * needs multi-party payment, a coordinator deposit, an approval cascade, a
+     * stock-reservation primitive that does not exist, and per-buyer invoicing
+     * and GST. A seller enabling this is agreeing to split one paid order across
+     * destinations, not to be paid by several people.
+     */
+    allowSharedPurchase?: boolean;
+    /**
+     * Flat fee per shared-purchase arrangement, in decimal rupees.
+     *
+     * Covers picking, packing and labelling one order into N parcels. Borne by
+     * the COORDINATOR — they chose the arrangement — which keeps each
+     * destination's own cost to goods plus that destination's shipping.
+     *
+     * 🛑 SNAPSHOTTED onto the order at checkout, never re-read later. The
+     * precedent is exact: the refund path reads `finalSale` from the ORDER
+     * snapshot rather than the live product, because "re-reading the live
+     * product would let a seller flip the switch afterwards" (D61). A fee read
+     * late is the same hole.
+     */
+    sharedPurchaseHandlingFee?: number;
+    /**
+     * Extra shipping per destination BEYOND THE FIRST, in decimal rupees.
+     *
+     * The first destination is the shipping the order would have paid anyway;
+     * this is the marginal cost of each additional parcel. Borne by the buyer at
+     * that destination in the full N-party flow — in S5a there is one payer, so
+     * the coordinator pays all of it, which is correct because they are the
+     * person who asked for the extra legs.
+     *
+     * Snapshotted with the handling fee, for the same reason.
+     */
+    sharedPurchaseExtraShippingPerDestination?: number;
     /**
      * ── C5g: ADMIN-GRANTED trust. Routes even a protected claim to the seller ──
      *

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

@@ -24,6 +24,25 @@ export interface StoreListItem {
      */
     supportsShippingProtection: boolean;
     supportsSaleProtection: boolean;
+    /**
+     * S5a — this seller will split one paid order across several destinations.
+     *
+     * Not optional, for the same reason as the two above: the projection
+     * resolves absence to `false`, so the client never decides what `undefined`
+     * means.
+     */
+    allowSharedPurchase: boolean;
+    /**
+     * The two shared-purchase fees, in decimal rupees.
+     *
+     * 🛑 OPTIONAL here where `allowSharedPurchase` is not, and the asymmetry is
+     * the point: a flag's absence means "no", but a fee's absence means "not
+     * configured" — which is not ₹0. A client that defaulted these to zero would
+     * quote a free arrangement from a store that has simply not priced one, and
+     * the coordinator commits against that quote.
+     */
+    sharedPurchaseHandlingFee?: number;
+    sharedPurchaseExtraShippingPerDestination?: number;
     createdAt?: string;
 }
 export interface StoreDetail extends StoreListItem {

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

@@ -175,11 +175,11 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
         attachments?: string[] | undefined;
     }[];
     orderId?: string | undefined;
-    assignedTo?: string | undefined;
-    resolvedAt?: string | Date | z.objectOutputType<{
+    closedAt?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    closedAt?: string | Date | z.objectOutputType<{
+    assignedTo?: string | undefined;
+    resolvedAt?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
     assignedToName?: string | undefined;
@@ -218,11 +218,11 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
         attachments?: string[] | undefined;
     }[];
     orderId?: string | undefined;
-    assignedTo?: string | undefined;
-    resolvedAt?: string | Date | z.objectInputType<{
+    closedAt?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    closedAt?: string | Date | z.objectInputType<{
+    assignedTo?: string | undefined;
+    resolvedAt?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
     assignedToName?: string | undefined;

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

@@ -1,7 +1,8 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
-import { Button, Card, Details, Div, Row, Stack, Summary, Text } from "../../../ui/index.js";
+import { Button, Card, Details, Div, Row, Stack, Summary, Text, TextLink } from "../../../ui/index.js";
+import { ROUTES } from "../../../next/routing/route-map.js";
 import { MediaImage } from "../../media/MediaImage.js";
 import { apiClient } from "../../../http/index.js";
 import { useApiMutation } from "../../../client/api/useApiMutation.js";
@@ -50,6 +51,6 @@ export function AdminTesterFeedbackIssuesView() {
     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.bugConfirmed ? (_jsxs(Row, { gap: "sm", align: "center", wrap: true, children: [_jsxs(Text, { size: "sm", weight: "semibold", color: "success", children: ["\uD83D\uDC1B Confirmed \u2014 credited to ", issue.bugHunterName ?? "unknown tester"] }), !issue.supersededByItemId && (_jsx(Button, { size: "sm", action: ACTIONS.ADMIN["reopen-checklist-item"], isLoading: reopenMutation.isPending, onClick: () => reopenMutation.mutate(issue.checklistItemId) }))] })) : (_jsx(Div, { children: _jsx(Button, { size: "sm", action: ACTIONS.ADMIN["confirm-bug"], isLoading: confirmBugMutation.isPending, onClick: () => confirmBugMutation.mutate(issue.id) }) }))] }) }, issue.id))) }) })] }, 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(TextLink, { href: String(ROUTES.ADMIN.TESTER_CHECKLIST_EDIT(issue.checklistItemId)), 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.bugConfirmed ? (_jsxs(Row, { gap: "sm", align: "center", wrap: true, children: [_jsxs(Text, { size: "sm", weight: "semibold", color: "success", children: ["\uD83D\uDC1B Confirmed \u2014 credited to ", issue.bugHunterName ?? "unknown tester"] }), !issue.supersededByItemId && (_jsx(Button, { size: "sm", action: ACTIONS.ADMIN["reopen-checklist-item"], isLoading: reopenMutation.isPending, onClick: () => reopenMutation.mutate(issue.checklistItemId) }))] })) : (_jsx(Div, { children: _jsx(Button, { size: "sm", action: ACTIONS.ADMIN["confirm-bug"], isLoading: confirmBugMutation.isPending, onClick: () => confirmBugMutation.mutate(issue.id) }) }))] }) }, issue.id))) }) })] }, phase));
         }) }));
 }

package/dist/features/wishlist/hooks/useWishlistWithGuest.d.ts

@@ -29,7 +29,7 @@ export declare function useWishlistWithGuest(userId: string | null | undefined,
         productPrice: number;
         productSlug: string;
         addedAt: string | undefined;
-        type: "category" | "store" | "classified" | "auction" | "digital-code" | "live" | "product" | "preorder";
+        type: "category" | "store" | "classified" | "auction" | "digital-code" | "live" | "preorder" | "product";
     }[];
     total: number;
     wishlistedIds: Set<string>;

package/dist/index.d.ts

@@ -52,6 +52,10 @@ export type { FieldSelectProps } from "./ui/index";
 export { FieldSelect } from "./ui/index";
 export type { FieldCheckboxProps } from "./ui/index";
 export { FieldCheckbox } from "./ui/index";
+export type { FieldTextareaProps } from "./ui/index";
+export { FieldTextarea } from "./ui/index";
+export type { FormErrorSummaryProps } from "./ui/index";
+export { FormErrorSummary } from "./ui/index";
 export { GRID_MAP } from "./ui/index";
 export { ImageGallery } from "./ui/index";
 export { ImageLightbox } from "./ui/index";
@@ -1958,6 +1962,8 @@ export type { OrderSiblingPaymentsProps } from "./features/orders/index";
 export { OrderPaymentSummary } from "./features/orders/index";
 export type { OrderPaymentSummaryProps } from "./features/orders/index";
 export { OrderStatusTimeline } from "./features/orders/index";
+export { OrderProvenanceCard } from "./features/orders/index";
+export type { OrderProvenanceCardProps } from "./features/orders/index";
 export { OrderCompletionPanel } from "./features/orders/index";
 export { StatusTimeline, stepsFromEntries } from "./features/status-history/index";
 export type { StatusTimelineProps, TimelineEntry, TimelineStep } from "./features/status-history/index";
@@ -1996,6 +2002,7 @@ export type { OrderAdminUpdateInput } from "./features/orders/index";
 export type { AppliedOrderDiscount } from "./features/orders/index";
 export type { OrderCreateInput } from "./features/orders/index";
 export type { OrderDocument } from "./features/orders/index";
+export type { OrderSourceContext } from "./features/orders/index";
 export type { OrderRefundEvent, RefundType } from "./features/orders/schemas/firestore";
 export { MANUAL_PAYMENT_METHODS, isManualPaymentMethod, PAYMENT_REVIEW_QUEUE_MODES, isPaymentReviewQueueMode, PAYMENT_REVIEW_QUEUE_SCAN_LIMIT, } from "./features/orders/constants/payment-window";
 export type { PaymentReviewQueueMode } from "./features/orders/constants/payment-window";
@@ -2186,7 +2193,7 @@ export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type Actio
 export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, type ActionDef, type ActionKind, type ActionResource, type ActionTree, type ActionConfirmation, } from "./_internal/shared/actions/action-registry";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers";
-export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
+export { computeCheckoutFees, allocateCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
 export { searchPriceIndex, PRICE_INDEX_SEARCH_LIMIT, PRICE_INDEX_MIN_QUERY_LENGTH } from "./_internal/server/features/price-index/search";
 export type { PriceIndexSearchResponse, PriceIndexSearchResult, PriceIndexSearchResultBand, } from "./_internal/server/features/price-index/search";
 export { protectionAvailability, computeProtectionFees, adjudicateClaim, badgesFor, showsRiskNotice, showsSafetyBadge, returnDestination, rtoDestination, PROTECTION_KINDS, } from "./_internal/shared/features/shipping/protections";
@@ -2848,6 +2855,8 @@ export { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "./_internal/shared/features/
 export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
 export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons";
 export type { ReturnReason } from "./_internal/shared/features/orders/return-reasons";
+export { DISPUTE_KIND, DISPUTE_KIND_LABEL, DISPUTE_GATE, DISPUTE_TRANSIT_WINDOW_DAYS, DISPUTE_NOT_REACHED_GRACE_DAYS, isDisputeKind, checkDisputeGate, resolveDisputeEtd, disputeNotReachedFilableFrom, } from "./_internal/shared/features/orders/dispute-reasons";
+export type { DisputeKind, DisputeGateOrder, DisputeGateResult, } from "./_internal/shared/features/orders/dispute-reasons";
 export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, type BundleCreateBody, type BundleUpdateBody, } from "./_internal/shared/features/categories/bundle-schemas";
 export type { GroupedListingDocument, GroupTheme, GroupVisibility } from "./features/grouped/schemas/firestore";
 export { navItemFormSchema, navItemCreateSchema, navItemUpdateSchema, type NavItemFormValues, } from "./features/admin/schemas/nav-item-form";
@@ -2940,7 +2949,7 @@ export type { OwnerQuickActionsProps, OwnerQuickActionsResource } from "./featur
 export type { ListingTypePlugin } from "./_internal/shared/listing-types/_registry";
 export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules";
 export type { ListingCheckoutRule, CategoryCheckoutRule, CartItemProductPair, OrderItemInput, RefundPolicy, } from "./_internal/shared/checkout/rules";
-export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, IMAGE_ACCEPT_ATTR, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, PRODUCT_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "./_internal/shared/media/limits";
+export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, IMAGE_ACCEPT_ATTR, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, PRODUCT_MAX_IMAGES, REVIEW_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "./_internal/shared/media/limits";
 export type { MediaKind, AllowedImageMime, AllowedVideoMime, AllowedDocMime, AllowedMime, } from "./_internal/shared/media/limits";
 export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, AD_TRACKED_FIELDS, BLOG_FIELDS, BRAND_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, COUPON_USAGE_FIELDS, CAROUSEL_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
 export { SORT_DIR, sortBy } from "./constants/sort";

package/dist/index.js

@@ -138,6 +138,8 @@ export { FormGroup } from "./ui/index.js";
 export { FieldInput } from "./ui/index.js";
 export { FieldSelect } from "./ui/index.js";
 export { FieldCheckbox } from "./ui/index.js";
+export { FieldTextarea } from "./ui/index.js";
+export { FormErrorSummary } from "./ui/index.js";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // GRID_MAP - Constant used across modules.
 export { GRID_MAP } from "./ui/index.js";
@@ -3689,6 +3691,9 @@ export { OrdersList } from "./features/orders/index.js";
 export { OrderSiblingPayments } from "./features/orders/index.js";
 export { OrderPaymentSummary } from "./features/orders/index.js";
 export { OrderStatusTimeline } from "./features/orders/index.js";
+// OrderProvenanceCard — renders sourceContext, the record of HOW the buyer
+// earned this price. Mounted on the buyer, seller AND admin order detail.
+export { OrderProvenanceCard } from "./features/orders/index.js";
 // OrderCompletionPanel - Per-line ratings + Mark complete, the buyer's fast path.
 export { OrderCompletionPanel } from "./features/orders/index.js";
 // [CLIENT] StatusTimeline — the ONE rail both orders and offers render.
@@ -4073,7 +4078,14 @@ export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_int
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, } from "./_internal/shared/actions/action-registry.js";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers.js";
 // Shared fee calculator — platform/gateway/GST/COD handling/addon fee math (pure, client-safe).
-export { computeCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator.js";
+export { computeCheckoutFees, 
+// The per-group split of the ONE capped commission. Exported for the capture
+// route's points tender: the tender is applied per order group against the
+// same base the order path uses, and that base includes this share. Without
+// it the route would have to re-derive the apportionment — and the allocator
+// also carries the `minimumTransactionFee` floor (D41), which already spent
+// a release being re-implemented by hand in that very file.
+allocateCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator.js";
 // C5e buyer protections — the pure three-tier gate plus the one fee pair
 // every money path must agree on. Public API because the capture route
 // (/api/payment/create-order) is one of the three sites that must agree.
@@ -5119,6 +5131,9 @@ export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy.js";
 // See the module docstring for why the exempt set is "seller or carrier fault"
 // rather than "serious reasons".
 export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons.js";
+// Dispute KINDS and their gates. `_internal/*` is not a subpath export, so a
+// consumer route reaches these only through a barrel.
+export { DISPUTE_KIND, DISPUTE_KIND_LABEL, DISPUTE_GATE, DISPUTE_TRANSIT_WINDOW_DAYS, DISPUTE_NOT_REACHED_GRACE_DAYS, isDisputeKind, checkDisputeGate, resolveDisputeEtd, disputeNotReachedFilableFrom, } from "./_internal/shared/features/orders/dispute-reasons.js";
 // S-SBUNI-4 follow-up â€" shared admin bundle zod schemas.
 export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, } from "./_internal/shared/features/categories/bundle-schemas.js";
 export { navItemFormSchema, navItemCreateSchema, navItemUpdateSchema, } from "./features/admin/schemas/nav-item-form.js";
@@ -5249,7 +5264,7 @@ export { RecordOwnerQuickActions } from "./features/admin/components/RecordOwner
 // Checkout rule registry â€" pure TS, safe in both client and server bundles.
 export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules/index.js";
 // Media upload limits â€" pure constants, safe in both client and server bundles.
-export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, IMAGE_ACCEPT_ATTR, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, PRODUCT_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "./_internal/shared/media/limits.js";
+export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, IMAGE_ACCEPT_ATTR, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, PRODUCT_MAX_IMAGES, REVIEW_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "./_internal/shared/media/limits.js";
 // ── Field name constants — canonical source of truth for all Firestore field names ──
 // NOTE: STORE_FIELDS, CATEGORY_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS,
 // COUPON_FIELDS, CART_FIELDS, USER_FIELDS, ADDRESS_FIELDS, NOTIFICATION_FIELDS,