@mohasinac/appkit 4.60.1 → 4.62.0

package/dist/features/shell/SectionForm.js

@@ -325,6 +325,25 @@ export function SectionForm({ sections, values, onChange, onSubmit, submitLabel
         }
         void onSubmit();
     }, [shellCtx, onSubmit, erroringSectionIds, fieldErrors, openIds, setOpenIds, expandMode]);
+    /**
+     * Open a section if it is closed, then scroll to it.
+     *
+     * Named rather than inlined in the rail's `onClick`: inline it sat five
+     * braces deep inside the JSX, and it is the same open-then-scroll the
+     * submit handler above performs for the first erroring section — so the
+     * two now read as the same operation rather than two similar ones.
+     *
+     * 🛑 Opening is CONDITIONAL on purpose. In `single` mode an unconditional
+     * `setOpenIds([id])` would COLLAPSE the section you are already in when you
+     * click its own rail entry, so the rail would read as having closed the
+     * form.
+     */
+    const openAndScrollTo = useCallback((id) => {
+        if (!openIds.includes(id)) {
+            setOpenIds(expandMode === "single" ? [id] : [...openIds, id]);
+        }
+        scrollToSection(id);
+    }, [openIds, setOpenIds, expandMode]);
     useFormBottomActions({
         onSubmit: handleSubmit,
         onCancel,
@@ -408,21 +427,28 @@ export function SectionForm({ sections, values, onChange, onSubmit, submitLabel
      * comment syntax does not parse. That is the fourth time today; the rule is
      * simply that JSX comments belong in CHILDREN position and nowhere else.
      */
-    const rail = showRail ? (_jsx(Div, { overflow: "auto", className: "hidden lg:block w-56 flex-shrink-0 sticky self-start top-[calc(var(--header-height,3.5rem)+1rem)] max-h-[calc(100vh-var(--header-height,3.5rem)-2rem)]", children: _jsx(Nav, { "aria-label": "Form sections", children: _jsx(Stack, { gap: "px", children: ordered.map((section) => {
+    const rail = showRail ? (_jsx(Div, { overflow: "auto", 
+        /*
+         * <StickyToolbar> is a horizontal translucent bar: it ships `border-b`, a
+         * z-10 layer and the dismiss/re-expand CollapseStrip, and offers no
+         * `self-start`, `max-h` or overflow scrolling. Using it here would paint
+         * a bottom border under a 14rem sidebar and give it a horizontal bar's
+         * collapse affordance.
+         *
+         * 🛑 The marker below must stay on the line DIRECTLY above the className.
+         * Every one of these audits reads `lines[i - 1]` and nothing further, so
+         * a tidy explanation with the marker on its first line suppresses
+         * nothing while looking suppressed to a human (CLAUDE.md § Rule #5).
+         */
+        // audit-raw-sticky-toolbar-ok: a vertical RAIL, not a toolbar — see above.
+        className: "hidden lg:block w-56 flex-shrink-0 sticky self-start top-[calc(var(--header-height,3.5rem)+1rem)] max-h-[calc(100vh-var(--header-height,3.5rem)-2rem)]", children: _jsx(Nav, { "aria-label": "Form sections", children: _jsx(Stack, { gap: "px", children: ordered.map((section) => {
                     const errorCount = errorCountFor(section);
                     const isOpen = section.required === true ||
                         openIds.includes(section.id) ||
                         forceOpenIds.includes(section.id);
                     return (_jsxs(Button, { type: "button", 
                         /* `ghost`, not `bare` — UI_BUTTON has no `bare` variant. */
-                        variant: "ghost", size: "sm", justify: "between", gap: "sm", className: `w-full text-left ${isOpen ? "appkit-section-rail__item--active" : ""}`, "aria-current": isOpen ? "true" : undefined, onClick: () => {
-                            if (!openIds.includes(section.id)) {
-                                setOpenIds(expandMode === "single"
-                                    ? [section.id]
-                                    : [...openIds, section.id]);
-                            }
-                            scrollToSection(section.id);
-                        }, children: [_jsx(Span, { size: "sm", color: isOpen ? "primary" : "muted", children: section.label }), errorCount > 0 && (_jsx(Span, { size: "xs", color: "error", weight: "semibold", children: errorCount }))] }, section.id));
+                        variant: "ghost", size: "sm", justify: "between", gap: "sm", className: `w-full text-left ${isOpen ? "appkit-section-rail__item--active" : ""}`, "aria-current": isOpen ? "true" : undefined, onClick: () => openAndScrollTo(section.id), children: [_jsx(Span, { size: "sm", color: isOpen ? "primary" : "muted", children: section.label }), submitAttempted && errorCount > 0 && (_jsx(Span, { size: "xs", color: "error", weight: "semibold", children: errorCount }))] }, section.id));
                 }) }) }) })) : null;
     const panels = (_jsxs(Stack, { gap: "md", children: [ordered.map((section) => {
                 const isRequired = section.required === true;

package/dist/features/shell/build-sections.js

@@ -288,7 +288,20 @@ function renderField(field, ctx, opts) {
              * case that most needs searching.
              */
             if (options.length > PAGINATED_SELECT_THRESHOLD) {
-                return (_jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { size: "sm", weight: "medium", color: "muted", children: [label, required ? " *" : ""] }), _jsx(PaginatedSelect, { value: typeof value === "string" ? value : null, onChange: (v) => set(v ?? ""), options: options, ariaLabel: label, placeholder: `Select ${label.toLowerCase()}…` }), meta.help && _jsx(Text, { size: "xs", color: "muted", children: meta.help }), ctx.errors[name] && (_jsx(Text, { size: "xs", color: "error", role: "alert", children: ctx.errors[name] }))] }, name));
+                /*
+                 * 🛑 The error block here used to be hand-rolled, and was the only
+                 * field in this generator whose error was not wired like the rest:
+                 * a `<Text>` with no `id`, nothing pointing `aria-describedby` at it,
+                 * no `aria-invalid` on the control, and — unlike every `Field*`
+                 * branch below — the help text was still rendered underneath the
+                 * error rather than replaced by it.
+                 *
+                 * `PaginatedSelect` now takes `name`/`error` and owns all of that,
+                 * so hand it the error and delete the copy. This is the one branch
+                 * that every schema-generated form shares, so the fix lands on all
+                 * of them at once rather than per call site.
+                 */
+                return (_jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { size: "sm", weight: "medium", color: "muted", children: [label, required ? " *" : ""] }), _jsx(PaginatedSelect, { name: name, error: ctx.errors[name], value: typeof value === "string" ? value : null, onChange: (v) => set(v ?? ""), options: options, ariaLabel: label, placeholder: `Select ${label.toLowerCase()}…` }), meta.help && !ctx.errors[name] && (_jsx(Text, { size: "xs", color: "muted", children: meta.help }))] }, name));
             }
             return (_jsx(FieldSelect, { name: name, label: label, hint: meta.help, required: required, value: typeof value === "string" ? value : "", options: options, onChange: set }, name));
         }

package/dist/features/shipments/components/AdminShipmentLotItemsView.js

@@ -1,6 +1,7 @@
 "use client";
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import React from "react";
+import { z } from "zod";
 import { useApiMutation } from "@mohasinac/appkit/client";
 import { Alert, Badge, Button, Div, Heading, Modal, Pagination, Skeleton, Stack, Table, Thead, Tbody, Tr, Th, Td, Text, Textarea, } from "../../../ui/index.js";
 import { apiClient } from "../../../http/index.js";
@@ -11,6 +12,7 @@ import { applyZodIssues } from "../../../ui/forms/apply-zod-issues.js";
 import { ValidationError } from "../../../errors/validation-error.js";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry.js";
+import { QuickEditMenu } from "../../admin/components/QuickEditMenu.js";
 import { useShipmentItems } from "../hooks/useShipments.js";
 import { ShipmentItemLinkModal } from "./ShipmentItemLinkModal.js";
 import { formatCurrency } from "../../../utils/number.formatter.js";
@@ -32,6 +34,30 @@ function parseBulkText(text) {
     })
         .filter((row) => row.title.length > 0);
 }
+/**
+ * The three fields a lot item can be corrected on after import.
+ *
+ * Deliberately NOT the whole of `shipmentItemBaseSchema`: `isForSelfUse`
+ * decides whether `price` is required at all and flipping it from a
+ * three-field drawer would silently change what the row means to the
+ * projections, and `categorySlugs`/`brandSlug` belong to the link flow that
+ * already owns them.
+ */
+const shipmentItemQuickEditSchema = z.object({
+    title: z.string().trim().min(1, "Item title is required"),
+    quantity: z.coerce.number().int().min(1, "Quantity must be at least 1."),
+    price: z.coerce.number().min(0, "Price cannot be negative."),
+});
+const SHIPMENT_ITEM_QUICK_FIELDS = [
+    { name: "title", label: "Title", type: "text", required: true },
+    { name: "quantity", label: "Quantity", type: "number", required: true },
+    {
+        name: "price",
+        label: "Projected sale price",
+        type: "number",
+        helperText: "Feeds this lot's projected revenue, and every profit figure on the projections screen.",
+    },
+];
 export function AdminShipmentLotItemsView({ shipmentId, lotId }) {
     const [page, setPage] = React.useState(1);
     const [pageSize, setPageSize] = React.useState(50);
@@ -113,6 +139,19 @@ export function AdminShipmentLotItemsView({ shipmentId, lotId }) {
         mutationFn: (itemId) => apiClient.delete(ADMIN_ENDPOINTS.SHIPMENT_LOT_ITEM_BY_ID(shipmentId, lotId, itemId)),
         onSuccess: () => refetch(),
     });
+    const editItemMutation = useApiMutation({
+        successMessage: "Item updated",
+        errorMessage: "Could not update that item.",
+        mutationFn: ({ itemId, values }) => {
+            const parsed = shipmentItemQuickEditSchema.parse(values);
+            return apiClient.patch(ADMIN_ENDPOINTS.SHIPMENT_LOT_ITEM_BY_ID(shipmentId, lotId, itemId), parsed);
+        },
+        onSuccess: () => refetch(),
+    });
+    /** Named so the row-action array stays a flat list of declarations. */
+    const saveItemEdit = React.useCallback(async (itemId, values) => {
+        await editItemMutation.mutateAsync({ itemId, values });
+    }, [editItemMutation]);
     const unlinkItemMutation = useApiMutation({
         successMessage: "Item unlinked",
         mutationFn: (itemId) => apiClient.patch(ADMIN_ENDPOINTS.SHIPMENT_LOT_ITEM_BY_ID(shipmentId, lotId, itemId), {
@@ -134,7 +173,21 @@ export function AdminShipmentLotItemsView({ shipmentId, lotId }) {
                                 return;
                             }
                             addItemMutation.mutate();
-                        }, onValidationChange: () => itemForm.validate(itemDraft), schema: shipmentItemFormSchema, openIds: itemNav.openIds, onOpenChange: itemNav.setOpenIds, submitLabel: "Save Item", cancelLabel: "Cancel", onCancel: () => setShowAddItem(false), isLoading: addItemMutation.isPending })] })), isLoading ? (_jsxs(Stack, { gap: "sm", children: [_jsx(Skeleton, { variant: "rectangular", height: "32px" }), _jsx(Skeleton, { variant: "rectangular", height: "32px" })] })) : items.length === 0 ? (_jsx(Text, { variant: "secondary", children: "No items tracked yet." })) : (_jsxs(Table, { children: [_jsx(Thead, { children: _jsxs(Tr, { children: [_jsx(Th, { children: "Title" }), _jsx(Th, { children: "Qty" }), _jsx(Th, { children: "Price" }), _jsx(Th, { children: "Status" }), _jsx(Th, {})] }) }), _jsx(Tbody, { children: items.map((item) => (_jsxs(Tr, { children: [_jsx(Td, { children: item.title }), _jsx(Td, { children: item.quantity }), _jsx(Td, { children: item.isForSelfUse ? "—" : formatCurrency(item.price ?? 0) }), _jsx(Td, { children: item.isForSelfUse ? (_jsx(Badge, { variant: "secondary", children: "Self use" })) : item.linkedProductId ? (_jsx(Badge, { variant: "success", children: "Linked" })) : (_jsx(Badge, { variant: "default", children: "Unlinked" })) }), _jsxs(Td, { className: "flex gap-[var(--appkit-space-2)]", children: [!item.isForSelfUse &&
+                        }, onValidationChange: () => itemForm.validate(itemDraft), schema: shipmentItemFormSchema, openIds: itemNav.openIds, onOpenChange: itemNav.setOpenIds, submitLabel: "Save Item", cancelLabel: "Cancel", onCancel: () => setShowAddItem(false), isLoading: addItemMutation.isPending })] })), isLoading ? (_jsxs(Stack, { gap: "sm", children: [_jsx(Skeleton, { variant: "rectangular", height: "32px" }), _jsx(Skeleton, { variant: "rectangular", height: "32px" })] })) : items.length === 0 ? (_jsx(Text, { variant: "secondary", children: "No items tracked yet." })) : (_jsxs(Table, { children: [_jsx(Thead, { children: _jsxs(Tr, { children: [_jsx(Th, { children: "Title" }), _jsx(Th, { children: "Qty" }), _jsx(Th, { children: "Price" }), _jsx(Th, { children: "Status" }), _jsx(Th, {})] }) }), _jsx(Tbody, { children: items.map((item) => (_jsxs(Tr, { children: [_jsx(Td, { children: item.title }), _jsx(Td, { children: item.quantity }), _jsx(Td, { children: item.isForSelfUse ? "—" : formatCurrency(item.price ?? 0) }), _jsx(Td, { children: item.isForSelfUse ? (_jsx(Badge, { variant: "secondary", children: "Self use" })) : item.linkedProductId ? (_jsx(Badge, { variant: "success", children: "Linked" })) : (_jsx(Badge, { variant: "default", children: "Unlinked" })) }), _jsxs(Td, { className: "flex gap-[var(--appkit-space-2)]", children: [_jsx(QuickEditMenu, { actions: [
+                                                {
+                                                    label: "Edit item",
+                                                    formTitle: `Edit "${item.title}"`,
+                                                    schema: shipmentItemQuickEditSchema,
+                                                    fields: SHIPMENT_ITEM_QUICK_FIELDS,
+                                                    defaultValues: {
+                                                        title: item.title,
+                                                        quantity: item.quantity,
+                                                        price: item.price ?? 0,
+                                                    },
+                                                    onSubmit: (values) => saveItemEdit(item.id, values),
+                                                    submitLabel: "Save item",
+                                                },
+                                            ] }), !item.isForSelfUse &&
                                             (item.linkedProductId ? (_jsx(Button, { size: "sm", variant: "ghost", isLoading: unlinkItemMutation.isPending, onClick: () => unlinkItemMutation.mutate(item.id), children: "Unlink" })) : (_jsx(Button, { size: "sm", variant: "ghost", onClick: () => setLinkTarget({ itemId: item.id, title: item.title }), children: "Create pre-order link" }))), _jsx(Button, { size: "sm", variant: "ghost", action: ACTIONS.SHIPMENT["delete"], isLoading: deleteItemMutation.isPending, onClick: () => deleteItemMutation.mutate(item.id), children: "Delete" })] })] }, item.id))) })] })), meta && meta.totalPages > 1 && (_jsx(Pagination, { currentPage: page, totalPages: meta.totalPages, onPageChange: setPage, pageSize: pageSize, onPageSizeChange: (size) => {
                     setPageSize(size);
                     setPage(1);

package/dist/features/shipments/components/AdminShipmentProjectionsView.js

@@ -1,7 +1,8 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React from "react";
-import { Button, Div, Heading, Modal, Pagination, Select, Skeleton, Stack, Table, Thead, Tbody, Tr, Th, Td, Text } from "../../../ui/index.js";
+import { Button, Div, Heading, Modal, Pagination, Select, Skeleton, Stack, Table, Thead, Tbody, Tr, Th, Td, Text, TextLink } from "../../../ui/index.js";
+import { ROUTES } from "../../../next/routing/route-map.js";
 import { useShipmentProjections, useShipmentItems } from "../hooks/useShipments.js";
 import { ShipmentItemLinkModal } from "./ShipmentItemLinkModal.js";
 import { formatCurrency } from "../../../utils/number.formatter.js";
@@ -25,7 +26,7 @@ export function AdminShipmentProjectionsView() {
     const [sorts, setSorts] = React.useState(SORT_OPTIONS[0].value);
     const { lots, meta, isLoading, refetch } = useShipmentProjections({ page, pageSize, sorts });
     const [pickerLot, setPickerLot] = React.useState(null);
-    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { layout: "flex", align: "center", justify: "between", children: [_jsx(Heading, { level: 2, children: "Projections" }), _jsx(Select, { "aria-label": "Sort by", value: sorts, onValueChange: setSorts, options: SORT_OPTIONS })] }), isLoading ? (_jsxs(Stack, { gap: "sm", children: [_jsx(Skeleton, { variant: "rectangular", height: "32px" }), _jsx(Skeleton, { variant: "rectangular", height: "32px" }), _jsx(Skeleton, { variant: "rectangular", height: "32px" })] })) : lots.length === 0 ? (_jsx(Text, { variant: "secondary", children: "No lots to project yet." })) : (_jsxs(Table, { children: [_jsx(Thead, { children: _jsxs(Tr, { children: [_jsx(Th, { children: "Lot" }), _jsx(Th, { children: "Items" }), _jsx(Th, { children: "Landed Cost" }), _jsx(Th, { children: "Projected Revenue" }), _jsx(Th, { children: "Projected Profit" }), _jsx(Th, {})] }) }), _jsx(Tbody, { children: lots.map((lot) => (_jsxs(Tr, { children: [_jsx(Td, { children: lot.lotName }), _jsx(Td, { children: lot.itemCount }), _jsx(Td, { children: formatCurrency(lot.totalLandedCost) }), _jsx(Td, { children: formatCurrency(lot.projectedRevenue) }), _jsx(Td, { className: lot.projectedProfit < 0 ? "text-error" : "text-success", children: formatCurrency(lot.projectedProfit) }), _jsx(Td, { children: _jsx(Button, { size: "sm", variant: "ghost", onClick: () => setPickerLot(lot), children: "Create pre-order link" }) })] }, lot.id))) })] })), meta && meta.totalPages > 1 && (_jsx(Pagination, { currentPage: page, totalPages: meta.totalPages, onPageChange: setPage, pageSize: pageSize, onPageSizeChange: (size) => {
+    return (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { layout: "flex", align: "center", justify: "between", children: [_jsx(Heading, { level: 2, children: "Projections" }), _jsx(Select, { "aria-label": "Sort by", value: sorts, onValueChange: setSorts, options: SORT_OPTIONS })] }), isLoading ? (_jsxs(Stack, { gap: "sm", children: [_jsx(Skeleton, { variant: "rectangular", height: "32px" }), _jsx(Skeleton, { variant: "rectangular", height: "32px" }), _jsx(Skeleton, { variant: "rectangular", height: "32px" })] })) : lots.length === 0 ? (_jsx(Text, { variant: "secondary", children: "No lots to project yet." })) : (_jsxs(Table, { children: [_jsx(Thead, { children: _jsxs(Tr, { children: [_jsx(Th, { children: "Lot" }), _jsx(Th, { children: "Items" }), _jsx(Th, { children: "Landed Cost" }), _jsx(Th, { children: "Projected Revenue" }), _jsx(Th, { children: "Projected Profit" }), _jsx(Th, {})] }) }), _jsx(Tbody, { children: lots.map((lot) => (_jsxs(Tr, { children: [_jsx(Td, { children: _jsx(TextLink, { href: String(ROUTES.ADMIN.SHIPMENT_LOT_ITEMS(lot.shipmentId, lot.id)), children: lot.lotName }) }), _jsx(Td, { children: lot.itemCount }), _jsx(Td, { children: formatCurrency(lot.totalLandedCost) }), _jsx(Td, { children: formatCurrency(lot.projectedRevenue) }), _jsx(Td, { className: lot.projectedProfit < 0 ? "text-error" : "text-success", children: formatCurrency(lot.projectedProfit) }), _jsx(Td, { children: _jsx(Button, { size: "sm", variant: "ghost", onClick: () => setPickerLot(lot), children: "Create pre-order link" }) })] }, lot.id))) })] })), meta && meta.totalPages > 1 && (_jsx(Pagination, { currentPage: page, totalPages: meta.totalPages, onPageChange: setPage, pageSize: pageSize, onPageSizeChange: (size) => {
                     setPageSize(size);
                     setPage(1);
                 } })), pickerLot && (_jsx(LotItemPickerModal, { lot: pickerLot, onClose: () => setPickerLot(null), onLinked: refetch }))] }));

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/sticker-trace/server.d.ts

@@ -6,3 +6,5 @@ export { rasterisePartToBox } from "../../_internal/shared/features/sticker-trac
 export { buildCutFileBytes, buildCutFileForRun } from "../../_internal/server/features/sticker-trace/build-cut-file";
 export { collectMosaicInputs, type MosaicInputs, type MosaicPartInput, } from "../../_internal/server/features/sticker-trace/mosaic-inputs";
 export type { PrintPageSizeId } from "../../_internal/shared/features/sticker-trace/export/page-sizes";
+export type { DecodeOptions, ImageCodec, PreviewOptions, ProbeResult, } from "../../_internal/shared/features/sticker-trace/codec";
+export type { DecodedRaster, EncodedImage, Rect as StickerRect, } from "../../_internal/shared/features/sticker-trace/types";

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/http/api-handler.js

@@ -2,7 +2,10 @@ import { normalizeError } from "../errors/normalize.js";
 import { isAccountDisabled } from "../features/auth/role-predicates.js";
 import { createApiHandlerFactory } from "../next/api/apiHandler.js";
 import { applyRateLimit } from "../security/index.js";
-import { AuthenticationError, AuthorizationError, ERROR_MESSAGES, handleApiError, } from "../errors/index.js";
+import { AuthenticationError, AuthorizationError, ERROR_MESSAGES, } from "../errors/index.js";
+// Next-coupled, so it comes from the defining module — see errors/index.ts.
+// This file is an API-route handler, so `next/server` here is correct.
+import { handleApiError } from "../errors/error-handler.js";
 import { errorResponse } from "../next/api/api-response.js";
 import { serverLogger } from "../monitoring/index.js";
 import { getProviders } from "../contracts/index.js";

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";
@@ -321,9 +325,9 @@ export { ERROR_CODES, BID_ERROR_CODES, OFFER_ERROR_CODES } from "./errors/index"
 export { ERROR_MESSAGES } from "./errors/index";
 export { NotFoundError } from "./errors/index";
 export { ValidationError } from "./errors/index";
-export { handleApiError } from "./errors/index";
-export { isAppError } from "./errors/index";
-export { logError } from "./errors/index";
+export { handleApiError } from "./errors/error-handler";
+export { isAppError } from "./errors/error-handler";
+export { logError } from "./errors/error-handler";
 export type { ErrorCode } from "./errors/index";
 export { PaymentProviderUnreachableError } from "./errors/index";
 export { mapToHttpError, HTTP_ERROR_CODES } from "./errors/index";
@@ -2940,7 +2944,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";
@@ -552,13 +554,13 @@ export { NotFoundError } from "./errors/index.js";
 export { ValidationError } from "./errors/index.js";
 // [UTIL]-Pure utility â€" no framework or runtime dependency; safe to import from any environment.
 // handleApiError - Model for handle api error.
-export { handleApiError } from "./errors/index.js";
+export { handleApiError } from "./errors/error-handler.js";
 // [UTIL]-Pure utility â€" no framework or runtime dependency; safe to import from any environment.
 // isAppError - Model for is app error.
-export { isAppError } from "./errors/index.js";
+export { isAppError } from "./errors/error-handler.js";
 // [UTIL]-Pure utility â€" no framework or runtime dependency; safe to import from any environment.
 // logError - Helper for log error.
-export { logError } from "./errors/index.js";
+export { logError } from "./errors/error-handler.js";
 // [UTIL]-Pure utility — no framework or runtime dependency; safe to import from any environment.
 // PaymentProviderUnreachableError - Thrown when the payment gateway API exhausts retries.
 export { PaymentProviderUnreachableError } from "./errors/index.js";
@@ -5249,7 +5251,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,

package/dist/next/routing/route-map.d.ts

@@ -182,6 +182,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CLAIMED_COUPONS: "/user/coupons";
         /** Points balance + ledger. 1 point = ₹1, spendable at checkout. */
         readonly POINTS: "/user/points";
+        readonly SESSIONS: "/user/sessions";
+        readonly PAYMENT_METHODS: "/user/payment-methods";
         readonly BECOME_SELLER: "/user/become-seller";
         readonly CART: "/cart";
         readonly CHECKOUT: "/checkout";
@@ -299,7 +301,6 @@ export declare const DEFAULT_ROUTE_MAP: {
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
         readonly SHIPMENTS: "/admin/shipments";
-        readonly INVENTORY: "/admin/inventory";
         readonly INVENTORY_BOXES: "/admin/inventory/boxes";
         readonly INVENTORY_BOX_DETAIL: (id: string) => string;
         readonly INVENTORY_BOX_LABELS: "/admin/inventory/boxes/labels";
@@ -635,6 +636,8 @@ export declare const ROUTES: {
         readonly CLAIMED_COUPONS: "/user/coupons";
         /** Points balance + ledger. 1 point = ₹1, spendable at checkout. */
         readonly POINTS: "/user/points";
+        readonly SESSIONS: "/user/sessions";
+        readonly PAYMENT_METHODS: "/user/payment-methods";
         readonly BECOME_SELLER: "/user/become-seller";
         readonly CART: "/cart";
         readonly CHECKOUT: "/checkout";
@@ -752,7 +755,6 @@ export declare const ROUTES: {
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
         readonly SHIPMENTS: "/admin/shipments";
-        readonly INVENTORY: "/admin/inventory";
         readonly INVENTORY_BOXES: "/admin/inventory/boxes";
         readonly INVENTORY_BOX_DETAIL: (id: string) => string;
         readonly INVENTORY_BOX_LABELS: "/admin/inventory/boxes/labels";

package/dist/next/routing/route-map.js

@@ -302,6 +302,15 @@ export const DEFAULT_ROUTE_MAP = {
         CLAIMED_COUPONS: "/user/coupons",
         /** Points balance + ledger. 1 point = ₹1, spendable at checkout. */
         POINTS: "/user/points",
+        /*
+         * 🛑 Both of these had a COMPLETE API and no page. `GET /api/user/sessions`
+         * + `DELETE [id]`, and `GET/POST /api/user/payment-methods` + `DELETE
+         * [id]`, were all live with zero consumers — and `BuyerAccountGuideView`
+         * already told buyers to "view all devices signed in at My Account →
+         * Sessions", pointing at a security control that did not exist.
+         */
+        SESSIONS: "/user/sessions",
+        PAYMENT_METHODS: "/user/payment-methods",
         BECOME_SELLER: "/user/become-seller",
         CART: "/cart",
         CHECKOUT: "/checkout",
@@ -433,7 +442,16 @@ export const DEFAULT_ROUTE_MAP = {
     ADMIN: {
         DASHBOARD: "/admin/dashboard",
         SHIPMENTS: "/admin/shipments",
-        INVENTORY: "/admin/inventory",
+        /*
+         * 🛑 There is deliberately NO `INVENTORY: "/admin/inventory"` key.
+         *
+         * I added one and never built the page behind it, and nothing ever
+         * referenced it — `audit-dead-route-key` caught it. A ROUTES key is a
+         * promise, and the two real surfaces (`INVENTORY_BOXES`,
+         * `INVENTORY_MOVEMENTS`) each carry their own nav entry, so an index page
+         * would be a third place to list the same two links. Build it only when
+         * there is a third child worth grouping.
+         */
         INVENTORY_BOXES: "/admin/inventory/boxes",
         INVENTORY_BOX_DETAIL: (id) => `/admin/inventory/boxes/${id}`,
         /*