@mohasinac/appkit 4.61.0 → 4.62.0

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/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/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";
@@ -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";
@@ -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";
@@ -634,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";

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",

package/dist/schemas/registry.d.ts

@@ -2801,8 +2801,8 @@ export declare const SCHEMAS: {
                 }, import("zod").ZodTypeAny, "passthrough">>]>>;
             }, "strip", import("zod").ZodTypeAny, {
                 status: "paid" | "pending" | "overdue";
-                amount: number;
                 index: number;
+                amount: number;
                 dueDate: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -2816,8 +2816,8 @@ export declare const SCHEMAS: {
                 }, import("zod").ZodTypeAny, "passthrough"> | undefined;
             }, {
                 status: "paid" | "pending" | "overdue";
-                amount: number;
                 index: number;
+                amount: number;
                 dueDate: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -3080,8 +3080,8 @@ export declare const SCHEMAS: {
             emiSurchargeAmount?: number | undefined;
             emiInstallments?: {
                 status: "paid" | "pending" | "overdue";
-                amount: number;
                 index: number;
+                amount: number;
                 dueDate: string | Date | import("zod").objectOutputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;
@@ -3234,8 +3234,8 @@ export declare const SCHEMAS: {
             emiSurchargeAmount?: number | undefined;
             emiInstallments?: {
                 status: "paid" | "pending" | "overdue";
-                amount: number;
                 index: number;
+                amount: number;
                 dueDate: string | Date | import("zod").objectInputType<{
                     toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
                 }, import("zod").ZodTypeAny, "passthrough">;

package/dist/schemas/sieve.d.ts

@@ -23,12 +23,12 @@ export declare const sieveFilterClauseSchema: z.ZodObject<{
     value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">]>;
 }, "strip", z.ZodTypeAny, {
     value: string | number | boolean | (string | number | boolean)[] | null;
-    op: "==" | "!=" | "<" | "<=" | ">" | ">=" | "array-contains" | "in" | "not-in" | "array-contains-any";
     field: string;
+    op: "==" | "!=" | "<" | "<=" | ">" | ">=" | "array-contains" | "in" | "not-in" | "array-contains-any";
 }, {
     value: string | number | boolean | (string | number | boolean)[] | null;
-    op: "==" | "!=" | "<" | "<=" | ">" | ">=" | "array-contains" | "in" | "not-in" | "array-contains-any";
     field: string;
+    op: "==" | "!=" | "<" | "<=" | ">" | ">=" | "array-contains" | "in" | "not-in" | "array-contains-any";
 }>;
 export type SieveFilterClause = z.infer<typeof sieveFilterClauseSchema>;
 export type SieveWhereOp = z.infer<typeof sieveWhereOpSchema>;
@@ -36,8 +36,8 @@ export declare const sieveSortClauseSchema: z.ZodObject<{
     field: z.ZodString;
     direction: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
 }, "strip", z.ZodTypeAny, {
-    direction: "desc" | "asc";
     field: string;
+    direction: "desc" | "asc";
 }, {
     field: string;
     direction?: "desc" | "asc" | undefined;

package/dist/server.d.ts

@@ -502,7 +502,7 @@ export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_
 export type { ListingTypePlugin } from "./_internal/shared/listing-types/_registry";
 export { applyMediaContextGuards, CONTEXT_LIMITS, } from "./_internal/server/features/media/contextGuards";
 export type { GuardResult, GuardError, GuardSuccess } from "./_internal/server/features/media/contextGuards";
-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 { getServerPermissions, checkPermission, checkAnyPermission, makeAdminSectionLayout, } from "./_internal/server/features/auth/permissions";
 export type { ResolvedPermissions, AdminSectionLayoutOpts, } from "./_internal/server/features/auth/permissions";

package/dist/server.js

@@ -1435,7 +1435,7 @@ export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_
 // Media context guards — shared by /api/media/sign + legacy /api/media/upload.
 export { applyMediaContextGuards, CONTEXT_LIMITS, } from "./_internal/server/features/media/contextGuards.js";
 // Media upload limits — shared by /api/media/sign + /api/media/finalize + /api/media/upload.
-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";
 // ── RBAC server helpers ───────────────────────────────────────────────────────
 // getServerPermissions, checkPermission, makeAdminSectionLayout
 export { getServerPermissions, checkPermission, checkAnyPermission, makeAdminSectionLayout, } from "./_internal/server/features/auth/permissions.js";

package/dist/ui/components/Checkbox.js

@@ -19,13 +19,21 @@ export function Checkbox({ label, suffix, error, indeterminate = false, type = "
     const generatedId = React.useId();
     const inputId = id ?? generatedId;
     const inputRef = React.useRef(null);
+    /*
+     * A caller's own `aria-invalid` wins. `{...props}` is spread first, so
+     * re-specifying the attribute afterwards used to overwrite an incoming
+     * `"true"` with `undefined` — and `FieldCheckbox` sets it itself while
+     * withholding `error` (to avoid a double message). See the full writeup in
+     * `Input.tsx`; the same bug existed here.
+     */
+    const ariaInvalid = props["aria-invalid"] ?? (error ? "true" : undefined);
     React.useEffect(() => {
         if (inputRef.current) {
             inputRef.current.indeterminate = indeterminate;
         }
     }, [indeterminate]);
     if (bare) {
-        return (_jsx("input", { ...props, ref: inputRef, id: inputId, type: type, checked: checked, disabled: disabled, "aria-invalid": error ? "true" : undefined, className: className }));
+        return (_jsx("input", { ...props, ref: inputRef, id: inputId, type: type, checked: checked, disabled: disabled, "aria-invalid": ariaInvalid, className: className }));
     }
     // A checkbox with no label/suffix has no text to lay out beside the box, so
     // the default `width: 100%` on the root serves no purpose and actively harms
@@ -43,7 +51,7 @@ export function Checkbox({ label, suffix, error, indeterminate = false, type = "
                     disabled ? UI_CHECKBOX.labelDisabled : "",
                 ]
                     .filter(Boolean)
-                    .join(" "), children: [_jsxs("span", { className: UI_CHECKBOX.boxWrap, children: [_jsx("input", { ...props, ref: inputRef, id: inputId, type: type, checked: checked, disabled: disabled, "aria-invalid": error ? "true" : undefined, className: [
+                    .join(" "), children: [_jsxs("span", { className: UI_CHECKBOX.boxWrap, children: [_jsx("input", { ...props, ref: inputRef, id: inputId, type: type, checked: checked, disabled: disabled, "aria-invalid": ariaInvalid, className: [
                                     UI_CHECKBOX.input,
                                     error ? UI_CHECKBOX.inputError : "",
                                     className,

package/dist/ui/components/DateInput.js

@@ -5,7 +5,14 @@ import { Label, Span, Text } from "./Typography.js";
 export const DateInput = React.forwardRef(function DateInput({ label, error, helperText, value, onChange, disabled, required, id, className = "", ...props }, ref) {
     const generatedId = React.useId();
     const inputId = id ?? generatedId;
-    return (_jsxs("div", { className: "w-full", children: [label && (_jsx(Label, { htmlFor: inputId, required: required, className: "appkit-form-field__label mb-1.5", children: label })), _jsx("input", { ...props, ref: ref, id: inputId, type: "date", value: value, disabled: disabled, required: required, "aria-invalid": error ? "true" : undefined, onChange: (e) => onChange?.(e.target.value), className: ["appkit-input", error ? "appkit-input--error" : "", className].filter(Boolean).join(" ") }), error ? (_jsx(Text, { size: "sm", variant: "error", role: "alert", className: "mt-1.5", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", className: "mt-1.5", children: helperText })) : null] }));
+    /*
+     * A caller's own `aria-invalid` wins. `{...props}` is spread first, so
+     * re-specifying the attribute afterwards overwrites an incoming "true"
+     * with `undefined` — the defect that left every Field*-built form in the
+     * app with no aria-invalid at all. See the full writeup in `Input.tsx`.
+     */
+    const ariaInvalid = props["aria-invalid"] ?? (error ? "true" : undefined);
+    return (_jsxs("div", { className: "w-full", children: [label && (_jsx(Label, { htmlFor: inputId, required: required, className: "appkit-form-field__label mb-1.5", children: label })), _jsx("input", { ...props, ref: ref, id: inputId, type: "date", value: value, disabled: disabled, required: required, "aria-invalid": ariaInvalid, onChange: (e) => onChange?.(e.target.value), className: ["appkit-input", error ? "appkit-input--error" : "", className].filter(Boolean).join(" ") }), error ? (_jsx(Text, { size: "sm", variant: "error", role: "alert", className: "mt-1.5", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", className: "mt-1.5", children: helperText })) : null] }));
 });
 export function DateRangeInput({ label, startLabel = "From", endLabel = "To", startValue, endValue, onStartChange, onEndChange, error, helperText, disabled, required, startMin, startMax, endMin, endMax, }) {
     return (_jsxs("div", { className: "w-full", children: [label && (_jsx(Text, { size: "sm", className: "appkit-form-field__label mb-1.5 block font-medium", children: label })), _jsxs("div", { className: "flex items-end gap-2", children: [_jsx(DateInput, { label: startLabel, value: startValue, onChange: onStartChange, disabled: disabled, required: required, min: startMin, max: startMax ?? endValue }), _jsx(Span, { size: "sm", className: "mb-2.5 shrink-0 text-[var(--appkit-color-text-muted)]", children: "\u2013" }), _jsx(DateInput, { label: endLabel, value: endValue, onChange: onEndChange, disabled: disabled, min: endMin ?? startValue, max: endMax })] }), error ? (_jsx(Text, { size: "sm", variant: "error", role: "alert", className: "mt-1.5", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", className: "mt-1.5", children: helperText })) : null] }));

package/dist/ui/components/Input.js

@@ -13,6 +13,26 @@ export const Input = React.forwardRef(function Input({ label, error, helperText,
         : variant === "ghost"
             ? "border-transparent bg-transparent shadow-none"
             : "";
+    /*
+     * 🛑 A CALLER'S OWN `aria-invalid` MUST WIN — it did not, and that broke
+     * every form in the app.
+     *
+     * `{...props}` is spread FIRST on both `<input>` elements below, so
+     * re-specifying `aria-invalid={error ? "true" : undefined}` afterwards
+     * OVERWROTE an incoming `"true"` with `undefined` (JSX: later wins).
+     *
+     * That is not hypothetical. `FieldInput` sets `aria-invalid` itself and
+     * deliberately WITHHOLDS `error` from this component, so the message is not
+     * rendered twice — which means `error` here is `undefined` exactly when the
+     * field is invalid. Net effect: no `Field*`-built form ever emitted
+     * `aria-invalid`, and `SectionForm`'s jump-to-error
+     * (`querySelector("[aria-invalid='true']")?.focus()`) silently focused
+     * nothing, every time.
+     *
+     * Same precedence rule as `bareAriaLabel` below: fill the gap, never
+     * override an explicit choice.
+     */
+    const ariaInvalid = props["aria-invalid"] ?? (error ? "true" : undefined);
     const inputClassName = [
         "appkit-input",
         icon ? "pl-10" : "",
@@ -45,10 +65,10 @@ export const Input = React.forwardRef(function Input({ label, error, helperText,
          * overrides an explicit choice.
          */
         const bareAriaLabel = props["aria-label"] ?? (typeof label === "string" ? label : undefined);
-        return (_jsx("input", { ...props, ref: ref, id: inputId, disabled: disabled, "aria-label": bareAriaLabel, "aria-invalid": error ? "true" : undefined, className: inputClassName }));
+        return (_jsx("input", { ...props, ref: ref, id: inputId, disabled: disabled, "aria-label": bareAriaLabel, "aria-invalid": ariaInvalid, className: inputClassName }));
     }
     const adornment = rightIcon ??
         (success && !error ? (_jsx("svg", { className: CLS_INPUT_SUCCESS_ICON, viewBox: "0 0 20 20", fill: "currentColor", "aria-hidden": "true", children: _jsx("path", { fillRule: "evenodd", d: "M16.704 5.29a1 1 0 010 1.42l-7.2 7.2a1 1 0 01-1.415 0l-3.2-3.2a1 1 0 111.414-1.42l2.493 2.494 6.493-6.494a1 1 0 011.415 0z", clipRule: "evenodd" }) })) : null);
-    return (_jsxs("div", { className: "w-full", "data-section": "input-div-527", children: [label && (_jsx(Label, { htmlFor: inputId, required: required, children: label })), _jsxs("div", { className: "relative", "data-section": "input-div-528", children: [icon && (_jsx(Div, { className: "pointer-events-none absolute inset-y-0 left-3 flex items-center text-[var(--appkit-color-text-faint)]", "data-section": "input-div-529", children: icon })), _jsx("input", { ...props, ref: ref, id: inputId, disabled: disabled, "aria-invalid": error ? "true" : undefined, className: inputClassName }), adornment && (_jsx(Div, { className: "pointer-events-none absolute inset-y-0 right-3 flex items-center text-[var(--appkit-color-text-faint)]", "data-section": "input-div-530", children: adornment }))] }), error ? (_jsx(Text, { size: "sm", variant: "error", className: "mt-1.5", role: "alert", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", className: "mt-1.5", children: helperText })) : null] }));
+    return (_jsxs("div", { className: "w-full", "data-section": "input-div-527", children: [label && (_jsx(Label, { htmlFor: inputId, required: required, children: label })), _jsxs("div", { className: "relative", "data-section": "input-div-528", children: [icon && (_jsx(Div, { className: "pointer-events-none absolute inset-y-0 left-3 flex items-center text-[var(--appkit-color-text-faint)]", "data-section": "input-div-529", children: icon })), _jsx("input", { ...props, ref: ref, id: inputId, disabled: disabled, "aria-invalid": ariaInvalid, className: inputClassName }), adornment && (_jsx(Div, { className: "pointer-events-none absolute inset-y-0 right-3 flex items-center text-[var(--appkit-color-text-faint)]", "data-section": "input-div-530", children: adornment }))] }), error ? (_jsx(Text, { size: "sm", variant: "error", className: "mt-1.5", role: "alert", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", className: "mt-1.5", children: helperText })) : null] }));
 });
 Input.displayName = "Input";

package/dist/ui/components/PaginatedSelect.d.ts

@@ -20,6 +20,14 @@ interface BaseProps<V> {
     disabled?: boolean;
     className?: string;
     ariaLabel?: string;
+    /** Field name — resolves this control's error from `FormShellContext`, as `Field*` do. */
+    name?: string;
+    /**
+     * Validation message. Explicit prop wins; else read from context by `name`.
+     * Without these two this control had no error affordance at all: a required
+     * taxonomy pick could fail and the control showed nothing.
+     */
+    error?: React.ReactNode;
     /** "+ Create new …" button. Provide `renderCreateForm` OR (`createFields` + `onCreateSubmit`). */
     createLabel?: string;
     drawerTitle?: string;
@@ -59,24 +67,5 @@ interface MultiProps<V> extends BaseProps<V> {
     maxChipsVisible?: number;
 }
 export type PaginatedSelectProps<V = string> = SingleProps<V> | MultiProps<V>;
-/**
- * PaginatedSelect — searchable, async-paginated select with optional multi-mode
- * and optional inline create-new drawer.
- *
- * @example single-select
- * <PaginatedSelect value={storeId} onChange={setStoreId} loadOptions={loadStores} />
- *
- * @example single-select with inline create
- * <PaginatedSelect
- *   value={categoryId}
- *   onChange={(v) => setCategoryId(v ?? "")}
- *   loadOptions={loadCategories}
- *   createLabel="Category"
- *   renderCreateForm={({ onCreated, onCancel }) => <CategoryForm ... />}
- * />
- *
- * @example multi-select
- * <PaginatedSelect multiple value={tagIds} onChange={setTagIds} loadOptions={loadTags} />
- */
 export declare function PaginatedSelect<V = string>(props: PaginatedSelectProps<V>): React.JSX.Element;
 export {};

package/dist/ui/components/PaginatedSelect.js

@@ -1,7 +1,10 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useCallback, useEffect, useRef, useState } from "react";
+import React, { useCallback, useEffect, useRef, useState } from "react";
 import { Input } from "./Input.js";
+import { toUserMessage } from "../../errors/error-display-map.js";
+import { Text } from "./Typography.js";
+import { FormShellContext } from "../forms/FormShell.js";
 import { SideDrawer } from "./SideDrawer.js";
 import { Button } from "./Button.js";
 import { QuickFormDrawer } from "../../features/shell/QuickFormDrawer.js";
@@ -87,9 +90,43 @@ function isValueSelected(value, props, isMulti) {
  * @example multi-select
  * <PaginatedSelect multiple value={tagIds} onChange={setTagIds} loadOptions={loadTags} />
  */
+/**
+ * Resolve this control's validation message and the id that labels it.
+ *
+ * A hook rather than four lines in the component body: `PaginatedSelect` is
+ * already at `audit-code-quality`'s size limit, and the error affordance is
+ * self-contained — explicit prop wins, else `FormShellContext` by `name`,
+ * exactly as the `Field*` primitives resolve theirs.
+ */
+function usePaginatedSelectError(name, errorProp) {
+    const ctx = React.useContext(FormShellContext);
+    const error = errorProp ?? (name ? ctx?.errors[name] : undefined);
+    const errorId = `${React.useId()}-error`;
+    return { error, errorId };
+}
+/** The message, under the trigger it describes. */
+function PaginatedSelectError({ id, error }) {
+    if (!error)
+        return null;
+    return (_jsx(Text, { id: id, size: "sm", variant: "error", className: "appkit-form-field__error", role: "alert", children: error }));
+}
+/**
+ * The selected-values row, multi-select only.
+ *
+ * Its own component because `PaginatedSelect` sits against
+ * `audit-code-quality`'s size limit, and this block needs none of the
+ * control's twelve state variables — only what it is handed.
+ */
+function PaginatedSelectChips({ chips, labelFor, overflowCount, disabled, onRemove, }) {
+    return (_jsxs("div", { className: C.chips, children: [chips.map((v) => (_jsxs("span", { className: C.chip, children: [_jsx("span", { className: C.chipLabel, children: labelFor(v) }), !disabled && (_jsx("button", { type: "button", "aria-label": "Remove", className: C.chipRemove, onClick: (e) => {
+                            e.stopPropagation();
+                            onRemove(v);
+                        }, children: "\u2715" }))] }, String(v)))), overflowCount > 0 && (_jsxs("span", { className: C.overflowChip, children: ["+", overflowCount, " more"] }))] }));
+}
 export function PaginatedSelect(props) {
-    const { options, loadOptions, placeholder = "Select...", searchPlaceholder = "Search...", noResultsText = "No results", disabled, className = "", ariaLabel, createLabel, drawerTitle, renderCreateForm, createFields, createSchema, onCreateSubmit, createSubmitLabel, editLabel, editDrawerTitle, renderEditForm, editFields, editSchema, onEditLoad, onEditSubmit, editSubmitLabel, } = props;
+    const { options, loadOptions, placeholder = "Select...", searchPlaceholder = "Search...", noResultsText = "No results", disabled, className = "", ariaLabel, name, error: errorProp, createLabel, drawerTitle, renderCreateForm, createFields, createSchema, onCreateSubmit, createSubmitLabel, editLabel, editDrawerTitle, renderEditForm, editFields, editSchema, onEditLoad, onEditSubmit, editSubmitLabel, } = props;
     const isMulti = props.multiple === true;
+    const { error, errorId } = usePaginatedSelectError(name, errorProp);
     const maxChipsVisible = isMulti ? props.maxChipsVisible ?? 3 : 0;
     const [query, setQuery] = useState("");
     const [open, setOpen] = useState(false);
@@ -222,7 +259,7 @@ export function PaginatedSelect(props) {
             // Same staleness rule as the success path: a superseded request must
             // not paint its failure over a newer request's results.
             if (requestId === requestIdRef.current) {
-                setLoadError(normalized.message || "Could not load options.");
+                setLoadError(toUserMessage(normalized.code, undefined, { fallback: "Could not load options." }));
                 if (reset)
                     setAsyncOptions([]);
             }
@@ -370,12 +407,9 @@ export function PaginatedSelect(props) {
     const multiValue = isMulti ? props.value : [];
     const visibleChips = multiValue.slice(0, maxChipsVisible);
     const overflowCount = multiValue.length - maxChipsVisible;
-    return (_jsxs(_Fragment, { children: [_jsxs("div", { ref: containerRef, className: [C.root, className].filter(Boolean).join(" "), "aria-label": ariaLabel, children: [isMulti && multiValue.length > 0 && (_jsxs("div", { className: C.chips, children: [visibleChips.map((v) => (_jsxs("span", { className: C.chip, children: [_jsx("span", { className: C.chipLabel, children: labelMap.current.get(v) ?? String(v) }), !disabled && (_jsx("button", { type: "button", "aria-label": "Remove", className: C.chipRemove, onClick: (e) => {
-                                            e.stopPropagation();
-                                            removeChip(v);
-                                        }, children: "\u2715" }))] }, String(v)))), overflowCount > 0 && (_jsxs("span", { className: C.overflowChip, children: ["+", overflowCount, " more"] }))] })), _jsxs("button", { type: "button", disabled: disabled, onClick: () => setOpen((prev) => !prev), className: [C.trigger, disabled ? C.triggerDisabled : ""]
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { ref: containerRef, className: [C.root, className].filter(Boolean).join(" "), children: [isMulti && multiValue.length > 0 && (_jsx(PaginatedSelectChips, { chips: visibleChips, labelFor: (v) => labelMap.current.get(v) ?? String(v), overflowCount: overflowCount, disabled: disabled, onRemove: removeChip })), _jsxs("button", { type: "button", disabled: disabled, onClick: () => setOpen((prev) => !prev), className: [C.trigger, disabled ? C.triggerDisabled : ""]
                             .filter(Boolean)
-                            .join(" "), "aria-expanded": open, "aria-haspopup": "listbox", children: [_jsx("span", { className: C.triggerLeft, children: _jsx("span", { className: triggerEmpty ? C.placeholder : "", children: triggerLabel }) }), _jsx("span", { "aria-hidden": "true", children: "\u25BE" })] }), hasEdit && !disabled ? (_jsx("button", { type: "button", className: C.editBtn, "aria-label": `Edit ${editLabel}`, title: `Edit ${editLabel}`, onClick: () => {
+                            .join(" "), "aria-label": ariaLabel, "aria-expanded": open, "aria-haspopup": "listbox", "aria-invalid": error ? "true" : undefined, "aria-describedby": error ? errorId : undefined, children: [_jsx("span", { className: C.triggerLeft, children: _jsx("span", { className: triggerEmpty ? C.placeholder : "", children: triggerLabel }) }), _jsx("span", { "aria-hidden": "true", children: "\u25BE" })] }), hasEdit && !disabled ? (_jsx("button", { type: "button", className: C.editBtn, "aria-label": `Edit ${editLabel}`, title: `Edit ${editLabel}`, onClick: () => {
                             setOpen(false);
                             setEditOpen(true);
                         }, children: "\u270E" })) : null, open && (_jsxs("div", { className: [C.dropdown, opensUp ? C.dropdownUp : ""].filter(Boolean).join(" "), role: "listbox", "aria-multiselectable": isMulti || undefined, children: [_jsx(Input, { autoFocus: true, value: query, onChange: (e) => setQuery(e.target.value), placeholder: searchPlaceholder, className: C.search }), _jsxs("ul", { className: C.list, children: [filtered.map((opt, idx) => {
@@ -386,7 +420,7 @@ export function PaginatedSelect(props) {
                                     }), loadError && !loading && (_jsxs("li", { className: C.empty, role: "alert", children: [loadError, " ", _jsx(Button, { variant: "ghost", size: "sm", onClick: () => void load(query, 1, true), children: "Try again" })] })), !loadError && filtered.length === 0 && !loading && (_jsx("li", { className: C.empty, children: noResultsText })), loading && _jsx("li", { className: C.loading, children: "Loading\u2026" }), hasMore && !loading && (_jsx("li", { children: _jsx("button", { type: "button", className: C.loadMore, onClick: () => void load(query, page + 1), children: "Load more" }) })), hasCreate && (_jsx("li", { children: _jsxs("button", { type: "button", className: C.createBtn, onClick: () => {
                                                 setOpen(false);
                                                 setDrawerOpen(true);
-                                            }, children: ["+ Create new ", createLabel] }) }, CREATE_SENTINEL))] })] }))] }), hasCreate && renderCreateForm ? (_jsx(SideDrawer, { isOpen: drawerOpen, onClose: () => setDrawerOpen(false), title: drawerTitle ?? `Create ${createLabel}`, mode: "create", footer: _jsx(Button, { variant: "ghost", onClick: () => setDrawerOpen(false), children: "Cancel" }), children: renderCreateForm({
+                                            }, children: ["+ Create new ", createLabel] }) }, CREATE_SENTINEL))] })] })), _jsx(PaginatedSelectError, { id: errorId, error: error })] }), hasCreate && renderCreateForm ? (_jsx(SideDrawer, { isOpen: drawerOpen, onClose: () => setDrawerOpen(false), title: drawerTitle ?? `Create ${createLabel}`, mode: "create", footer: _jsx(Button, { variant: "ghost", onClick: () => setDrawerOpen(false), children: "Cancel" }), children: renderCreateForm({
                     onCreated: handleCreated,
                     onCancel: () => setDrawerOpen(false),
                 }) })) : hasCreate && createFields && onCreateSubmit ? (_jsx(QuickFormDrawer, { isOpen: drawerOpen, onClose: () => setDrawerOpen(false), title: drawerTitle ?? `Create ${createLabel}`, fields: createFields, schema: createSchema, submitLabel: createSubmitLabel ?? `Create ${createLabel}`, onSubmit: async (values) => {

package/dist/ui/components/Radio.js

@@ -66,5 +66,12 @@ export function RadioGroup({ name, options, value, onChange, label, error, orien
 export function RadioItem({ label, suffix, error, className = "", checked, disabled, id, ...props }) {
     const generatedId = React.useId();
     const inputId = id ?? generatedId;
-    return (_jsxs("div", { className: "appkit-radio-item", "data-section": "radio-item-div", children: [_jsxs(Label, { htmlFor: inputId, className: ["appkit-radio-item__label", disabled ? "appkit-radio-item__label--disabled" : ""].filter(Boolean).join(" "), children: [_jsx("span", { className: "appkit-radio-item__box-wrap", children: _jsx("input", { ...props, id: inputId, type: "radio", checked: checked, disabled: disabled, "aria-invalid": error ? "true" : undefined, className: ["appkit-radio-item__input", error ? "appkit-radio-item__input--error" : "", className].filter(Boolean).join(" ") }) }), (label || suffix) && (_jsxs("span", { className: "appkit-radio-item__content", children: [label ? _jsx(Span, { className: "appkit-radio-item__text", children: label }) : _jsx("span", {}), suffix] }))] }), error && (_jsx(Text, { size: "sm", variant: "error", className: "appkit-radio-item__error", role: "alert", children: error }))] }));
+    /*
+     * A caller's own `aria-invalid` wins. `{...props}` is spread first, so
+     * re-specifying the attribute afterwards overwrites an incoming "true"
+     * with `undefined` — the defect that left every Field*-built form in the
+     * app with no aria-invalid at all. See the full writeup in `Input.tsx`.
+     */
+    const ariaInvalid = props["aria-invalid"] ?? (error ? "true" : undefined);
+    return (_jsxs("div", { className: "appkit-radio-item", "data-section": "radio-item-div", children: [_jsxs(Label, { htmlFor: inputId, className: ["appkit-radio-item__label", disabled ? "appkit-radio-item__label--disabled" : ""].filter(Boolean).join(" "), children: [_jsx("span", { className: "appkit-radio-item__box-wrap", children: _jsx("input", { ...props, id: inputId, type: "radio", checked: checked, disabled: disabled, "aria-invalid": ariaInvalid, className: ["appkit-radio-item__input", error ? "appkit-radio-item__input--error" : "", className].filter(Boolean).join(" ") }) }), (label || suffix) && (_jsxs("span", { className: "appkit-radio-item__content", children: [label ? _jsx(Span, { className: "appkit-radio-item__text", children: label }) : _jsx("span", {}), suffix] }))] }), error && (_jsx(Text, { size: "sm", variant: "error", className: "appkit-radio-item__error", role: "alert", children: error }))] }));
 }