@mohasinac/appkit 2.3.2 → 2.4.0

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

@@ -1,18 +1,71 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useState, useCallback } from "react";
-import { Search, SlidersHorizontal, X } from "lucide-react";
+import { useState, useCallback, useMemo } from "react";
+import { X } from "lucide-react";
 import { useUrlTable } from "../../../react/hooks/useUrlTable";
 import { useBlogPosts } from "../hooks/useBlog";
-import { Pagination, SortDropdown } from "../../../ui";
+import { Pagination, ListingToolbar } from "../../../ui";
 import { ROUTES } from "../../../next";
 import { BlogCard } from "./BlogListView";
 import { BlogFilters, BLOG_PUBLIC_SORT_OPTIONS } from "./BlogFilters";
 const PAGE_SIZE = 24;
+const FILTER_KEYS = ["category", "dateFrom", "dateTo"];
 export function BlogIndexListing({ initialData }) {
     const table = useUrlTable({ defaults: { pageSize: String(PAGE_SIZE), sort: "-publishedAt" } });
     const [searchInput, setSearchInput] = useState(table.get("q") || "");
     const [filterOpen, setFilterOpen] = useState(false);
+    // Pending filter state — buffered until "Apply Filters" clicked
+    const [pendingFilters, setPendingFilters] = useState(() => Object.fromEntries(FILTER_KEYS.map((k) => [k, table.get(k)])));
+    const pendingTable = useMemo(() => ({
+        get: (key) => pendingFilters[key] ?? "",
+        getNumber: (key, fallback = 0) => {
+            const v = pendingFilters[key];
+            if (!v)
+                return fallback;
+            const n = Number(v);
+            return isNaN(n) ? fallback : n;
+        },
+        set: (key, value) => setPendingFilters((p) => ({ ...p, [key]: value })),
+        setMany: (updates) => setPendingFilters((p) => ({ ...p, ...updates })),
+        clear: (keys) => {
+            const ks = keys ?? FILTER_KEYS;
+            setPendingFilters((p) => ({
+                ...p,
+                ...Object.fromEntries(ks.map((k) => [k, ""])),
+            }));
+        },
+        setPage: (_) => { },
+        setPageSize: (_) => { },
+        setSort: (_) => { },
+        buildSieveParams: () => "",
+        buildSearchParams: () => "",
+        params: new URLSearchParams(),
+    }), [pendingFilters]);
+    const openFilters = useCallback(() => {
+        setPendingFilters(Object.fromEntries(FILTER_KEYS.map((k) => [k, table.get(k)])));
+        setFilterOpen(true);
+    }, [table]);
+    const applyFilters = useCallback(() => {
+        const updates = { page: "1" };
+        for (const k of FILTER_KEYS)
+            updates[k] = pendingFilters[k] ?? "";
+        table.setMany(updates);
+        setFilterOpen(false);
+    }, [pendingFilters, table]);
+    const clearFilters = useCallback(() => {
+        setPendingFilters(Object.fromEntries(FILTER_KEYS.map((k) => [k, ""])));
+    }, []);
+    const resetAll = useCallback(() => {
+        const updates = { q: "", sort: "" };
+        for (const k of FILTER_KEYS)
+            updates[k] = "";
+        table.setMany(updates);
+        setSearchInput("");
+    }, [table]);
+    const activeFilterCount = FILTER_KEYS.filter((k) => !!table.get(k)).length;
+    const hasActiveState = !!table.get("q") ||
+        table.get("sort") !== "-publishedAt" ||
+        activeFilterCount > 0;
     const params = {
         q: table.get("q") || undefined,
         category: (table.get("category") || undefined),
@@ -26,6 +79,5 @@ export function BlogIndexListing({ initialData }) {
         table.set("q", searchInput.trim());
         table.setPage(1);
     }, [searchInput, table]);
-    const closeFilters = () => setFilterOpen(false);
-    return (_jsxs("div", { className: "min-h-screen", children: [_jsx("div", { className: "sticky top-0 z-20 border-b border-zinc-200 dark:border-slate-700 bg-white/95 dark:bg-slate-900/95 backdrop-blur-sm py-2.5 px-4", children: _jsxs("div", { className: "flex items-center gap-2.5 max-w-full", children: [_jsxs("button", { type: "button", onClick: () => setFilterOpen(true), className: "flex shrink-0 items-center gap-2 rounded-lg border border-zinc-300 dark:border-slate-600 px-3.5 py-2 text-sm font-medium text-zinc-700 dark:text-zinc-200 hover:bg-zinc-50 dark:hover:bg-slate-800 transition-colors", children: [_jsx(SlidersHorizontal, { className: "h-4 w-4" }), _jsx("span", { className: "hidden sm:inline", children: "Filters" })] }), _jsxs("div", { className: "flex flex-1 items-center overflow-hidden rounded-lg border border-zinc-300 dark:border-slate-600 bg-white dark:bg-slate-900", children: [_jsx("input", { type: "text", value: searchInput, onChange: (e) => setSearchInput(e.target.value), onKeyDown: (e) => e.key === "Enter" && commitSearch(), placeholder: "Search posts...", className: "min-w-0 flex-1 bg-transparent px-3 py-2 text-sm text-zinc-900 dark:text-zinc-100 placeholder-zinc-400 outline-none" }), _jsx("button", { type: "button", onClick: commitSearch, className: "flex shrink-0 items-center justify-center px-3 py-2 text-zinc-400 hover:text-primary dark:hover:text-primary-400 transition-colors", "aria-label": "Search", children: _jsx(Search, { className: "h-4 w-4" }) })] }), _jsxs("div", { className: "flex shrink-0 items-center gap-1.5 text-sm text-zinc-500 dark:text-zinc-400", children: [_jsx("span", { className: "hidden md:inline whitespace-nowrap", children: "Sort by" }), _jsx(SortDropdown, { value: table.get("sort") || "-publishedAt", onChange: (v) => { table.set("sort", v); table.setPage(1); }, options: BLOG_PUBLIC_SORT_OPTIONS })] })] }) }), _jsxs("div", { className: "py-6", children: [isLoading ? (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6", children: Array.from({ length: 6 }).map((_, i) => (_jsxs("div", { className: "rounded-xl border border-zinc-100 dark:border-slate-700 overflow-hidden animate-pulse", children: [_jsx("div", { className: "aspect-video bg-zinc-200 dark:bg-slate-700" }), _jsxs("div", { className: "p-5 space-y-2", children: [_jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-1/4" }), _jsx("div", { className: "h-4 bg-zinc-200 dark:bg-slate-700 rounded w-3/4" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-full" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-2/3" })] })] }, i))) })) : posts.length === 0 ? (_jsx("p", { className: "py-12 text-center text-sm text-zinc-500 dark:text-zinc-400", children: "No posts found." })) : (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6", children: posts.map((post) => (_jsx(BlogCard, { post: post, href: String(ROUTES.BLOG.ARTICLE(post.slug)) }, post.id))) })), totalPages > 1 && (_jsx("div", { className: "mt-8 flex justify-center", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) }))] }), filterOpen && (_jsxs(_Fragment, { children: [_jsx("div", { className: "fixed inset-0 z-40 bg-black/40", "aria-hidden": "true", onClick: closeFilters }), _jsxs("div", { className: "fixed inset-y-0 left-0 z-50 flex w-80 flex-col bg-white dark:bg-slate-900 shadow-2xl", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: [_jsxs("span", { className: "flex items-center gap-2 text-base font-semibold text-zinc-900 dark:text-zinc-100", children: [_jsx(SlidersHorizontal, { className: "h-4 w-4" }), "Filters"] }), _jsx("button", { type: "button", onClick: closeFilters, "aria-label": "Close filters", className: "rounded-lg p-1.5 text-zinc-500 hover:bg-zinc-100 dark:hover:bg-slate-800 transition-colors", children: _jsx(X, { className: "h-5 w-5" }) })] }), _jsx("div", { className: "flex-1 overflow-y-auto px-4 py-4", children: _jsx(BlogFilters, { table: table, variant: "public" }) }), _jsx("div", { className: "border-t border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: _jsx("button", { type: "button", onClick: closeFilters, className: "w-full rounded-lg bg-primary py-2.5 text-sm font-semibold text-white hover:bg-primary-600 transition-colors", children: "Apply filters" }) })] })] }))] }));
+    return (_jsxs("div", { className: "min-h-screen", children: [_jsx(ListingToolbar, { filterCount: activeFilterCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: "Search posts...", onSearchChange: setSearchInput, onSearchCommit: commitSearch, sortValue: table.get("sort") || "-publishedAt", sortOptions: BLOG_PUBLIC_SORT_OPTIONS, onSortChange: (v) => { table.set("sort", v); table.setPage(1); }, hideViewToggle: true, onResetAll: resetAll, hasActiveState: hasActiveState }), totalPages > 1 && (_jsx("div", { className: "sticky top-[calc(var(--header-height,0px)+44px)] z-10 flex justify-center bg-white/95 dark:bg-slate-900/95 backdrop-blur-sm border-b border-zinc-200 dark:border-slate-700 px-3 py-1.5", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) })), _jsx("div", { className: "py-6", children: isLoading ? (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6", children: Array.from({ length: 6 }).map((_, i) => (_jsxs("div", { className: "rounded-xl border border-zinc-100 dark:border-slate-700 overflow-hidden animate-pulse", children: [_jsx("div", { className: "aspect-video bg-zinc-200 dark:bg-slate-700" }), _jsxs("div", { className: "p-5 space-y-2", children: [_jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-1/4" }), _jsx("div", { className: "h-4 bg-zinc-200 dark:bg-slate-700 rounded w-3/4" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-full" }), _jsx("div", { className: "h-3 bg-zinc-200 dark:bg-slate-700 rounded w-2/3" })] })] }, i))) })) : posts.length === 0 ? (_jsx("p", { className: "py-12 text-center text-sm text-zinc-500 dark:text-zinc-400", children: "No posts found." })) : (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6", children: posts.map((post) => (_jsx(BlogCard, { post: post, href: String(ROUTES.BLOG.ARTICLE(post.slug)) }, post.id))) })) }), filterOpen && (_jsxs(_Fragment, { children: [_jsx("div", { className: "fixed inset-0 z-40 bg-black/40", "aria-hidden": "true", onClick: () => setFilterOpen(false) }), _jsxs("div", { className: "fixed inset-y-0 left-0 z-50 flex w-80 flex-col bg-white dark:bg-slate-900 shadow-2xl", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: [_jsx("span", { className: "flex items-center gap-2 text-base font-semibold text-zinc-900 dark:text-zinc-100", children: "Filters" }), _jsxs("div", { className: "flex items-center gap-2", children: [activeFilterCount > 0 && (_jsx("button", { type: "button", onClick: clearFilters, className: "text-xs text-zinc-500 hover:text-rose-500 dark:text-zinc-400 transition-colors", children: "Clear all" })), _jsx("button", { type: "button", onClick: () => setFilterOpen(false), "aria-label": "Close filters", className: "rounded-lg p-1.5 text-zinc-500 hover:bg-zinc-100 dark:hover:bg-slate-800 transition-colors", children: _jsx(X, { className: "h-5 w-5" }) })] })] }), _jsx("div", { className: "flex-1 overflow-y-auto px-4 py-4", children: _jsx(BlogFilters, { table: pendingTable, variant: "public" }) }), _jsx("div", { className: "border-t border-zinc-200 dark:border-slate-700 px-4 py-3.5", children: _jsxs("button", { type: "button", onClick: applyFilters, className: "w-full rounded-lg bg-primary py-2.5 text-sm font-semibold text-white hover:bg-primary-600 transition-colors active:scale-[0.98]", children: ["Apply Filters", activeFilterCount > 0 ? ` (${activeFilterCount})` : ""] }) })] })] }))] }));
 }

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

@@ -12,8 +12,20 @@ export async function BlogIndexPageView({ searchParams = {} }) {
     const page = Number(sp(searchParams, "page")) || 1;
     const pageSize = Number(sp(searchParams, "pageSize")) || 24;
     const category = sp(searchParams, "category");
-    const result = await blogRepository
+    const sieveResult = await blogRepository
         .listPublished({ ...(category ? { category } : {}) }, { sorts: sort, page, pageSize })
         .catch(() => null);
-    return (_jsx(Main, { children: _jsx(Section, { className: "py-10", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8 text-3xl font-semibold text-zinc-900 dark:text-zinc-50", children: "Blog" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(BlogIndexListing, { initialData: result }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
+    const initialData = sieveResult
+        ? {
+            posts: sieveResult.items,
+            meta: {
+                total: sieveResult.total,
+                page: sieveResult.page,
+                pageSize: sieveResult.pageSize,
+                totalPages: sieveResult.totalPages,
+                hasMore: sieveResult.hasMore,
+            },
+        }
+        : undefined;
+    return (_jsx(Main, { children: _jsx(Section, { className: "py-10", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8 text-3xl font-semibold text-zinc-900 dark:text-zinc-50", children: "Blog" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(BlogIndexListing, { initialData: initialData }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }

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

@@ -3,7 +3,7 @@ import { Div, Input, Label, RichTextEditor, Select, Stack, TagInput, Text, Texta
 import { Checkbox } from "../../forms/index";
 import { MediaUploadField, MediaUploadList } from "../../media/index";
 import { coerceMediaFieldArray, getMediaUrl, } from "../../media/types/index";
-import { normalizeRichTextHtml } from "../../../utils/string.formatter";
+import { normalizeRichTextHtml, slugify } from "../../../utils/string.formatter";
 export function BlogPostForm({ value, onChange, categoryOptions, statusOptions, labels, onUploadCover, onUploadContentImage, onUploadAdditionalImage, onAbort, isReadonly = false, renderContentField, renderContentReadonly, }) {
     const coverImageUrl = getMediaUrl(value.coverImage);
     const contentImages = coerceMediaFieldArray(value.contentImages);
@@ -14,7 +14,11 @@ export function BlogPostForm({ value, onChange, categoryOptions, statusOptions,
             ...partial,
         });
     };
-    return (_jsxs(Stack, { gap: "5", children: [_jsxs(Div, { className: "grid gap-4 md:grid-cols-2", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Label, { htmlFor: "blog-post-title", children: labels.title }), _jsx(Input, { id: "blog-post-title", value: value.title || "", onChange: (event) => update({ title: event.target.value }), disabled: isReadonly })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { htmlFor: "blog-post-slug", children: labels.slug }), _jsx(Input, { id: "blog-post-slug", value: value.slug || "", onChange: (event) => update({ slug: event.target.value }), disabled: isReadonly })] })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { htmlFor: "blog-post-excerpt", children: labels.excerpt }), _jsx(Textarea, { id: "blog-post-excerpt", value: value.excerpt || "", onChange: (event) => update({ excerpt: event.target.value }), rows: 3, disabled: isReadonly })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { children: labels.content }), renderContentField ? (renderContentField({
+    return (_jsxs(Stack, { gap: "5", children: [_jsxs(Div, { className: "grid gap-4 md:grid-cols-2", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Label, { htmlFor: "blog-post-title", children: labels.title }), _jsx(Input, { id: "blog-post-title", value: value.title || "", onChange: (event) => {
+                                    const title = event.target.value;
+                                    const autoSlug = `blog-${slugify(title)}`;
+                                    update({ title, slug: autoSlug });
+                                }, disabled: isReadonly })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { htmlFor: "blog-post-slug", children: labels.slug }), _jsx(Input, { id: "blog-post-slug", value: value.slug || "", onChange: (event) => update({ slug: event.target.value }), disabled: isReadonly })] })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { htmlFor: "blog-post-excerpt", children: labels.excerpt }), _jsx(Textarea, { id: "blog-post-excerpt", value: value.excerpt || "", onChange: (event) => update({ excerpt: event.target.value }), rows: 3, disabled: isReadonly })] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { children: labels.content }), renderContentField ? (renderContentField({
                         value: value.content || "",
                         onChange: (content) => update({ content }),
                         isReadonly,

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

@@ -1,3 +1,4 @@
+"use client";
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
 import { Div, Heading, RichText, Row, Span, Text } from "../../../ui";
@@ -35,5 +36,5 @@ export function BlogPostView({ slug, initialData, labels = {}, renderImage, rend
         })
         : "";
     const coverImageUrl = getMediaUrl(post.coverImage);
-    return (_jsxs(Div, { className: `min-h-screen ${className}`, children: [coverImageUrl && (_jsxs(Div, { className: "relative h-72 md:h-96 overflow-hidden", children: [renderImage ? (renderImage(post)) : (_jsx(Div, { role: "img", "aria-label": post.title, className: "h-full w-full bg-cover bg-center", style: { backgroundImage: `url(${coverImageUrl})` } })), _jsx(Div, { className: "absolute inset-0 bg-gradient-to-t from-black/50 to-transparent" })] })), _jsxs(Div, { className: "max-w-3xl mx-auto px-4 py-12", children: [_jsxs(Div, { className: "mb-8", children: [_jsxs(Row, { className: "gap-2 mb-4", children: [_jsx(Span, { className: `inline-block px-2 py-0.5 rounded-full text-xs font-medium capitalize ${CATEGORY_BADGE[post.category] ?? ""}`, children: post.category }), post.isFeatured && (_jsx(Span, { className: "bg-yellow-100 text-yellow-800 px-2 py-0.5 rounded-full text-xs font-medium", children: labels.featured ?? "Featured" }))] }), _jsx(Heading, { level: 1, className: "text-3xl font-bold mb-4", children: post.title }), post.excerpt && (_jsx(Text, { className: "text-lg text-neutral-500 mb-6", children: post.excerpt })), _jsxs(Row, { wrap: true, gap: "md", className: "text-sm text-neutral-400", children: [post.authorName && (_jsxs(Span, { children: [labels.author ?? "By", " ", _jsx(Span, { className: "font-medium text-neutral-700", children: post.authorName })] })), post.readTimeMinutes != null && (_jsxs(Span, { children: [post.readTimeMinutes, " ", labels.readTime ?? "min read"] })), date && (_jsxs(Span, { children: [labels.publishedOn ?? "Published", " ", date] })), post.views != null && (_jsxs(Span, { children: [post.views, " ", labels.viewsLabel ?? "views"] }))] })] }), post.tags && post.tags.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mb-8", children: post.tags.map((tag) => (_jsxs(Span, { className: "inline-block px-3 py-1 rounded-full bg-neutral-100 text-neutral-600 text-xs font-medium", children: ["#", tag] }, tag))) })), _jsx(Div, { className: "bg-white rounded-xl border border-neutral-200 p-8 mb-12", children: renderContent ? (renderContent(post)) : (_jsx(RichText, { html: normalizeRichTextHtml(post.content ?? ""), proseClass: "prose max-w-none dark:prose-invert", className: "text-neutral-800 dark:text-neutral-100" })) }), related.length > 0 && (_jsxs(Div, { children: [_jsx(Heading, { level: 2, className: "text-xl font-semibold mb-6", children: labels.relatedTitle ?? "Related Posts" }), _jsx(Div, { className: "grid sm:grid-cols-3 gap-6", children: related.map((rel, i) => renderRelatedCard ? (_jsx(React.Fragment, { children: renderRelatedCard(rel, i) }, rel.id)) : (_jsx(BlogCard, { post: rel }, rel.id))) })] })), renderBackButton && (_jsx(Div, { className: "mt-10 pt-8 border-t border-neutral-200", children: renderBackButton() }))] })] }));
+    return (_jsxs(Div, { className: `min-h-screen ${className}`, children: [coverImageUrl && (_jsxs(Div, { className: "relative h-72 md:h-96 overflow-hidden", children: [renderImage ? (renderImage(post)) : (_jsx(Div, { role: "img", "aria-label": post.title, className: "h-full w-full bg-cover bg-center", style: { backgroundImage: `url(${coverImageUrl})` } })), _jsx(Div, { className: "absolute inset-0 bg-gradient-to-t from-black/50 to-transparent" })] })), _jsxs(Div, { className: "max-w-3xl mx-auto px-4 py-12", children: [_jsxs(Div, { className: "mb-8", children: [_jsxs(Row, { className: "gap-2 mb-4", children: [_jsx(Span, { className: `inline-block px-2 py-0.5 rounded-full text-xs font-medium capitalize ${CATEGORY_BADGE[post.category] ?? ""}`, children: post.category }), post.isFeatured && (_jsx(Span, { className: "bg-yellow-100 text-yellow-800 px-2 py-0.5 rounded-full text-xs font-medium", children: labels.featured ?? "Featured" }))] }), _jsx(Heading, { level: 1, className: "text-3xl font-bold mb-4", children: post.title }), post.excerpt && (_jsx(Text, { className: "text-lg text-neutral-500 mb-6", children: post.excerpt })), _jsxs(Row, { wrap: true, gap: "md", className: "text-sm text-neutral-400", children: [post.authorName && (_jsxs(Span, { children: [labels.author ?? "By", " ", _jsx(Span, { className: "font-medium text-neutral-700", children: post.authorName })] })), post.readTimeMinutes != null && (_jsxs(Span, { children: [post.readTimeMinutes, " ", labels.readTime ?? "min read"] })), date && (_jsxs(Span, { children: [labels.publishedOn ?? "Published", " ", date] })), post.views != null && (_jsxs(Span, { children: [post.views, " ", labels.viewsLabel ?? "views"] }))] })] }), post.tags && post.tags.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mb-8", children: post.tags.map((tag) => (_jsxs(Span, { className: "inline-block px-3 py-1 rounded-full bg-neutral-100 text-neutral-600 text-xs font-medium", children: ["#", tag] }, tag))) })), _jsx(Div, { className: "bg-white dark:bg-slate-900 rounded-xl border border-neutral-200 dark:border-slate-700 p-8 mb-12", children: renderContent ? (renderContent(post)) : (_jsx(RichText, { html: normalizeRichTextHtml(post.content ?? ""), proseClass: "prose max-w-none dark:prose-invert", className: "text-neutral-800 dark:text-neutral-100" })) }), related.length > 0 && (_jsxs(Div, { children: [_jsx(Heading, { level: 2, className: "text-xl font-semibold mb-6", children: labels.relatedTitle ?? "Related Posts" }), _jsx(Div, { className: "grid sm:grid-cols-3 gap-6", children: related.map((rel, i) => renderRelatedCard ? (_jsx(React.Fragment, { children: renderRelatedCard(rel, i) }, rel.id)) : (_jsx(BlogCard, { post: rel }, rel.id))) })] })), renderBackButton && (_jsx(Div, { className: "mt-10 pt-8 border-t border-neutral-200", children: renderBackButton() }))] })] }));
 }

package/dist/features/blog/hooks/useBlog.d.ts

@@ -5,6 +5,7 @@ interface UseBlogPostsOptions {
     initialData?: BlogListResponse;
     enabled?: boolean;
     endpoint?: string;
+    staleTime?: number;
 }
 export declare function useBlogPosts(params?: BlogListParams, opts?: UseBlogPostsOptions): {
     posts: import("..").BlogPost[];
@@ -18,6 +19,7 @@ export declare function useBlogPosts(params?: BlogListParams, opts?: UseBlogPost
 interface UseBlogPostOptions {
     initialData?: BlogPostDetailResponse;
     enabled?: boolean;
+    staleTime?: number;
 }
 export declare function useBlogPost(slug: string, opts?: UseBlogPostOptions): {
     post: import("..").BlogPost | null;

package/dist/features/blog/hooks/useBlog.js

@@ -22,6 +22,7 @@ export function useBlogPosts(params = {}, opts) {
         queryKey: ["blog", qs],
         queryFn: () => apiClient.get(`${BLOG_ENDPOINTS.LIST}${qs ? `?${qs}` : ""}`),
         initialData: opts?.initialData,
+        staleTime: opts?.staleTime ?? (opts?.initialData !== undefined ? Infinity : 0),
         enabled: opts?.enabled,
     });
     return {
@@ -39,6 +40,7 @@ export function useBlogPost(slug, opts) {
         queryKey: ["blog", "post", slug],
         queryFn: () => apiClient.get(BLOG_ENDPOINTS.BY_SLUG(slug)),
         initialData: opts?.initialData,
+        staleTime: opts?.staleTime ?? (opts?.initialData !== undefined ? Infinity : 0),
         enabled: opts?.enabled !== false && !!slug,
     });
     return {

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

@@ -26,64 +26,86 @@ export declare const blogPostSchema: z.ZodObject<{
         type: z.ZodEnum<["image", "video", "file"]>;
         alt: z.ZodOptional<z.ZodString>;
         thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }>, z.ZodEffects<z.ZodString, {
         url: string;
         type: "image";
     }, string>]>>>, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     } | {
         url: string;
         type: "image";
     } | null, string | {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     } | null | undefined>;
     contentImages: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
         url: z.ZodString;
         type: z.ZodEnum<["image", "video", "file"]>;
         alt: z.ZodOptional<z.ZodString>;
         thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }>, "many">>>;
     additionalImages: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
         url: z.ZodString;
         type: z.ZodEnum<["image", "video", "file"]>;
         alt: z.ZodOptional<z.ZodString>;
         thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }, {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }>, "many">>>;
     category: z.ZodEnum<["news", "tips", "guides", "updates", "community"]>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -107,8 +129,10 @@ export declare const blogPostSchema: z.ZodObject<{
     coverImage: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     } | {
         url: string;
         type: "image";
@@ -116,30 +140,34 @@ export declare const blogPostSchema: z.ZodObject<{
     additionalImages: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }[];
     slug: string;
     contentImages: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }[];
     content?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     tags?: string[] | undefined;
-    authorName?: string | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
-    views?: number | undefined;
+    isFeatured?: boolean | undefined;
+    authorName?: string | undefined;
     excerpt?: string | undefined;
+    metaTitle?: string | undefined;
+    metaDescription?: string | undefined;
+    views?: number | undefined;
     authorId?: string | undefined;
     authorAvatar?: string | undefined;
     readTimeMinutes?: number | undefined;
-    metaTitle?: string | undefined;
-    metaDescription?: string | undefined;
 }, {
     id: string;
     title: string;
@@ -152,32 +180,38 @@ export declare const blogPostSchema: z.ZodObject<{
     coverImage?: string | {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     } | null | undefined;
     additionalImages?: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }[] | undefined;
     tags?: string[] | undefined;
-    authorName?: string | undefined;
-    isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
-    views?: number | undefined;
+    isFeatured?: boolean | undefined;
+    authorName?: string | undefined;
     excerpt?: string | undefined;
+    metaTitle?: string | undefined;
+    metaDescription?: string | undefined;
+    views?: number | undefined;
     contentImages?: {
         url: string;
         type: "video" | "image" | "file";
+        source?: "external" | "upload" | "youtube" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
     }[] | undefined;
     authorId?: string | undefined;
     authorAvatar?: string | undefined;
     readTimeMinutes?: number | undefined;
-    metaTitle?: string | undefined;
-    metaDescription?: string | undefined;
 }>;
 /** Base Zod schema for list-query parameters. */
 export declare const blogListParamsSchema: z.ZodObject<{
@@ -191,16 +225,16 @@ export declare const blogListParamsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
     q?: string | undefined;
-    page?: number | undefined;
     category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
+    page?: number | undefined;
     perPage?: number | undefined;
     tags?: string | undefined;
     featured?: boolean | undefined;
 }, {
     sort?: string | undefined;
     q?: string | undefined;
-    page?: number | undefined;
     category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
+    page?: number | undefined;
     perPage?: number | undefined;
     tags?: string | undefined;
     featured?: boolean | undefined;

package/dist/features/brands/actions/brand-actions.d.ts

@@ -0,0 +1,2 @@
+import type { BrandDocument } from "../schemas";
+export declare function getBrandBySlug(slug: string): Promise<BrandDocument | null>;

package/dist/features/brands/actions/brand-actions.js

@@ -0,0 +1,5 @@
+import { BrandsRepository } from "../repository/brands.repository";
+const brandsRepository = new BrandsRepository();
+export async function getBrandBySlug(slug) {
+    return brandsRepository.findBySlug(slug);
+}

package/dist/features/brands/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./schemas";
+export * from "./repository/brands.repository";
+export * from "./actions/brand-actions";

package/dist/features/brands/index.js

@@ -0,0 +1,3 @@
+export * from "./schemas";
+export * from "./repository/brands.repository";
+export * from "./actions/brand-actions";

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

@@ -0,0 +1,13 @@
+import { BaseRepository, type FirebaseSieveFields, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
+import { type BrandDocument, type BrandCreateInput, type BrandUpdateInput } from "../schemas";
+export declare class BrandsRepository extends BaseRepository<BrandDocument> {
+    constructor();
+    static readonly SIEVE_FIELDS: FirebaseSieveFields;
+    list(model: SieveModel): Promise<FirebaseSieveResult<BrandDocument>>;
+    findBySlug(slug: string): Promise<BrandDocument | null>;
+    findActive(): Promise<BrandDocument[]>;
+    create(input: BrandCreateInput): Promise<BrandDocument>;
+    update(id: string, input: BrandUpdateInput): Promise<BrandDocument>;
+    delete(id: string): Promise<void>;
+}
+export declare const brandsRepository: BrandsRepository;

package/dist/features/brands/repository/brands.repository.js

@@ -0,0 +1,60 @@
+import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { BRANDS_COLLECTION, BRAND_FIELDS, } from "../schemas";
+import { serverLogger } from "../../../monitoring";
+export class BrandsRepository extends BaseRepository {
+    constructor() {
+        super(BRANDS_COLLECTION);
+    }
+    async list(model) {
+        return this.sieveQuery(model, BrandsRepository.SIEVE_FIELDS);
+    }
+    async findBySlug(slug) {
+        const snap = await this.getCollection()
+            .where(BRAND_FIELDS.SLUG, "==", slug)
+            .limit(1)
+            .get();
+        if (snap.empty)
+            return null;
+        return this.mapDoc(snap.docs[0]);
+    }
+    async findActive() {
+        const snap = await this.getCollection()
+            .where(BRAND_FIELDS.IS_ACTIVE, "==", true)
+            .orderBy(BRAND_FIELDS.DISPLAY_ORDER)
+            .get();
+        return snap.docs.map((d) => this.mapDoc(d));
+    }
+    async create(input) {
+        const now = new Date();
+        const ref = this.getCollection().doc(input.slug);
+        const data = prepareForFirestore({
+            ...input,
+            id: ref.id,
+            createdAt: now,
+            updatedAt: now,
+        });
+        await ref.set(data);
+        serverLogger.info("Brand created", { id: ref.id, name: input.name });
+        return { ...data, id: ref.id };
+    }
+    async update(id, input) {
+        const data = prepareForFirestore({ ...input, updatedAt: new Date() });
+        await this.getCollection().doc(id).update(data);
+        const updated = await this.findById(id);
+        if (!updated)
+            throw new Error(`Brand ${id} not found after update`);
+        return updated;
+    }
+    async delete(id) {
+        await this.getCollection().doc(id).delete();
+        serverLogger.info("Brand deleted", { id });
+    }
+}
+BrandsRepository.SIEVE_FIELDS = {
+    name: { canFilter: true, canSort: true },
+    slug: { canFilter: true, canSort: false },
+    isActive: { canFilter: true, canSort: false },
+    displayOrder: { canFilter: false, canSort: true },
+    createdAt: { canFilter: true, canSort: true },
+};
+export const brandsRepository = new BrandsRepository();

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

@@ -0,0 +1,33 @@
+export declare const BRANDS_COLLECTION: "brands";
+export interface BrandDocument {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    logoURL?: string;
+    bannerURL?: string;
+    website?: string;
+    country?: string;
+    founded?: number;
+    isActive: boolean;
+    displayOrder?: number;
+    productCount?: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type BrandCreateInput = Omit<BrandDocument, "id" | "createdAt" | "updatedAt" | "productCount">;
+export type BrandUpdateInput = Partial<BrandCreateInput>;
+export declare const BRAND_FIELDS: {
+    readonly ID: "id";
+    readonly NAME: "name";
+    readonly SLUG: "slug";
+    readonly DESCRIPTION: "description";
+    readonly LOGO_URL: "logoURL";
+    readonly BANNER_URL: "bannerURL";
+    readonly WEBSITE: "website";
+    readonly IS_ACTIVE: "isActive";
+    readonly DISPLAY_ORDER: "displayOrder";
+    readonly PRODUCT_COUNT: "productCount";
+    readonly CREATED_AT: "createdAt";
+    readonly UPDATED_AT: "updatedAt";
+};

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

@@ -0,0 +1,15 @@
+export const BRANDS_COLLECTION = "brands";
+export const BRAND_FIELDS = {
+    ID: "id",
+    NAME: "name",
+    SLUG: "slug",
+    DESCRIPTION: "description",
+    LOGO_URL: "logoURL",
+    BANNER_URL: "bannerURL",
+    WEBSITE: "website",
+    IS_ACTIVE: "isActive",
+    DISPLAY_ORDER: "displayOrder",
+    PRODUCT_COUNT: "productCount",
+    CREATED_AT: "createdAt",
+    UPDATED_AT: "updatedAt",
+};

package/dist/features/brands/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @mohasinac/appkit/features/brands/server
+ *
+ * Server-only entry point — repositories and actions.
+ */
+export * from "./actions/brand-actions";
+export { BrandsRepository } from "./repository/brands.repository";

package/dist/features/brands/server.js

@@ -0,0 +1,7 @@
+/**
+ * @mohasinac/appkit/features/brands/server
+ *
+ * Server-only entry point — repositories and actions.
+ */
+export * from "./actions/brand-actions";
+export { BrandsRepository } from "./repository/brands.repository";

package/dist/features/cart/actions/cart-actions.js

@@ -37,8 +37,8 @@ export async function mergeGuestCart(userId, items) {
             price: product.price,
             currency: product.currency ?? getDefaultCurrency(),
             quantity: safeQty,
-            sellerId: product.sellerId,
-            sellerName: product.sellerName ?? "",
+            storeId: product.storeId,
+            storeName: product.storeName ?? "",
             isAuction: product.isAuction ?? false,
         });
     }

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

@@ -3,8 +3,12 @@ interface CartItemRowProps {
     item: CartItem;
     onQtyChange?: (id: string, qty: number) => void;
     onRemove?: (id: string) => void;
+    /** Product detail URL — if provided, title becomes a link */
+    href?: string;
+    /** When true: grays out item, shows "Out of Stock" badge, locks qty stepper */
+    isOutOfStock?: boolean;
 }
-export declare function CartItemRow({ item, onQtyChange, onRemove }: CartItemRowProps): import("react/jsx-runtime").JSX.Element;
+export declare function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock }: CartItemRowProps): import("react/jsx-runtime").JSX.Element;
 interface CartDrawerProps {
     isOpen: boolean;
     onClose: () => void;

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

@@ -2,11 +2,11 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Aside, Button, Div, Heading, Row, Span, Text } from "../../../ui";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { THEME_CONSTANTS } from "../../../tokens";
-export function CartItemRow({ item, onQtyChange, onRemove }) {
-    return (_jsxs(Div, { className: "flex gap-4 rounded-xl border border-neutral-200 dark:border-slate-700 bg-white dark:bg-slate-900 p-4", children: [_jsx(Div, { className: "h-20 w-20 flex-shrink-0 overflow-hidden rounded-lg bg-neutral-100 dark:bg-slate-800", children: item.meta.image && (_jsx(Div, { role: "img", "aria-label": item.meta.title, className: "h-full w-full bg-center bg-cover", style: { backgroundImage: `url(${item.meta.image})` } })) }), _jsxs(Div, { className: "flex flex-1 flex-col justify-between", children: [_jsx(Text, { className: `font-medium text-neutral-900 dark:text-zinc-100 ${THEME_CONSTANTS.utilities.textClamp2}`, children: item.meta.title }), item.meta.attributes &&
+export function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock = false }) {
+    return (_jsxs(Div, { className: `flex gap-4 rounded-xl border bg-white dark:bg-slate-900 p-4 transition-opacity ${isOutOfStock ? "border-neutral-200 dark:border-slate-700 opacity-60" : "border-neutral-200 dark:border-slate-700"}`, children: [_jsx(Div, { className: "h-20 w-20 flex-shrink-0 overflow-hidden rounded-lg bg-neutral-100 dark:bg-slate-800", children: item.meta.image && (_jsx(Div, { role: "img", "aria-label": item.meta.title, className: "h-full w-full bg-center bg-cover", style: { backgroundImage: `url(${item.meta.image})` } })) }), _jsxs(Div, { className: "flex flex-1 flex-col justify-between", children: [_jsxs(Div, { className: "flex items-start gap-1.5", children: [href ? (_jsx("a", { href: href, target: "_blank", rel: "noopener noreferrer", className: `font-medium text-neutral-900 dark:text-zinc-100 hover:underline underline-offset-2 ${THEME_CONSTANTS.utilities.textClamp2}`, children: item.meta.title })) : (_jsx(Text, { className: `font-medium text-neutral-900 dark:text-zinc-100 ${THEME_CONSTANTS.utilities.textClamp2}`, children: item.meta.title })), isOutOfStock && (_jsx(Span, { className: "flex-shrink-0 rounded bg-red-100 dark:bg-red-900/30 px-1.5 py-0.5 text-[10px] font-semibold uppercase tracking-wide text-[var(--appkit-color-error)]", children: "Out of Stock" }))] }), item.meta.attributes &&
                         Object.keys(item.meta.attributes).length > 0 && (_jsx(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: Object.entries(item.meta.attributes)
                             .map(([k, v]) => `${k}: ${v}`)
-                            .join(", ") })), _jsxs(Row, { justify: "between", children: [_jsx(Text, { className: "font-semibold text-neutral-900 dark:text-zinc-100", children: formatCurrency(item.meta.price * item.quantity, item.meta.currency) }), onQtyChange && (_jsxs(Row, { className: "gap-2", children: [_jsx(Button, { onClick: () => onQtyChange(item.id, item.quantity - 1), disabled: item.quantity <= 1, variant: "outline", size: "sm", className: "flex h-7 w-7 items-center justify-center rounded-full border border-neutral-200 dark:border-slate-600 text-sm disabled:opacity-40", children: "\u2212" }), _jsx(Span, { className: "min-w-[1.5rem] text-center text-sm", children: item.quantity }), _jsx(Button, { onClick: () => onQtyChange(item.id, item.quantity + 1), variant: "outline", size: "sm", className: "flex h-7 w-7 items-center justify-center rounded-full border border-neutral-200 dark:border-slate-600 text-sm", children: "+" })] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": "Remove from cart", className: "self-start text-neutral-400 dark:text-zinc-500 transition hover:text-red-500", children: "\u2715" }))] }));
+                            .join(", ") })), _jsxs(Row, { justify: "between", children: [_jsx(Text, { className: "font-semibold text-neutral-900 dark:text-zinc-100", children: formatCurrency(item.meta.price * item.quantity, item.meta.currency) }), onQtyChange && !isOutOfStock && (_jsxs(Row, { className: "gap-2", children: [_jsx(Button, { onClick: () => onQtyChange(item.id, item.quantity - 1), disabled: item.quantity <= 1, variant: "outline", size: "sm", className: "flex h-7 w-7 items-center justify-center rounded-full border border-neutral-200 dark:border-slate-600 text-sm disabled:opacity-40", children: "\u2212" }), _jsx(Span, { className: "min-w-[1.5rem] text-center text-sm", children: item.quantity }), _jsx(Button, { onClick: () => onQtyChange(item.id, item.quantity + 1), variant: "outline", size: "sm", className: "flex h-7 w-7 items-center justify-center rounded-full border border-neutral-200 dark:border-slate-600 text-sm", children: "+" })] })), isOutOfStock && (_jsxs(Span, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: ["Qty: ", item.quantity] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": "Remove from cart", className: "self-start text-neutral-400 dark:text-zinc-500 transition hover:text-red-500", children: "\u2715" }))] }));
 }
 export function CartDrawer({ isOpen, onClose, items, subtotal = 0, currency, isLoading, onQtyChange, onRemove, onCheckout, labels = {}, }) {
     if (!isOpen)

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

@@ -2,6 +2,7 @@
  * useCartCount
  *
  * Returns a live cart count, preferring server cart data when available
- * and falling back to guest-cart storage.
+ * and falling back to guest-cart storage. Pass `enabled=true` only when
+ * a user session exists — prevents unauthenticated API calls sitewide.
  */
-export declare function useCartCount(): number;
+export declare function useCartCount(enabled?: boolean): number;