@mohasinac/appkit 4.31.0 → 4.32.0

package/dist/features/admin/schemas/admin-ops-forms.js

@@ -40,7 +40,11 @@ export const adminOrderUpdateSchema = z.object({
         section: "shipping", sectionLabel: "Shipping", order: 1, row: "pair",
     }),
     carrier: annotate(z.string().trim().max(80).optional(), {
-        section: "shipping", order: 2, row: "pair",
+        // `kind: "select"` is explicit because the field is a free string in the
+        // schema — the route accepts any carrier name — while the ADMIN form offers
+        // a fixed list. Without it the inferred control is a text input and the
+        // `options` passed by the view would be ignored.
+        section: "shipping", order: 2, row: "pair", kind: "select",
     }),
     /*
      * 🛑 Bounded. This was `parseFloat` + `> 0` with no ceiling, so a slipped
@@ -229,3 +233,121 @@ export const adminAdFormSchema = z
         }
     }
 });
+/**
+ * Ad SETTINGS — the provider credentials and the global consent switch.
+ *
+ * Distinct from `adminAdFormSchema`, which is one ad record. This is the
+ * platform-level configuration every ad renders under, and it was validated by
+ * a hand-written `localCredentialIssues` array that computed the same two rules
+ * on every keystroke and rendered them as a banner headed "Fix settings before
+ * saving" — never on the field that was wrong.
+ *
+ * Both credentials are optional and BLANK MEANS UNCHANGED: the route stores
+ * them encrypted and returns only a masked form, so the input starts empty on
+ * every load and an empty submit must leave the stored value alone. That is why
+ * neither field has a `.min()` — an empty string here is not an omission.
+ */
+export const adsConfigSchema = z.object({
+    consentRequired: annotate(z.boolean(), {
+        section: "consent", sectionLabel: "Consent", sectionRequired: true,
+        quick: true, order: 1, row: "full",
+        label: "Require consent globally for ad rendering",
+    }),
+    adsenseClientId: annotate(z
+        .string()
+        .trim()
+        .regex(/^ca-pub-[0-9]{10,20}$/, "An AdSense client id looks like ca-pub-XXXXXXXXXX.")
+        .optional()
+        .or(z.literal("")), {
+        section: "credentials", sectionLabel: "Provider credentials",
+        order: 1, row: "pair", label: "AdSense client id",
+        help: "Leave blank to keep the stored value.",
+    }),
+    thirdPartyScriptUrl: annotate(z.string().trim().max(2000).optional().or(z.literal("")), {
+        section: "credentials", order: 2, row: "pair",
+        label: "Third-party script URL", inputType: "url",
+        help: "Must be https. Leave blank to keep the stored value.",
+    }),
+})
+    .superRefine((v, ctx) => {
+    const url = v.thirdPartyScriptUrl?.trim();
+    if (!url)
+        return;
+    let parsed = null;
+    try {
+        parsed = new URL(url);
+    }
+    catch (err) {
+        void normalizeError(err);
+        parsed = null;
+    }
+    if (!parsed) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom, path: ["thirdPartyScriptUrl"],
+            message: "That is not a valid URL.",
+        });
+    }
+    else if (parsed.protocol !== "https:") {
+        // A third-party ad script runs in the page's own origin; http would let
+        // any network hop rewrite it.
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom, path: ["thirdPartyScriptUrl"],
+            message: "A third-party script URL must use https.",
+        });
+    }
+});
+/**
+ * The support-ticket triage form — what an admin CHANGES about a ticket, as
+ * distinct from what they SAY on it (the reply box, which is its own write to
+ * a different endpoint and carries the ticket's new status with it).
+ *
+ * The five linked-party ids are FLAT here and reassembled into
+ * `relatedParties` at the payload boundary, the same call the ad creative and
+ * the user's public profile make: the stored shape is one nested object, and
+ * the form has always offered five discrete inputs.
+ */
+export const supportTicketUpdateSchema = z.object({
+    status: annotate(z.enum(["open", "in_progress", "waiting_on_user", "resolved", "closed"]), {
+        section: "triage", sectionLabel: "Triage", sectionRequired: true,
+        quick: true, order: 1, row: "pair", kind: "select",
+    }),
+    priority: annotate(z.enum(["low", "normal", "high", "urgent"]), {
+        section: "triage", quick: true, order: 2, row: "pair", kind: "select",
+    }),
+    internalNotes: annotate(z.string().trim().max(4000).optional().or(z.literal("")), {
+        section: "triage", order: 3, row: "full", kind: "textarea",
+        label: "Internal notes (staff only)",
+        help: "Visible only to admins and employees.",
+    }),
+    userId: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "parties", sectionLabel: "Linked parties", order: 1, row: "pair",
+        label: "User slug",
+        help: "Tag the buyer, store, order, product or bid this ticket concerns.",
+    }),
+    storeId: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "parties", order: 2, row: "pair", label: "Store slug",
+    }),
+    orderId: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "parties", order: 3, row: "pair", label: "Order ID",
+    }),
+    productId: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "parties", order: 4, row: "pair", label: "Product slug",
+    }),
+    bidId: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "parties", order: 5, row: "pair", label: "Bid ID",
+    }),
+});
+/**
+ * The five flat id fields, back into the nested `relatedParties` the ticket
+ * stores. Blank fields are dropped, and an entirely empty set returns
+ * `undefined` so the key is omitted rather than written as `{}`.
+ */
+export function toRelatedPartiesPayload(v) {
+    const out = {};
+    for (const key of ["userId", "storeId", "orderId", "productId", "bidId"]) {
+        const value = v[key]?.trim();
+        if (value)
+            out[key] = value;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}

package/dist/features/admin/schemas/admin-user-form.d.ts

@@ -1,26 +1,69 @@
 import { z } from "zod";
+import type { JsonValue } from "../../../schemas/types";
 export declare const adminUserUpdateSchema: z.ZodObject<{
+    role: z.ZodOptional<z.ZodEnum<["user", "seller", "admin", "moderator"]>>;
+    emailVerified: z.ZodOptional<z.ZodBoolean>;
     displayName: z.ZodOptional<z.ZodString>;
     phoneNumber: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
     isTester: z.ZodOptional<z.ZodBoolean>;
     canTestAdmin: z.ZodOptional<z.ZodBoolean>;
     adminNotes: z.ZodOptional<z.ZodString>;
-    publicProfile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../../..").FirestoreValue, z.ZodTypeDef, import("../../..").FirestoreValue>>>;
+    bio: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    location: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    website: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    twitter: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    instagram: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    facebook: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    linkedin: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
 }, "strip", z.ZodTypeAny, {
+    role?: "user" | "seller" | "admin" | "moderator" | undefined;
     displayName?: string | undefined;
+    location?: string | undefined;
     adminNotes?: string | undefined;
+    bio?: string | undefined;
     phoneNumber?: string | undefined;
+    emailVerified?: boolean | undefined;
+    website?: string | undefined;
     isTester?: boolean | undefined;
     canTestAdmin?: boolean | undefined;
-    publicProfile?: Record<string, import("../../..").FirestoreValue> | undefined;
+    instagram?: string | undefined;
+    facebook?: string | undefined;
+    twitter?: string | undefined;
+    linkedin?: string | undefined;
 }, {
+    role?: "user" | "seller" | "admin" | "moderator" | undefined;
     displayName?: string | undefined;
+    location?: string | undefined;
     adminNotes?: string | undefined;
+    bio?: string | undefined;
     phoneNumber?: string | undefined;
+    emailVerified?: boolean | undefined;
+    website?: string | undefined;
     isTester?: boolean | undefined;
     canTestAdmin?: boolean | undefined;
-    publicProfile?: Record<string, import("../../..").FirestoreValue> | undefined;
+    instagram?: string | undefined;
+    facebook?: string | undefined;
+    twitter?: string | undefined;
+    linkedin?: string | undefined;
 }>;
+/**
+ * The flat social/profile fields, reassembled into the nested shape the PATCH
+ * route stores.
+ *
+ * Empty strings are dropped rather than written: the drawer sends a partial
+ * PATCH so an untouched field must leave the stored subkey alone, and writing
+ * `""` would erase it. Returns `undefined` when nothing was filled in, so the
+ * key is omitted from the payload entirely.
+ */
+export declare function toPublicProfilePayload(v: {
+    bio?: string;
+    location?: string;
+    website?: string;
+    twitter?: string;
+    instagram?: string;
+    facebook?: string;
+    linkedin?: string;
+}): Record<string, JsonValue> | undefined;
 export type AdminUserUpdateValues = z.infer<typeof adminUserUpdateSchema>;
 /**
  * A store's WhatsApp Business connection.
@@ -51,6 +94,38 @@ export declare const whatsappSettingsSchema: z.ZodObject<{
     catalogId?: string | undefined;
 }>;
 export type WhatsappSettingsValues = z.infer<typeof whatsappSettingsSchema>;
+/**
+ * The CONNECTION form's fields — credentials only.
+ *
+ * `catalogSyncEnabled` is deliberately absent. Its toggle lives in a different
+ * card and owns its own write (`syncToggleMutation`), because the credentials
+ * form used to send it unconditionally from two cards away: a seller flipped
+ * the switch, saw it move, and nothing persisted it. A field in this schema is
+ * a field this form's Save button owns.
+ *
+ * 🛑 `.omit()` rather than a second literal, so the two cannot drift — it
+ * carries the SAME field instances into the new shape, which is what keeps the
+ * `annotate()` WeakMap entries alive. (A wrapper such as `.superRefine()` is
+ * transparent for the same reason; a field-level re-wrap is not.)
+ */
+export declare const whatsappConnectionSchema: z.ZodObject<Omit<{
+    catalogSyncEnabled: z.ZodBoolean;
+    phoneNumber: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    wabaId: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    catalogId: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    accessToken: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+}, "catalogSyncEnabled">, "strip", z.ZodTypeAny, {
+    phoneNumber?: string | undefined;
+    accessToken?: string | undefined;
+    wabaId?: string | undefined;
+    catalogId?: string | undefined;
+}, {
+    phoneNumber?: string | undefined;
+    accessToken?: string | undefined;
+    wabaId?: string | undefined;
+    catalogId?: string | undefined;
+}>;
+export type WhatsappConnectionValues = z.infer<typeof whatsappConnectionSchema>;
 /**
  * A buyer's lottery entry.
  *

package/dist/features/admin/schemas/admin-user-form.js

@@ -30,13 +30,26 @@
  */
 import { z } from "zod";
 import { annotate } from "../../shell/field-ui-meta";
-import { firestoreValueSchema } from "../../../schemas/firestore-value";
 const PHONE_RE = /^(\+?91[-\s]?)?[6-9]\d{9}$/;
 export const adminUserUpdateSchema = z.object({
+    /*
+     * Role and email-verification lead, because they are what an admin opens this
+     * drawer for. They were controls with no schema entry at all — the form
+     * declared a schema covering six of its twelve fields, so `Role` and
+     * `Email verified` were validated by nothing.
+     */
+    role: annotate(z.enum(["user", "seller", "admin", "moderator"]).optional(), {
+        section: "profile", sectionLabel: "Profile", sectionRequired: true, quick: true,
+        order: 1, row: "pair", kind: "select",
+    }),
+    emailVerified: annotate(z.boolean().optional(), {
+        section: "profile", quick: true, order: 2, row: "quarter",
+        label: "Email verified",
+    }),
     displayName: annotate(z.string().trim().min(1).max(120).optional(), {
-        section: "profile", sectionLabel: "Profile", sectionRequired: true, quick: true, order: 1, row: "pair",
+        section: "profile", quick: true, order: 3, row: "pair",
     }),
-    phoneNumber: annotate(z.string().trim().regex(PHONE_RE, "Enter a 10-digit Indian mobile number.").optional().or(z.literal("")), { section: "profile", order: 2, row: "pair" }),
+    phoneNumber: annotate(z.string().trim().regex(PHONE_RE, "Enter a 10-digit Indian mobile number.").optional().or(z.literal("")), { section: "profile", order: 4, row: "pair" }),
     /*
      * The tester flags. Kept OPTIONAL rather than defaulted, deliberately: a
      * PATCH that omits them must leave them alone. Defaulting either to `false`
@@ -48,17 +61,76 @@ export const adminUserUpdateSchema = z.object({
     }),
     canTestAdmin: annotate(z.boolean().optional(), {
         section: "access", order: 2, row: "quarter",
+        // The drawer already hid this behind `isTester`; stating it here is what
+        // makes `visibleValues()` drop a stale `true` when the flag is switched off.
+        when: (v) => Boolean(v.isTester),
     }),
     adminNotes: annotate(z.string().trim().max(2000).optional(), {
         section: "access", order: 3, row: "full", kind: "textarea",
         help: "Internal only — never shown to the user.",
     }),
-    // Open: the public profile carries per-user social links and bio fields that
-    // are added over time, and a closed shape would strip a newly-added one.
-    publicProfile: annotate(z.record(firestoreValueSchema).optional(), {
-        section: "access", order: 4, row: "full", kind: "list",
+    /*
+     * The public profile, FLAT — the same call the ad form makes.
+     *
+     * The STORED shape is an open record (`publicProfileSchema` on the route),
+     * because per-user profile keys are added over time and a closed shape would
+     * strip a newly-added one. That was the right conclusion for the document and
+     * the wrong one for the FORM: as one `kind: "list"` field it renders as a
+     * disabled placeholder, while the drawer has always offered seven discrete
+     * inputs — bio, location, website and four social handles — validated by
+     * nothing. The nested shape is reassembled at the payload boundary, where the
+     * API wants it, by `toPublicProfilePayload()` below.
+     */
+    bio: annotate(z.string().trim().max(1000).optional().or(z.literal("")), {
+        section: "public", sectionLabel: "Public profile", order: 1, row: "full",
+        kind: "textarea", help: "Shown on the user's public profile page.",
+    }),
+    location: annotate(z.string().trim().max(120).optional().or(z.literal("")), {
+        section: "public", order: 2, row: "pair",
+    }),
+    website: annotate(z.string().trim().max(2000).optional().or(z.literal("")), {
+        section: "public", order: 3, row: "pair", inputType: "url",
+    }),
+    twitter: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "social", sectionLabel: "Social links", order: 1, row: "pair",
+        label: "Twitter / X",
+    }),
+    instagram: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "social", order: 2, row: "pair",
+    }),
+    facebook: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "social", order: 3, row: "pair",
+    }),
+    linkedin: annotate(z.string().trim().max(200).optional().or(z.literal("")), {
+        section: "social", order: 4, row: "pair", label: "LinkedIn",
     }),
 });
+/**
+ * The flat social/profile fields, reassembled into the nested shape the PATCH
+ * route stores.
+ *
+ * Empty strings are dropped rather than written: the drawer sends a partial
+ * PATCH so an untouched field must leave the stored subkey alone, and writing
+ * `""` would erase it. Returns `undefined` when nothing was filled in, so the
+ * key is omitted from the payload entirely.
+ */
+export function toPublicProfilePayload(v) {
+    const socialLinks = {};
+    for (const key of ["twitter", "instagram", "facebook", "linkedin"]) {
+        const value = v[key]?.trim();
+        if (value)
+            socialLinks[key] = value;
+    }
+    const publicProfile = {};
+    for (const key of ["bio", "location", "website"]) {
+        const value = v[key]?.trim();
+        if (value)
+            publicProfile[key] = value;
+    }
+    if (Object.keys(socialLinks).length > 0)
+        publicProfile.socialLinks = socialLinks;
+    return Object.keys(publicProfile).length > 0 ? publicProfile : undefined;
+}
 /**
  * A store's WhatsApp Business connection.
  *
@@ -79,6 +151,23 @@ export const whatsappSettingsSchema = z.object({
     catalogId: annotate(z.string().trim().regex(/^\d{5,32}$/, "A catalog ID is a numeric id, not a URL.").optional().or(z.literal("")), { section: "connection", order: 3, row: "pair" }),
     accessToken: annotate(z.string().trim().min(20, "That access token looks truncated.").optional().or(z.literal("")), { section: "connection", order: 4, row: "full", help: "Leave blank to keep the current token." }),
 });
+/**
+ * The CONNECTION form's fields — credentials only.
+ *
+ * `catalogSyncEnabled` is deliberately absent. Its toggle lives in a different
+ * card and owns its own write (`syncToggleMutation`), because the credentials
+ * form used to send it unconditionally from two cards away: a seller flipped
+ * the switch, saw it move, and nothing persisted it. A field in this schema is
+ * a field this form's Save button owns.
+ *
+ * 🛑 `.omit()` rather than a second literal, so the two cannot drift — it
+ * carries the SAME field instances into the new shape, which is what keeps the
+ * `annotate()` WeakMap entries alive. (A wrapper such as `.superRefine()` is
+ * transparent for the same reason; a field-level re-wrap is not.)
+ */
+export const whatsappConnectionSchema = whatsappSettingsSchema.omit({
+    catalogSyncEnabled: true,
+});
 /**
  * A buyer's lottery entry.
  *

package/dist/features/admin/schemas/homepage-section-form.d.ts

@@ -20,3 +20,12 @@ export declare const homepageSectionFormSchema: z.ZodObject<{
     order?: number | undefined;
 }>;
 export type HomepageSectionFormValues = z.infer<typeof homepageSectionFormSchema>;
+/**
+ * What the FORM holds, as distinct from what the schema produces.
+ *
+ * `order` is a `z.coerce.number()`, so the parsed value is a number while the
+ * control that feeds it is a text input holding a string — including the empty
+ * string, which means "auto-place". The draft is the INPUT side; only the save
+ * path sees the output.
+ */
+export type HomepageSectionFormInput = z.input<typeof homepageSectionFormSchema>;

package/dist/features/layout/PageTabs.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+export interface PageTabDef {
+    id: string;
+    label: string;
+}
+export interface PageTabsProps {
+    /** The tabs, in order. The first is the default when `?tab=` is absent or unknown. */
+    tabs: readonly PageTabDef[];
+    /** One node per tab id. A missing entry renders an empty panel, not a crash. */
+    panels: Record<string, React.ReactNode>;
+    /**
+     * Override the default tab. Omit to use the first — which is right whenever
+     * the host page's own content is the first tab, as it is on all six.
+     */
+    defaultTabId?: string;
+}
+export declare function PageTabs({ tabs, panels, defaultTabId }: PageTabsProps): React.JSX.Element;

package/dist/features/layout/PageTabs.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * WHY: W8's C2 folds sibling pages that are one task into one tabbed page, and
+ *      four of the six hosts are SERVER components that fetch their panels'
+ *      data. Tabs need client state, so something has to sit between.
+ *
+ * WHAT: The tab strip and the panel switch, URL-synced via `?tab=`.
+ *
+ * ## 🛑 Why the tab list is DATA and the guard is derived
+ *
+ * A Server Component cannot hand a function to a Client Component — it is not
+ * serialisable, and the failure is a build error at best and a React #441 at
+ * worst (Root Cause #76). So this takes the tab ARRAY and derives the
+ * "is this a real tab id" test from it, rather than taking an `isValid`
+ * predicate the way `useTabParam` does for callers that are already clients.
+ *
+ * Panels are passed as a record of nodes, which IS serialisable: a Server
+ * Component renders both panels and hands over the results.
+ *
+ * ## Every panel is rendered, always
+ *
+ * `TabsContent` mounts all of them and shows one. That is deliberate for these
+ * six pages: the absorbed panels are small, their data was already fetched
+ * server-side by the same request, and mounting on first view would make a tab
+ * click cost a spinner for content that is already in the payload.
+ *
+ * EXPORTS: PageTabs, type PageTabDef
+ *
+ * @tag domain:layout
+ * @tag layer:component
+ * @tag pattern:none
+ * @tag access:client
+ * @tag consumers:store payouts/shipping/fulfillment/storefront,admin roles/settings
+ * @tag sideEffects:router
+ */
+import React from "react";
+import { Tabs, TabsList, TabsTrigger, TabsContent } from "../../ui";
+import { useTabParam } from "../../react/hooks/useTabParam";
+export function PageTabs({ tabs, panels, defaultTabId }) {
+    const ids = React.useMemo(() => tabs.map((t) => t.id), [tabs]);
+    const isValid = React.useCallback((value) => !!value && ids.includes(value), [ids]);
+    const [activeTab, setActiveTab] = useTabParam(isValid, defaultTabId ?? tabs[0]?.id ?? "");
+    return (_jsxs(Tabs, { value: activeTab, onChange: setActiveTab, children: [_jsx(TabsList, { children: tabs.map((tab) => (_jsx(TabsTrigger, { value: tab.id, children: tab.label }, tab.id))) }), tabs.map((tab) => (_jsx(TabsContent, { value: tab.id, children: panels[tab.id] ?? null }, tab.id)))] }));
+}

package/dist/features/products/components/GroupSettingsPanel.js

@@ -1,9 +1,9 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
-import { useEffect, useState } from "react";
+import React, { useEffect, useState } from "react";
 import { z } from "zod";
-import { Button, Code, ConfirmDeleteModal, Div, FormField, Heading, Modal, Row, Select, SideDrawer, Span, Stack, Tabs, TabsContent, TabsList, TabsTrigger, Text, useToast } from "../../../ui";
+import { Button, Code, ConfirmDeleteModal, Div, Heading, Modal, Row, SideDrawer, Span, Stack, Tabs, TabsContent, TabsList, TabsTrigger, Text, useToast } from "../../../ui";
 import { FormShellContext, useFormShellState, FormErrorSummary } from "../../../ui/forms";
 import { MediaImage } from "../../media/MediaImage";
 import { apiClient } from "../../../http";
@@ -11,13 +11,33 @@ import { PRODUCT_ENDPOINTS } from "../../../constants/api-endpoints";
 import { ProductInlineSelect } from "../../seller/components/ProductInlineSelect";
 import { SIEVE_OP, sieveFilter } from "../../../utils/sieve-builder";
 import { PRODUCT_FIELDS } from "../../../constants/field-names";
+import { annotate } from "../../shell/field-ui-meta";
+import { SectionForm, useSectionFormNav, buildSectionsFromSchema, visibleValues, } from "../../shell";
+import { applyZodIssues } from "../../../ui/forms/apply-zod-issues";
 const groupTitleSchema = z.object({
-    groupTitle: z.string().min(1, "Group title is required"),
+    groupTitle: annotate(z.string().min(1, "Group title is required"), {
+        section: "group", sectionLabel: "Group", sectionRequired: true, quick: true,
+        order: 1, row: "full", label: "Group title",
+        help: "Shown above the set on the parent listing.",
+    }),
 });
+/*
+ * `price` stays a STRING rather than `z.coerce.number()`, deliberately: the
+ * POST body sends `parseFloat(price)` and an empty numeric input coerces to
+ * `NaN`, which passes `.optional()` and lands in the payload as `null`. As a
+ * string the "enter a valid price" rule can be stated once and reported on the
+ * field.
+ */
 const createChildSchema = z.object({
-    title: z.string().min(1, "Title is required"),
-    price: z.string().refine((v) => v.trim() !== "" && !Number.isNaN(parseFloat(v)) && parseFloat(v) > 0, "Enter a valid price"),
-    condition: z.string(),
+    title: annotate(z.string().min(1, "Title is required"), {
+        section: "child", sectionLabel: "New child listing", sectionRequired: true,
+        quick: true, order: 1, row: "pair", label: "Title",
+    }),
+    price: annotate(z.string().refine((v) => v.trim() !== "" && !Number.isNaN(parseFloat(v)) && parseFloat(v) > 0, "Enter a valid price"), { section: "child", quick: true, order: 2, row: "pair", kind: "number", label: "Price (INR)" }),
+    condition: annotate(z.string(), {
+        section: "child", order: 3, row: "pair", kind: "select", label: "Condition",
+        help: "Category, brand, shipping and return policy are inherited from the parent listing.",
+    }),
 });
 const __P = {
     p4: "p-[var(--appkit-space-4)]",
@@ -34,7 +54,7 @@ export function GroupSettingsPanel({ productId, productSlug, groupId, isGroupPar
     const { showToast } = useToast();
     const [open, setOpen] = useState(false);
     const [loading, setLoading] = useState(false);
-    const [editTitle, setEditTitle] = useState(groupTitle ?? "");
+    const [titleDraft, setTitleDraft] = useState({ groupTitle: groupTitle ?? "" });
     const [showAddModal, setShowAddModal] = useState(false);
     const [addTab, setAddTab] = useState("create");
     const [createForm, setCreateForm] = useState({
@@ -45,11 +65,18 @@ export function GroupSettingsPanel({ productId, productSlug, groupId, isGroupPar
     const [linkTargets, setLinkTargets] = useState([]);
     const [children, setChildren] = useState(null);
     const [confirmAction, setConfirmAction] = useState(null);
-    const { shellCtx: titleShellCtx, validate: validateTitle } = useFormShellState(groupTitleSchema);
+    const titleSections = React.useMemo(() => buildSectionsFromSchema(groupTitleSchema), []);
+    const titleNav = useSectionFormNav(titleSections, titleDraft, { scope: "store:group-title" });
+    const titleForm = useFormShellState(groupTitleSchema, {
+        sections: titleNav.sectionMeta,
+        onGoToSection: titleNav.goToSection,
+        fieldToSectionIndex: titleNav.fieldToSectionIndex,
+    });
+    const titleShellCtx = titleForm.shellCtx;
     useEffect(() => {
-        validateTitle({ groupTitle: editTitle });
+        titleForm.validate(titleDraft);
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [editTitle, validateTitle]);
+    }, [titleDraft]);
     if (isAuction)
         return null;
     const groupEndpoint = `${storeProductsEndpoint}/${productId}/group`;
@@ -90,7 +117,7 @@ export function GroupSettingsPanel({ productId, productSlug, groupId, isGroupPar
             return;
         setLoading(true);
         try {
-            await apiClient.patch(groupEndpoint, { groupTitle: editTitle });
+            await apiClient.patch(groupEndpoint, visibleValues(groupTitleSchema, titleDraft));
             showToast("Group title saved.", "success");
             onGroupChanged();
         }
@@ -237,17 +264,36 @@ export function GroupSettingsPanel({ productId, productSlug, groupId, isGroupPar
                     setOpen(next);
                     if (next && isGroupParent && children === null)
                         loadChildren();
-                }, paddingX: "none", paddingY: "xs", justify: "between", className: "w-full text-left group", "aria-expanded": open, children: [_jsx(Heading, { level: 3, size: "sm", weight: "semibold", color: "muted", children: "Group Settings" }), _jsx(Span, { size: "xs", className: "group-hover:text-[var(--appkit-color-text-muted)] dark:group-hover:text-[var(--appkit-color-text-faint)] transition-colors", color: "faint", children: open ? "▲" : "▼" })] }), open && (_jsxs(Stack, { gap: "sm", className: `mt-3 ${__P.p4}`, surface: "muted", rounded: "lg", border: "default", children: [!groupId && !groupParentSlug && (_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", color: "muted", children: "Group related listings together \u2014 e.g. a set, bundle, or multi-part item. Parts can be sold individually but shown together." }), _jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: startGroup, isLoading: loading, children: "Start a group" })] })), isGroupParent && groupId && (_jsxs(Stack, { gap: "md", children: [_jsxs(FormShellContext.Provider, { value: titleShellCtx, children: [_jsxs(Row, { align: "start", gap: "sm", wrap: true, children: [_jsx(Div, { className: "flex-1 min-w-[200px]", children: _jsx(FormField, { name: "groupTitle", label: "Group title", type: "text", value: editTitle, onChange: setEditTitle, placeholder: "e.g. Human Toy Complete Set" }) }), _jsx(Div, { padding: "t-lg", children: _jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: saveTitle, isLoading: loading, children: "Save title" }) })] }), _jsx(FormErrorSummary, {})] }), _jsxs(Div, { children: [_jsxs(Text, { className: "mb-2", color: "muted", size: "xs", weight: "semibold", children: ["Members (", childSlugsCount + 1, " \u2014 including this listing)"] }), loading && !children ? (_jsx(Text, { size: "xs", color: "faint", children: "Loading\u2026" })) : (_jsxs(Div, { className: "divide-y divide-zinc-100 divide-[var(--appkit-color-border-subtle)]", children: [_jsxs(Row, { align: "center", gap: "sm", padding: "y-xs", children: [_jsx(Span, { padding: "pill-2xs", weight: "semibold", className: "bg-[var(--appkit-color-primary)]/10 text-[var(--appkit-color-primary)] text-[10px]", rounded: "default", children: "Parent" }), _jsx(Text, { className: "flex-1", color: "primary", size: "sm", children: productSlug })] }), (children ?? []).filter((c) => c.id !== productId).map((child) => (_jsxs(Row, { align: "center", gap: "sm", padding: "y-xs", children: [child.images?.[0] ? (_jsx(Div, { className: "relative w-8 h-8 flex-shrink-0 border border-[var(--appkit-color-border)]", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: child.images[0], alt: child.title, size: "thumbnail" }) })) : (_jsx(Div, { className: "w-8 h-8", surface: "subtle", rounded: "full" })), _jsx(Text, { className: "flex-1 truncate", color: "primary", size: "sm", children: child.title }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => requestUnlinkChild(child.id), isLoading: loading, className: `${CLS_DELETE_LINK} text-[length:var(--appkit-text-xs)]`, children: "Unlink" })] }, child.id)))] }))] }), _jsxs(Row, { gap: "sm", wrap: true, children: [_jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => setShowAddModal(true), children: "Add child listing" }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: requestDissolveGroup, isLoading: loading, className: CLS_DELETE_LINK, children: "Dissolve group" })] })] })), !isGroupParent && groupParentSlug && (_jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { size: "sm", color: "muted", children: ["Part of:", " ", _jsx(Span, { weight: "medium", color: "primary", children: groupTitle ?? groupParentSlug })] }), _jsxs(Text, { size: "xs", color: "muted", children: ["Parent listing: ", _jsx(Code, { className: "font-mono", children: groupParentSlug })] }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: requestLeaveGroup, isLoading: loading, className: `${CLS_DELETE_LINK} w-fit`, children: "Leave group" })] }))] })), (() => {
+                }, paddingX: "none", paddingY: "xs", justify: "between", className: "w-full text-left group", "aria-expanded": open, children: [_jsx(Heading, { level: 3, size: "sm", weight: "semibold", color: "muted", children: "Group Settings" }), _jsx(Span, { size: "xs", className: "group-hover:text-[var(--appkit-color-text-muted)] dark:group-hover:text-[var(--appkit-color-text-faint)] transition-colors", color: "faint", children: open ? "▲" : "▼" })] }), open && (_jsxs(Stack, { gap: "sm", className: `mt-3 ${__P.p4}`, surface: "muted", rounded: "lg", border: "default", children: [!groupId && !groupParentSlug && (_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", color: "muted", children: "Group related listings together \u2014 e.g. a set, bundle, or multi-part item. Parts can be sold individually but shown together." }), _jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: startGroup, isLoading: loading, children: "Start a group" })] })), isGroupParent && groupId && (_jsxs(Stack, { gap: "md", children: [_jsxs(FormShellContext.Provider, { value: titleShellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: titleSections, values: titleDraft, onChange: (partial) => setTitleDraft((d) => ({ ...d, ...partial })), onSubmit: () => void saveTitle(), onValidationChange: () => titleForm.validate(titleDraft), schema: groupTitleSchema, openIds: titleNav.openIds, onOpenChange: titleNav.setOpenIds, submitLabel: "Save title", isLoading: loading })] }), _jsxs(Div, { children: [_jsxs(Text, { className: "mb-2", color: "muted", size: "xs", weight: "semibold", children: ["Members (", childSlugsCount + 1, " \u2014 including this listing)"] }), loading && !children ? (_jsx(Text, { size: "xs", color: "faint", children: "Loading\u2026" })) : (_jsxs(Div, { className: "divide-y divide-zinc-100 divide-[var(--appkit-color-border-subtle)]", children: [_jsxs(Row, { align: "center", gap: "sm", padding: "y-xs", children: [_jsx(Span, { padding: "pill-2xs", weight: "semibold", className: "bg-[var(--appkit-color-primary)]/10 text-[var(--appkit-color-primary)] text-[10px]", rounded: "default", children: "Parent" }), _jsx(Text, { className: "flex-1", color: "primary", size: "sm", children: productSlug })] }), (children ?? []).filter((c) => c.id !== productId).map((child) => (_jsxs(Row, { align: "center", gap: "sm", padding: "y-xs", children: [child.images?.[0] ? (_jsx(Div, { className: "relative w-8 h-8 flex-shrink-0 border border-[var(--appkit-color-border)]", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: child.images[0], alt: child.title, size: "thumbnail" }) })) : (_jsx(Div, { className: "w-8 h-8", surface: "subtle", rounded: "full" })), _jsx(Text, { className: "flex-1 truncate", color: "primary", size: "sm", children: child.title }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => requestUnlinkChild(child.id), isLoading: loading, className: `${CLS_DELETE_LINK} text-[length:var(--appkit-text-xs)]`, children: "Unlink" })] }, child.id)))] }))] }), _jsxs(Row, { gap: "sm", wrap: true, children: [_jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => setShowAddModal(true), children: "Add child listing" }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: requestDissolveGroup, isLoading: loading, className: CLS_DELETE_LINK, children: "Dissolve group" })] })] })), !isGroupParent && groupParentSlug && (_jsxs(Stack, { gap: "xs", children: [_jsxs(Text, { size: "sm", color: "muted", children: ["Part of:", " ", _jsx(Span, { weight: "medium", color: "primary", children: groupTitle ?? groupParentSlug })] }), _jsxs(Text, { size: "xs", color: "muted", children: ["Parent listing: ", _jsx(Code, { className: "font-mono", children: groupParentSlug })] }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: requestLeaveGroup, isLoading: loading, className: `${CLS_DELETE_LINK} w-fit`, children: "Leave group" })] }))] })), (() => {
                 const content = (_jsx(AddChildContent, { addTab: addTab, setAddTab: setAddTab, createForm: createForm, setCreateForm: setCreateForm, productSlug: productSlug, storeProductsEndpoint: storeProductsEndpoint, linkTargets: linkTargets, setLinkTargets: setLinkTargets, onAddCreate: addCreateChild, onAddLink: addLinkChild, loading: loading }));
                 const close = () => setShowAddModal(false);
                 return (groupChildSlugs?.length ?? 0) >= 4 ? (_jsx(SideDrawer, { isOpen: showAddModal, onClose: close, title: "Add child listing", children: content })) : (_jsx(Modal, { open: showAddModal, onClose: close, title: "Add child listing", size: "lg", children: content }));
             })(), confirmAction && (_jsx(ConfirmDeleteModal, { isOpen: true, title: confirmAction.title, message: confirmAction.message, onConfirm: confirmAction.onConfirm, onClose: () => setConfirmAction(null), isDeleting: loading }))] }));
 }
 function AddChildContent({ addTab, setAddTab, createForm, setCreateForm, productSlug, storeProductsEndpoint, linkTargets, setLinkTargets, onAddCreate, onAddLink, loading, }) {
-    const { shellCtx, validate } = useFormShellState(createChildSchema);
+    const sections = React.useMemo(() => buildSectionsFromSchema(createChildSchema, {
+        options: { condition: CONDITION_OPTIONS },
+    }), []);
+    const nav = useSectionFormNav(sections, createForm, { scope: "store:group-add-child" });
+    const form = useFormShellState(createChildSchema, {
+        sections: nav.sectionMeta,
+        onGoToSection: nav.goToSection,
+        fieldToSectionIndex: nav.fieldToSectionIndex,
+    });
+    const shellCtx = form.shellCtx;
     useEffect(() => {
-        validate(createForm);
+        form.validate(createForm);
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [createForm, validate]);
-    return (_jsx(Stack, { gap: "md", children: _jsxs(Tabs, { value: addTab, onChange: (v) => setAddTab(v), children: [_jsxs(TabsList, { children: [_jsx(TabsTrigger, { value: "create", children: "Create new child" }), _jsx(TabsTrigger, { value: "link", children: "Link existing" })] }), _jsx(TabsContent, { value: "create", children: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsxs(Stack, { gap: "sm", className: "mt-4", children: [_jsx(FormField, { name: "title", label: "Title *", type: "text", value: createForm.title, onChange: (v) => setCreateForm({ ...createForm, title: v }), placeholder: `${productSlug}-part` }), _jsx(FormField, { name: "price", label: "Price (\u20B9) *", type: "number", value: createForm.price, onChange: (v) => setCreateForm({ ...createForm, price: v }), placeholder: "0" }), _jsx(Select, { label: "Condition", value: createForm.condition, onValueChange: (v) => setCreateForm({ ...createForm, condition: v }), options: CONDITION_OPTIONS }), _jsx(Text, { className: "dark:text-[var(--appkit-color-text-faint)]/80", color: "faint", size: "xs", children: "Other fields (category, brand, shipping, return policy) are inherited from this parent listing. Need more control? Edit the full listing after saving." }), _jsx(FormErrorSummary, {}), _jsx(Button, { type: "button", onClick: onAddCreate, isLoading: loading, disabled: !createForm.title || !createForm.price, children: "Create and link child" })] }) }) }), _jsx(TabsContent, { value: "link", children: _jsxs(Stack, { gap: "sm", className: "mt-4", children: [_jsx(Text, { size: "xs", color: "muted", children: "Search your existing products or pre-orders. Auctions cannot be linked. Select multiple to bulk-link." }), _jsx(ProductInlineSelect, { scope: "store", endpoint: storeProductsEndpoint, filters: sieveFilter(PRODUCT_FIELDS.LISTING_TYPE, SIEVE_OP.EQ, "standard"), multiple: true, value: linkTargets, onChange: setLinkTargets, placeholder: "Search listings\u2026" }), _jsx(Button, { type: "button", onClick: onAddLink, isLoading: loading, disabled: linkTargets.length === 0, children: linkTargets.length > 1 ? `Link ${linkTargets.length} to group` : "Link to group" })] }) })] }) }));
+    }, [createForm]);
+    return (_jsx(Stack, { gap: "md", children: _jsxs(Tabs, { value: addTab, onChange: (v) => setAddTab(v), children: [_jsxs(TabsList, { children: [_jsx(TabsTrigger, { value: "create", children: "Create new child" }), _jsx(TabsTrigger, { value: "link", children: "Link existing" })] }), _jsx(TabsContent, { value: "create", children: _jsx(FormShellContext.Provider, { value: shellCtx, children: _jsxs(Stack, { gap: "sm", className: "mt-4", children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: createForm, onChange: (partial) => setCreateForm({ ...createForm, ...partial }), onSubmit: () => {
+                                        // SectionForm scrolls to the first erroring section and then
+                                        // submits regardless, so the guard lives here.
+                                        form.clearErrors();
+                                        const parsed = createChildSchema.safeParse(visibleValues(createChildSchema, createForm));
+                                        if (!parsed.success) {
+                                            applyZodIssues(parsed.error.issues, form.setFieldError);
+                                            return;
+                                        }
+                                        onAddCreate();
+                                    }, onValidationChange: () => form.validate(createForm), schema: createChildSchema, openIds: nav.openIds, onOpenChange: nav.setOpenIds, submitLabel: "Create and link child", isLoading: loading }), _jsx(Text, { className: "dark:text-[var(--appkit-color-text-faint)]/80", color: "faint", size: "xs", children: "Need more control? Edit the full listing after saving." })] }) }) }), _jsx(TabsContent, { value: "link", children: _jsxs(Stack, { gap: "sm", className: "mt-4", children: [_jsx(Text, { size: "xs", color: "muted", children: "Search your existing products or pre-orders. Auctions cannot be linked. Select multiple to bulk-link." }), _jsx(ProductInlineSelect, { scope: "store", endpoint: storeProductsEndpoint, filters: sieveFilter(PRODUCT_FIELDS.LISTING_TYPE, SIEVE_OP.EQ, "standard"), multiple: true, value: linkTargets, onChange: setLinkTargets, placeholder: "Search listings\u2026" }), _jsx(Button, { type: "button", onClick: onAddLink, isLoading: loading, disabled: linkTargets.length === 0, children: linkTargets.length > 1 ? `Link ${linkTargets.length} to group` : "Link to group" })] }) })] }) }));
 }

package/dist/features/search/action-index/tab-entries.d.ts

@@ -0,0 +1,18 @@
+import type { ActionIndexEntry } from "./types";
+export interface ConsolidatedTabSurface {
+    /** Stable id suffix — `admin:tab:<slug>`. */
+    slug: string;
+    label: string;
+    description: string;
+    keywords: string[];
+    /** The host page's route key, resolved by the caller. */
+    route: "storePayouts" | "storeShipping" | "storeFulfillment" | "storeStorefront" | "adminRoles" | "adminSettings";
+    tab: string;
+    portal: "admin" | "store";
+    sectionPath: string;
+    requiredPermission?: string;
+}
+export declare const CONSOLIDATED_TAB_SURFACES: readonly ConsolidatedTabSurface[];
+/** The host page each surface now lives on. */
+export type ConsolidatedTabHrefs = Record<ConsolidatedTabSurface["route"], string>;
+export declare function deriveConsolidatedTabEntries(hrefs: ConsolidatedTabHrefs): ActionIndexEntry[];