@mohasinac/appkit 4.27.0 → 4.29.0

package/dist/features/events/components/event-entry-detail-fields.d.ts

@@ -0,0 +1,24 @@
+import type { EventEntryItem } from "../types";
+/**
+ * The scalar rows for one event entry.
+ *
+ * Extracted 2026-08-26 (W22) so `AdminEventEntriesView`'s detail modal and
+ * `/admin/event-entries/[id]/view` render the same thing. The list had these
+ * inline; a page that re-listed them would be a second copy, and the first
+ * field added to one and not the other is the drift.
+ *
+ * Same shape as `buildBidDetailFields` in the auctions feature — that one also
+ * takes a viewer, because a bid's bidder identity is portal-dependent. An
+ * event entry has no such split: only admins and moderators reach this at all,
+ * so there is no viewer parameter to add and adding one "for symmetry" would
+ * imply a distinction that does not exist.
+ *
+ * `formResponses` is deliberately NOT a row. It is the survey/feedback
+ * submission being judged — open-ended and often long — and belongs in the
+ * `metadata` slot, not squeezed into a definition list.
+ */
+export interface EntryFieldRow {
+    label: string;
+    value: string;
+}
+export declare function buildEventEntryDetailFields(entry: EventEntryItem): EntryFieldRow[];

package/dist/features/events/components/event-entry-detail-fields.js

@@ -0,0 +1,13 @@
+export function buildEventEntryDetailFields(entry) {
+    return [
+        { label: "Entrant", value: entry.userDisplayName ?? entry.userId ?? "—" },
+        { label: "Email", value: entry.userEmail ?? "—" },
+        { label: "Review status", value: entry.reviewStatus },
+        { label: "Points", value: entry.points != null ? String(entry.points) : "—" },
+        { label: "Raffle eligible", value: entry.raffleEligible ? "Yes" : "No" },
+        { label: "Poll votes", value: entry.pollVotes?.join(", ") || "—" },
+        { label: "Reviewed by", value: entry.reviewedBy ?? "—" },
+        { label: "Review note", value: entry.reviewNote ?? "—" },
+        { label: "Entry ID", value: entry.id },
+    ];
+}

package/dist/features/events/repository/events.repository.js

@@ -166,6 +166,7 @@ class EventRepository extends BaseRepository {
     }
 }
 EventRepository.SIEVE_FIELDS = {
+    searchTxt: { canFilter: true, canSort: false },
     type: { canFilter: true, canSort: false },
     status: { canFilter: true, canSort: true },
     title: { canFilter: true, canSort: true },

package/dist/features/events/schemas/firestore.d.ts

@@ -9,6 +9,8 @@ import type { LotteryConfig } from "../../lottery/types";
 export declare const EVENTS_COLLECTION: "events";
 export declare const EVENT_ENTRIES_COLLECTION: "eventEntries";
 export interface EventDocument extends BaseDocument {
+    /** Normalized edge-n-gram search field — see appkit/src/utils/search-txt.ts. */
+    searchTxt?: string[];
     slug?: string;
     type: EventType;
     title: string;
@@ -100,7 +102,7 @@ export type EventEntryDocument = {
     guestIpHash?: string;
     submittedAt: Date;
 };
-export declare const EVENT_INDEXED_FIELDS: readonly ["type", "status", "startsAt", "endsAt", "createdAt"];
+export declare const EVENT_INDEXED_FIELDS: readonly ["searchTxt", "type", "status", "startsAt", "endsAt", "createdAt"];
 export declare const EVENT_ENTRY_INDEXED_FIELDS: readonly ["eventId", "userId", "guestIpHash", "reviewStatus", "status", "submittedAt", "points", "spinWonAt"];
 export declare const EVENT_FIELDS: {
     readonly ID: "id";

package/dist/features/events/schemas/firestore.js

@@ -4,6 +4,7 @@
 export const EVENTS_COLLECTION = "events";
 export const EVENT_ENTRIES_COLLECTION = "eventEntries";
 export const EVENT_INDEXED_FIELDS = [
+    "searchTxt",
     "type",
     "status",
     "startsAt",

package/dist/features/faq/components/ContactCTA.js

@@ -3,7 +3,7 @@ import { Card, Div, Heading, Row, Span, Text, TextLink } from "../../../ui";
 const __P = {
     p8: "p-[var(--appkit-space-8)]",
 };
-const CLS_CONTACT_CARD = "flex items-center gap-[var(--appkit-space-3)] rounded-lg border border-zinc-100 border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface-elevated)] px-[var(--appkit-space-4)] py-[var(--appkit-space-3)] hover:border-primary/40 transition-colors";
+const CLS_CONTACT_CARD = "flex items-center gap-[var(--appkit-space-3)] rounded-lg border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface-elevated)] px-[var(--appkit-space-4)] py-[var(--appkit-space-3)] hover:border-primary/40 transition-colors";
 const CLS_CONTACT_LABEL = "text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)]";
 export function ContactCTA({ email, phone, contactHref, labels, }) {
     return (_jsxs(Card, { variant: "outlined", padding: "lg", className: "text-center", children: [_jsx(Row, { className: "mb-6", justify: "center", children: _jsx(Div, { className: `bg-primary/10 ${__P.p8}`, rounded: "full", children: _jsx("svg", { className: "h-12 w-12 text-primary", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M3 8l7.89 5.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" }) }) }) }), _jsx(Heading, { level: 2, className: "mb-3", size: "2xl", weight: "semibold", children: labels?.title ?? "Need More Help?" }), _jsx(Text, { className: "mx-auto mb-6 max-w-2xl", color: "muted", children: labels?.description ?? "Our support team is here to help you." }), _jsxs(Div, { layout: "grid", gap: "4", className: "mb-8 grid-cols-1 md:grid-cols-3", children: [_jsxs(TextLink, { href: `mailto:${email}`, variant: "none", className: CLS_CONTACT_CARD, children: [_jsx(Text, { className: CLS_CONTACT_LABEL, children: labels?.emailUs ?? "Email Us" }), _jsx(Text, { size: "xs", color: "muted", children: email })] }), _jsxs(TextLink, { href: `tel:${phone}`, variant: "none", className: CLS_CONTACT_CARD, children: [_jsx(Text, { className: CLS_CONTACT_LABEL, children: labels?.callUs ?? "Call Us" }), _jsx(Text, { size: "xs", color: "muted", children: phone })] }), _jsxs(TextLink, { href: contactHref, className: CLS_CONTACT_CARD, children: [_jsx(Text, { className: CLS_CONTACT_LABEL, children: labels?.contactForm ?? "Contact Form" }), _jsx(Text, { size: "xs", color: "muted", children: labels?.submitRequest ?? "Submit a request" })] })] }), _jsxs(TextLink, { rounded: "xl", href: contactHref, layout: "inline-flex", align: "center", gap: "sm", className: "bg-primary p-[1.5rem] text-white transition-colors hover:bg-primary/90", weight: "medium", children: [_jsx(Span, { children: labels?.contactTeam ?? "Contact Team" }), _jsx("svg", { className: "h-5 w-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M9 5l7 7-7 7" }) })] })] }));

package/dist/features/faq/components/FAQHelpfulButtons.js

@@ -44,9 +44,9 @@ export function FAQHelpfulButtons({ faqId, initialHelpful, initialNotHelpful, on
                             ? "bg-success-solid text-success-on-solid"
                             : userVote
                                 ? "cursor-not-allowed bg-zinc-200 text-[var(--appkit-color-text-muted)] opacity-50 dark:bg-slate-600 text-[var(--appkit-color-text-muted)]"
-                                : "bg-[var(--appkit-color-surface)] text-zinc-800 hover:bg-green-50 bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text)] dark:hover:bg-green-900/20"}`, children: [_jsx(Span, { size: "sm", children: labels?.yes ?? "Yes" }), _jsxs(Span, { size: "sm", color: "muted", children: ["(", helpful, ")"] })] }), _jsxs(Button, { variant: "ghost", onClick: () => handleVote(false), disabled: isPending || userVote !== null, className: `flex-1 gap-[var(--appkit-space-2)] rounded-lg p-[var(--appkit-space-4)] transition-all ${userVote === "not-helpful"
+                                : "bg-[var(--appkit-color-surface)] hover:bg-success-surface bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text)]"}`, children: [_jsx(Span, { size: "sm", children: labels?.yes ?? "Yes" }), _jsxs(Span, { size: "sm", color: "muted", children: ["(", helpful, ")"] })] }), _jsxs(Button, { variant: "ghost", onClick: () => handleVote(false), disabled: isPending || userVote !== null, className: `flex-1 gap-[var(--appkit-space-2)] rounded-lg p-[var(--appkit-space-4)] transition-all ${userVote === "not-helpful"
                             ? "bg-error-solid text-error-on-solid"
                             : userVote
                                 ? "cursor-not-allowed bg-zinc-200 text-[var(--appkit-color-text-muted)] opacity-50 dark:bg-slate-600 text-[var(--appkit-color-text-muted)]"
-                                : "bg-[var(--appkit-color-surface)] text-zinc-800 hover:bg-red-50 bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text)] dark:hover:bg-red-900/20"}`, children: [_jsx(Span, { size: "sm", children: labels?.no ?? "No" }), _jsxs(Span, { size: "sm", color: "muted", children: ["(", notHelpful, ")"] })] })] })] }));
+                                : "bg-[var(--appkit-color-surface)] hover:bg-error-surface bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text)]"}`, children: [_jsx(Span, { size: "sm", children: labels?.no ?? "No" }), _jsxs(Span, { size: "sm", color: "muted", children: ["(", notHelpful, ")"] })] })] })] }));
 }

package/dist/features/faq/repository/faqs.repository.d.ts

@@ -15,10 +15,25 @@ export declare class FAQsRepository {
     update(id: string, data: Partial<FAQ>): Promise<FAQ>;
     delete(id: string): Promise<void>;
 }
+/**
+ * FAQ `searchTxt`. Exported so the seed derives byte-identical tokens — the
+ * seed writes documents raw via batch.set() and never goes through this
+ * repository, which is exactly why all 63 seeded FAQs had no tokens at all.
+ *
+ * EVERY field is prefix-expanded, including the answer body. An earlier version
+ * whole-worded the body to protect the token budget, and a seed test caught what
+ * that costs: searching "ship" returned FEWER FAQs than "shipping", because an
+ * answer mentioning shipping had only the whole word indexed. Partial match that
+ * silently excludes the body is not partial match.
+ *
+ * Measured over the real seed corpus: max 449 tokens, average 200, nothing near
+ * the 600 cap — so nothing is truncated. Re-measure before reusing this shape on
+ * a long-form collection (blog posts), where bodies are far larger.
+ */
+export declare function buildFaqSearchTxt(input: Partial<FAQDocument>): string[];
 export declare class FirebaseFAQsRepository extends BaseRepository<FAQDocument> {
     static readonly SIEVE_FIELDS: FirebaseSieveFields;
     constructor();
-    private buildSearchTokens;
     create(data: Partial<FAQDocument>): Promise<FAQDocument>;
     update(id: string, data: Partial<FAQDocument>): Promise<FAQDocument>;
     list(model: SieveModel, opts?: {

package/dist/features/faq/repository/faqs.repository.js

@@ -2,6 +2,7 @@ import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../..
 import { DatabaseError } from "../../../errors";
 import { increment } from "../../../contracts/field-ops";
 import { FAQ_FIELDS } from "../../../constants/field-names";
+import { buildSearchTxt, matchesAllSearchTerms, parseSearchTxtQuery, } from "../../../utils/search-txt";
 import { FAQS_COLLECTION, createFAQId, slugifyQuestion, } from "../schemas";
 export class FAQsRepository {
     constructor(repo) {
@@ -51,38 +52,39 @@ export class FAQsRepository {
         return this.repo.delete(id);
     }
 }
+/**
+ * FAQ `searchTxt`. Exported so the seed derives byte-identical tokens — the
+ * seed writes documents raw via batch.set() and never goes through this
+ * repository, which is exactly why all 63 seeded FAQs had no tokens at all.
+ *
+ * EVERY field is prefix-expanded, including the answer body. An earlier version
+ * whole-worded the body to protect the token budget, and a seed test caught what
+ * that costs: searching "ship" returned FEWER FAQs than "shipping", because an
+ * answer mentioning shipping had only the whole word indexed. Partial match that
+ * silently excludes the body is not partial match.
+ *
+ * Measured over the real seed corpus: max 449 tokens, average 200, nothing near
+ * the 600 cap — so nothing is truncated. Re-measure before reusing this shape on
+ * a long-form collection (blog posts), where bodies are far larger.
+ */
+export function buildFaqSearchTxt(input) {
+    const answer = typeof input.answer === "string" ? input.answer : (input.answer?.text ?? "");
+    return buildSearchTxt([
+        input.question,
+        input.category,
+        ...(input.tags ?? []),
+        answer.replace(/<[^>]+>/g, " "),
+    ]);
+}
 export class FirebaseFAQsRepository extends BaseRepository {
     constructor() {
         super(FAQS_COLLECTION);
     }
-    buildSearchTokens(input) {
-        const rawText = [
-            input.question,
-            typeof input.answer === "string" ? input.answer : input.answer?.text,
-            input.category,
-            ...(input.tags ?? []),
-        ]
-            .filter(Boolean)
-            .join(" ")
-            .toLowerCase();
-        return Array.from(new Set(rawText
-            .split(/[^a-z0-9]+/i)
-            .map((token) => token.trim())
-            .filter((token) => token.length >= 2))).slice(0, 50);
-    }
     async create(data) {
-        const searchTokens = this.buildSearchTokens({
-            question: data.question ?? "",
-            answer: data.answer ?? {
-                text: "",
-                format: "plain",
-            },
-            tags: data.tags ?? [],
-            category: (data.category ?? "general"),
-        });
+        const searchTxt = buildFaqSearchTxt(data);
         return super.create({
             ...data,
-            searchTokens,
+            searchTxt,
         });
     }
     async update(id, data) {
@@ -96,39 +98,52 @@ export class FirebaseFAQsRepository extends BaseRepository {
         };
         return super.update(id, {
             ...data,
-            searchTokens: this.buildSearchTokens({
-                question: merged.question,
-                answer: merged.answer,
-                tags: merged.tags ?? [],
-                category: merged.category,
-            }),
+            searchTxt: buildFaqSearchTxt(merged),
         });
     }
     async list(model, opts) {
         let baseQuery = this.getCollection();
         const tags = opts?.tags?.filter(Boolean) ?? [];
-        const searchTokens = (opts?.search ?? "")
-            .toLowerCase()
-            .split(/[^a-z0-9]+/i)
-            .map((token) => token.trim())
-            .filter((token) => token.length >= 2)
-            .slice(0, 10);
-        if (tags.length > 0 && searchTokens.length > 0) {
-            throw new DatabaseError("Combining FAQ tag filters and token search requires a dedicated search index");
+        // Longest term first — only ONE may become the array-contains clause
+        // (Firestore permits a single array operator per query), and the longest is
+        // the cheapest proxy for "narrows the most" without cardinality stats.
+        const terms = parseSearchTxtQuery(opts?.search ?? "");
+        const rawSearch = (opts?.search ?? "").trim();
+        // A query that produced no usable term must return NOTHING, not everything.
+        // The old guard dropped tokens under 2 characters, so a 1-character search
+        // silently fell through to the entire unfiltered list.
+        if (rawSearch && terms.length === 0) {
+            return { items: [], total: 0, page: 1, pageSize: 0, totalPages: 0, hasMore: false };
         }
-        if (tags.length === 1) {
+        // Firestore allows one array operator per query, so tags and search cannot
+        // both be pushed down. Search takes the clause and tags refine in memory —
+        // this used to throw a DatabaseError and fail the request outright.
+        const pushTags = terms.length === 0;
+        if (pushTags && tags.length === 1) {
             baseQuery = baseQuery.where(FAQ_FIELDS.TAGS, "array-contains", tags[0]);
         }
-        else if (tags.length > 1) {
+        else if (pushTags && tags.length > 1) {
             baseQuery = baseQuery.where(FAQ_FIELDS.TAGS, "array-contains-any", tags.slice(0, 10));
         }
-        if (searchTokens.length === 1) {
-            baseQuery = baseQuery.where(FAQ_FIELDS.SEARCH_TOKENS, "array-contains", searchTokens[0]);
+        if (terms.length > 0) {
+            baseQuery = baseQuery.where(FAQ_FIELDS.SEARCH_TXT, "array-contains", terms[0]);
         }
-        else if (searchTokens.length > 1) {
-            baseQuery = baseQuery.where(FAQ_FIELDS.SEARCH_TOKENS, "array-contains-any", searchTokens);
-        }
-        return this.sieveQuery(model, FirebaseFAQsRepository.SIEVE_FIELDS, { baseQuery });
+        const result = await this.sieveQuery(model, FirebaseFAQsRepository.SIEVE_FIELDS, { baseQuery });
+        // Refine the remaining terms (AND) and any tags that could not be pushed
+        // down. `array-contains-any` would have been OR — "shipping cost" returning
+        // everything matching either word is why search felt like it did nothing.
+        const extraTerms = terms.slice(1);
+        if (extraTerms.length === 0 && (pushTags || tags.length === 0))
+            return result;
+        const items = result.items.filter((faq) => matchesAllSearchTerms(faq.searchTxt, extraTerms) &&
+            (pushTags || tags.length === 0 || tags.some((t) => faq.tags?.includes(t))));
+        return {
+            ...result,
+            items,
+            total: items.length,
+            totalPages: items.length === 0 ? 0 : 1,
+            hasMore: false,
+        };
     }
     async getFAQBySlug(slug) {
         const snapshot = await this.db
@@ -248,12 +263,7 @@ export class FirebaseFAQsRepository extends BaseRepository {
                 ...input.seo,
                 slug,
             },
-            searchTokens: this.buildSearchTokens({
-                question: input.question,
-                answer: input.answer,
-                tags: input.tags ?? [],
-                category: input.category,
-            }),
+            searchTxt: buildFaqSearchTxt(input),
             stats: {
                 views: 0,
                 helpful: 0,
@@ -293,7 +303,7 @@ FirebaseFAQsRepository.SIEVE_FIELDS = {
     order: { canFilter: true, canSort: true },
     priority: { canFilter: true, canSort: true },
     tags: { canFilter: true, canSort: false },
-    searchTokens: { canFilter: true, canSort: false },
+    searchTxt: { canFilter: true, canSort: false },
     "stats.helpful": { canFilter: false, canSort: true },
     createdAt: { canFilter: true, canSort: true, parseValue: parseSieveDateValue },
 };

package/dist/features/faq/schemas/firestore.d.ts

@@ -19,7 +19,8 @@ export interface FAQDocument extends BaseDocument {
     order: number;
     priority: number;
     tags: string[];
-    searchTokens?: string[];
+    /** Normalized edge-n-gram search field. Replaced `searchTokens`. */
+    searchTxt?: string[];
     relatedFAQs: string[];
     useSiteSettings: boolean;
     variables?: Record<string, string>;
@@ -31,7 +32,7 @@ export interface FAQDocument extends BaseDocument {
     createdBy: string;
 }
 export declare const FAQS_COLLECTION: "faqs";
-export declare const FAQS_INDEXED_FIELDS: readonly ["slug", "seo.slug", "category", "order", "showOnHomepage", "showInFooter", "isPinned", "priority", "tags", "searchTokens", "isActive", "stats.helpful", "createdBy", "createdAt"];
+export declare const FAQS_INDEXED_FIELDS: readonly ["slug", "seo.slug", "category", "order", "showOnHomepage", "showInFooter", "isPinned", "priority", "tags", "searchTxt", "isActive", "stats.helpful", "createdBy", "createdAt"];
 export declare const FAQ_CATEGORY_LABELS: Record<FAQCategory, string>;
 export declare const DEFAULT_FAQ_DATA: Partial<FAQDocument>;
 export declare const FAQS_PUBLIC_FIELDS: readonly ["id", "question", "answer", "category", "showOnHomepage", "showInFooter", "isPinned", "order", "priority", "tags", "relatedFAQs", "stats.views", "stats.helpful", "stats.notHelpful", "seo.slug", "seo.metaTitle", "seo.metaDescription", "isActive", "createdAt"];

package/dist/features/faq/schemas/firestore.js

@@ -13,7 +13,7 @@ export const FAQS_INDEXED_FIELDS = [
     "isPinned",
     "priority",
     "tags",
-    "searchTokens",
+    "searchTxt",
     "isActive",
     "stats.helpful",
     "createdBy",
@@ -36,7 +36,7 @@ export const DEFAULT_FAQ_DATA = {
     order: 0,
     priority: 0,
     tags: [],
-    searchTokens: [],
+    searchTxt: [],
     relatedFAQs: [],
     useSiteSettings: true,
     variables: {},

package/dist/features/faq/schemas/index.d.ts

@@ -228,7 +228,7 @@ export declare const faqFirestoreSchema: z.ZodObject<{
     order: z.ZodNumber;
     priority: z.ZodNumber;
     tags: z.ZodArray<z.ZodString, "many">;
-    searchTokens: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    searchTxt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     relatedFAQs: z.ZodArray<z.ZodString, "many">;
     useSiteSettings: z.ZodBoolean;
     variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -310,7 +310,7 @@ export declare const faqFirestoreSchema: z.ZodObject<{
         metaTitle?: string | undefined;
         metaDescription?: string | undefined;
     };
-    searchTokens?: string[] | undefined;
+    searchTxt?: string[] | undefined;
     variables?: Record<string, string> | undefined;
 }, {
     id: string;
@@ -349,7 +349,7 @@ export declare const faqFirestoreSchema: z.ZodObject<{
         metaTitle?: string | undefined;
         metaDescription?: string | undefined;
     };
-    searchTokens?: string[] | undefined;
+    searchTxt?: string[] | undefined;
     variables?: Record<string, string> | undefined;
 }>;
 export type FAQFromSchema = z.infer<typeof faqFirestoreSchema>;

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

@@ -85,7 +85,7 @@ export const faqFirestoreSchema = z.object({
     order: z.number().int(),
     priority: z.number().int(),
     tags: z.array(z.string()),
-    searchTokens: z.array(z.string()).optional(),
+    searchTxt: z.array(z.string()).optional(),
     relatedFAQs: z.array(z.string()),
     useSiteSettings: z.boolean(),
     variables: z.record(z.string(), z.string()).optional(),

package/dist/features/filters/FilterFacetSection.js

@@ -77,9 +77,9 @@ export function FilterFacetSection({ title, options, selected, onChange, selecti
     if (displayAs === "dropdown") {
         return (_jsxs(Div, { ref: dropdownRef, className: cn("relative inline-block", className), children: [_jsxs(Button, { type: "button", onClick: () => setDropdownOpen((o) => !o), variant: "ghost", className: cn("inline-flex items-center gap-[var(--appkit-space-1-5)] rounded-full border px-[var(--appkit-space-3)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-sm)] font-medium transition-colors", hasValue
                         ? CLS_OPTION_SELECTED
-                        : "border-zinc-200 bg-[var(--appkit-color-surface)] text-zinc-700 hover:border-zinc-400 border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] text-[var(--appkit-color-text-muted)] hover:border-[var(--appkit-color-border)]"), children: [title, hasValue && (_jsx(Span, { weight: "bold", className: CLS_OPTION_DOT, children: selected.length })), _jsx("svg", { className: cn("h-3.5 w-3.5 text-zinc-400 transition-transform", dropdownOpen ? "rotate-180" : ""), fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2, "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M19 9l-7 7-7-7" }) })] }), dropdownOpen && (_jsxs(Div, { className: "absolute left-0 top-full z-[var(--appkit-z-dropdown,50)] mt-1 min-w-[180px] max-w-[260px]", surface: "default", rounded: "xl", shadow: "lg", border: "default", children: [searchable && (_jsx(Div, { border: "subtle", className: "border-b", padding: "xs", children: _jsx(Input, { type: "search", placeholder: "Search\u2026", value: search, onChange: (e) => handleSearch(e.target.value), className: "w-full rounded-md border px-[var(--appkit-space-2)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] focus:outline-none border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface-input)] text-[var(--appkit-color-text)]" }) })), _jsxs(Div, { className: `max-h-56 ${__O.yAuto}`, padding: "y-2xs", children: [filtered.map((option) => {
+                        : " bg-[var(--appkit-color-surface)] hover:border-zinc-400 border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] text-[var(--appkit-color-text-muted)] hover:border-[var(--appkit-color-border)]"), children: [title, hasValue && (_jsx(Span, { weight: "bold", className: CLS_OPTION_DOT, children: selected.length })), _jsx("svg", { className: cn("h-3.5 w-3.5 text-zinc-400 transition-transform", dropdownOpen ? "rotate-180" : ""), fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", strokeWidth: 2, "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M19 9l-7 7-7-7" }) })] }), dropdownOpen && (_jsxs(Div, { className: "absolute left-0 top-full z-[var(--appkit-z-dropdown,50)] mt-1 min-w-[180px] max-w-[260px]", surface: "default", rounded: "xl", shadow: "lg", border: "default", children: [searchable && (_jsx(Div, { border: "subtle", className: "border-b", padding: "xs", children: _jsx(Input, { type: "search", placeholder: "Search\u2026", value: search, onChange: (e) => handleSearch(e.target.value), className: "w-full rounded-md border px-[var(--appkit-space-2)] py-[var(--appkit-space-1)] text-[length:var(--appkit-text-xs)] focus:outline-none border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface-input)] text-[var(--appkit-color-text)]" }) })), _jsxs(Div, { className: `max-h-56 ${__O.yAuto}`, padding: "y-2xs", children: [filtered.map((option) => {
                                     const isSelected = selected.includes(option.value);
-                                    return (_jsxs(Row, { gap: "xs", className: "cursor-pointer py-[0.375rem] hover:bg-[var(--appkit-color-bg)] mx-1", padding: "x-sm", rounded: "lg", onClick: () => toggle(option.value), children: [_jsx(Checkbox, { bare: true, type: selectionMode === "single" ? "radio" : "checkbox", checked: isSelected, onChange: () => toggle(option.value), "aria-label": option.label, className: "h-3.5 w-3.5 flex-shrink-0 cursor-pointer rounded border-zinc-300 text-primary-600 border-[var(--appkit-color-border)] dark:text-secondary-500" }), _jsx(Span, { size: "xs", className: "flex-1 truncate", color: "muted", children: option.label }), option.count !== undefined && (_jsx(Span, { className: "flex-shrink-0 text-[10px] tabular-nums", color: "faint", children: option.count }))] }, option.value));
+                                    return (_jsxs(Row, { gap: "xs", className: "cursor-pointer py-[0.375rem] hover:bg-[var(--appkit-color-bg)] mx-1", padding: "x-sm", rounded: "lg", onClick: () => toggle(option.value), children: [_jsx(Checkbox, { bare: true, type: selectionMode === "single" ? "radio" : "checkbox", checked: isSelected, onChange: () => toggle(option.value), "aria-label": option.label, className: "h-3.5 w-3.5 flex-shrink-0 cursor-pointer rounded text-primary-600 border-[var(--appkit-color-border)] dark:text-secondary-500" }), _jsx(Span, { size: "xs", className: "flex-1 truncate", color: "muted", children: option.label }), option.count !== undefined && (_jsx(Span, { className: "flex-shrink-0 text-[10px] tabular-nums", color: "faint", children: option.count }))] }, option.value));
                                 }), filtered.length === 0 && (_jsx(Text, { paddingY: "xs", paddingX: "x-sm", color: "faint", size: "xs", children: "No results" }))] }), hasValue && (_jsx(Div, { border: "subtle", className: "border-t p-[0.25rem]", children: _jsx(Button, { type: "button", variant: "ghost", size: "sm", className: CLS_CLEAR_BTN, onClick: () => { onChange([]); onClear?.(); setDropdownOpen(false); }, children: "Clear" }) }))] }))] }));
     }
     // ── Accordion variant (default) ─────────────────────────────────────────

package/dist/features/forms/Toggle.js

@@ -45,7 +45,7 @@ export function Toggle({ checked: controlledChecked, defaultChecked = false, onC
     const cfg = SIZE_CONFIG[size];
     return (_jsxs(Row, { className: cn("gap-3", className), children: [_jsx(Button, { type: "button", role: "switch", id: toggleId, "aria-checked": checked, disabled: disabled, onClick: handleChange, className: cn("relative inline-flex items-center rounded-full transition-colors duration-200 focus:outline-none focus:ring-2 focus:ring-primary-500/30 dark:focus:ring-secondary-400/30 focus:ring-offset-2 dark:focus:ring-offset-slate-900", cfg.track, checked
                     ? "bg-primary-600 dark:bg-secondary-500"
-                    : "bg-zinc-200 bg-[var(--appkit-color-border)]", disabled && "opacity-50 cursor-not-allowed"), children: _jsx(Span, { className: cn("inline-block rounded-full bg-[var(--appkit-color-surface)] shadow-sm transition-transform duration-200", cfg.thumb, checked ? cfg.translateOn : cfg.translateOff) }) }), label && (_jsx("label", { htmlFor: toggleId, className: cn("text-sm font-medium cursor-pointer select-none", checked
+                    : " bg-[var(--appkit-color-border)]", disabled && "opacity-50 cursor-not-allowed"), children: _jsx(Span, { className: cn("inline-block rounded-full bg-[var(--appkit-color-surface)] shadow-sm transition-transform duration-200", cfg.thumb, checked ? cfg.translateOn : cfg.translateOff) }) }), label && (_jsx("label", { htmlFor: toggleId, className: cn("text-sm font-medium cursor-pointer select-none", checked
                     ? "text-[var(--appkit-color-text)]"
                     : "text-[var(--appkit-color-text-muted)]", disabled && "opacity-50 cursor-not-allowed"), children: label }))] }));
 }

package/dist/features/grouped/components/GroupedListingEditorView.d.ts

@@ -0,0 +1,18 @@
+import React from "react";
+type Scope = "admin" | "store";
+export interface GroupedListingEditorViewProps {
+    scope: Scope;
+    /** Present → edit that group; absent → create a new one. */
+    groupId?: string;
+    /**
+     * Store the group belongs to. Required for admin CREATE (an admin owns no
+     * store, so there is nothing to derive it from); ignored on the seller side,
+     * where the route reads it from the session and a body value would let a
+     * seller file a group under someone else's store.
+     */
+    fixedStoreId?: string;
+    onSaved?: (id: string) => void;
+    onCancel?: () => void;
+}
+export declare function GroupedListingEditorView({ scope, groupId, fixedStoreId, onSaved, onCancel, }: GroupedListingEditorViewProps): React.JSX.Element;
+export {};

package/dist/features/grouped/components/GroupedListingEditorView.js

@@ -0,0 +1,192 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * WHY: There were TWO hand-rolled grouped-listing forms (the seller's `new` and
+ *      `[id]/edit` pages), between them covering 5 of the entity's 8 fields —
+ *      `productIds` was hardcoded to `[]` on create, and `minActiveMembers` and
+ *      `coverImage` could not be set anywhere at all. Admin had no form.
+ * WHAT: One editor for both portals, deriving its sections from
+ *       `groupedListingFormSchema` so a field added to the schema appears here
+ *       without a second edit.
+ *
+ * ## The admin API was the blocker, not this component
+ *
+ * Pointing an editor at the admin endpoints used to give: create → 405 (there
+ * was no admin POST), and every save of `title`/`groupTheme`/`isActive` → a
+ * 200 that wrote nothing, because the admin PATCH schema was
+ * `z.object({ productIds })` and `z.object()` strips unknown keys. That is
+ * Root Cause #40's exact shape — a success response is what the broken version
+ * returns, so only a reload reveals it. Both were fixed alongside this file;
+ * an `endpointOverride` on the seller form could never have worked.
+ *
+ * ## Two fields are overridden, the other six are derived
+ *
+ * `productIds` needs the real product search (`ProductInlineSelect`), and admin
+ * create needs a store picker — a grouped listing is store-owned and the seller
+ * route takes `storeId` from the session, which an admin has no equivalent of.
+ * Everything else comes from `buildSectionsFromSchema`.
+ *
+ * EXPORTS: GroupedListingEditorView, type GroupedListingEditorViewProps
+ *
+ * @tag domain:grouped
+ * @tag layer:feature
+ * @tag pattern:slot-shell
+ * @tag access:client
+ * @tag consumers:admin/grouped-listings pages,store/grouped-listings pages
+ * @tag sideEffects:network
+ */
+import React from "react";
+import { useQuery } from "@tanstack/react-query";
+import { useRouter } from "next/navigation";
+import { Stack, Text, useToast } from "../../../ui";
+import { FieldSelect, FormShellContext, FormErrorSummary, applyZodIssues, useFormShellState, } from "../../../ui/forms";
+import { SectionForm, useSectionFormNav } from "../../shell";
+import { buildSectionsFromSchema } from "../../shell/build-sections";
+import { apiClient } from "../../../http";
+import { ADMIN_ENDPOINTS, SELLER_ENDPOINTS } from "../../../constants/api-endpoints";
+import { ROUTES } from "../../../next/routing/route-map";
+import { normalizeError } from "../../../errors/normalize";
+import { ProductInlineSelect } from "../../seller/components/ProductInlineSelect";
+import { groupedListingFormSchema, } from "../schemas/grouped-listing-form";
+const EMPTY = {
+    title: "",
+    description: "",
+    groupTheme: "generic",
+    productIds: [],
+    minActiveMembers: 1,
+    coverImage: "",
+    isActive: true,
+    isFeatured: false,
+};
+export function GroupedListingEditorView({ scope, groupId, fixedStoreId, onSaved, onCancel, }) {
+    const router = useRouter();
+    const { showToast } = useToast();
+    const isEdit = Boolean(groupId);
+    const isAdmin = scope === "admin";
+    const listEndpoint = isAdmin ? ADMIN_ENDPOINTS.GROUPED_LISTINGS : SELLER_ENDPOINTS.GROUPED_LISTINGS;
+    const byIdEndpoint = isAdmin
+        ? ADMIN_ENDPOINTS.GROUPED_LISTING_BY_ID
+        : SELLER_ENDPOINTS.GROUPED_LISTING_BY_ID;
+    const [values, setValues] = React.useState(EMPTY);
+    const [storeId, setStoreId] = React.useState(fixedStoreId ?? "");
+    const [saving, setSaving] = React.useState(false);
+    /*
+     * Seeded from the single-item GET, never from a cached list row — a list
+     * projection is narrower than the document, and an editor seeded from one
+     * re-sends the fields it never received as their defaults (Root Cause #38).
+     */
+    const existing = useQuery({
+        queryKey: [scope, "grouped-listing", groupId],
+        queryFn: async () => {
+            const res = await apiClient.get(byIdEndpoint(groupId));
+            const body = res?.data ?? res;
+            // The admin GET wraps in `{ item }`; the seller GET returns the doc.
+            return (body?.item ?? body);
+        },
+        enabled: isEdit,
+    });
+    // Admin create only: an admin has no session store to derive the owner from.
+    const stores = useQuery({
+        queryKey: ["admin", "grouped-listing-editor", "stores"],
+        queryFn: async () => {
+            const res = await apiClient.get(`${ADMIN_ENDPOINTS.STORES}?pageSize=200&sorts=storeName`);
+            const body = res?.data ?? res;
+            return (body?.items ?? []);
+        },
+        enabled: isAdmin && !isEdit && !fixedStoreId,
+    });
+    React.useEffect(() => {
+        const doc = existing.data;
+        if (!doc)
+            return;
+        setValues({
+            title: String(doc.title ?? ""),
+            description: String(doc.description ?? ""),
+            groupTheme: doc.groupTheme ?? "generic",
+            productIds: Array.isArray(doc.productIds) ? doc.productIds.map(String) : [],
+            minActiveMembers: Number(doc.minActiveMembers ?? 1),
+            coverImage: String(doc.coverImage ?? ""),
+            isActive: doc.isActive !== false,
+            isFeatured: doc.isFeatured === true,
+        });
+        if (doc.storeId)
+            setStoreId(String(doc.storeId));
+    }, [existing.data]);
+    const update = React.useCallback((partial) => {
+        setValues((prev) => ({ ...prev, ...partial }));
+    }, []);
+    const needsStorePicker = isAdmin && !isEdit && !fixedStoreId;
+    const sections = React.useMemo(() => buildSectionsFromSchema(groupedListingFormSchema, {
+        renderers: {
+            productIds: ({ values: v, onChange }) => (_jsxs(Stack, { gap: "xs", children: [_jsx(ProductInlineSelect, { scope: scope, multiple: true, value: v.productIds ?? [], onChange: (ids) => onChange({ productIds: ids }), placeholder: "Search products to add\u2026" }), _jsxs(Text, { size: "xs", color: "muted", children: [(v.productIds ?? []).length, " product", (v.productIds ?? []).length === 1 ? "" : "s", " in this group."] })] })),
+        },
+    }), [scope]);
+    /*
+     * The nav seam — without it `FormErrorSummary`'s "jump to section" resolves
+     * to undefined, which is what it did for every form before W0.
+     */
+    const { openIds, setOpenIds, goToSection, fieldToSectionIndex, sectionMeta } = useSectionFormNav(sections, values);
+    const { shellCtx, setFieldError, validate } = useFormShellState(groupedListingFormSchema, {
+        sections: sectionMeta,
+        onGoToSection: goToSection,
+        fieldToSectionIndex,
+    });
+    React.useEffect(() => {
+        validate(values);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [values, validate]);
+    const handleSubmit = async () => {
+        const parsed = groupedListingFormSchema.safeParse(values);
+        if (!parsed.success) {
+            applyZodIssues(parsed.error.issues, setFieldError);
+            return;
+        }
+        if (needsStorePicker && !storeId) {
+            showToast("Pick the store this group belongs to.", "error");
+            return;
+        }
+        setSaving(true);
+        try {
+            if (isEdit) {
+                await apiClient.patch(byIdEndpoint(groupId), parsed.data);
+            }
+            else {
+                /*
+                 * `storeId` is sent ONLY by admin. The seller route derives it from the
+                 * session and rejects it in the body, which is what stops a seller
+                 * filing a group under another store.
+                 */
+                const payload = isAdmin ? { ...parsed.data, storeId } : parsed.data;
+                const res = await apiClient.post(listEndpoint, payload);
+                const created = res?.data?.id;
+                if (created && onSaved) {
+                    showToast("Group created.", "success");
+                    onSaved(created);
+                    return;
+                }
+            }
+            showToast(isEdit ? "Group updated." : "Group created.", "success");
+            if (onSaved)
+                onSaved(groupId ?? "");
+            else
+                router.push(String(isAdmin ? ROUTES.ADMIN.GROUPED_LISTINGS : ROUTES.STORE.GROUPED_LISTINGS));
+        }
+        catch (err) {
+            const e = normalizeError(err);
+            showToast(e.message || "Failed to save the group.", "error");
+        }
+        finally {
+            setSaving(false);
+        }
+    };
+    if (isEdit && existing.isLoading) {
+        return _jsx(Text, { color: "muted", children: "Loading\u2026" });
+    }
+    return (_jsxs(Stack, { gap: "md", children: [needsStorePicker ? (_jsx(FieldSelect, { name: "storeId", label: "Store", required: true, value: storeId, onChange: setStoreId, options: [
+                    { value: "", label: "Select a store…" },
+                    ...(stores.data ?? []).map((s) => ({
+                        value: s.id,
+                        label: s.storeName ?? s.id,
+                    })),
+                ] })) : null, _jsxs(FormShellContext.Provider, { value: shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: values, onChange: update, onSubmit: handleSubmit, schema: groupedListingFormSchema, openIds: openIds, onOpenChange: setOpenIds, submitLabel: isEdit ? "Save changes" : "Create group", isLoading: saving, onCancel: onCancel })] })] }));
+}