simplycms 0.4.0

package/src/core/hooks/useAuth.tsx

@@ -0,0 +1,75 @@
+import React, { createContext, useCallback, useContext, useMemo } from 'react';
+import { useQuery } from '@tanstack/react-query';
+import {
+  authClient,
+  type AuthSession,
+  type AuthUser,
+} from '../lib/auth-client';
+import { fetchIsAdmin } from '../lib/auth-session';
+
+/**
+ * Контекст автентифікації вітрини (К1′б: Better Auth замість GoTrue).
+ *
+ * Форма контексту навмисно збережена з попереднього контуру — компоненти
+ * читають `user.id`/`user.email`, і переписувати їх заміна провайдера не
+ * зобовʼязана. Змінилися лише ТИПИ: `user`/`session` тепер із Better Auth.
+ */
+interface AuthContextType {
+  user: AuthUser | null;
+  session: AuthSession | null;
+  isLoading: boolean;
+  isAdmin: boolean;
+  signOut: () => Promise<void>;
+}
+
+const AuthContext = createContext<AuthContextType>({
+  user: null,
+  session: null,
+  isLoading: true,
+  isAdmin: false,
+  signOut: async () => {},
+});
+
+export function AuthProvider({ children }: { children: React.ReactNode }) {
+  // Джерело правди про сесію — атом клієнта Better Auth. Власного стану тут
+  // немає свідомо: другий стан довелося б синхронізувати з ним вручну, і
+  // саме на цій синхронізації жили гонки старого `onAuthStateChange`.
+  const { data, isPending } = authClient.useSession();
+  const user = data?.user ?? null;
+  const session = data?.session ?? null;
+
+  // Роль — окремий серверний запит (див. докблок `fetchIsAdmin`). Ключ
+  // містить id користувача, тож вихід і вхід іншим акаунтом не лишають
+  // чужого `isAdmin` у кеші.
+  const { data: isAdmin } = useQuery({
+    queryKey: ['auth', 'is-admin', user?.id ?? null],
+    queryFn: () => fetchIsAdmin(),
+    enabled: Boolean(user),
+    staleTime: 5 * 60 * 1000,
+  });
+
+  const signOut = useCallback(async () => {
+    await authClient.signOut();
+  }, []);
+
+  const value = useMemo(
+    () => ({
+      user,
+      session,
+      isLoading: isPending,
+      isAdmin: isAdmin ?? false,
+      signOut,
+    }),
+    [user, session, isPending, isAdmin, signOut],
+  );
+
+  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
+}
+
+export function useAuth() {
+  const context = useContext(AuthContext);
+  if (!context) {
+    throw new Error('useAuth must be used within an AuthProvider');
+  }
+  return context;
+}

package/src/core/hooks/useBanners.ts

@@ -0,0 +1,27 @@
+import { useQuery } from '@tanstack/react-query';
+import { getBanners } from '../lib/banners';
+
+export type { Banner, BannerButton } from 'simplycms/contracts';
+
+/**
+ * Банери одного місця розміщення.
+ *
+ * 🔴 Ані фільтр `is_active`, ані розклад показу більше не живуть у браузері:
+ * перший переїхав у предикат запиту (RLS на `banners` немає — див.
+ * `simplycms/storefront/loaders/banners`), другий рахується за годинником
+ * СЕРВЕРА, тож банер «щодня 9:00–18:00» вмикається однаково для всіх
+ * відвідувачів, а не по локальному часу кожного.
+ */
+export function useBanners(placement: string, sectionId?: string) {
+  const query = useQuery({
+    queryKey: ['banners', placement, sectionId ?? null],
+    queryFn: () =>
+      getBanners({ data: { placement, sectionId: sectionId ?? null } }),
+    staleTime: 60 * 1000,
+  });
+
+  // 🔴 `data` лишається `undefined` до відповіді, а не порожнім масивом:
+  // слайдер каркаса показує до цього моменту банери з SSR-лоадера, і
+  // підмінити їх пустим масивом означало б блимнути порожнім екраном.
+  return { data: query.data, isLoading: query.isLoading };
+}

package/src/core/hooks/useCart.tsx

@@ -0,0 +1,3 @@
+// Перенесено в simplycms/react-query. Re-export для зворотної сумісності.
+export { CartProvider, useCart } from 'simplycms/react-query';
+export type { CartItem } from 'simplycms/react-query';

package/src/core/hooks/useDiscountedPrice.ts

@@ -0,0 +1,83 @@
+import { useQuery } from '@tanstack/react-query';
+import { getDiscountEnvironment, type DiscountActor } from '../lib/discounts';
+import {
+  resolveDiscount,
+  type DiscountGroup,
+  type DiscountContext,
+  type DiscountResult,
+} from 'simplycms/domain/discounts';
+
+/** Актор до відповіді сервера: без категорії знижки просто не спрацьовують. */
+const ANONYMOUS: DiscountActor = {
+  userId: null,
+  userCategoryId: null,
+  isLoggedIn: false,
+};
+
+const NO_GROUPS: DiscountGroup[] = [];
+
+/**
+ * Правила знижок і актор — один серверний виклик на застосунок.
+ *
+ * 🔴 Раніше це були ДВА браузерні запити: дерево знижок через PostgREST і
+ * категорія покупця запитом `profiles` за `user_id` із клієнта. Обидва зникли
+ * (пояснення — у `../lib/discounts`), тож ціна на вітрині більше не залежить
+ * від того, що браузер сказав про себе.
+ *
+ * 🔴 Ключ НЕ містить id покупця: акторa визначає cookie сесії на сервері.
+ * Додати його в ключ означало б дати клієнту вибирати, чию відповідь дістати
+ * з кешу.
+ */
+function useDiscountEnvironment() {
+  return useQuery({
+    queryKey: ['discount-environment'],
+    queryFn: () => getDiscountEnvironment(),
+    staleTime: 2 * 60 * 1000,
+  });
+}
+
+/**
+ * Активні групи знижок для типу ціни покупця.
+ *
+ * 🔴 Повертає ВЛАСНИЙ вузький об'єкт, а не результат React Query: спред
+ * результату зчитує всі його поля й тим самим вимикає відстеження змін
+ * (`notifyOnChangeProps`), тобто повертає зайві ререндери сітки каталогу.
+ */
+export function useDiscountGroups(): {
+  data: DiscountGroup[];
+  isLoading: boolean;
+} {
+  const { data, isLoading } = useDiscountEnvironment();
+  return { data: data?.groups ?? NO_GROUPS, isLoading };
+}
+
+/**
+ * Контекст покупця для рушія знижок.
+ *
+ * 🔴 Повертається САМЕ поле відповіді, а не новий об'єкт: результат іде в
+ * `deps` мемоїзованих прайсингів, і свіжий літерал на кожному рендері
+ * перераховував би ціни всієї сітки каталогу без жодної зміни даних.
+ */
+export function useDiscountContext(): DiscountActor {
+  const { data } = useDiscountEnvironment();
+  return data?.actor ?? ANONYMOUS;
+}
+
+export type { DiscountActor };
+
+/** Застосовує дерево знижок до однієї ціни. */
+export function applyDiscount(
+  basePrice: number,
+  groups: DiscountGroup[],
+  context: Omit<DiscountContext, 'now'>,
+): DiscountResult {
+  if (!groups.length || basePrice <= 0) {
+    return {
+      finalPrice: basePrice,
+      totalDiscount: 0,
+      appliedDiscounts: [],
+      rejectedDiscounts: [],
+    };
+  }
+  return resolveDiscount(basePrice, groups, { ...context, now: new Date() });
+}

package/src/core/hooks/usePriceType.ts

@@ -0,0 +1,25 @@
+import { useQuery } from '@tanstack/react-query';
+import { getPriceTypeContext } from '../lib/price-type';
+import { useAuth } from './useAuth';
+
+/**
+ * Контекст цін покупця: тип за замовчуванням і персональний тип категорії.
+ *
+ * 🔴 Один серверний виклик замість двох запитів браузера — і персональний
+ * тип більше не резолвиться за `user_id`, присланим із клієнта (пояснення —
+ * у `../lib/price-type`).
+ */
+export function usePriceType() {
+  const { user } = useAuth();
+
+  const { data } = useQuery({
+    queryKey: ['price-type-context', user?.id ?? null],
+    queryFn: () => getPriceTypeContext(),
+    staleTime: 5 * 60 * 1000,
+  });
+
+  return {
+    priceTypeId: data?.priceTypeId ?? null,
+    defaultPriceTypeId: data?.defaultPriceTypeId ?? null,
+  };
+}

package/src/core/hooks/useProductReviews.ts

@@ -0,0 +1,141 @@
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { useAuth } from './useAuth';
+import { useToast } from 'simplycms/ui/use-toast';
+import { useT } from 'simplycms/i18n';
+import { deleteMyProductReview, submitProductReview } from '../lib/review-form';
+import { getProductRatings, getProductReviews } from '../lib/reviews';
+import type { ProductReviewRow } from '../lib/reviews';
+
+export type ProductReview = ProductReviewRow;
+
+const NO_REVIEWS: ProductReview[] = [];
+
+/**
+ * Відгуки товару, рейтинг і власний відгук покупця.
+ *
+ * 🔴 Список звужує АКТОР серверної транзакції, а не клієнт: анонім дістає
+ * лише `approved`, залогінений — ще й власні `pending` (політика
+ * `product_reviews_select_approved_or_own`). Раніше браузер тягнув усі рядки
+ * таблиці й фільтрував їх у пам'яті, а імена авторів добирав окремим запитом
+ * до `profiles` — тобто чужі нерозглянуті відгуки їхали в клієнт.
+ */
+export function useProductReviews(productId: string | undefined) {
+  const { user } = useAuth();
+  const { toast } = useToast();
+  const queryClient = useQueryClient();
+  const t = useT();
+
+  const reviewsQuery = useQuery({
+    queryKey: ['product-reviews', productId],
+    queryFn: () => getProductReviews({ data: { productId: productId! } }),
+    enabled: !!productId,
+    staleTime: 60 * 1000,
+  });
+
+  const invalidate = () => {
+    void queryClient.invalidateQueries({
+      queryKey: ['product-reviews', productId],
+    });
+    void queryClient.invalidateQueries({ queryKey: ['product-ratings'] });
+  };
+
+  const onError = (err: Error) =>
+    toast({
+      variant: 'destructive',
+      title: t('common.error'),
+      description: err.message,
+    });
+
+  const submitReview = useMutation({
+    mutationFn: async (data: {
+      rating: number;
+      title?: string;
+      content?: string;
+      images?: string[];
+    }) => {
+      // 🔴 Перевірка ЛИШАЄТЬСЯ, хоч автора й задає сервер: без неї відмова
+      // приїхала б англійською серверною діагностикою просто в тост покупця.
+      if (!user || !productId)
+        throw new Error(t('product.review.notAuthorized'));
+      await submitProductReview({
+        data: {
+          productId,
+          rating: data.rating,
+          title: data.title || null,
+          content: data.content || null,
+          images: data.images ?? [],
+        },
+      });
+    },
+    onSuccess: () => {
+      invalidate();
+      toast({
+        title: t('product.review.submitted'),
+        description: t('product.review.submittedDescription'),
+      });
+    },
+    onError,
+  });
+
+  const deleteReview = useMutation({
+    mutationFn: async (reviewId: string) => {
+      // `false` — рядка немає або він чужий: RLS лишила `returning` порожнім.
+      // Тихий «успіх» тут показав би відгук видаленим, доки сторінка не
+      // перезавантажиться.
+      const deleted = await deleteMyProductReview({ data: { reviewId } });
+      if (!deleted) throw new Error(t('product.review.notAuthorized'));
+    },
+    onSuccess: () => {
+      invalidate();
+      toast({ title: t('product.review.deleted') });
+    },
+    onError,
+  });
+
+  const reviews = reviewsQuery.data ?? NO_REVIEWS;
+  const approvedReviews = reviews.filter((r) => r.status === 'approved');
+  const userReview = user ? reviews.find((r) => r.user_id === user.id) : null;
+
+  return {
+    reviews,
+    approvedReviews,
+    userReview,
+    hasUserReview: !!userReview,
+    ...summarize(approvedReviews),
+    isLoading: reviewsQuery.isLoading,
+    submitReview,
+    deleteReview,
+  };
+}
+
+/** Середнє й розподіл зірок — рахуються ЛИШЕ по схвалених відгуках. */
+function summarize(approved: ProductReview[]) {
+  const distribution: Record<number, number> = { 5: 0, 4: 0, 3: 0, 2: 0, 1: 0 };
+  for (const review of approved) {
+    distribution[review.rating] = (distribution[review.rating] || 0) + 1;
+  }
+  const reviewCount = approved.length;
+  const sum = approved.reduce((total, r) => total + r.rating, 0);
+
+  return {
+    reviewCount,
+    avgRating: reviewCount > 0 ? Math.round((sum / reviewCount) * 10) / 10 : 0,
+    distribution,
+  };
+}
+
+/**
+ * Рейтинги пачки товарів для сітки каталогу.
+ *
+ * 🔴 Заміна `rpc('get_product_ratings')` — функції, якої в схемі v2 немає,
+ * тож зірки в каталозі не малювались узагалі. Агрегат рахує SQL і ЛИШЕ по
+ * `status = 'approved'` (див. `loadProductRatings`).
+ */
+export function useProductRatings(productIds: string[]) {
+  return useQuery({
+    queryKey: ['product-ratings', productIds],
+    queryFn: () => getProductRatings({ data: { productIds } }),
+    enabled: productIds.length > 0,
+    staleTime: 60 * 1000,
+  });
+}

package/src/core/hooks/useProductsWithStock.ts

@@ -0,0 +1,11 @@
+// Pure-розрахунок наявності перенесено в simplycms/domain/inventory.
+//
+// 🔴 Fetch-хелпери (`fetchModificationPropertyValues`, `fetchModificationStockData`)
+// ЗНЕСЕНО разом із контуром PostgREST: залишки й характеристики модифікацій
+// тепер рахує сервер (`storefront/loaders/stock`, `modification-values`), а
+// складські рядки по точках видачі в браузер більше не їдуть узагалі.
+export {
+  calculateProductAvailability,
+  enrichProductsWithAvailability,
+} from 'simplycms/domain/inventory';
+export type { StockData } from 'simplycms/domain/inventory';

package/src/core/hooks/useRecipientBook.ts

@@ -0,0 +1,56 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import {
+  deleteMyRecipient,
+  getMyRecipients,
+  saveMyRecipient,
+  type RecipientRow,
+} from '../lib/user-recipients';
+
+export type { RecipientRow };
+
+/** Поля форми отримувача: без `id` — створення, з `id` — редагування. */
+export interface RecipientFormInput {
+  id?: string | null;
+  firstName: string;
+  lastName: string;
+  phone: string;
+  email: string | null;
+  city: string;
+  address: string;
+  notes: string | null;
+  isDefault: boolean;
+}
+
+/** Ключ книги отримувачів — один на застосунок (див. `useAddressBook`). */
+export const RECIPIENT_BOOK_KEY = ['recipient-book'] as const;
+
+/**
+ * Книга отримувачів покупця: список + збереження + видалення.
+ *
+ * 🔴 `userId` у параметрах немає — ідентичність бере серверна сесія.
+ */
+export function useRecipientBook(enabled: boolean) {
+  const queryClient = useQueryClient();
+  const invalidate = () =>
+    queryClient.invalidateQueries({ queryKey: RECIPIENT_BOOK_KEY });
+
+  const list = useQuery({
+    queryKey: RECIPIENT_BOOK_KEY,
+    queryFn: (): Promise<RecipientRow[]> => getMyRecipients(),
+    enabled,
+  });
+
+  const save = useMutation({
+    mutationFn: (input: RecipientFormInput): Promise<string | null> =>
+      saveMyRecipient({ data: input }),
+    onSuccess: invalidate,
+  });
+
+  const remove = useMutation({
+    mutationFn: (id: string): Promise<boolean> =>
+      deleteMyRecipient({ data: { id } }),
+    onSuccess: invalidate,
+  });
+
+  return { recipients: list.data, isLoading: list.isLoading, save, remove };
+}

package/src/core/hooks/useShippingDirectory.ts

@@ -0,0 +1,61 @@
+import { useMemo } from 'react';
+import { useQuery } from '@tanstack/react-query';
+import {
+  findShippingZoneIn,
+  resolveShippingRate,
+  type ShippingCalculationResult,
+} from 'simplycms/domain/shipping';
+import {
+  getShippingDirectory,
+  type ShippingDirectory,
+} from '../lib/shipping-directory';
+
+export type { ShippingDirectory };
+
+/** Порожній довідник — форма рендериться до відповіді сервера. */
+const EMPTY: ShippingDirectory = {
+  methods: [],
+  zones: [],
+  rates: [],
+  pickupPoints: [],
+};
+
+/**
+ * Довідники доставки + розрахунок вартості способу.
+ *
+ * 🔴 Розрахунок НЕ живе тут: `resolveShippingRate` і `findShippingZoneIn` —
+ * доменні (T1) функції, і саме вони єдине джерело правила. До В2-К1а форма
+ * чекауту мала власну копію («перший тариф методу, `free_from` — нуль понад
+ * поріг»), тобто ціна в списку способів і ціна в підсумку рахувалися різним
+ * кодом і могли розійтися.
+ *
+ * 🔴 Зона резолвиться з МІСТА покупця — раніше форма зон не читала взагалі й
+ * брала перший-ліпший тариф методу незалежно від напрямку.
+ */
+export function useShippingDirectory(city: string, subtotal: number) {
+  const query = useQuery({
+    queryKey: ['shipping-directory'],
+    queryFn: (): Promise<ShippingDirectory> => getShippingDirectory(),
+    staleTime: 5 * 60 * 1000,
+  });
+
+  const directory = query.data ?? EMPTY;
+  const zone = useMemo(
+    () => findShippingZoneIn(directory.zones, city),
+    [directory.zones, city],
+  );
+
+  const rateFor = useMemo(() => {
+    const byId = new Map(directory.methods.map((m) => [m.id, m]));
+    return (methodId: string): ShippingCalculationResult | null => {
+      const method = byId.get(methodId);
+      if (!method) return null;
+      return resolveShippingRate(
+        { method, zone, cart: { items: [], subtotal } },
+        directory.rates,
+      );
+    };
+  }, [directory.methods, directory.rates, zone, subtotal]);
+
+  return { ...directory, isLoading: query.isLoading, rateFor };
+}

package/src/core/hooks/useStock.ts

@@ -0,0 +1,102 @@
+import { useQuery } from '@tanstack/react-query';
+import type { StockStatus } from 'simplycms/contracts';
+import type { Translator } from 'simplycms/i18n';
+import {
+  getActivePickupPoints,
+  getPickupPointsCount,
+  getStockInfo,
+} from '../lib/stock';
+
+export type { StockStatus };
+export type {
+  StockByPointRow as StockByPoint,
+  StockInfoRow as StockInfo,
+} from '../lib/stock';
+
+/**
+ * Наявність товару або обраної модифікації.
+ *
+ * 🔴 Заміна браузерного `rpc('get_stock_info')`: такої функції в схемі v2
+ * немає, тож блок наявності на картці товару просто не мав що показати.
+ * Тепер залишок рахує SQL під анонімним актором вітрини, а розкладка по
+ * точках видачі відсіює вимкнені точки (див. `loadStockInfo`).
+ */
+export function useStock(
+  productId?: string | null,
+  modificationId?: string | null,
+) {
+  return useQuery({
+    queryKey: ['stock-info', modificationId ?? null, productId ?? null],
+    queryFn: () =>
+      getStockInfo({
+        data: {
+          productId: modificationId ? null : (productId ?? null),
+          modificationId: modificationId ?? null,
+        },
+      }),
+    enabled: !!(productId || modificationId),
+    staleTime: 30 * 1000,
+  });
+}
+
+/** Скільки точок видачі активні — заміна `rpc('get_active_pickup_points_count')`. */
+export function usePickupPointsCount() {
+  return useQuery({
+    queryKey: ['pickup-points-count'],
+    queryFn: () => getPickupPointsCount(),
+    staleTime: 60 * 1000,
+  });
+}
+
+/** Активні точки видачі — довідник самовивозу. */
+export function usePickupPoints() {
+  return useQuery({
+    queryKey: ['active-pickup-points'],
+    queryFn: () => getActivePickupPoints(),
+    staleTime: 60 * 1000,
+  });
+}
+
+// Helper to check availability based on stock status
+export function isProductAvailable(
+  stockStatus: StockStatus | null,
+  totalQuantity: number,
+): boolean {
+  if (stockStatus === 'on_order') return true;
+  if (stockStatus === 'in_stock') return totalQuantity > 0;
+  return false;
+}
+
+// Status display helpers.
+// 🔴 `getStockStatusLabel` — не хук (викликається з ternary/мап поза
+// компонентом), тому `useT()` тут заборонений — транслятор приймає параметром,
+// як і решта не-хук функцій у пакеті (див. CLAUDE-інструкцію проєкту з i18n).
+export function getStockStatusLabel(
+  status: StockStatus | null,
+  t: Translator,
+): string {
+  switch (status) {
+    case 'in_stock':
+      return t('product.inStock');
+    case 'out_of_stock':
+      return t('product.outOfStock');
+    case 'on_order':
+      return t('product.onOrder');
+    default:
+      return t('product.stockUnknown');
+  }
+}
+
+// Кольорові класи ні від локалі, ні від t() не залежать — сигнатура незмінна.
+export function getStockStatusColor(status: StockStatus | null): string {
+  switch (status) {
+    case 'in_stock':
+      return 'text-green-600';
+    case 'out_of_stock':
+      return 'text-destructive';
+    case 'on_order':
+      return 'text-amber-600';
+    default:
+      return 'text-muted-foreground';
+  }
+}

package/src/core/index.ts

@@ -0,0 +1,83 @@
+// Тір `core` — те, що лишилося від однойменного пакета після К0: власні
+// провайдери, хуки й компоненти, які ще не розселені по цільових тірах.
+//
+// 🔴 Фасадної ролі тут БІЛЬШЕ НЕМАЄ. Реекспорти чужого (pricing, discounts,
+// shipping, `cn`, `Database`) знято разом із розчиненням пакета: споживач
+// бере їх із джерела — `simplycms/domain/*`, `simplycms/contracts`,
+// `simplycms/ui/utils`, `simplycms/supabase`. Повне розселення власних
+// модулів по тірах — свідомо поза К0.
+
+// ---- Providers ----
+export { CMSProvider } from './providers/CMSProvider';
+
+// ---- Hooks ----
+export { AuthProvider, useAuth } from './hooks/useAuth';
+export { useCart } from './hooks/useCart';
+export type { CartItem as CartItemType } from './hooks/useCart';
+export { useToast, toast } from './hooks/use-toast';
+export { useBanners } from './hooks/useBanners';
+export type { Banner, BannerButton } from './hooks/useBanners';
+export {
+  useDiscountGroups,
+  useDiscountContext,
+  applyDiscount,
+} from './hooks/useDiscountedPrice';
+export { usePriceType } from './hooks/usePriceType';
+export {
+  useProductReviews,
+  useProductRatings,
+} from './hooks/useProductReviews';
+export type { ProductReview } from './hooks/useProductReviews';
+export {
+  calculateProductAvailability,
+  enrichProductsWithAvailability,
+} from './hooks/useProductsWithStock';
+export type { StockData } from './hooks/useProductsWithStock';
+export {
+  useStock,
+  usePickupPointsCount,
+  usePickupPoints,
+  isProductAvailable,
+  getStockStatusLabel,
+  getStockStatusColor,
+} from './hooks/useStock';
+export type { StockStatus, StockByPoint, StockInfo } from './hooks/useStock';
+
+// ---- Lib ----
+// 🔴 Обгортки `signUp`/`signIn`/`signOut`/… над GoTrue знесено разом із ним
+// (К1′б). Їхня заміна — `authClient` нижче: він і є публічний API входу для
+// вітрини й тем, а не ще один шар власних функцій поверх нього.
+export { authClient } from './lib/auth-client';
+export type { AuthSession, AuthUser } from './lib/auth-client';
+
+// ---- Catalog Components ----
+export { ActiveFilters } from './components/catalog/ActiveFilters';
+export type { ActiveFilter } from './components/catalog/ActiveFilters';
+export { FilterSidebar } from './components/catalog/FilterSidebar';
+export { ModificationSelector } from './components/catalog/ModificationSelector';
+export type { ModificationStockInfo } from './components/catalog/ModificationSelector';
+export { ProductCard } from './components/catalog/ProductCard';
+export { ProductCharacteristics } from './components/catalog/ProductCharacteristics';
+export { ProductGallery } from './components/catalog/ProductGallery';
+export { StockDisplay, StockBadge } from './components/catalog/StockDisplay';
+
+// ---- Cart Components ----
+export { CartDrawer } from './components/cart/CartDrawer';
+export { CartItem } from './components/cart/CartItem';
+
+// ---- Checkout Components ----
+export { CheckoutAuthBlock } from './components/checkout/CheckoutAuthBlock';
+export { CheckoutContactForm } from './components/checkout/CheckoutContactForm';
+export { CheckoutDeliveryForm } from './components/checkout/CheckoutDeliveryForm';
+export { CheckoutOrderSummary } from './components/checkout/CheckoutOrderSummary';
+export { CheckoutPaymentForm } from './components/checkout/CheckoutPaymentForm';
+export { CheckoutRecipientForm } from './components/checkout/CheckoutRecipientForm';
+
+// ---- Reviews Components ----
+export { ProductReviews } from './components/reviews/ProductReviews';
+export { StarRating } from './components/reviews/StarRating';
+
+// ---- Profile Components ----
+export { AddressesList } from './components/profile/AddressesList';
+export { AvatarUpload } from './components/profile/AvatarUpload';
+export { RecipientsList } from './components/profile/RecipientsList';