@mohasinac/appkit 4.27.0 → 4.28.0

package/dist/features/blog/components/BlogListView.js

@@ -25,7 +25,7 @@ export function BlogCard({ post, href, onClick, className = "" }) {
         : "";
     const isInteractive = !!(href || onClick);
     const card = (_jsxs(Article, { role: onClick && !href ? "button" : undefined, tabIndex: onClick && !href ? 0 : undefined, onKeyDown: onClick && !href
-            ? (e) => (e.key === "Enter" || e.key === " ") && onClick(post)
+            ? (e) => (e.key === "Enter" || e.key === "") && onClick(post)
             : undefined, onClick: onClick && !href ? () => onClick(post) : undefined, className: `group flex flex-col h-full overflow-hidden rounded-xl border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] shadow-sm transition hover:shadow-md ${isInteractive ? "cursor-pointer" : ""} ${className}`, children: [_jsx(Div, { className: `relative aspect-video w-full ${__O.hidden} bg-[var(--appkit-color-surface)] dark:bg-[var(--appkit-color-surface-elevated)] flex-shrink-0`, children: coverImageUrl ? (_jsx(MediaImage, { src: coverImageUrl, alt: post.title, size: "card", className: "transition-transform duration-300 group-hover:scale-105" })) : (_jsx(Row, { surface: "muted", className: "h-full w-full", align: "center", justify: "center", children: _jsx(Span, { className: "opacity-30", size: "4xl", "aria-hidden": "true", children: "\u270D\uFE0F" }) })) }), _jsxs(Stack, { className: `flex-1 ${__P.p5}`, children: [_jsxs(Row, { className: "mb-2", gap: "sm", wrap: true, children: [_jsx(Span, { size: "xs", weight: "medium", className: "bg-primary/10 text-primary", rounded: "full", padding: "pill-xs", transform: "capitalize", children: post.category }), post.isFeatured && (_jsx(Span, { size: "xs", weight: "medium", className: CLS_FEATURED_BADGE, children: "Featured" })), post.readTimeMinutes && (_jsxs(Span, { size: "xs", color: "muted", children: [post.readTimeMinutes, " min read"] }))] }), _jsx(Heading, { level: 3, className: `group-hover:text-primary`, color: "primary", truncate: 2, size: "base", weight: "semibold", children: post.title }), post.excerpt && (_jsx(Text, { className: `mt-2 flex-1`, color: "muted", truncate: 3, size: "sm", children: post.excerpt })), _jsxs(Row, { className: "mt-auto", padding: "t-sm", gap: "3", children: [post.authorAvatar ? (_jsx(Div, { className: "relative h-7 w-7 flex-shrink-0", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: post.authorAvatar, alt: post.authorName ?? "author", size: "avatar" }) })) : post.authorName ? (_jsx(Row, { textWeight: "bold", textSize: "xs", className: "h-7 w-7 flex-shrink-0 bg-primary/10 text-primary", align: "center", justify: "center", rounded: "full", children: post.authorName.charAt(0).toUpperCase() })) : null, _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] min-w-0", size: "xs", children: [post.authorName && (_jsx(Span, { weight: "medium", className: "text-neutral-700", children: safeDisplayName(post.authorName, "Author") })), date && _jsxs(Span, { className: "ml-1 text-neutral-400", children: ["\u00B7 ", date] })] })] })] })] }));
     if (href) {
         return (_jsx(Link, { href: href, className: "block h-full", children: card }));
@@ -33,7 +33,7 @@ export function BlogCard({ post, href, onClick, className = "" }) {
     return card;
 }
 export function BlogCategoryTabs({ categories, active, onSelect, labels = {}, }) {
-    return (_jsxs(Div, { layout: "flex", gap: "2", className: `scrollbar-none ${__O.xAuto}`, padding: "b-2xs", children: [_jsx(Button, { onClick: () => onSelect(null), variant: !active ? "primary" : "ghost", size: "sm", className: `whitespace-nowrap rounded-full px-[var(--appkit-space-4)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-sm)] font-medium transition ${!active ? "bg-neutral-900 text-white" : "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)] text-[var(--appkit-color-text-muted)] hover:bg-neutral-200 dark:hover:bg-slate-700"}`, children: labels.all ?? "All" }), categories.map((cat) => (_jsx(Button, { onClick: () => onSelect(cat), variant: active === cat ? "primary" : "ghost", size: "sm", className: `whitespace-nowrap rounded-full px-[var(--appkit-space-4)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-sm)] font-medium capitalize transition ${active === cat ? "bg-neutral-900 text-white" : "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)] text-[var(--appkit-color-text-muted)] hover:bg-neutral-200 dark:hover:bg-slate-700"}`, children: labels[cat] ?? cat }, cat)))] }));
+    return (_jsxs(Div, { layout: "flex", gap: "2", className: `scrollbar-none ${__O.xAuto}`, padding: "b-2xs", children: [_jsx(Button, { onClick: () => onSelect(null), variant: !active ? "primary" : "ghost", size: "sm", className: `whitespace-nowrap rounded-full px-[var(--appkit-space-4)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-sm)] font-medium transition ${!active ? "bg-neutral-900 text-white" : "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)] text-[var(--appkit-color-text-muted)] hover:bg-surface-hover"}`, children: labels.all ?? "All" }), categories.map((cat) => (_jsx(Button, { onClick: () => onSelect(cat), variant: active === cat ? "primary" : "ghost", size: "sm", className: `whitespace-nowrap rounded-full px-[var(--appkit-space-4)] py-[var(--appkit-space-1-5)] text-[length:var(--appkit-text-sm)] font-medium capitalize transition ${active === cat ? "bg-neutral-900 text-white" : "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)] text-[var(--appkit-color-text-muted)] hover:bg-surface-hover"}`, children: labels[cat] ?? cat }, cat)))] }));
 }
 export function BlogListView({ posts, isLoading, totalPages = 1, currentPage = 1, total = 0, onPageChange, onPostClick, emptyLabel = "No posts found", slots, }) {
     if (isLoading) {

package/dist/features/cart/components/CartPriceBreakdown.d.ts

@@ -55,7 +55,17 @@ export interface CartPriceBreakdownProps {
     unavailableNote?: React.ReactNode;
     /** Subtotal to show when `preview` is null (guest carts). */
     fallbackSubtotal?: number;
+    /**
+     * Shown when the preview request FAILED, as opposed to never having run.
+     *
+     * Separate from `unavailableNote` because the two say different things and
+     * the failure case can coexist with a rendered breakdown: on a refetch error
+     * the last good `preview` is deliberately kept, so the buyer sees real
+     * figures plus a note that they may be out of date — strictly better than
+     * blanking to ₹0, which is what a swallowed error used to produce.
+     */
+    errorNote?: React.ReactNode;
     isLoading?: boolean;
     className?: string;
 }
-export declare function CartPriceBreakdown({ preview, itemCount, currency, unavailableNote, fallbackSubtotal, isLoading, className, }: CartPriceBreakdownProps): React.JSX.Element;
+export declare function CartPriceBreakdown({ preview, itemCount, currency, unavailableNote, fallbackSubtotal, errorNote, isLoading, className, }: CartPriceBreakdownProps): React.JSX.Element;

package/dist/features/cart/components/CartPriceBreakdown.js

@@ -9,10 +9,10 @@ function Line({ label, amount, tone = "muted", strong = false, }) {
 function withStoreCount(label, count) {
     return count > 1 ? `${label} (${count} stores)` : label;
 }
-export function CartPriceBreakdown({ preview, itemCount, currency = "INR", unavailableNote, fallbackSubtotal = 0, isLoading = false, className = "", }) {
+export function CartPriceBreakdown({ preview, itemCount, currency = "INR", unavailableNote, fallbackSubtotal = 0, errorNote, isLoading = false, className = "", }) {
     const money = (value) => formatCurrency(value, currency);
     if (!preview) {
-        return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: itemCount !== undefined ? `Subtotal (${itemCount} item${itemCount !== 1 ? "s" : ""})` : "Subtotal", amount: money(fallbackSubtotal) }), unavailableNote && (_jsx(Text, { size: "xs", color: "muted", children: unavailableNote }))] }));
+        return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: itemCount !== undefined ? `Subtotal (${itemCount} item${itemCount !== 1 ? "s" : ""})` : "Subtotal", amount: money(fallbackSubtotal) }), (errorNote ?? unavailableNote) && (_jsx(Text, { size: "xs", color: errorNote ? "error" : "muted", children: errorNote ?? unavailableNote }))] }));
     }
     const storeCount = preview.stores.length;
     // Count how many stores are actually charged each per-store add-on, so the
@@ -21,5 +21,5 @@ export function CartPriceBreakdown({ preview, itemCount, currency = "INR", unava
     const subtotalLabel = itemCount !== undefined
         ? `Subtotal (${itemCount} item${itemCount !== 1 ? "s" : ""}${storeCount > 1 ? `, ${storeCount} stores` : ""})`
         : "Subtotal";
-    return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: subtotalLabel, amount: money(preview.subtotal) }), preview.shippingFee > 0 && (_jsx(Line, { label: withStoreCount("Shipping", storeCount), amount: money(preview.shippingFee) })), preview.codHandlingFee > 0 && (_jsx(Line, { label: "COD handling fee", amount: money(preview.codHandlingFee) })), preview.whatsappNotifyFee > 0 && (_jsx(Line, { label: withStoreCount("WhatsApp updates", countCharged((s) => s.whatsappNotifyFee)), amount: money(preview.whatsappNotifyFee) })), preview.giftWrapFee > 0 && (_jsx(Line, { label: withStoreCount("Gift wrap", countCharged((s) => s.giftWrapFee)), amount: money(preview.giftWrapFee) })), preview.shipmentProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Shipment protection", countCharged((s) => s.shipmentProtectionFee)), amount: money(preview.shipmentProtectionFee) })), preview.platformFee > 0 && _jsx(Line, { label: "Platform fee", amount: money(preview.platformFee) }), (preview.gstAmount > 0 || preview.gstOnFee > 0) && (_jsx(Line, { label: "GST", amount: money(preview.gstAmount + preview.gstOnFee) })), preview.couponDiscount > 0 && (_jsx(Line, { label: "Coupon discount", amount: `−${money(preview.couponDiscount)}`, tone: "success" })), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Total", amount: money(preview.total), tone: "primary", strong: true }) }), isLoading && (_jsx(Text, { size: "xs", color: "muted", children: "Updating\u2026" }))] }));
+    return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: subtotalLabel, amount: money(preview.subtotal) }), preview.shippingFee > 0 && (_jsx(Line, { label: withStoreCount("Shipping", storeCount), amount: money(preview.shippingFee) })), preview.codHandlingFee > 0 && (_jsx(Line, { label: "COD handling fee", amount: money(preview.codHandlingFee) })), preview.whatsappNotifyFee > 0 && (_jsx(Line, { label: withStoreCount("WhatsApp updates", countCharged((s) => s.whatsappNotifyFee)), amount: money(preview.whatsappNotifyFee) })), preview.giftWrapFee > 0 && (_jsx(Line, { label: withStoreCount("Gift wrap", countCharged((s) => s.giftWrapFee)), amount: money(preview.giftWrapFee) })), preview.shipmentProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Shipment protection", countCharged((s) => s.shipmentProtectionFee)), amount: money(preview.shipmentProtectionFee) })), preview.platformFee > 0 && _jsx(Line, { label: "Platform fee", amount: money(preview.platformFee) }), (preview.gstAmount > 0 || preview.gstOnFee > 0) && (_jsx(Line, { label: "GST", amount: money(preview.gstAmount + preview.gstOnFee) })), preview.couponDiscount > 0 && (_jsx(Line, { label: "Coupon discount", amount: `−${money(preview.couponDiscount)}`, tone: "success" })), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Total", amount: money(preview.total), tone: "primary", strong: true }) }), errorNote ? (_jsx(Text, { size: "xs", color: "error", children: errorNote })) : (isLoading && (_jsx(Text, { size: "xs", color: "muted", children: "Updating\u2026" })))] }));
 }

package/dist/features/cart/components/StoreAddonsPicker.d.ts

@@ -24,6 +24,15 @@ export interface StoreAddonsRates {
     shipmentProtectionFeePercent?: number;
     shipmentProtectionFeeMin?: number;
 }
+/**
+ * True when the site offers at least one paid add-on.
+ *
+ * Exported because the picker renders NOTHING when the answer is false, and a
+ * parent that doesn't know that ends up drawing a bare "Add-ons" heading over
+ * empty space. Callers use this to decide between mounting the picker and
+ * showing an explanatory line instead.
+ */
+export declare function hasAnyStoreAddon(rates: StoreAddonsRates | null | undefined): boolean;
 export interface StoreAddonsPickerProps {
     storeId: string;
     /** This store's subtotal — shipment protection is a percentage of it. */

package/dist/features/cart/components/StoreAddonsPicker.js

@@ -6,12 +6,22 @@ import { IconBox } from "../../../ui/components/IconBox";
 import { FieldCheckbox } from "../../../ui/forms/FieldCheckbox";
 import { FieldTextarea } from "../../../ui/forms/FieldTextarea";
 import { formatCurrency } from "../../../utils/number.formatter";
-export function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rates, disabled = false, disabledReason, showGiftMessage = false, currency = "INR", className = "", }) {
-    const anyEnabled = !!rates &&
-        (rates.whatsappNotifyFeeEnabled ||
+/**
+ * True when the site offers at least one paid add-on.
+ *
+ * Exported because the picker renders NOTHING when the answer is false, and a
+ * parent that doesn't know that ends up drawing a bare "Add-ons" heading over
+ * empty space. Callers use this to decide between mounting the picker and
+ * showing an explanatory line instead.
+ */
+export function hasAnyStoreAddon(rates) {
+    return (!!rates &&
+        !!(rates.whatsappNotifyFeeEnabled ||
             rates.giftWrapFeeEnabled ||
-            rates.shipmentProtectionFeeEnabled);
-    if (!anyEnabled)
+            rates.shipmentProtectionFeeEnabled));
+}
+export function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rates, disabled = false, disabledReason, showGiftMessage = false, currency = "INR", className = "", }) {
+    if (!hasAnyStoreAddon(rates) || !rates)
         return null;
     const money = (value) => formatCurrency(value, currency);
     const set = (patch) => onChange(storeId, { ...value, ...patch });

package/dist/features/cart/components/index.d.ts

@@ -5,7 +5,7 @@ export { CartView } from "./CartView";
 export type { CartViewProps, CartOrderGroup } from "./CartView";
 export { CartSummary } from "./CartSummary";
 export type { CartSummaryProps } from "./CartSummary";
-export { StoreAddonsPicker } from "./StoreAddonsPicker";
+export { StoreAddonsPicker, hasAnyStoreAddon } from "./StoreAddonsPicker";
 export type { StoreAddonsPickerProps, StoreAddonsValue, StoreAddonsRates, } from "./StoreAddonsPicker";
 export { CartPriceBreakdown } from "./CartPriceBreakdown";
 export type { CartPriceBreakdownProps, CartPriceBreakdownData, CartPriceBreakdownStore, } from "./CartPriceBreakdown";

package/dist/features/cart/components/index.js

@@ -2,7 +2,7 @@ export { CartItemRow, CartDrawer } from "./CartDrawer";
 export { CartGroupLineRow } from "./CartGroupLineRow";
 export { CartView } from "./CartView";
 export { CartSummary } from "./CartSummary";
-export { StoreAddonsPicker } from "./StoreAddonsPicker";
+export { StoreAddonsPicker, hasAnyStoreAddon } from "./StoreAddonsPicker";
 export { CartPriceBreakdown } from "./CartPriceBreakdown";
 export { CheckoutView } from "./CheckoutView";
 export { CheckoutAddressStep } from "./CheckoutAddressStep";

package/dist/features/cart/hooks/useGuestCartMerge.d.ts

@@ -1,11 +1,18 @@
 import { type GuestCartItem } from "../utils/guest-cart";
+import { type NormalizedError } from "../../../errors/normalize";
 export interface UseGuestCartMergeOptions {
     userId: string | null | undefined;
     mergeEndpoint?: string;
     onNavigate?: (url: string) => void;
     mergeFn?: (items: GuestCartItem[]) => Promise<void>;
     onMerged?: (count: number) => void;
-    onMergeFailed?: (error: unknown) => void;
+    /**
+     * Receives a typed NormalizedError, not the raw `unknown` — the hook is the
+     * boundary that knows how to classify the failure, so every consumer would
+     * otherwise repeat the same narrowing. Zero external consumers at the time of
+     * narrowing, so this broke nothing.
+     */
+    onMergeFailed?: (error: NormalizedError) => void;
 }
 /**
  * useGuestCartMerge

package/dist/features/cart/hooks/useGuestCartMerge.js

@@ -3,6 +3,7 @@ import { useEffect, useRef } from "react";
 import { apiClient } from "../../../http";
 import { clearGuestCart, clearGuestReturnTo, getGuestCartItems, getGuestReturnTo, } from "../utils/guest-cart";
 import { CART_ENDPOINTS } from "../../../constants/api-endpoints";
+import { normalizeError } from "../../../errors/normalize";
 /**
  * useGuestCartMerge
  *
@@ -42,7 +43,7 @@ export function useGuestCartMerge(options) {
             }
         })
             .catch((err) => {
-            options.onMergeFailed?.(err);
+            options.onMergeFailed?.(normalizeError(err));
             if (returnTo)
                 clearGuestReturnTo();
         });

package/dist/features/cart/utils/line-total.d.ts

@@ -0,0 +1,25 @@
+import { type PricedCartLine } from "../../../_internal/shared/checkout/order-math";
+/**
+ * What one cart line contributes to a subtotal, computed on the CLIENT — where
+ * no `ProductDocument` is available.
+ *
+ * Delegates to `lineTotalFor(item, null)` so the priority order that actually
+ * matters stays in one place (`order-math.ts`): a `lockedPrice` beats
+ * everything, a bundle is charged its own discounted price and is checked
+ * BEFORE its members, a grouped line is the sum of what the buyer picked, and
+ * anything else falls back to the cart's snapshotted price.
+ *
+ * 🛑 Do not re-derive this at a call site. That rule has been hand-rolled six
+ * times already and two of the copies silently omitted the `lockedPrice`
+ * branch, so an accepted offer was charged at the seller's list price
+ * (Recurrent Root Cause #75).
+ *
+ * The one thing it cannot know is a live listing price that has moved since the
+ * line was added — `lineTotalFor` would read that off the product document.
+ * That is fine for the surfaces this serves (the cart and the checkout
+ * add-ons/fees step): both exist to render immediately with a good figure, and
+ * the server pricing preview overwrites it with the authoritative one the
+ * moment it lands.
+ */
+export declare function clientLineTotal(item: PricedCartLine): number;
+export type { PricedCartLine };

package/dist/features/cart/utils/line-total.js

@@ -0,0 +1,26 @@
+import { lineTotalFor } from "../../../_internal/shared/checkout/order-math";
+/**
+ * What one cart line contributes to a subtotal, computed on the CLIENT — where
+ * no `ProductDocument` is available.
+ *
+ * Delegates to `lineTotalFor(item, null)` so the priority order that actually
+ * matters stays in one place (`order-math.ts`): a `lockedPrice` beats
+ * everything, a bundle is charged its own discounted price and is checked
+ * BEFORE its members, a grouped line is the sum of what the buyer picked, and
+ * anything else falls back to the cart's snapshotted price.
+ *
+ * 🛑 Do not re-derive this at a call site. That rule has been hand-rolled six
+ * times already and two of the copies silently omitted the `lockedPrice`
+ * branch, so an accepted offer was charged at the seller's list price
+ * (Recurrent Root Cause #75).
+ *
+ * The one thing it cannot know is a live listing price that has moved since the
+ * line was added — `lineTotalFor` would read that off the product document.
+ * That is fine for the surfaces this serves (the cart and the checkout
+ * add-ons/fees step): both exist to render immediately with a good figure, and
+ * the server pricing preview overwrites it with the authoritative one the
+ * moment it lands.
+ */
+export function clientLineTotal(item) {
+    return lineTotalFor(item, null);
+}

package/dist/features/catalogue/repository/catalogue.repository.d.ts

@@ -1,3 +1,4 @@
+import type { DocumentSnapshot } from "firebase-admin/firestore";
 /**
  * Personal Catalogue Repository (Feature B).
  */
@@ -12,6 +13,17 @@ export interface CatalogueWriteContext {
     note?: string;
 }
 export declare class CatalogueRepository extends BaseRepository<CatalogueItemDocument> {
+    /**
+     * `ownerEmail` only — NOT `ownerName`.
+     *
+     * Per decision D1 names stay partial-match searchable, and catalogue items are
+     * searchable by owner in the admin approvals queue. `CATALOGUE_HISTORY_PII_FIELDS`
+     * lists both, but that constant scrubs status *history*, which has no search
+     * requirement — the two lists are intentionally different.
+     */
+    protected piiFields: readonly ["ownerEmail"];
+    /** Decrypt on read so callers see the shape they wrote. */
+    protected mapDoc<D = CatalogueItemDocument>(snap: DocumentSnapshot): D;
     constructor();
     create(input: CatalogueItemCreateInput): Promise<CatalogueItemDocument>;
     /**

package/dist/features/catalogue/repository/catalogue.repository.js

@@ -1,3 +1,4 @@
+import { decryptPiiFields } from "../../../security/pii-encrypt";
 /**
  * Personal Catalogue Repository (Feature B).
  */
@@ -5,8 +6,22 @@ import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../..
 import { CATALOGUE_COLLECTION, CATALOGUE_FIELDS, CATALOGUE_TRACKED_FIELDS, CATALOGUE_HISTORY_PII_FIELDS, createCatalogueItemId, } from "../schemas/firestore";
 import { withHistory } from "../../../_internal/shared/history/index";
 export class CatalogueRepository extends BaseRepository {
+    /** Decrypt on read so callers see the shape they wrote. */
+    mapDoc(snap) {
+        const raw = super.mapDoc(snap);
+        return decryptPiiFields(raw, [...this.piiFields]);
+    }
     constructor() {
         super(CATALOGUE_COLLECTION);
+        /**
+         * `ownerEmail` only — NOT `ownerName`.
+         *
+         * Per decision D1 names stay partial-match searchable, and catalogue items are
+         * searchable by owner in the admin approvals queue. `CATALOGUE_HISTORY_PII_FIELDS`
+         * lists both, but that constant scrubs status *history*, which has no search
+         * requirement — the two lists are intentionally different.
+         */
+        this.piiFields = ["ownerEmail"];
     }
     async create(input) {
         const id = createCatalogueItemId({ ownerSlug: input.ownerId, title: input.title });

package/dist/features/categories/components/CategoryTree.js

@@ -10,7 +10,7 @@ function CategoryTreeNode({ item, children = [], activeId, onSelect, depth = 0,
     const DEPTH_PL = ["pl-2", "pl-6", "pl-10", "pl-14", "pl-[72px]"];
     const depthPl = DEPTH_PL[Math.min(depth, 4)];
     return (_jsxs(Div, { children: [_jsxs(Row, { textWeight: "semibold", textSize: "sm", role: "treeitem", "aria-expanded": hasChildren ? expanded : undefined, "aria-selected": isActive, tabIndex: 0, onKeyDown: (e) => {
-                    if (e.key === "Enter" || e.key === " ") {
+                    if (e.key === "Enter" || e.key === "") {
                         if (hasChildren)
                             setExpanded((p) => !p);
                         onSelect?.(item);
@@ -20,7 +20,7 @@ function CategoryTreeNode({ item, children = [], activeId, onSelect, depth = 0,
                     if (hasChildren)
                         setExpanded((p) => !p);
                     onSelect?.(item);
-                }, className: `cursor-pointer py-[var(--appkit-space-1-5)] transition select-none ${depthPl} ${isActive ? "bg-primary-50 text-primary-700 dark:bg-primary-900/30 dark:text-primary-400" : "text-neutral-700 hover:bg-neutral-50 text-[var(--appkit-color-text-muted)] hover:bg-[var(--appkit-color-surface-elevated)]"}`, align: "center", gap: "xs", padding: "x-xs", rounded: "md", children: [hasChildren && (_jsx(Span, { size: "xs", "aria-hidden": "true", className: `transition-transform duration-150 ${expanded ? "rotate-90" : ""}`, color: "faint", children: "\u25B6" })), !hasChildren && _jsx(Span, { className: "w-3" }), item.display?.icon && (_jsx(Span, { size: "base", "aria-hidden": "true", className: "flex-shrink-0", children: item.display.icon })), _jsx(Text, { className: "flex-1 truncate", children: item.name }), item.metrics && (_jsx(Span, { size: "xs", className: "ml-auto flex-shrink-0 tabular-nums", color: "faint", children: item.metrics.productCount }))] }), hasChildren && expanded && (_jsx(Div, { role: "group", children: children.map((child) => (_jsx(CategoryTreeNode, { item: child, activeId: activeId, onSelect: onSelect, depth: depth + 1 }, child.id))) }))] }));
+                }, className: `cursor-pointer py-[var(--appkit-space-1-5)] transition select-none ${depthPl} ${isActive ? "bg-primary-50 text-primary-700 dark:bg-primary-900/30 dark:text-primary-400" : " hover:bg-surface-hover text-[var(--appkit-color-text-muted)]"}`, align: "center", gap: "xs", padding: "x-xs", rounded: "md", children: [hasChildren && (_jsx(Span, { size: "xs", "aria-hidden": "true", className: `transition-transform duration-150 ${expanded ? "rotate-90" : ""}`, color: "faint", children: "\u25B6" })), !hasChildren && _jsx(Span, { className: "w-3" }), item.display?.icon && (_jsx(Span, { size: "base", "aria-hidden": "true", className: "flex-shrink-0", children: item.display.icon })), _jsx(Text, { className: "flex-1 truncate", children: item.name }), item.metrics && (_jsx(Span, { size: "xs", className: "ml-auto flex-shrink-0 tabular-nums", color: "faint", children: item.metrics.productCount }))] }), hasChildren && expanded && (_jsx(Div, { role: "group", children: children.map((child) => (_jsx(CategoryTreeNode, { item: child, activeId: activeId, onSelect: onSelect, depth: depth + 1 }, child.id))) }))] }));
 }
 /**
  * CategoryTree — hierarchical expandable navigation for categories.

package/dist/features/contact/components/ContactForm.js

@@ -68,7 +68,7 @@ export function ContactForm({ onSubmit, labels = {}, className = "", }) {
     if (submitted) {
         return (_jsxs(Div, { className: `text-center ${className}`, padding: "y-3xl", children: [_jsx(Div, { textSize: "5xl", className: "mb-4", children: "\u2705" }), _jsx(Heading, { level: 2, className: "mb-2", children: labels.successTitle ?? "Message Sent!" }), _jsx(Text, { variant: "secondary", className: "mb-6", children: labels.successDescription ?? "We'll get back to you shortly." }), _jsx(Button, { type: "button", variant: "outline", onClick: () => setSubmitted(false), children: labels.sendAnotherButton ?? "Send another message" })] }));
     }
-    const field = (id, label, placeholder, multiline) => (_jsxs(Stack, { gap: "xs", children: [_jsx("label", { htmlFor: id, className: "text-[length:var(--appkit-text-sm)] font-medium text-[var(--appkit-color-text-muted)]", children: label }), multiline ? (_jsx(Textarea, { id: id, value: form[id], onChange: (e) => setForm((f) => ({ ...f, [id]: e.target.value })), placeholder: placeholder, rows: 5, className: "w-full rounded-lg border border-neutral-200 border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] outline-none focus:ring-2 ring-primary/20 transition" })) : (_jsx(Input, { id: id, type: id === "email" ? "email" : "text", value: form[id], onChange: (e) => setForm((f) => ({ ...f, [id]: e.target.value })), placeholder: placeholder, className: "h-10" })), errors[id] && _jsx(Span, { size: "xs", className: CLS_FIELD_ERROR, children: errors[id] })] }));
+    const field = (id, label, placeholder, multiline) => (_jsxs(Stack, { gap: "xs", children: [_jsx("label", { htmlFor: id, className: "text-[length:var(--appkit-text-sm)] font-medium text-[var(--appkit-color-text-muted)]", children: label }), multiline ? (_jsx(Textarea, { id: id, value: form[id], onChange: (e) => setForm((f) => ({ ...f, [id]: e.target.value })), placeholder: placeholder, rows: 5, className: "w-full rounded-lg border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] outline-none focus:ring-2 ring-primary/20 transition" })) : (_jsx(Input, { id: id, type: id === "email" ? "email" : "text", value: form[id], onChange: (e) => setForm((f) => ({ ...f, [id]: e.target.value })), placeholder: placeholder, className: "h-10" })), errors[id] && _jsx(Span, { size: "xs", className: CLS_FIELD_ERROR, children: errors[id] })] }));
     return (_jsx(FormShellContext.Provider, { value: shellCtx, children: _jsxs(Form, { onSubmit: handleSubmit, noValidate: true, className: className, spacing: "md", children: [_jsx(Heading, { level: 2, className: "mb-6", children: labels.title ?? "Send us a message" }), submitError && (_jsx(Div, { className: CLS_ERROR_BANNER, children: submitError })), field("name", labels.nameLabel ?? "Your Name", labels.namePlaceholder ?? "Enter your name"), field("email", labels.emailLabel ?? "Email", labels.emailPlaceholder ?? "your@email.com"), field("subject", labels.subjectLabel ?? "Subject", labels.subjectPlaceholder ?? "How can we help?"), field("message", labels.messageLabel ?? "Message", labels.messagePlaceholder ?? "Tell us more…", true), _jsx(FormErrorSummary, {}), _jsx(Button, { type: "submit", variant: "primary", disabled: isSubmitting, className: "w-full sm:w-auto", children: isSubmitting
                         ? (labels.submittingButton ?? "Sending…")
                         : (labels.submitButton ?? "Send Message") })] }) }));

package/dist/features/copilot/hooks/useCopilotFeedback.d.ts

@@ -9,7 +9,7 @@ export interface UseCopilotFeedbackOptions {
  * Sends thumbs-up / thumbs-down feedback on a copilot response.
  * The consumer injects the endpoint builder so appkit stays route-agnostic.
  */
-export declare function useCopilotFeedback({ feedbackEndpoint, }: UseCopilotFeedbackOptions): import("@tanstack/react-query").UseMutationResult<void, import("@mohasinac/appkit/client").ApiError, {
+export declare function useCopilotFeedback({ feedbackEndpoint, }: UseCopilotFeedbackOptions): import("@tanstack/react-query").UseMutationResult<void, import("../../../client").ApiError, {
     logId: string;
     feedback: CopilotFeedback;
 }, unknown>;

package/dist/features/copilot/hooks/useCopilotFeedback.js

@@ -1,4 +1,4 @@
-import { useApiMutation } from "@mohasinac/appkit/client";
+import { useApiMutation } from "../../../client/api/useApiMutation";
 import { apiClient } from "../../../http";
 /**
  * useCopilotFeedback

package/dist/features/events/components/AdminEventEditorView.js

@@ -8,6 +8,7 @@ import { Alert, Button, Div, Grid, Heading, Input, Label, RichTextEditor, Row, S
 import { FormShellContext, useFormShellState, applyZodIssues, FormErrorSummary } from "../../../ui/forms";
 import { apiClient } from "../../../http";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { ALL_EVENT_TYPES, EVENT_TYPE_LABELS } from "../types";
 import { SectionForm, useSectionFormNav } from "../../shell";
 import { eventDraftSchema } from "../schemas/event-form";
 import { ProductInlineSelect } from "../../seller/components/ProductInlineSelect";
@@ -31,15 +32,21 @@ const CLS_REMOVE_BTN_LG = "text-zinc-400 hover:text-error text-[length:var(--app
 const CLS_RAFFLE_PANEL = "border border-warning bg-warning-surface dark:border-warning dark:bg-warning-surface";
 const CLS_RAFFLE_HEADING = "text-warning dark:text-warning";
 const CLS_RAFFLE_BODY = "text-warning dark:text-warning";
-const EVENT_TYPE_OPTIONS = [
-    { label: "Sale", value: "sale" },
-    { label: "Offer / Coupon", value: "offer" },
-    { label: "Poll", value: "poll" },
-    { label: "Survey", value: "survey" },
-    { label: "Feedback", value: "feedback" },
-    { label: "Raffle", value: "raffle" },
-    { label: "Spin Wheel", value: "spin_wheel" },
-];
+/*
+ * DERIVED. This was a hand-written 7-entry array and `EVENT_TYPE_LABELS`
+ * — a `Record<EventType, string>` sitting one import away — already held the
+ * same labels for all 8. It was missing `lottery`, and `allowedTypes` filters
+ * AGAINST this list, so passing `"lottery"` in still could not surface it:
+ * lottery events had no create path in the UI at all and could only come from
+ * `npm run seed`.
+ *
+ * Deriving from the Record means a new EventType cannot be omitted here
+ * without failing to compile (Root Cause #61).
+ */
+const EVENT_TYPE_OPTIONS = ALL_EVENT_TYPES.map((value) => ({
+    value,
+    label: EVENT_TYPE_LABELS[value],
+}));
 const RAFFLE_TYPE_OPTIONS = [
     { label: "Open raffle (all confirmed entries)", value: "open_raffle" },
     { label: "Top N scorers", value: "top_n_scorers" },

package/dist/features/events/components/AdminEventEntriesView.js

@@ -9,6 +9,9 @@ import { normalizeError } from "../../../errors/normalize";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 import { DataListingView } from "../../admin/components/DataListingView";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+import { buildEventEntryDetailFields } from "./event-entry-detail-fields";
+import { TextLink } from "../../../ui";
+import { ROUTES } from "../../../constants/index";
 const CLS_RESPONSE_TEXT = "whitespace-pre-wrap break-words";
 const REVIEW_STATUS_OPTIONS = [
     { label: "All", value: "all" },
@@ -151,19 +154,10 @@ export function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEnd
         toolbarExtra: eventId ? (_jsx(Button, { variant: "ghost", action: ACTIONS.ADMIN["export-event-entries"], onClick: handleExportReport })) : undefined,
         renderAboveContent: () => (_jsxs(Stack, { gap: "3", className: "px-[var(--appkit-space-3)] pb-[var(--appkit-space-2)]", children: [!eventId ? (_jsx(Alert, { variant: "warning", title: "Missing event id", children: "Event id is required to load entries." })) : null, statsQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load event stats", children: statsQuery.error instanceof Error ? statsQuery.error.message : "Unknown error" })) : null, _jsxs(Div, { layout: "grid", gap: "3", className: "grid-cols-1 sm:grid-cols-3", children: [_jsx(Alert, { variant: "info", title: "Total entries", children: String(statsQuery.data?.stats?.totalEntries ?? 0) }), _jsx(Alert, { variant: "success", title: "Approved", children: String(statsQuery.data?.stats?.approvedEntries ?? 0) }), _jsx(Alert, { variant: "warning", title: "Flagged", children: String(statsQuery.data?.stats?.flaggedEntries ?? 0) })] })] })),
     };
-    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(RecordDetailModal, { isOpen: detail !== null, onClose: () => setDetail(null), title: detail?.userDisplayName || detail?.userEmail || "Entry", badges: detail ? [{ label: detail.reviewStatus }] : undefined, description: detail?.pollComment, fields: detail
-                    ? [
-                        { label: "Entrant", value: detail.userDisplayName ?? detail.userId ?? "—" },
-                        { label: "Email", value: detail.userEmail ?? "—" },
-                        { label: "Review status", value: detail.reviewStatus },
-                        { label: "Points", value: detail.points != null ? String(detail.points) : "—" },
-                        { label: "Raffle eligible", value: detail.raffleEligible ? "Yes" : "No" },
-                        { label: "Poll votes", value: detail.pollVotes?.join(", ") || "—" },
-                        { label: "Reviewed by", value: detail.reviewedBy ?? "—" },
-                        { label: "Review note", value: detail.reviewNote ?? "—" },
-                        { label: "Entry ID", value: detail.id },
-                    ]
-                    : undefined, 
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(RecordDetailModal, { isOpen: detail !== null, onClose: () => setDetail(null), title: detail?.userDisplayName || detail?.userEmail || "Entry", badges: detail ? [{ label: detail.reviewStatus }] : undefined, description: detail?.pollComment, fields: detail ? buildEventEntryDetailFields(detail) : undefined, footer: detail ? (
+                // The full page — a modal cannot be linked, bookmarked or reloaded
+                // into, which is the whole reason the page exists.
+                _jsx(TextLink, { href: String(ROUTES.ADMIN.EVENT_ENTRY_DETAIL(detail.id)), children: "Open full page \u2192" })) : undefined, 
                 // The survey/feedback answers — the actual submission being judged.
                 metadata: detail?.formResponses })] }));
 }

package/dist/features/events/components/EventRafflesSection.js

@@ -1,7 +1,13 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
-import { sieveFilter, sieveAnd, SIEVE_OP } from "@mohasinac/appkit/client";
-import { sortBy } from "@mohasinac/appkit/client";
+import { serverLogger } from "../../../monitoring/server-logger";
+// Import from the DEFINING modules, never `@mohasinac/appkit/client` — that
+// entry is `"use client"`, so in this async Server Component these would resolve
+// to client-reference proxies and calling them throws during the server render
+// (Root Cause #18). The `try/catch` below swallowed that throw, which is why
+// this section silently rendered nothing instead of failing loudly.
+import { sieveFilter, sieveAnd, SIEVE_OP } from "../../../utils/sieve-builder";
+import { sortBy } from "../../../constants/sort";
 import { Container, Div, Heading, Section, Stack, Text, } from "../../../ui";
 import { eventRepository } from "../repository/events.repository";
 import { EventCard } from "./EventCard";
@@ -24,6 +30,12 @@ export async function EventRafflesSection({ config, }) {
     }
     catch (_err) {
         void normalizeError(_err);
+        // Loud on purpose: a swallowed failure here is indistinguishable from "no
+        // active raffles", which is how this section stayed invisible in production
+        // without anyone noticing (Root Cause #59).
+        serverLogger.error("EventRafflesSection query failed", {
+            error: _err instanceof Error ? _err.message : String(_err),
+        });
         events = [];
     }
     if (events.length === 0)

package/dist/features/events/components/EventStatusBadge.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Span } from "../../../ui";
 const STATUS_MAP = {
-    draft: { label: "Draft", color: "bg-[var(--appkit-color-surface)] text-gray-700 bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)]" },
+    draft: { label: "Draft", color: "bg-[var(--appkit-color-surface)] bg-[var(--appkit-color-surface-elevated)] text-[var(--appkit-color-text-muted)]" },
     active: { label: "Active", color: "bg-success-surface text-success" },
     paused: { label: "Paused", color: "bg-warning-surface text-warning" },
     ended: { label: "Ended", color: "bg-error-surface text-error" },

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/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?: {