@mohasinac/appkit 4.30.19 → 4.31.0

package/dist/features/catalogue/schemas/validation.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { annotate } from "../../shell/field-ui-meta";
 const productConditionSchema = z.enum([
     "new",
     "like_new",
@@ -11,15 +12,51 @@ const productConditionSchema = z.enum([
     "graded",
 ]);
 export const createCatalogueItemSchema = z.object({
-    title: z.string().min(1, "Title is required"),
-    description: z.string().optional(),
-    images: z.array(z.string()).default([]),
-    mainImage: z.string().optional(),
-    condition: productConditionSchema.optional(),
-    categorySlugs: z.array(z.string()).optional(),
-    brandSlug: z.string().optional(),
-    price: z.number().min(0).optional(),
-    quantity: z.number().int().min(1).default(1),
-    visibility: z.enum(["public", "private"]).default("public"),
+    title: annotate(z.string().min(1, "Title is required"), {
+        section: "basics", sectionLabel: "Item", sectionRequired: true,
+        order: 1, row: "full", label: "Title",
+    }),
+    description: annotate(z.string().optional(), {
+        section: "basics", order: 2, row: "full", kind: "textarea", label: "Description",
+    }),
+    condition: annotate(productConditionSchema.optional(), {
+        section: "basics", order: 3, row: "pair", kind: "select", label: "Condition",
+    }),
+    quantity: annotate(z.number().int().min(1).default(1), {
+        section: "basics", order: 4, row: "pair", kind: "number", label: "Quantity",
+    }),
+    /*
+     * `kind: "media"` is inferred from the field NAME (field-ui-meta.ts:336),
+     * which also sets `sectionKeepMounted` — mandatory here, because a collapsed
+     * section unmounts and would discard an in-flight upload. Declared anyway so
+     * the section id and order are not left to inference.
+     */
+    images: annotate(z.array(z.string()).default([]), {
+        section: "media", sectionLabel: "Photos", order: 1, row: "full", kind: "media",
+        sectionKeepMounted: true, label: "Photos",
+    }),
+    /*
+     * Derived from `images[0]`, never typed. Rendering it as an editable box
+     * lets a user point it at a photo they have since removed from the gallery —
+     * the field would then name an image that does not exist on the item.
+     */
+    mainImage: annotate(z.string().optional(), {
+        section: "media", order: 2, row: "full", kind: "media", label: "Main photo",
+        derived: true, tier: "t1-derive", help: "The first photo in the gallery.",
+    }),
+    categorySlugs: annotate(z.array(z.string()).optional(), {
+        section: "classification", sectionLabel: "Filing", order: 1, row: "pair",
+        label: "Categories",
+    }),
+    brandSlug: annotate(z.string().optional(), {
+        section: "classification", order: 2, row: "pair", kind: "select", label: "Brand",
+    }),
+    price: annotate(z.number().min(0).optional(), {
+        section: "pricing", sectionLabel: "Value", order: 1, row: "pair", kind: "number",
+        label: "Estimated value (₹)",
+    }),
+    visibility: annotate(z.enum(["public", "private"]).default("public"), {
+        section: "visibility", order: 1, row: "pair", kind: "select", label: "Visibility",
+    }),
 });
 export const updateCatalogueItemSchema = createCatalogueItemSchema.partial();

package/dist/features/categories/schemas/bundle-form.d.ts

@@ -0,0 +1,142 @@
+import { z } from "zod";
+/** The two member sources, as the rule-type select offers them. */
+export declare const BUNDLE_RULE_TYPE_OPTIONS: {
+    value: string;
+    label: string;
+}[];
+/**
+ * 🛑 `annotate()` must be the OUTERMOST call on each field — it keys a WeakMap
+ * by schema instance and every zod wrapper returns a new one.
+ */
+export declare const bundleFormSchema: z.ZodEffects<z.ZodObject<{
+    name: z.ZodString;
+    priceRupees: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    ruleType: z.ZodEnum<["static", "dynamic"]>;
+    productIds: z.ZodArray<z.ZodString, "many">;
+    dynamicRule: z.ZodObject<{
+        type: z.ZodLiteral<"dynamic">;
+        filter: z.ZodObject<{
+            categorySlug: z.ZodOptional<z.ZodString>;
+            brandSlug: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            listingType: z.ZodOptional<z.ZodEnum<["standard", "pre-order", "prize-draw"]>>;
+        }, "strip", z.ZodTypeAny, {
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
+            brandSlug?: string | undefined;
+            tags?: string[] | undefined;
+        }, {
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
+            brandSlug?: string | undefined;
+            tags?: string[] | undefined;
+        }>;
+        orderBy: z.ZodOptional<z.ZodEnum<["price-asc", "price-desc", "createdAt-desc"]>>;
+        limit: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "dynamic";
+        filter: {
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
+            brandSlug?: string | undefined;
+            tags?: string[] | undefined;
+        };
+        limit: number;
+        orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
+    }, {
+        type: "dynamic";
+        filter: {
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
+            brandSlug?: string | undefined;
+            tags?: string[] | undefined;
+        };
+        limit: number;
+        orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
+    }>;
+    coverImage: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    brandSlug: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    isActive: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    isActive: boolean;
+    productIds: string[];
+    priceRupees: string;
+    ruleType: "static" | "dynamic";
+    dynamicRule: {
+        type: "dynamic";
+        filter: {
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
+            brandSlug?: string | undefined;
+            tags?: string[] | undefined;
+        };
+        limit: number;
+        orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
+    };
+    brandSlug?: string | undefined;
+    description?: string | undefined;
+    coverImage?: string | undefined;
+}, {
+    name: string;
+    isActive: boolean;
+    productIds: string[];
+    priceRupees: string;
+    ruleType: "static" | "dynamic";
+    dynamicRule: {
+        type: "dynamic";
+        filter: {
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
+            brandSlug?: string | undefined;
+            tags?: string[] | undefined;
+        };
+        limit: number;
+        orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
+    };
+    brandSlug?: string | undefined;
+    description?: string | undefined;
+    coverImage?: string | undefined;
+}>, {
+    name: string;
+    isActive: boolean;
+    productIds: string[];
+    priceRupees: string;
+    ruleType: "static" | "dynamic";
+    dynamicRule: {
+        type: "dynamic";
+        filter: {
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
+            brandSlug?: string | undefined;
+            tags?: string[] | undefined;
+        };
+        limit: number;
+        orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
+    };
+    brandSlug?: string | undefined;
+    description?: string | undefined;
+    coverImage?: string | undefined;
+}, {
+    name: string;
+    isActive: boolean;
+    productIds: string[];
+    priceRupees: string;
+    ruleType: "static" | "dynamic";
+    dynamicRule: {
+        type: "dynamic";
+        filter: {
+            listingType?: "standard" | "pre-order" | "prize-draw" | undefined;
+            categorySlug?: string | undefined;
+            brandSlug?: string | undefined;
+            tags?: string[] | undefined;
+        };
+        limit: number;
+        orderBy?: "price-asc" | "price-desc" | "createdAt-desc" | undefined;
+    };
+    brandSlug?: string | undefined;
+    description?: string | undefined;
+    coverImage?: string | undefined;
+}>;
+export type BundleFormValues = z.infer<typeof bundleFormSchema>;

package/dist/features/categories/schemas/bundle-form.js

@@ -0,0 +1,149 @@
+/*
+ * WHY: `AdminBundleEditorView` declared a seven-field `.passthrough()` schema
+ *      inside the component, passed it to `<Form schema>`, and never parsed it
+ *      — the submit handler ran two hand-written `if` checks instead. So the
+ *      only rules that ever ran were "name is non-empty" and "price parses",
+ *      and the member-count bounds the form DISPLAYS (`min 3, max 16`) were
+ *      rendered as red hint text under the picker with nothing stopping a save.
+ *      A bundle with one member, or with twenty, saved cleanly.
+ * WHAT: The bundle editor's schema — the real field set, annotated for
+ *       `buildSectionsFromSchema`, with the member-count bounds as a
+ *       `superRefine` keyed on the rule type.
+ *
+ * ## `dynamicRule` is a field, not a side-car
+ *
+ * The editor held it in component state beside the schema, so `visibleValues`
+ * could not see it and the payload builder had to restate the static/dynamic
+ * branch by hand. Declaring it here is what makes "a hidden control is not
+ * sent" structural: `ruleType` switches which of the two member sources is on
+ * screen, and the same predicate decides which reaches the payload.
+ *
+ * ## Prices stay strings
+ *
+ * `priceRupees` comes from an `<input>`, so it is a string here and coerced
+ * once, in the payload builder. Coercing inside the schema would put a
+ * `Number()` at every call site, which is how a `NaN` reaches Firestore.
+ *
+ * EXPORTS:
+ *   bundleFormSchema, type BundleFormValues, BUNDLE_RULE_TYPE_OPTIONS
+ *
+ * @tag domain:categories
+ * @tag layer:schema
+ * @tag pattern:none
+ * @tag access:isomorphic
+ * @tag consumers:AdminBundleEditorView
+ * @tag sideEffects:none
+ */
+import { z } from "zod";
+import { annotate } from "../../shell/field-ui-meta";
+import { BUNDLE_COPY } from "../../../_internal/shared/features/categories/bundle-copy";
+import { BUNDLE_MIN_ITEMS, BUNDLE_MAX_ITEMS, } from "../../../_internal/shared/features/categories/bundle-config";
+/** The two member sources, as the rule-type select offers them. */
+export const BUNDLE_RULE_TYPE_OPTIONS = [
+    { value: "static", label: BUNDLE_COPY.adminEditor.ruleTypeStatic },
+    { value: "dynamic", label: BUNDLE_COPY.adminEditor.ruleTypeDynamic },
+];
+/**
+ * The dynamic rule, as `BundleDynamicRuleEditor` edits it.
+ *
+ * Mirrors the `type: "dynamic"` arm of `BundleQueryRule` so the draft can be
+ * handed to the API without a cast.
+ */
+const dynamicRuleSchema = z.object({
+    type: z.literal("dynamic"),
+    filter: z.object({
+        categorySlug: z.string().optional(),
+        brandSlug: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+        listingType: z.enum(["standard", "pre-order", "prize-draw"]).optional(),
+    }),
+    orderBy: z.enum(["price-asc", "price-desc", "createdAt-desc"]).optional(),
+    limit: z.number().int().min(1).max(50),
+});
+/**
+ * 🛑 `annotate()` must be the OUTERMOST call on each field — it keys a WeakMap
+ * by schema instance and every zod wrapper returns a new one.
+ */
+export const bundleFormSchema = z
+    .object({
+    name: annotate(z
+        .string()
+        .min(1, BUNDLE_COPY.adminEditor.errors.nameRequired)
+        .max(150, "Keep the name under 150 characters."), {
+        section: "basics", sectionLabel: "Bundle", sectionRequired: true,
+        quick: true, order: 1, row: "pair", label: "Name",
+    }),
+    priceRupees: annotate(z
+        .string()
+        .regex(/^\d+(\.\d{1,2})?$/, BUNDLE_COPY.adminEditor.errors.priceInvalid)
+        .refine((v) => Number(v) > 0, BUNDLE_COPY.adminEditor.errors.priceInvalid), {
+        section: "basics", quick: true, order: 2, row: "pair",
+        kind: "number", label: "Bundle price (₹)",
+        help: "What the buyer pays for the whole bundle — normally less than the members' total.",
+    }),
+    description: annotate(z.string().max(2000).optional().or(z.literal("")), {
+        section: "basics", order: 3, row: "full", kind: "textarea",
+        label: BUNDLE_COPY.adminEditor.fields.descriptionLabel,
+    }),
+    ruleType: annotate(z.enum(["static", "dynamic"]), {
+        section: "members", sectionLabel: BUNDLE_COPY.picker.title,
+        order: 1, row: "full", kind: "select",
+        label: BUNDLE_COPY.adminEditor.ruleTypeLabel,
+    }),
+    /*
+     * Bounded in the `superRefine` rather than with `.min()/.max()` here,
+     * because an empty picker on a DYNAMIC bundle is correct — the resolver
+     * fills the mirror. A flat `.min(3)` would block every dynamic save.
+     */
+    productIds: annotate(z.array(z.string()), {
+        section: "members", order: 2, row: "full", kind: "list",
+        label: `${BUNDLE_COPY.adminEditor.ruleTypeStatic} (${BUNDLE_MIN_ITEMS}–${BUNDLE_MAX_ITEMS})`,
+        when: (v) => v.ruleType !== "dynamic",
+    }),
+    dynamicRule: annotate(dynamicRuleSchema, {
+        section: "members", order: 3, row: "full",
+        label: BUNDLE_COPY.adminEditor.dynamic.title,
+        help: BUNDLE_COPY.adminEditor.dynamic.hint,
+        when: (v) => v.ruleType === "dynamic",
+    }),
+    coverImage: annotate(z
+        .string()
+        .url("Enter a full image URL, starting with http.")
+        .optional()
+        .or(z.literal("")), {
+        section: "media", sectionLabel: "Presentation", order: 1, row: "full",
+        inputType: "url", label: BUNDLE_COPY.adminEditor.fields.coverImageLabel,
+    }),
+    brandSlug: annotate(z.string().optional().or(z.literal("")), {
+        section: "media", order: 2, row: "pair", kind: "select", label: "Brand",
+        help: "The bundle's own brand tag — independent of how its members resolve.",
+    }),
+    isActive: annotate(z.boolean(), {
+        section: "visibility", sectionLabel: "Visibility", order: 1, row: "full",
+        label: BUNDLE_COPY.adminEditor.fields.activeLabel,
+    }),
+})
+    .superRefine((v, ctx) => {
+    /*
+     * The bounds the picker has always DISPLAYED, now enforced. They were two
+     * `<Text color="danger">` hints under the multi-select and nothing read
+     * them — a two-member bundle saved, and `listBundleMembers` rendered it as
+     * a "bundle" of two.
+     */
+    if (v.ruleType !== "static")
+        return;
+    if (v.productIds.length < BUNDLE_MIN_ITEMS) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["productIds"],
+            message: `Select at least ${BUNDLE_MIN_ITEMS} products (currently ${v.productIds.length}).`,
+        });
+    }
+    else if (v.productIds.length > BUNDLE_MAX_ITEMS) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["productIds"],
+            message: `Maximum ${BUNDLE_MAX_ITEMS} products allowed (currently ${v.productIds.length}).`,
+        });
+    }
+});

package/dist/features/classified/components/ClassifiedDetailPageView.d.ts

@@ -1,22 +1,23 @@
+import { type OfferBounds } from "../../../_internal/shared/features/offers/config";
 import type { ProductDocument } from "../../products/schemas/firestore";
 export interface ClassifiedDetailPageViewProps {
     slug: string;
     /** Pre-fetched product document — dedupes with generateMetadata() via React.cache(). */
     initialProduct?: ProductDocument | null;
     /**
-     * Render prop for offer UI, mounted inside the contact-seller panel.
+     * Render prop for the offer UI — which, on a classified, IS the purchase path.
      *
      * Deliberately the SAME shape `ProductDetailPageView.renderOfferAction` uses,
      * so both detail views share one contract and both consumer pages share one
-     * snippet. Called only when all three offer gates pass: `featureFlags.offers`,
-     * the classified type's `canMakeOffer` capability, and the seller's own
-     * `allowOffers` opt-in.
+     * snippet. `bounds` comes from `resolveOfferBounds()`, the same function
+     * `makeOffer` enforces server-side.
      */
     renderOfferAction?: (opts: {
         productId: string;
         price: number;
         currency: string;
         minOfferPercent: number;
+        bounds: OfferBounds;
     }) => React.ReactNode;
 }
 export declare function ClassifiedDetailPageView({ slug, initialProduct, renderOfferAction }: ClassifiedDetailPageViewProps): Promise<import("react").JSX.Element>;

package/dist/features/classified/components/ClassifiedDetailPageView.js

@@ -1,7 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import Link from "next/link";
 import { getClassifiedForDetail } from "../../../_internal/server/features/classified/data";
-import { startClassifiedConversationAction } from "../../../_internal/server/features/classified/actions";
 const CLS_BREADCRUMB_LINK = "hover:text-primary-600 transition-colors";
 const CLS_CLASSIFIED_BADGE = "inline-block rounded-full bg-cyan-100 dark:bg-cyan-900/30 px-[var(--appkit-space-2-5)] py-[var(--appkit-space-0-5)] text-cyan-700 dark:text-cyan-300";
 import { ROUTES } from "../../../next";
@@ -20,11 +19,9 @@ import { RelatedItemsSection } from "../../products/components/RelatedItemsSecti
 import { computeRelatedItems } from "../../../_internal/server/features/products/data";
 import { GroupedListingsCarousel } from "../../grouped/components/GroupedListingsCarousel";
 import { getGroupsWithItemsForProduct } from "../../../_internal/server/features/grouped/data";
-import { ClassifiedContactSellerPanel } from "./ClassifiedContactSellerPanel";
 import { getSiteSettingsGlobal } from "../../admin/utils/getSiteSettingsGlobal";
 import { safeRead } from "../../../errors/safe-read";
-import { canMakeOffer } from "../../../_internal/shared/listing-types/capabilities";
-import { DEFAULT_MIN_OFFER_PERCENT } from "../../../_internal/shared/features/offers/config";
+import { DEFAULT_MIN_OFFER_PERCENT, offersEnabledFor, resolveOfferBounds, } from "../../../_internal/shared/features/offers/config";
 import { ListingBottomActions } from "../../products/components/ListingBottomActions";
 function toDescriptionHtml(raw) {
     if (!raw)
@@ -68,31 +65,55 @@ export async function ClassifiedDetailPageView({ slug, initialProduct, renderOff
             fallback: null,
         }),
     ]);
-    // Classifieds are the one non-standard type where haggling is the norm, so
-    // `canMakeOffer` is true for them — but the seller still opts in per listing
-    // (`allowOffers`, usually alongside `classified.negotiable`).
-    const offersAvailable = siteSettings?.featureFlags?.offers !== false &&
-        canMakeOffer("classified") &&
-        p.allowOffers === true &&
-        price !== null &&
-        !!renderOfferAction;
+    /*
+     * The offer IS the purchase path here — classified has `cartLine: "blocked"`,
+     * and until 2026-08-31 the only other route to the seller was a `conversations`
+     * chat thread, which no longer exists.
+     *
+     * So `offersEnabledFor` does NOT require `allowOffers` on a type with no cart:
+     * unchecking it would leave the page showing a price and no way to act on it.
+     * What it controls instead is the FLOOR — a seller who did not opt into
+     * haggling gets requests to buy at their asking price, never below it. Both
+     * facts come from `resolveOfferBounds`, which `makeOffer` re-derives.
+     */
+    // Narrowed, not cast: the document's fields are `FirestoreValue`, which
+    // includes `null`, and `allowOffers` decides a money rule.
+    const allowOffers = p.allowOffers === true;
+    const offersAvailable = offersEnabledFor("classified", allowOffers) && price !== null && !!renderOfferAction;
+    const offerBounds = price !== null
+        ? resolveOfferBounds({
+            listingType: "classified",
+            listedPrice: price,
+            minOfferPercent: typeof p.minOfferPercent === "number" ? p.minOfferPercent : undefined,
+            allowOffers,
+        })
+        : null;
     return (_jsxs(Main, { children: [_jsx(HistoryTracker, { productId: String(p.id ?? p.slug ?? ""), productType: "product", snapshot: {
                     title,
                     thumb: images[0],
                     price: price ?? undefined,
                     storeId: typeof p.storeId === "string" ? p.storeId : undefined,
                     storeName: storeName ?? undefined,
-                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CLASSIFIED), className: CLS_BREADCRUMB_LINK, children: "Classifieds" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => _jsx(ProductGalleryClient, { images: images, productName: title }), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_CLASSIFIED_BADGE, children: "Classified" }), meta?.negotiable && (_jsx(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: "Negotiable" })), meta?.acceptsShipping && (_jsx(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: "Shipping available" }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: formatCurrency(price, currency) })), location && (_jsxs(Row, { color: "muted", textSize: "sm", align: "center", gap: "xs", children: [_jsx(Span, { children: "\uD83D\uDCCD" }), _jsx(Span, { children: location }), meta?.meetupArea?.pincode && _jsxs(Span, { children: ["\u00B7 ", meta.meetupArea.pincode] })] })), meta?.contactMethod && (_jsxs(Text, { size: "xs", color: "muted", children: ["Contact via: ", meta.contactMethod === "both" ? "chat or phone" : meta.contactMethod] })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(Dl, { divide: "subtle", rounded: "xl", border: "subtle", className: "overflow-hidden", children: specs.map((s, i) => (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-36 flex-shrink-0", color: "primary", weight: "medium", children: s.name }), _jsxs(Dd, { className: "flex-1", color: "muted", children: [s.value, s.unit ? ` ${s.unit}` : ""] })] }, i))) })) : undefined, customTabs: customSections.map((s) => ({
+                } }), _jsxs(Container, { size: "xl", padding: "y-lg", children: [_jsxs(Row, { className: "mb-4", align: "center", justify: "between", gap: "sm", wrap: true, children: [_jsxs(Nav, { "aria-label": "Breadcrumb", layout: "flex-wrap", gap: "2xs", textSize: "xs", color: "muted", children: [_jsx(Link, { href: String(ROUTES.HOME), className: CLS_BREADCRUMB_LINK, children: "Home" }), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CLASSIFIED), className: CLS_BREADCRUMB_LINK, children: "Classifieds" }), category && (_jsxs(_Fragment, { children: [_jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Link, { href: String(ROUTES.PUBLIC.CATEGORY_DETAIL(category)), className: CLS_BREADCRUMB_LINK, children: categoryName || category })] })), _jsx(Span, { "aria-hidden": true, children: "/" }), _jsx(Span, { className: "truncate max-w-[200px]", color: "muted", children: title })] }), _jsx(ShareButton, { title: title })] }), _jsx(PreOrderDetailView, { renderGallery: () => _jsx(ProductGalleryClient, { images: images, productName: title }), renderInfo: () => (_jsxs(Stack, { gap: "md", children: [_jsxs(Div, { children: [_jsxs(Row, { gap: "xs", wrap: true, className: "mb-2", children: [_jsx(Span, { size: "xs", weight: "semibold", className: CLS_CLASSIFIED_BADGE, children: "Classified" }), meta?.negotiable && (_jsx(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: "Negotiable" })), meta?.acceptsShipping && (_jsx(Span, { size: "xs", weight: "medium", className: "inline-block", padding: "pill-sm", rounded: "full", surface: "subtle", color: "muted", children: "Shipping available" }))] }), _jsx(Heading, { level: 1, className: "leading-snug", smSize: "2xl", color: "primary", size: "xl", weight: "bold", children: title })] }), price !== null && (_jsx(Text, { size: "2xl", weight: "bold", color: "primary", children: formatCurrency(price, currency) })), location && (_jsxs(Row, { color: "muted", textSize: "sm", align: "center", gap: "xs", children: [_jsx(Span, { children: "\uD83D\uDCCD" }), _jsx(Span, { children: location }), meta?.meetupArea?.pincode && _jsxs(Span, { children: ["\u00B7 ", meta.meetupArea.pincode] })] })), descriptionHtml && (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: "text-[length:var(--appkit-text-sm)] leading-relaxed text-[var(--appkit-color-text-muted)] line-clamp-4" })), safeSeller && (_jsx(Div, { border: "subtle", rounded: "xl", surface: "muted", padding: "md", children: _jsxs(Row, { justify: "between", align: "center", children: [_jsxs(Div, { children: [_jsx(Text, { className: "text-[10px] tracking-wide mb-0.5", color: "faint", transform: "uppercase", children: "Sold by" }), _jsx(Text, { size: "sm", weight: "semibold", color: "primary", children: safeSeller })] }), storeHref && (_jsx(Link, { href: storeHref, className: "shrink-0 rounded-lg bg-primary/10 dark:bg-primary/20 px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-xs)] font-semibold text-primary-700 dark:text-primary-300 hover:bg-primary/20 dark:hover:bg-primary/30 transition-colors", children: "Visit Store \u2192" }))] }) }))] })), renderTabs: () => (_jsx(ProductTabsShell, { descriptionContent: descriptionHtml ? (_jsx(RichText, { html: descriptionHtml, proseClass: "prose prose-sm sm:prose max-w-none dark:prose-invert", className: "text-[var(--appkit-color-text-muted)]" })) : undefined, specsContent: specs.length > 0 ? (_jsx(Dl, { divide: "subtle", rounded: "xl", border: "subtle", className: "overflow-hidden", children: specs.map((s, i) => (_jsxs(Row, { gap: "md", oddEven: "zebra", surface: "default", padding: "inline", children: [_jsx(Dt, { className: "w-36 flex-shrink-0", color: "primary", weight: "medium", children: s.name }), _jsxs(Dd, { className: "flex-1", color: "muted", children: [s.value, s.unit ? ` ${s.unit}` : ""] })] }, i))) })) : undefined, customTabs: customSections.map((s) => ({
                                 id: s.id,
                                 label: s.title,
                                 content: _jsx(CustomSectionTabContent, { section: s }),
-                            })) })), renderBuyBar: () => (_jsxs(Stack, { id: "classified-contact-bar", className: "p-[var(--appkit-space-5)]", border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: [offersAvailable &&
-                                    renderOfferAction({
+                            })) })), renderBuyBar: () => (_jsx(Stack, { id: "classified-contact-bar", className: "p-[var(--appkit-space-5)]", border: "subtle", gap: "md", rounded: "xl", surface: "muted", children: offersAvailable && offerBounds ? (_jsxs(_Fragment, { children: [renderOfferAction({
                                         productId: String(product.id),
                                         price: price,
                                         currency,
                                         minOfferPercent: typeof p.minOfferPercent === "number"
                                             ? p.minOfferPercent
                                             : DEFAULT_MIN_OFFER_PERCENT,
-                                    }), _jsx(ClassifiedContactSellerPanel, { productId: String(product.id), onContactSeller: startClassifiedConversationAction })] })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand, storeLabel: storeName ?? undefined })] })) }), _jsx(ListingBottomActions, { listingType: "classified", anchorId: "classified-contact-bar", price: price, currency: currency })] })] }));
+                                        bounds: offerBounds,
+                                    }), _jsx(Text, { size: "xs", color: "muted", children: offerBounds.isBuyRequest
+                                            ? "Send a request to buy and the seller will confirm. Payment and collection are arranged after they accept."
+                                            : "Offer what you think it's worth — the seller can accept, decline or counter." })] })) : (
+                            /*
+                             * Reachable only when the listing has no price at all: a
+                             * classified always accepts offers otherwise (see the gate
+                             * above). Saying so beats an empty bordered box, which is what
+                             * this bar rendered while the contact panel was being removed.
+                             */
+                            _jsx(Text, { size: "sm", color: "muted", children: "This listing doesn't have a price yet, so it isn't accepting offers. Check back shortly." })) })), renderRelated: () => (_jsxs(Stack, { gap: "xl", children: [_jsx(GroupedListingsCarousel, { groups: groups }), _jsx(RelatedItemsSection, { relatedItems: relatedItems, relatedByBrand: relatedByBrand, relatedByTags: relatedByTags, relatedByStore: relatedByStore, categoryLabel: categoryName || category || undefined, brandLabel: brand, storeLabel: storeName ?? undefined })] })) }), _jsx(ListingBottomActions, { listingType: "classified", anchorId: "classified-contact-bar", price: price, currency: currency })] })] }));
 }

package/dist/features/consultation/components/ConsultationForm.js

@@ -45,7 +45,7 @@ export function ConsultationForm({ onSubmit, isPending, concerns = [], }) {
     }
     return (_jsxs(Form, { schema: bookConsultationSchema, onSubmit: handleSubmit, spacing: "md", children: [_jsx(FormErrorSummary, {}), _jsx(FieldInput, { name: "name", type: "text", placeholder: "Full name", value: form.name, onChange: (v) => handleValueChange("name", v), required: true }), _jsx(FieldInput, { name: "email", type: "email", placeholder: "Email address", value: form.email, onChange: (v) => handleValueChange("email", v), required: true }), _jsx(FieldInput, { name: "phone", type: "tel", placeholder: "Phone number", value: form.phone, onChange: (v) => handleValueChange("phone", v), required: true }), concerns.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", children: concerns.map((c) => (_jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => toggleConcern(c), className: `rounded-full border px-[var(--appkit-space-3)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] transition ${form.concern.includes(c)
                         ? "border-primary bg-primary text-white"
-                        : "border-neutral-300 text-neutral-700 hover:border-primary"}`, children: c }, c))) })), _jsxs(Row, { gap: "3", children: [_jsx(FieldInput, { name: "preferredDate", type: "date", value: form.preferredDate, onChange: (v) => handleValueChange("preferredDate", v), required: true, className: "flex-1" }), _jsx(Select, { value: form.preferredTime, onValueChange: (value) => handleValueChange("preferredTime", value), options: TIME_SLOTS.map((t) => ({ value: t, label: t })), wrapperClassName: "flex-1" })] }), _jsx(Select, { value: form.mode, onValueChange: (value) => handleValueChange("mode", value), options: [
+                        : "border-neutral-300 text-neutral-700 hover:border-primary"}`, children: c }, c))) })), _jsxs(Row, { gap: "3", children: [_jsx(FieldInput, { name: "preferredDate", type: "date", value: form.preferredDate, onChange: (v) => handleValueChange("preferredDate", v), required: true, className: "flex-1" }), _jsx(Select, { name: "preferredTime", label: "Preferred time", value: form.preferredTime, onValueChange: (value) => handleValueChange("preferredTime", value), options: TIME_SLOTS.map((t) => ({ value: t, label: t })), wrapperClassName: "flex-1" })] }), _jsx(Select, { name: "mode", label: "How would you like to meet?", value: form.mode, onValueChange: (value) => handleValueChange("mode", value), options: [
                     { value: "remote", label: "Remote (Video Call)" },
                     { value: "in-person", label: "In-Person" },
                 ] }), _jsx(FieldTextarea, { name: "message", placeholder: "Any additional notes (optional)", value: form.message, onChange: (v) => handleValueChange("message", v), rows: 3 }), _jsx(Button, { type: "submit", isLoading: isPending, disabled: isPending, variant: "primary", className: "w-full", children: isPending ? "Booking..." : "Book Consultation" })] }));

package/dist/features/consultation/schemas/index.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { annotate } from "../../shell/field-ui-meta";
 export const consultationStatusSchema = z.enum([
     "pending",
     "confirmed",
@@ -36,29 +37,52 @@ export const consultationBookingSchema = z.object({
  * Form schema for submitting a new consultation booking.
  */
 export const bookConsultationSchema = z.object({
-    name: z.string().trim().min(2, "Please tell us your name.").max(120),
-    email: z
+    name: annotate(z.string().trim().min(2, "Please tell us your name.").max(120), {
+        section: "who", sectionLabel: "Your details", sectionRequired: true,
+        order: 1, row: "pair", label: "Your name",
+    }),
+    email: annotate(z
         .string()
         .trim()
         .toLowerCase()
         .min(1, "An email address is required.")
-        .email("That doesn't look like an email address."),
+        .email("That doesn't look like an email address."), { section: "who", order: 2, row: "pair", inputType: "email", label: "Email" }),
     // Same shape as the corporate enquiry's — see the note there.
-    phone: z
+    phone: annotate(z
         .string()
         .trim()
         .regex(/^(\+?91[-\s]?)?[6-9]\d{9}$/, "Enter a 10-digit Indian mobile number.")
         .optional()
-        .or(z.literal("")),
+        .or(z.literal("")), { section: "who", order: 3, row: "pair", inputType: "tel", label: "Phone" }),
     /*
      * Optional here, though the document treats it as the subject of the
      * booking: the public form does not render a concern picker, so requiring it
      * would reject every submission the form can produce. The admin-side booking
      * path is where it is set.
      */
-    concern: z.array(z.string()).optional(),
-    preferredDate: z.string().optional(),
-    preferredTime: z.string().optional(),
-    mode: consultationModeSchema.optional(),
-    message: z.string().trim().max(4000).optional(),
+    /*
+     * NOT `derived`. An earlier annotation here marked it server-owned on the
+     * strength of the comment above — and the form does render a picker for it
+     * (`ConsultationForm.tsx:92`), conditional on a `concerns` prop rather than
+     * on anything the schema can see. `kind: "list"` so the generator asks for a
+     * renderer instead of guessing, which is the honest answer for a control
+     * whose options arrive from outside the schema.
+     */
+    concern: annotate(z.array(z.string()).optional(), {
+        section: "who", order: 4, row: "full", kind: "list", label: "What do you need help with?",
+    }),
+    preferredDate: annotate(z.string().optional(), {
+        section: "schedule", sectionLabel: "When suits you",
+        order: 1, row: "pair", kind: "date", label: "Preferred date",
+    }),
+    preferredTime: annotate(z.string().optional(), {
+        section: "schedule", order: 2, row: "pair", label: "Preferred time",
+    }),
+    mode: annotate(consultationModeSchema.optional(), {
+        section: "schedule", order: 3, row: "pair", kind: "select", label: "How would you like to meet?",
+    }),
+    message: annotate(z.string().trim().max(4000).optional(), {
+        section: "detail", sectionLabel: "Anything else",
+        order: 1, row: "full", kind: "textarea", label: "Message",
+    }),
 });