@mohasinac/appkit 4.60.1 → 4.62.0

package/dist/schemas/registry.d.ts

@@ -1994,6 +1994,9 @@ export declare const SCHEMAS: {
             }, import("zod").ZodTypeAny, "passthrough">;
             userId: string;
             couponCode: string;
+            claimedAt: string | Date | import("zod").objectOutputType<{
+                toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
+            }, import("zod").ZodTypeAny, "passthrough">;
             couponId: string;
             couponSnapshot: {
                 type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
@@ -2015,9 +2018,6 @@ export declare const SCHEMAS: {
                 storeId?: string | undefined;
                 description?: string | undefined;
             };
-            claimedAt: string | Date | import("zod").objectOutputType<{
-                toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
-            }, import("zod").ZodTypeAny, "passthrough">;
             expiresAt?: string | Date | import("zod").objectOutputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
             }, import("zod").ZodTypeAny, "passthrough"> | null | undefined;
@@ -2034,6 +2034,9 @@ export declare const SCHEMAS: {
             }, import("zod").ZodTypeAny, "passthrough">;
             userId: string;
             couponCode: string;
+            claimedAt: string | Date | import("zod").objectInputType<{
+                toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
+            }, import("zod").ZodTypeAny, "passthrough">;
             couponId: string;
             couponSnapshot: {
                 type: "fixed" | "percentage" | "free_shipping" | "buy_x_get_y";
@@ -2055,9 +2058,6 @@ export declare const SCHEMAS: {
                 storeId?: string | undefined;
                 description?: string | undefined;
             };
-            claimedAt: string | Date | import("zod").objectInputType<{
-                toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
-            }, import("zod").ZodTypeAny, "passthrough">;
             expiresAt?: string | Date | import("zod").objectInputType<{
                 toDate: import("zod").ZodFunction<import("zod").ZodTuple<[], import("zod").ZodUnknown>, import("zod").ZodDate>;
             }, import("zod").ZodTypeAny, "passthrough"> | null | undefined;
@@ -2105,16 +2105,19 @@ export declare const SCHEMAS: {
             bxgy: import("zod").ZodOptional<import("zod").ZodObject<{
                 buyQuantity: import("zod").ZodNumber;
                 getQuantity: import("zod").ZodNumber;
+                maxItemPrice: import("zod").ZodOptional<import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodNumber, number, number>, number, number>>;
                 applicableProducts: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
                 applicableCategories: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
             }, "strip", import("zod").ZodTypeAny, {
                 buyQuantity: number;
                 getQuantity: number;
+                maxItemPrice?: number | undefined;
                 applicableProducts?: string[] | undefined;
                 applicableCategories?: string[] | undefined;
             }, {
                 buyQuantity: number;
                 getQuantity: number;
+                maxItemPrice?: number | undefined;
                 applicableProducts?: string[] | undefined;
                 applicableCategories?: string[] | undefined;
             }>>;
@@ -2261,6 +2264,7 @@ export declare const SCHEMAS: {
             bxgy?: {
                 buyQuantity: number;
                 getQuantity: number;
+                maxItemPrice?: number | undefined;
                 applicableProducts?: string[] | undefined;
                 applicableCategories?: string[] | undefined;
             } | undefined;
@@ -2319,6 +2323,7 @@ export declare const SCHEMAS: {
             bxgy?: {
                 buyQuantity: number;
                 getQuantity: number;
+                maxItemPrice?: number | undefined;
                 applicableProducts?: string[] | undefined;
                 applicableCategories?: string[] | undefined;
             } | undefined;
@@ -2796,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">;
@@ -2811,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">;
@@ -3075,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">;
@@ -3229,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";
@@ -571,7 +571,6 @@ export type { ActionIndexValidationContext, ActionIndexValidationIssue, } from "
 export { ActionIndexRepository, actionIndexRepository, } from "./features/search/action-index/repository";
 export type { ActionIndexDocument } from "./features/search/action-index/repository";
 export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
-export { wouldBeFullRefund } from "./_internal/shared/checkout/refundable-base";
 export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons";
 export type { ReturnReason } from "./_internal/shared/features/orders/return-reasons";
 export { draftToProductInput, productToDraft, } from "./features/seller/utils/product-draft-mapping";

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";
@@ -1529,10 +1529,12 @@ export { validateActionIndexEntry, normaliseRoute, } from "./features/search/act
 export { ActionIndexRepository, actionIndexRepository, } from "./features/search/action-index/repository.js";
 export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy.js";
 /*
- * `wouldBeFullRefund` — from refundable-base, NOT return-reasons. It was
- * never exported at all, so the admin refund route could not import it.
+ * 🛑 `wouldBeFullRefund` is deliberately NOT exported. I added it here, and
+ * `audit-appkit-reexports` was right to refuse it: `_internal/shared/checkout/`
+ * is not a `features/` module, so exporting it would have made a money
+ * predicate public purely so one route could duplicate a decision
+ * `processRefundAction` already makes — see the note on `ProcessRefundInput`.
  */
-export { wouldBeFullRefund } from "./_internal/shared/checkout/refundable-base.js";
 // Return / refund reasons — the closed enum the final-sale gate branches on.
 // See the module docstring for why the exempt set is "seller or carrier fault"
 // rather than "serious reasons".

package/dist/styles.css

@@ -11350,6 +11350,57 @@ body:has(.appkit-page-breadcrumb) .appkit-auto-breadcrumbs {
  * plain file like this one can never win an importance tie.
  */
 
+/* The kiss-cut label sheet. Shipped unbundled when it was written — the
+   `.appkit-label-sheet` grid and its `@page` rules reached no consumer, so
+   every printed sheet fell back to browser defaults and the die-cut
+   alignment the component exists to produce could not happen. */
+/*
+ * Print-layout classes for physical labels and printable documents.
+ *
+ * 🛑 THESE LIVE IN A STATIC STYLESHEET, NOT ONLY IN `labelPageCss`'s STRING.
+ *
+ * `labelPageCss()` and `documentPageCss()` emit an `@page` rule plus these
+ * same `break-*` declarations into a runtime `<style>`. That is necessary for
+ * `@page` — its `size` is computed from the chosen profile, so it cannot be
+ * static — but it meant `.appkit-label` and `.appkit-label-sheet` existed
+ * ONLY inside a template literal.
+ *
+ * Consequence: `audit-dead-css-classes` reported them as classes generating no
+ * CSS rule, correctly, because nothing it can read defines them. A class whose
+ * only definition is a string concatenation is invisible to every tool — the
+ * audit, an editor's go-to-definition, and anyone grepping the stylesheets.
+ * Declaring them here makes them real; the runtime string still carries its
+ * own copy because a print view may be opened in a context where the bundled
+ * stylesheet has not loaded, and a duplicated `break-inside: avoid` is
+ * harmless where a missing one splits a label across two pages.
+ *
+ * @tag domain:print
+ * @tag layer:feature
+ */
+
+@media print {
+  /*
+   * A label must never be split across a page boundary. On thermal stock a
+   * page IS a label, so a split would print the top half on one label and the
+   * bottom half on the next — and the operator discovers it after both have
+   * been peeled and stuck to something.
+   */
+  .appkit-label {
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  /*
+   * A sheet is one A4 page of die-cut labels, or one contents sheet. Same
+   * rule, different unit — splitting it would offset every label after the
+   * break from its die-cut hole.
+   */
+  .appkit-label-sheet {
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+}
+
 /*
  * Third-party stylesheet, vendored into dist/vendor by copy-assets.mjs.
  * It used to be a JS import inside ImageEditor.tsx, which made it invisible to

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/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 }))] }));
 }

package/dist/ui/components/Select.js

@@ -6,6 +6,14 @@ import { Label, Text } from "./Typography.js";
 export function Select({ options, value, onChange, onValueChange, placeholder, label, error, helperText, disabled = false, required, className = "", id, variant = "default", bare = false, wrapperClassName, ...props }) {
     const generatedId = React.useId();
     const inputId = id ?? generatedId;
+    /*
+     * 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 `FieldSelect` 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);
     const handleChange = (event) => {
         onChange?.(event);
         onValueChange?.(event.target.value);
@@ -28,7 +36,7 @@ export function Select({ options, value, onChange, onValueChange, placeholder, l
         .join(" ");
     const optionsMarkup = (_jsxs(_Fragment, { children: [placeholder ? (_jsx("option", { value: "", disabled: true, children: placeholder })) : null, options.map((option) => (_jsx("option", { value: option.value, disabled: option.disabled, children: option.label }, String(option.value))))] }));
     if (bare) {
-        return (_jsx("select", { ...props, id: inputId, value: value, onChange: handleChange, disabled: disabled, "aria-invalid": error ? "true" : undefined, className: selectClassName, children: optionsMarkup }));
+        return (_jsx("select", { ...props, id: inputId, value: value, onChange: handleChange, disabled: disabled, "aria-invalid": ariaInvalid, className: selectClassName, children: optionsMarkup }));
     }
-    return (_jsxs("div", { className: ["appkit-select", wrapperClassName].filter(Boolean).join(" "), "data-section": "select-div-592", children: [label && (_jsx(Label, { htmlFor: inputId, className: "appkit-select__label", required: required, children: label })), _jsxs("div", { className: "relative group", "data-section": "select-div-593", children: [_jsx("select", { ...props, id: inputId, value: value, onChange: handleChange, disabled: disabled, "aria-invalid": error ? "true" : undefined, className: selectClassName, children: optionsMarkup }), _jsx(Div, { className: "pointer-events-none absolute inset-y-0 right-3 flex items-center text-[var(--appkit-color-text-faint)]", "data-section": "select-div-594", children: _jsx("svg", { className: "h-4 w-4", viewBox: "0 0 20 20", fill: "currentColor", "aria-hidden": "true", children: _jsx("path", { fillRule: "evenodd", d: "M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z", clipRule: "evenodd" }) }) })] }), error ? (_jsx(Text, { size: "sm", variant: "error", className: "appkit-select__error", role: "alert", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", className: "appkit-select__error", children: helperText })) : null] }));
+    return (_jsxs("div", { className: ["appkit-select", wrapperClassName].filter(Boolean).join(" "), "data-section": "select-div-592", children: [label && (_jsx(Label, { htmlFor: inputId, className: "appkit-select__label", required: required, children: label })), _jsxs("div", { className: "relative group", "data-section": "select-div-593", children: [_jsx("select", { ...props, id: inputId, value: value, onChange: handleChange, disabled: disabled, "aria-invalid": ariaInvalid, className: selectClassName, children: optionsMarkup }), _jsx(Div, { className: "pointer-events-none absolute inset-y-0 right-3 flex items-center text-[var(--appkit-color-text-faint)]", "data-section": "select-div-594", children: _jsx("svg", { className: "h-4 w-4", viewBox: "0 0 20 20", fill: "currentColor", "aria-hidden": "true", children: _jsx("path", { fillRule: "evenodd", d: "M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z", clipRule: "evenodd" }) }) })] }), error ? (_jsx(Text, { size: "sm", variant: "error", className: "appkit-select__error", role: "alert", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", className: "appkit-select__error", children: helperText })) : null] }));
 }

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

@@ -7,5 +7,12 @@ export interface TagInputProps {
     placeholder?: string;
     className?: string;
     helperText?: string;
+    /**
+     * Validation message. This control had no error slot at all, so a schema
+     * failure on a tags field could only ever appear in the summary — the field
+     * itself showed nothing and was not announced as invalid. Mirrors the
+     * contract Input/Select/Textarea/Checkbox already have.
+     */
+    error?: React.ReactNode;
 }
-export declare function TagInput({ value, onChange, disabled, label, placeholder, className, helperText, }: TagInputProps): React.JSX.Element;
+export declare function TagInput({ value, onChange, disabled, label, placeholder, className, helperText, error, }: TagInputProps): React.JSX.Element;

package/dist/ui/components/TagInput.js

@@ -1,10 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useRef, useState } from "react";
+import React, { useRef, useState } from "react";
 import { Label, Span } from "./Typography.js";
-export function TagInput({ value, onChange, disabled = false, label, placeholder = "Add a tag...", className = "", helperText = "Press Enter or comma to add a tag", }) {
+export function TagInput({ value, onChange, disabled = false, label, placeholder = "Add a tag...", className = "", helperText = "Press Enter or comma to add a tag", error, }) {
     const [draft, setDraft] = useState("");
     const inputRef = useRef(null);
+    const errorId = React.useId();
     const normalizeTag = (raw) => raw.trim().replace(/,+$/, "").trim();
     const addTag = (raw) => {
         const tag = normalizeTag(raw);
@@ -69,5 +70,5 @@ export function TagInput({ value, onChange, disabled = false, label, placeholder
                             disabled ? "appkit-tag-input__text--disabled" : "",
                         ]
                             .filter(Boolean)
-                            .join(" "), "aria-label": label ?? "Tag input" })] }), helperText && (_jsx(Span, { size: "xs", className: "appkit-tag-input__helper", children: helperText }))] }));
+                            .join(" "), "aria-label": label ?? "Tag input", "aria-invalid": error ? "true" : undefined, "aria-describedby": error ? errorId : undefined })] }), error ? (_jsx(Span, { id: errorId, size: "xs", className: "appkit-tag-input__helper appkit-form-field__error", role: "alert", children: error })) : helperText ? (_jsx(Span, { size: "xs", className: "appkit-tag-input__helper", children: helperText })) : null] }));
 }

package/dist/ui/components/Textarea.js

@@ -15,12 +15,20 @@ export const Textarea = React.forwardRef(function Textarea({ label, error, helpe
         : variant === "ghost"
             ? "border-transparent bg-transparent shadow-none"
             : "";
+    /*
+     * 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 `FieldTextarea` 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);
     const textareaClassName = ["appkit-textarea", variantClass, className]
         .filter(Boolean)
         .join(" ");
     if (bare) {
-        return (_jsx("textarea", { ...props, ref: ref, id: inputId, value: value, defaultValue: defaultValue, maxLength: maxLength, "aria-invalid": error ? "true" : undefined, className: textareaClassName }));
+        return (_jsx("textarea", { ...props, ref: ref, id: inputId, value: value, defaultValue: defaultValue, maxLength: maxLength, "aria-invalid": ariaInvalid, className: textareaClassName }));
     }
-    return (_jsxs("div", { className: "w-full", "data-section": "textarea-div-620", children: [label && (_jsx(Label, { htmlFor: inputId, required: required, children: label })), _jsx("textarea", { ...props, ref: ref, id: inputId, value: value, defaultValue: defaultValue, maxLength: maxLength, "aria-invalid": error ? "true" : undefined, className: textareaClassName }), (error || helperText || (showCharCount && maxLength)) && (_jsxs("div", { className: "mt-1.5 flex items-start justify-between gap-3", "data-section": "textarea-div-621", children: [_jsx("div", { className: "min-w-0 flex-1", "data-section": "textarea-div-622", children: error ? (_jsx(Text, { size: "sm", variant: "error", role: "alert", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", children: helperText })) : null }), showCharCount && maxLength ? (_jsxs(Text, { size: "xs", variant: charCount >= maxLength ? "error" : "muted", className: "shrink-0 tabular-nums", children: [charCount, "/", maxLength] })) : null] }))] }));
+    return (_jsxs("div", { className: "w-full", "data-section": "textarea-div-620", children: [label && (_jsx(Label, { htmlFor: inputId, required: required, children: label })), _jsx("textarea", { ...props, ref: ref, id: inputId, value: value, defaultValue: defaultValue, maxLength: maxLength, "aria-invalid": ariaInvalid, className: textareaClassName }), (error || helperText || (showCharCount && maxLength)) && (_jsxs("div", { className: "mt-1.5 flex items-start justify-between gap-3", "data-section": "textarea-div-621", children: [_jsx("div", { className: "min-w-0 flex-1", "data-section": "textarea-div-622", children: error ? (_jsx(Text, { size: "sm", variant: "error", role: "alert", children: error })) : helperText ? (_jsx(Text, { size: "sm", variant: "secondary", children: helperText })) : null }), showCharCount && maxLength ? (_jsxs(Text, { size: "xs", variant: charCount >= maxLength ? "error" : "muted", className: "shrink-0 tabular-nums", children: [charCount, "/", maxLength] })) : null] }))] }));
 });
 Textarea.displayName = "Textarea";

package/dist/ui/forms/FieldCheckbox.js

@@ -34,5 +34,5 @@ export function FieldCheckbox({ name, label, hint, checked, onChange, onBlur, di
         ctx?.setFieldTouched(name);
         onBlur?.();
     }
-    return (_jsxs("div", { className: ["appkit-form-field", className].filter(Boolean).join(" "), children: [_jsx(Checkbox, { id: inputId, name: name, checked: checked, onChange: handleChange, onBlur: handleBlur, label: label, disabled: disabled, "aria-describedby": showError ? errorId : undefined }), !showError && hint && (_jsx(Text, { size: "sm", variant: "secondary", className: "appkit-form-field__hint", children: hint })), showError && (_jsx(Text, { id: errorId, size: "sm", variant: "error", className: "appkit-form-field__error", role: "alert", children: error }))] }));
+    return (_jsxs("div", { className: ["appkit-form-field", className].filter(Boolean).join(" "), children: [_jsx(Checkbox, { id: inputId, name: name, checked: checked, onChange: handleChange, onBlur: handleBlur, label: label, disabled: disabled, "aria-invalid": showError || undefined, "aria-describedby": showError ? errorId : undefined }), !showError && hint && (_jsx(Text, { size: "sm", variant: "secondary", className: "appkit-form-field__hint", children: hint })), showError && (_jsx(Text, { id: errorId, size: "sm", variant: "error", className: "appkit-form-field__error", role: "alert", children: error }))] }));
 }

package/dist/ui/forms/FormErrorList.d.ts

@@ -9,21 +9,5 @@ export interface FormErrorListProps {
     ctx?: FormShellContextValue;
     className?: string;
 }
-/**
- * The `<ul>` of current validation errors, with a jump link per entry when
- * the form declares sections.
- *
- * WHY it is its own file: two surfaces render this exact list — the inline
- * `<FormErrorSummary>` beside the submit button on desktop, and the mobile
- * "Fix N issues" sheet in the bottom-chrome tier. Writing it twice would mean
- * a jump-link fix, an empty-state fix or a wording fix landing in one and not
- * the other, which is the bug-fix multiplier the Duplication Framework calls
- * out. There are exactly two consumers and they are the same list, so this is
- * a consolidation, not speculative abstraction.
- *
- * Renders nothing when there are no errors. It does NOT gate on
- * `submitAttempted` — that is the *summary's* decision, not the list's, and
- * the sheet needs to keep rendering while open.
- */
 export declare function FormErrorList({ ctx: ctxProp, className }: FormErrorListProps): import("react").JSX.Element | null;
 export default FormErrorList;

package/dist/ui/forms/FormErrorList.js

@@ -19,6 +19,39 @@ import { Span } from "../components/Typography.js";
  * `submitAttempted` — that is the *summary's* decision, not the list's, and
  * the sheet needs to keep rendering while open.
  */
+/*
+ * 🛑 The two sides of this lookup use DIFFERENT key shapes, so an exact match
+ * silently loses every nested error.
+ *
+ * `errors` is keyed by the full dotted Zod path — `applyZodIssues` does
+ * `issue.path.map(String).join(".")`, giving `"address.line1"`. But
+ * `fieldToStepIndex` is built by `buildFieldToSectionIndex` from
+ * `SectionDef.fields`, which lists BARE field names — `"address"`. So
+ * `fieldToStepIndex["address.line1"]` was always `undefined`, the entry fell
+ * through to the plain `<Span>`, and the error that a section demonstrably
+ * owned rendered with no jump link.
+ *
+ * `SectionForm` already solved this for its own badge counts
+ * (`erroringSectionIds`, `errorCountFor`) with a prefix match. This is the same
+ * rule, so the list and the badges can no longer disagree about which section
+ * an error belongs to.
+ *
+ * Exact match is tried first: a field genuinely named `"address.line1"` must
+ * beat a prefix match on `"address"`.
+ */
+function resolveStepIndex(ctx, key) {
+    const map = ctx.fieldToStepIndex;
+    if (!map)
+        return undefined;
+    const exact = map[key];
+    if (exact != null)
+        return exact;
+    for (const [field, index] of Object.entries(map)) {
+        if (key.startsWith(`${field}.`))
+            return index;
+    }
+    return undefined;
+}
 export function FormErrorList({ ctx: ctxProp, className }) {
     const ambient = useContext(FormShellContext);
     const ctx = ctxProp ?? ambient;
@@ -28,7 +61,7 @@ export function FormErrorList({ ctx: ctxProp, className }) {
     if (entries.length === 0)
         return null;
     return (_jsx("ul", { className: ["appkit-formshell__error-summary__list", className].filter(Boolean).join(" "), children: entries.map(([key, message]) => {
-            const stepIndex = ctx.fieldToStepIndex?.[key];
+            const stepIndex = resolveStepIndex(ctx, key);
             const stepLabel = stepIndex != null ? ctx.steps[stepIndex]?.label : undefined;
             return (_jsx("li", { children: stepLabel ? (_jsxs("button", { type: "button", className: "appkit-formshell__error-summary__step-link", onClick: () => ctx.goToStep(stepIndex), children: [_jsxs(Span, { weight: "semibold", children: [stepLabel, ":"] }), " ", message] })) : (_jsx(Span, { children: message })) }, key));
         }) }));

package/dist/ui/forms/apply-zod-issues.d.ts

@@ -22,7 +22,16 @@
  *
  * Root-level `.refine()` issues (empty `path: []`, no owning field) are still
  * skipped — there is no field to attach them to, so the caller must surface
- * those some other way (they fall through to a toast in `surfaceError`).
+ * those some other way.
+ *
+ * 🛑 That last sentence used to end "(they fall through to a toast in
+ * `surfaceError`)", which was only true when EVERY issue was root-level.
+ * In the mixed case — one field error plus one cross-field `.refine()`, which
+ * is the common shape for "passwords must match" or "end date must be after
+ * start date" — `hasAttachableIssue` returned true, this function skipped the
+ * root issue, and `surfaceError` returned without a toast. The cross-field
+ * rule was enforced, the save was refused, and the user was told nothing
+ * about why. `rootLevelMessages` below is how a caller surfaces them.
  */
 export declare function applyZodIssues(issues: ReadonlyArray<{
     path?: ReadonlyArray<PropertyKey>;
@@ -32,3 +41,12 @@ export declare function applyZodIssues(issues: ReadonlyArray<{
 export declare function hasAttachableIssue(issues: ReadonlyArray<{
     path?: ReadonlyArray<PropertyKey>;
 }> | undefined): boolean;
+/**
+ * The messages `applyZodIssues` cannot attach — the root-level `.refine()`
+ * ones with no owning field. A caller that has just run `applyZodIssues`
+ * should surface these separately, or they are silently discarded.
+ */
+export declare function rootLevelMessages(issues: ReadonlyArray<{
+    path?: ReadonlyArray<PropertyKey>;
+    message: string;
+}> | undefined): string[];