@mohasinac/appkit 4.44.0 → 4.45.0

package/dist/features/homepage/hooks/useHomepageEvents.js

@@ -1,6 +1,6 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { EVENT_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { EVENT_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useHomepageEvents(limit = 6, options) {
     return useQuery({
         queryKey: ["events", "homepage", String(limit)],

package/dist/features/homepage/hooks/useHomepageReviews.d.ts

@@ -1,4 +1,4 @@
-import type { Review } from "../../reviews";
+import type { Review } from "../../reviews/types";
 export interface UseHomepageReviewsOptions {
     endpoint?: string;
     initialData?: Review[];

package/dist/features/homepage/hooks/useHomepageReviews.js

@@ -1,6 +1,6 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { REVIEW_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { REVIEW_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useHomepageReviews(options) {
     return useQuery({
         queryKey: [

package/dist/features/homepage/hooks/useHomepageSections.js

@@ -1,6 +1,6 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { HOMEPAGE_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { HOMEPAGE_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useHomepageSections(params) {
     return useQuery({
         queryKey: ["homepage-sections", params ?? ""],

package/dist/features/homepage/hooks/useNewsletter.js

@@ -1,6 +1,6 @@
 import { useMutation } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { HOMEPAGE_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { HOMEPAGE_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useNewsletter(options) {
     return useMutation({
         mutationFn: options?.mutationFn ??

package/dist/features/homepage/hooks/useTopBrands.js

@@ -1,6 +1,6 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useTopBrands(limit = 12, options) {
     return useQuery({
         queryKey: ["categories", "brands", String(limit)],

package/dist/features/homepage/hooks/useTopCategories.js

@@ -1,6 +1,6 @@
 import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import { CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints";
+import { apiClient } from "../../../http/index.js";
+import { CATEGORY_ENDPOINTS } from "../../../constants/api-endpoints.js";
 export function useTopCategories(limit = 12, options) {
     return useQuery({
         queryKey: ["categories", "top", String(limit)],

package/dist/features/homepage/index.js

@@ -1,17 +1,17 @@
-export * from "./types";
-export * from "./hooks/useHomepage";
-export * from "./hooks/useHomepageSections";
-export * from "./hooks/useHeroCarousel";
-export * from "./hooks/useFeaturedProducts";
-export * from "./hooks/useFeaturedAuctions";
-export * from "./hooks/useFeaturedPreOrders";
-export * from "./hooks/useTopCategories";
-export * from "./hooks/useTopBrands";
-export * from "./hooks/useBlogArticles";
-export * from "./hooks/useHomepageReviews";
-export * from "./hooks/useNewsletter";
-export { useActiveAd } from "./hooks/useActiveAd";
-export * from "./hooks/useFeaturedStores";
-export * from "./hooks/useHomepageEvents";
-export * from "./components";
-export { registerAdSlot, registerAdSlots, getAdSlot, getAllAdSlots, unregisterAdSlot, clearAdRegistry, setAdConsentGranted, isAdConsentGranted, isAdSlotRenderable, } from "./ad-registry";
+export * from "./types/index.js";
+export * from "./hooks/useHomepage.js";
+export * from "./hooks/useHomepageSections.js";
+export * from "./hooks/useHeroCarousel.js";
+export * from "./hooks/useFeaturedProducts.js";
+export * from "./hooks/useFeaturedAuctions.js";
+export * from "./hooks/useFeaturedPreOrders.js";
+export * from "./hooks/useTopCategories.js";
+export * from "./hooks/useTopBrands.js";
+export * from "./hooks/useBlogArticles.js";
+export * from "./hooks/useHomepageReviews.js";
+export * from "./hooks/useNewsletter.js";
+export { useActiveAd } from "./hooks/useActiveAd.js";
+export * from "./hooks/useFeaturedStores.js";
+export * from "./hooks/useHomepageEvents.js";
+export * from "./components/index.js";
+export { registerAdSlot, registerAdSlots, getAdSlot, getAllAdSlots, unregisterAdSlot, clearAdRegistry, setAdConsentGranted, isAdConsentGranted, isAdSlotRenderable, } from "./ad-registry.js";

package/dist/features/homepage/lib/live-stats.js

@@ -5,11 +5,11 @@
  * individual metric are silently swallowed — the section falls back to the
  * static `value` from the Firestore section config.
  */
-import { ALLOWED_LIVE_COLLECTIONS } from "../schemas/firestore";
-import { productRepository, storeRepository, userRepository, reviewRepository, orderRepository, } from "../../../repositories";
-import { getAdminDb, getFirestoreCount } from "../../../providers/db-firebase";
-import { normalizeError } from "../../../errors/normalize";
-import { serverLogger } from "../../../monitoring/server-logger";
+import { ALLOWED_LIVE_COLLECTIONS } from "../schemas/firestore.js";
+import { productRepository, storeRepository, userRepository, reviewRepository, orderRepository, } from "../../../repositories/index.js";
+import { getAdminDb, getFirestoreCount } from "../../../providers/db-firebase/index.js";
+import { normalizeError } from "../../../errors/normalize.js";
+import { serverLogger } from "../../../monitoring/server-logger.js";
 /**
  * Fetch live stats for all requested metrics.
  * Preset metrics are deduped so each Firestore query runs at most once.

package/dist/features/homepage/lib/section-helpers.js

@@ -1,6 +1,6 @@
 /** Shared string helpers for homepage section rendering. */
 /** Strip leading emoji/symbols that admins sometimes prefix onto DB titles. */
-import { normalizeError } from "../../../errors/normalize";
+import { normalizeError } from "../../../errors/normalize.js";
 export function cleanTitle(raw) {
     if (!raw)
         return raw;

package/dist/features/homepage/lib/section-renderer.js

@@ -1,39 +1,39 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
-import { ROUTES } from "../../../next";
-import { cleanTitle, parseWelcomeDescription } from "./section-helpers";
-import { DEFAULT_TRUST_FEATURES, DEFAULT_SECURITY_ITEMS } from "./section-defaults";
-import { SECTION_TITLE, SECTION_COPY, VIEW_MORE_LABEL, WELCOME_TRUST_CHIPS, } from "../constants/section-copy";
-import { FAQ_CATEGORY_LABELS } from "../constants/faq-category-labels";
-import { AnnouncementBar, hashBannerMessage } from "../components/AnnouncementBar";
-import { HeroCarousel } from "../components/HeroCarousel";
-import { StatsCounterSection } from "../components/StatsCounterSection";
-import { TrustFeaturesSection } from "../components/TrustFeaturesSection";
-import { ShopByCategorySection } from "../components/ShopByCategorySection";
-import { FeaturedProductsSection } from "../components/FeaturedProductsSection";
-import { FeaturedAuctionsSection } from "../components/FeaturedAuctionsSection";
-import { FeaturedPreOrdersSection } from "../components/FeaturedPreOrdersSection";
-import { FeaturedStoresSection } from "../components/FeaturedStoresSection";
-import { EventsSection } from "../components/EventsSection";
-import { CTABannerSection } from "../components/CTABannerSection";
-import { HomepageCustomerReviewsSection } from "../components/HomepageCustomerReviewsSection";
-import { SecurityHighlightsSection } from "../components/SecurityHighlightsSection";
-import { WhatsAppCommunitySection } from "../components/WhatsAppCommunitySection";
-import { FAQSection } from "../components/FAQSection";
-import { NewsletterSection } from "../components/NewsletterSection";
-import { BlogArticlesSection } from "../components/BlogArticlesSection";
-import { WelcomeSection } from "../components/WelcomeSection";
-import { BrandsSection } from "../components/BrandsSection";
-import { SocialFeedSection } from "../components/SocialFeedSection";
-import { CustomCardsSection } from "../components/CustomCardsSection";
-import { GoogleReviewsSection } from "../components/GoogleReviewsSection";
+import { ROUTES } from "../../../next/routing/route-map.js";
+import { cleanTitle, parseWelcomeDescription } from "./section-helpers.js";
+import { DEFAULT_TRUST_FEATURES, DEFAULT_SECURITY_ITEMS } from "./section-defaults.js";
+import { SECTION_TITLE, SECTION_COPY, VIEW_MORE_LABEL, WELCOME_TRUST_CHIPS, } from "../constants/section-copy.js";
+import { FAQ_CATEGORY_LABELS } from "../constants/faq-category-labels.js";
+import { AnnouncementBar, hashBannerMessage } from "../components/AnnouncementBar.js";
+import { HeroCarousel } from "../components/HeroCarousel.js";
+import { StatsCounterSection } from "../components/StatsCounterSection.js";
+import { TrustFeaturesSection } from "../components/TrustFeaturesSection.js";
+import { ShopByCategorySection } from "../components/ShopByCategorySection.js";
+import { FeaturedProductsSection } from "../components/FeaturedProductsSection.js";
+import { FeaturedAuctionsSection } from "../components/FeaturedAuctionsSection.js";
+import { FeaturedPreOrdersSection } from "../components/FeaturedPreOrdersSection.js";
+import { FeaturedStoresSection } from "../components/FeaturedStoresSection.js";
+import { EventsSection } from "../components/EventsSection.js";
+import { CTABannerSection } from "../components/CTABannerSection.js";
+import { HomepageCustomerReviewsSection } from "../components/HomepageCustomerReviewsSection.js";
+import { SecurityHighlightsSection } from "../components/SecurityHighlightsSection.js";
+import { WhatsAppCommunitySection } from "../components/WhatsAppCommunitySection.js";
+import { FAQSection } from "../components/FAQSection.js";
+import { NewsletterSection } from "../components/NewsletterSection.js";
+import { BlogArticlesSection } from "../components/BlogArticlesSection.js";
+import { WelcomeSection } from "../components/WelcomeSection.js";
+import { BrandsSection } from "../components/BrandsSection.js";
+import { SocialFeedSection } from "../components/SocialFeedSection.js";
+import { CustomCardsSection } from "../components/CustomCardsSection.js";
+import { GoogleReviewsSection } from "../components/GoogleReviewsSection.js";
 // S-SBUNI-3 2026-05-13 — FeaturedBundlesSection rebuilt against
 // categoryType:"bundle" rows on the categories collection.
-import { FeaturedBundlesSection } from "../components/FeaturedBundlesSection";
-import { HomepageSectionBoundary } from "../components/HomepageSectionBoundary";
-import { PrizeDrawsSection } from "../../products/components/PrizeDrawsSection";
-import { EventRafflesSection } from "../../events/components/EventRafflesSection";
-import { CollectionCardsSection } from "../components/CollectionCardsSection";
+import { FeaturedBundlesSection } from "../components/FeaturedBundlesSection.js";
+import { HomepageSectionBoundary } from "../components/HomepageSectionBoundary.js";
+import { PrizeDrawsSection } from "../../products/components/PrizeDrawsSection.js";
+import { EventRafflesSection } from "../../events/components/EventRafflesSection.js";
+import { CollectionCardsSection } from "../components/CollectionCardsSection.js";
 const AD_SLOT_MAP = {
     carousel: "afterHero",
     products: "afterFeaturedProducts",

package/dist/features/homepage/repository/carousel.repository.js

@@ -1,14 +1,14 @@
-import { normalizeError } from "../../../errors/normalize";
+import { normalizeError } from "../../../errors/normalize.js";
 /**
  * Carousel Repository
  *
  * Manages homepage carousel slides with grid card system
  */
-import { BaseRepository, getFirestoreCount, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
-import { increment } from "../../../contracts/field-ops";
-import { CAROUSEL_SLIDES_COLLECTION, MAX_ACTIVE_SLIDES, DEFAULT_CAROUSEL_SLIDE_DATA, canActivateSlide, createCarouselId, } from "../schemas";
-import { DatabaseError } from "../../../errors";
-import { CAROUSEL_FIELDS } from "../../../constants/field-names";
+import { BaseRepository, getFirestoreCount, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase/index.js";
+import { increment } from "../../../contracts/field-ops.js";
+import { CAROUSEL_SLIDES_COLLECTION, MAX_ACTIVE_SLIDES, DEFAULT_CAROUSEL_SLIDE_DATA, canActivateSlide, createCarouselId, } from "../schemas/index.js";
+import { DatabaseError } from "../../../errors/index.js";
+import { CAROUSEL_FIELDS } from "../../../constants/field-names.js";
 /**
  * Repository for carousel slide management
  */

package/dist/features/homepage/repository/carousels.repository.js

@@ -5,12 +5,12 @@
  * of up to MAX_SLIDES_PER_CAROUSEL slide IDs. The default hero carousel
  * continues to operate without a CarouselDocument (carouselId = null).
  */
-import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
-import { normalizeError } from "../../../errors/normalize";
-import { CAROUSELS_COLLECTION, MAX_SLIDES_PER_CAROUSEL, TooManySlidesError, } from "../schemas";
-import { DatabaseError } from "../../../errors";
-import { getAdminDb } from "../../../providers/db-firebase";
-import { CAROUSEL_FIELDS } from "../../../constants/field-names";
+import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase/index.js";
+import { normalizeError } from "../../../errors/normalize.js";
+import { CAROUSELS_COLLECTION, MAX_SLIDES_PER_CAROUSEL, TooManySlidesError, } from "../schemas/index.js";
+import { DatabaseError } from "../../../errors/index.js";
+import { getAdminDb } from "../../../providers/db-firebase/index.js";
+import { CAROUSEL_FIELDS } from "../../../constants/field-names.js";
 export class CarouselsRepository extends BaseRepository {
     constructor() {
         super(CAROUSELS_COLLECTION);

package/dist/features/homepage/repository/homepage-sections.repository.js

@@ -3,11 +3,11 @@
  *
  * Manages homepage section configuration and ordering.
  */
-import { DatabaseError } from "../../../errors";
-import { HOMEPAGE_SECTION_FIELDS } from "../../../constants/field-names";
-import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase";
-import { normalizeError } from "../../../errors/normalize";
-import { HOMEPAGE_SECTIONS_COLLECTION, createHomepageSectionId, } from "../schemas";
+import { DatabaseError } from "../../../errors/index.js";
+import { HOMEPAGE_SECTION_FIELDS } from "../../../constants/field-names.js";
+import { BaseRepository, prepareForFirestore, parseSieveDateValue, } from "../../../providers/db-firebase/index.js";
+import { normalizeError } from "../../../errors/normalize.js";
+import { HOMEPAGE_SECTIONS_COLLECTION, createHomepageSectionId, } from "../schemas/index.js";
 export class HomepageSectionsRepository extends BaseRepository {
     constructor() {
         super(HOMEPAGE_SECTIONS_COLLECTION);

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

@@ -3,6 +3,7 @@
  * Covers: carousel slides, homepage sections
  */
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+import type { FAQCategory } from "../../faq/types";
 /** Unified background for a slide or card — supports image, video, solid color, or gradient. */
 export interface CarouselBackground {
     type: "image" | "video" | "color" | "gradient";
@@ -381,7 +382,31 @@ export interface FeaturesSectionConfig {
     learnMoreLabel?: string;
     learnMoreLink?: string;
 }
-export type FAQCategoryKey = "general" | "orders_payment" | "shipping_delivery" | "returns_refunds" | "product_information" | "account_security" | "technical_support";
+/**
+ * 🛑 An ALIAS, no longer its own union.
+ *
+ * There were FOUR same-named-or-equivalent FAQ-category unions and they had
+ * drifted in two different directions:
+ *
+ *   1. `FAQCategory`      (features/faq/types)            — 9 values, the REAL one
+ *   2. `FAQCategoryKey`   (here)                          — 7, missing scam_awareness + fees_and_taxes
+ *   3. `FAQCategory`      (admin/.../adminSectionsTypes)  — 7, DIFFERENT SPELLINGS
+ *   4. `FAQ_CATEGORY_LABELS` (homepage/constants)         — 7 keys, loosely typed
+ *
+ * (2) merely lagged. (3) was a live DATA-DESTROYING defect: its options were
+ * `shipping` / `returns` / `payment` / `account` / `products` / `sellers`, so
+ * `parseFAQBuilder` filtered every stored value against that list and only
+ * `general` survived. An admin opening the homepage FAQ section to change its
+ * TITLE saw one of five categories ticked, and saving wrote `["general"]` —
+ * permanently dropping the other four, silently, with a form that looked
+ * complete. Root Cause #76's write-shape lesson: a form that can only express
+ * a subset destroys the rest on every save.
+ *
+ * Keeping the NAME rather than deleting it: it is referenced by two fields
+ * below and by consumer code, and a rename would be churn for no gain. What
+ * matters is that it can no longer hold a different value set.
+ */
+export type FAQCategoryKey = FAQCategory;
 export interface FAQSectionConfig {
     title: string;
     subtitle?: string;

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

@@ -2,7 +2,7 @@
  * Homepage Feature Firestore Document Types & Constants
  * Covers: carousel slides, homepage sections
  */
-import { generateCarouselId, generateHomepageSectionId, } from "../../../utils/id-generators";
+import { generateCarouselId, generateHomepageSectionId, } from "../../../utils/id-generators.js";
 export class TooManySlidesError extends Error {
     constructor() {
         super(`A carousel may have at most ${MAX_SLIDES_PER_CAROUSEL} slides.`);

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

@@ -1,4 +1,4 @@
-export * from "./firestore";
+export * from "./firestore.js";
 // ─── Firestore document schemas (W2) ──────────────────────────────────────────
 // Mirrors HomepageSectionDocument + CarouselSlideDocument + CarouselDocument in
 // ./firestore.ts. Registered into:
@@ -10,7 +10,7 @@ export * from "./firestore";
 // Here the `config` field is treated as a typed `Record<string, JsonValue>` —
 // the section-builder schemas validate it at the form boundary.
 import { z } from "zod";
-import { auditTimestampsShape, firestoreDateSchema } from "../../../schemas/firestore-helpers";
+import { auditTimestampsShape, firestoreDateSchema } from "../../../schemas/firestore-helpers.js";
 export const homepageSectionTypeSchema = z.enum([
     "welcome",
     "carousel",

package/dist/features/homepage/server.js

@@ -1,9 +1,9 @@
-export * from "./actions";
-export { HomepageSectionsRepository } from "./repository/homepage.repository";
-export { carouselRepository } from "./repository/carousel.repository";
-export { homepageSectionsRepository } from "./repository/homepage-sections.repository";
-export { manifest } from "./manifest";
-export { GET as homepageGET, GET, POST } from "./api/route";
-export { homepageSectionItemGET, homepageSectionItemPATCH, homepageSectionItemDELETE, } from "./api/[id]/route";
-export { carouselGET, carouselPOST } from "./api/carousel/route";
-export { carouselItemGET, carouselItemPATCH, carouselItemDELETE, } from "./api/carousel/[id]/route";
+export * from "./actions/index.js";
+export { HomepageSectionsRepository } from "./repository/homepage.repository.js";
+export { carouselRepository } from "./repository/carousel.repository.js";
+export { homepageSectionsRepository } from "./repository/homepage-sections.repository.js";
+export { manifest } from "./manifest.js";
+export { GET as homepageGET, GET, POST } from "./api/route.js";
+export { homepageSectionItemGET, homepageSectionItemPATCH, homepageSectionItemDELETE, } from "./api/[id]/route.js";
+export { carouselGET, carouselPOST } from "./api/carousel/route.js";
+export { carouselItemGET, carouselItemPATCH, carouselItemDELETE, } from "./api/carousel/[id]/route.js";

package/dist/features/jobs/actions/enqueue-job.js

@@ -12,12 +12,12 @@
  * (`appkit/firebase/base/database.rules.json`) — the caller signs in with it
  * client-side and subscribes via `useBulkEvent({ rtdbPath: RTDB_PATHS.BULK_EVENTS })`.
  */
-import { normalizeError } from "../../../errors/normalize";
-import { serverLogger } from "../../../monitoring";
-import { jobsRepository } from "../../../repositories";
-import { JobStatusValues } from "../schemas/firestore";
-import { getAdminAuth, getAdminRealtimeDb } from "../../../providers/db-firebase";
-import { RTDB_PATHS } from "../../../providers/db-firebase/rtdb-paths";
+import { normalizeError } from "../../../errors/normalize.js";
+import { serverLogger } from "../../../monitoring/index.js";
+import { jobsRepository } from "../../../repositories/index.js";
+import { JobStatusValues } from "../schemas/firestore.js";
+import { getAdminAuth, getAdminRealtimeDb } from "../../../providers/db-firebase/index.js";
+import { RTDB_PATHS } from "../../../providers/db-firebase/rtdb-paths.js";
 export async function enqueueJob(input) {
     const job = await jobsRepository.create({
         jobType: input.jobType,

package/dist/features/jobs/repository/jobs.repository.js

@@ -4,8 +4,8 @@
  * See `appkit/src/features/jobs/schemas/firestore.ts` for the doc shape and
  * the async-job primitive's overall flow.
  */
-import { BaseRepository } from "../../../providers/db-firebase";
-import { JOBS_COLLECTION, JOB_FIELDS, JobStatusValues, } from "../schemas/firestore";
+import { BaseRepository } from "../../../providers/db-firebase/index.js";
+import { JOBS_COLLECTION, JOB_FIELDS, JobStatusValues, } from "../schemas/firestore.js";
 export class JobsRepository extends BaseRepository {
     constructor() {
         super(JOBS_COLLECTION);

package/dist/features/layout/AppLayoutShell.js

@@ -5,7 +5,7 @@ import { useCallback, useEffect, useRef, useState } from "react";
 // owns the singleton; nesting another would risk Turbopack chunk-splitting.
 // The actual 2.8.8 SSR crash was a peer-dep duplicate fixed by the
 // scripts/dedupe-peer-deps.mjs postinstall hook (see scripts/ and CLAUDE.md #19).
-import { AvatarDisplay, BackgroundRenderer, Div, Li, Main, Row, Span, Stack, Text, TextLink, Ul, UnsavedChangesModal } from "../../ui";
+import { AvatarDisplay, BackgroundRenderer, Div, Li, Main, Row, Span, Stack, Text, TextLink, Ul, UnsavedChangesModal } from "../../ui/index.js";
 // Role indicator dots — distinct hues per role tier.
 const ROLE_DOT_BG_CLASS = {
     admin: "bg-purple-600",
@@ -13,23 +13,23 @@ const ROLE_DOT_BG_CLASS = {
     seller: "bg-teal-600",
     employee: "bg-amber-500",
 };
-import { useTheme } from "../../_internal/client/theme";
-import { useAuth } from "../../react/contexts/SessionContext";
-import { useVisualViewportInset } from "../../react/hooks/useVisualViewportInset";
-import { isBuyerUser } from "../auth/role-predicates";
-import { NavbarWithSettings } from "./NavbarWithSettings";
-import BottomActions from "./BottomActions";
-import { BottomChrome } from "./BottomChrome";
-import { AutoBreadcrumbs } from "./AutoBreadcrumbs";
-import { BottomNavbar } from "./BottomNavbar";
-import { FooterLayout } from "./FooterLayout";
-import { SidebarLayout } from "./SidebarLayout";
-import { TitleBar } from "./TitleBar";
-import { BackToTop } from "./BackToTop";
-import { useDashboardNav } from "./DashboardNavContext";
-import { usePathname } from "next/navigation";
-import { findActiveNavItem } from "../../_internal/client/features/layout/navActive";
-import { OVERLAY_FALLBACK_COLOR, SEED_DARK_BG as DEFAULT_DARK_BG, SEED_LIGHT_BG as DEFAULT_LIGHT_BG } from "./background-seed-defaults";
+import { useTheme } from "../../_internal/client/theme/index.js";
+import { useAuth } from "../../react/contexts/SessionContext.js";
+import { useVisualViewportInset } from "../../react/hooks/useVisualViewportInset.js";
+import { isBuyerUser } from "../auth/role-predicates.js";
+import { NavbarWithSettings } from "./NavbarWithSettings.js";
+import BottomActions from "./BottomActions.js";
+import { BottomChrome } from "./BottomChrome.js";
+import { AutoBreadcrumbs } from "./AutoBreadcrumbs.js";
+import { BottomNavbar } from "./BottomNavbar.js";
+import { FooterLayout } from "./FooterLayout.js";
+import { SidebarLayout } from "./SidebarLayout.js";
+import { TitleBar } from "./TitleBar.js";
+import { BackToTop } from "./BackToTop.js";
+import { useDashboardNav } from "./DashboardNavContext.js";
+import { usePathname } from "next/navigation.js";
+import { findActiveNavItem } from "../../_internal/client/features/layout/navActive.js";
+import { OVERLAY_FALLBACK_COLOR, SEED_DARK_BG as DEFAULT_DARK_BG, SEED_LIGHT_BG as DEFAULT_LIGHT_BG } from "./background-seed-defaults.js";
 const CLS_STAT_BOX = "flex flex-col items-center gap-[var(--appkit-space-1)] p-[var(--appkit-space-2)] bg-[var(--appkit-color-surface)] rounded-lg text-center";
 const CLS_STAT_LABEL = "text-[length:var(--appkit-text-xs)] text-[var(--appkit-color-text-muted)]";
 const CLS_LOGOUT_BTN = "flex w-full items-center justify-end gap-[var(--appkit-space-3)] rounded-lg px-[var(--appkit-space-3)] py-[var(--appkit-space-2)] text-[length:var(--appkit-text-sm)] text-error transition-colors hover:bg-error-surface hover:text-error dark:text-error dark:hover:bg-error-surface dark:hover:text-error";

package/dist/features/layout/AutoBreadcrumbs.js

@@ -1,8 +1,8 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import Link from "next/link";
-import { usePathname } from "next/navigation";
-import { Div, Li, Nav, Ol, Span } from "../../ui";
+import Link from "next/link.js";
+import { usePathname } from "next/navigation.js";
+import { Div, Li, Nav, Ol, Span } from "../../ui/index.js";
 /** Map of path segments → human-readable labels. */
 const DEFAULT_PATH_LABELS = {
     auth: "Authentication",

package/dist/features/layout/BackToTop.js

@@ -1,11 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import Link from "next/link";
-import { usePathname } from "next/navigation";
+import Link from "next/link.js";
+import { usePathname } from "next/navigation.js";
 import { useEffect, useState } from "react";
 import { ChevronUp, X } from "lucide-react";
-import { Button, Div } from "../../ui";
-import { useHandMode } from "../../_internal/client/hand-mode";
+import { Button, Div } from "../../ui/index.js";
+import { useHandMode } from "../../_internal/client/hand-mode/index.js";
 /**
  * BackToTop — floating scroll-to-top button.
  *

package/dist/features/layout/BottomActions.js

@@ -31,9 +31,9 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  */
 import { useState, useRef, useEffect, useId } from "react";
 import { X, ChevronUp, ChevronDown, Check } from "lucide-react";
-import { useBottomActionsContext } from "./BottomActionsContext";
-import { useClickOutside } from "../../react";
-import { ActionRow, Div, Row, Span, Text, Button } from "../../ui";
+import { useBottomActionsContext } from "./BottomActionsContext.js";
+import { useClickOutside } from "../../react/index.js";
+import { ActionRow, Div, Row, Span, Text, Button } from "../../ui/index.js";
 // Token values inlined from @mohasinac/appkit/tokens
 const BOTTOM_NAV_BG = "bg-[color-mix(in_srgb,var(--appkit-color-bg)_90%,transparent)] backdrop-blur-md border-t border-[var(--appkit-color-border)]";
 const BOTTOM_NAV_HEIGHT = "h-14";

package/dist/features/layout/BottomChrome.js

@@ -1,8 +1,8 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef } from "react";
-import { Div } from "../../ui";
-import { BOTTOM_CHROME_SLOT_ID } from "../../ui/components/bottom-chrome-slot";
+import { Div } from "../../ui/index.js";
+import { BOTTOM_CHROME_SLOT_ID } from "../../ui/components/bottom-chrome-slot.js";
 /**
  * BottomChrome — the middle tier of the bottom edge.
  *

package/dist/features/layout/BottomNavItem.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Li, Span } from "../../ui";
+import { Li, Span } from "../../ui/index.js";
 /**
  * BottomNavItem — a single tap target inside `<BottomNavLayout>`.
  *

package/dist/features/layout/BottomNavLayout.js

@@ -1,8 +1,8 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect } from "react";
-import { Nav, Ul } from "../../ui";
-import { useVisualViewportInset } from "../../react/hooks/useVisualViewportInset";
+import { Nav, Ul } from "../../ui/index.js";
+import { useVisualViewportInset } from "../../react/hooks/useVisualViewportInset.js";
 /**
  * BottomNavLayout — generic fixed-bottom navigation shell.
  *

package/dist/features/layout/BottomNavbar.js

@@ -1,11 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { usePathname } from "next/navigation";
-import { AvatarDisplay, Li, Span, TextLink } from "../../ui";
-import { BottomNavLayout } from "./BottomNavLayout";
-import { NavItem } from "./NavItem";
-import { useWishlistCount } from "../wishlist/hooks/useWishlistCount";
-import { useCartCount } from "../cart/hooks/useCartCount";
+import { usePathname } from "next/navigation.js";
+import { AvatarDisplay, Li, Span, TextLink } from "../../ui/index.js";
+import { BottomNavLayout } from "./BottomNavLayout.js";
+import { NavItem } from "./NavItem.js";
+import { useWishlistCount } from "../wishlist/hooks/useWishlistCount.js";
+import { useCartCount } from "../cart/hooks/useCartCount.js";
 /** Badge counter class for the cart/wishlist slots.
  *
  * Horizontal offset comes from `.appkit-hand-badge` + the `--lg` (0.5rem) size

package/dist/features/layout/BottomSheet.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useCallback } from "react";
-import { Button, Div, Row, Span, Stack } from "../../ui";
+import { Button, Div, Row, Span, Stack } from "../../ui/index.js";
 const __O = {
     yAuto: "overflow-y-auto",
 };

package/dist/features/layout/Breadcrumbs.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
-import Link from "next/link";
-import { Li, Nav, Ol, Span } from "../../ui";
+import Link from "next/link.js";
+import { Li, Nav, Ol, Span } from "../../ui/index.js";
 /**
  * Breadcrumbs — navigation hierarchy showing the user's location.
  * Automatically adds separators between items.

package/dist/features/layout/FooterLayout.js

@@ -1,9 +1,9 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import Link from "next/link";
+import Link from "next/link.js";
 import { useState } from "react";
 import { ChevronDown } from "lucide-react";
-import { BlockFooter, Button, Div, Heading, Li, Nav, Row, Span, Stack, Text, Ul } from "../../ui";
+import { BlockFooter, Button, Div, Heading, Li, Nav, Row, Span, Stack, Text, Ul } from "../../ui/index.js";
 export function FooterLayout({ brandName, brandDescription, socialLinks, linkGroups, copyrightText, madeInText, newsletterSlot, newsletterEnabled = true, showTrustBar = false, trustBarItems = [], bottomLinks = [], id = "footer", }) {
     const [openGroups, setOpenGroups] = useState({});
     const toggleGroup = (idx) => setOpenGroups((prev) => ({ ...prev, [idx]: !prev[idx] }));

package/dist/features/layout/LocaleSwitcher.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { Select } from "../../ui";
+import { Select } from "../../ui/index.js";
 /**
  * LocaleSwitcher — generic locale selector.
  *

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

@@ -12,6 +12,12 @@ export interface MainNavbarItem {
     id?: string;
     /** RBAC permission key — item hidden when user lacks this permission. */
     requiredPermission?: string;
+    /** Sub-items, rendered as a dropdown. One level only — see NavbarLayoutItem. */
+    children?: Array<{
+        href: string;
+        label: string;
+        description?: string;
+    }>;
 }
 export interface MainNavbarProps {
     /** Pre-translated nav items to display */