@rovela-ai/sdk 0.1.2 → 0.1.4

package/dist/products/hooks/useProducts.d.ts

@@ -0,0 +1,67 @@
+import type { Product } from '../../core/types';
+export interface UseProductsOptions {
+    /** Filter by category ID */
+    category?: string;
+    /** Search by product name */
+    search?: string;
+    /** Sort order */
+    sort?: 'newest' | 'price-asc' | 'price-desc' | 'name';
+    /** Filter by variant attributes */
+    attributes?: Record<string, string[]>;
+    /** Minimum price filter */
+    minPrice?: number;
+    /** Maximum price filter */
+    maxPrice?: number;
+    /** Page size (default 12) */
+    limit?: number;
+    /** Initial page (default 1) */
+    initialPage?: number;
+    /** API endpoint (default /api/products) */
+    endpoint?: string;
+}
+export interface UseProductsReturn {
+    /** List of products */
+    products: Product[];
+    /** Total number of products matching filters */
+    total: number;
+    /** Current page (1-based) */
+    page: number;
+    /** Whether data is currently loading */
+    isLoading: boolean;
+    /** Error if request failed */
+    error: Error | null;
+    /** Whether there are more products to load */
+    hasMore: boolean;
+    /** Load the next page of products */
+    loadMore: () => void;
+    /** Refresh the current page */
+    refresh: () => void;
+    /** Go to a specific page */
+    setPage: (page: number) => void;
+}
+/**
+ * Hook for fetching and managing product listings.
+ *
+ * @example
+ * ```tsx
+ * import { useProducts } from '@rovela/sdk/products'
+ *
+ * function ProductList() {
+ *   const { products, isLoading, hasMore, loadMore } = useProducts({
+ *     category: 'shirts',
+ *     sort: 'price-asc',
+ *   })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <>
+ *       <ProductGrid products={products} />
+ *       {hasMore && <button onClick={loadMore}>Load More</button>}
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+export declare function useProducts(options?: UseProductsOptions): UseProductsReturn;
+//# sourceMappingURL=useProducts.d.ts.map

package/dist/products/hooks/useProducts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProducts.d.ts","sourceRoot":"","sources":["../../../src/products/hooks/useProducts.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAM/C,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB;IACjB,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAA;IACrD,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACrC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAA;IAClB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,4BAA4B;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA0H/E"}

package/dist/products/hooks/useProducts.js

@@ -0,0 +1,132 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useProducts = useProducts;
+/**
+ * @rovela/sdk/products/hooks/useProducts
+ *
+ * Hook for fetching product listings with filtering, sorting, and pagination.
+ */
+const react_1 = require("react");
+// =============================================================================
+// Hook
+// =============================================================================
+/**
+ * Hook for fetching and managing product listings.
+ *
+ * @example
+ * ```tsx
+ * import { useProducts } from '@rovela/sdk/products'
+ *
+ * function ProductList() {
+ *   const { products, isLoading, hasMore, loadMore } = useProducts({
+ *     category: 'shirts',
+ *     sort: 'price-asc',
+ *   })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <>
+ *       <ProductGrid products={products} />
+ *       {hasMore && <button onClick={loadMore}>Load More</button>}
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+function useProducts(options = {}) {
+    const { category, search, sort = 'newest', attributes, minPrice, maxPrice, limit = 12, initialPage = 1, endpoint = '/api/products', } = options;
+    const [products, setProducts] = (0, react_1.useState)([]);
+    const [total, setTotal] = (0, react_1.useState)(0);
+    const [page, setPage] = (0, react_1.useState)(initialPage);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [hasMore, setHasMore] = (0, react_1.useState)(false);
+    // Track if we're appending (loadMore) or replacing (new filters)
+    const isAppending = (0, react_1.useRef)(false);
+    // Build query string
+    const buildQueryString = (0, react_1.useCallback)((pageNum) => {
+        const params = new URLSearchParams();
+        params.set('page', pageNum.toString());
+        params.set('limit', limit.toString());
+        params.set('sort', sort);
+        if (category)
+            params.set('category', category);
+        if (search)
+            params.set('search', search);
+        if (minPrice !== undefined)
+            params.set('minPrice', minPrice.toString());
+        if (maxPrice !== undefined)
+            params.set('maxPrice', maxPrice.toString());
+        if (attributes) {
+            params.set('attributes', JSON.stringify(attributes));
+        }
+        return params.toString();
+    }, [category, search, sort, attributes, minPrice, maxPrice, limit]);
+    // Fetch products
+    const fetchProducts = (0, react_1.useCallback)(async (pageNum, append = false) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const queryString = buildQueryString(pageNum);
+            const response = await fetch(`${endpoint}?${queryString}`);
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                throw new Error(errorData.error || `HTTP ${response.status}`);
+            }
+            const data = await response.json();
+            if (append) {
+                setProducts((prev) => [...prev, ...data.data]);
+            }
+            else {
+                setProducts(data.data);
+            }
+            setTotal(data.total);
+            setHasMore(data.hasMore);
+            setPage(pageNum);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error('Failed to fetch products'));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [buildQueryString, endpoint]);
+    // Initial fetch and refetch when filters change
+    (0, react_1.useEffect)(() => {
+        isAppending.current = false;
+        fetchProducts(1, false);
+    }, [category, search, sort, attributes, minPrice, maxPrice, limit]);
+    // Load more products
+    const loadMore = (0, react_1.useCallback)(() => {
+        if (!isLoading && hasMore) {
+            isAppending.current = true;
+            fetchProducts(page + 1, true);
+        }
+    }, [isLoading, hasMore, page, fetchProducts]);
+    // Refresh current page
+    const refresh = (0, react_1.useCallback)(() => {
+        isAppending.current = false;
+        fetchProducts(page, false);
+    }, [page, fetchProducts]);
+    // Go to specific page
+    const goToPage = (0, react_1.useCallback)((newPage) => {
+        if (newPage !== page && newPage >= 1) {
+            isAppending.current = false;
+            fetchProducts(newPage, false);
+        }
+    }, [page, fetchProducts]);
+    return {
+        products,
+        total,
+        page,
+        isLoading,
+        error,
+        hasMore,
+        loadMore,
+        refresh,
+        setPage: goToPage,
+    };
+}
+//# sourceMappingURL=useProducts.js.map

package/dist/products/hooks/useProducts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProducts.js","sourceRoot":"","sources":["../../../src/products/hooks/useProducts.ts"],"names":[],"mappings":";AAAA,YAAY,CAAA;;AAqFZ,kCA0HC;AA7MD;;;;GAIG;AAEH,iCAAgE;AAiDhE,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,WAAW,CAAC,UAA8B,EAAE;IAC1D,MAAM,EACJ,QAAQ,EACR,MAAM,EACN,IAAI,GAAG,QAAQ,EACf,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,KAAK,GAAG,EAAE,EACV,WAAW,GAAG,CAAC,EACf,QAAQ,GAAG,eAAe,GAC3B,GAAG,OAAO,CAAA;IAEX,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EAAY,EAAE,CAAC,CAAA;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,CAAC,CAAC,CAAA;IACrC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAA,gBAAQ,EAAC,WAAW,CAAC,CAAA;IAC7C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAe,IAAI,CAAC,CAAA;IACtD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAA;IAE7C,iEAAiE;IACjE,MAAM,WAAW,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAA;IAEjC,qBAAqB;IACrB,MAAM,gBAAgB,GAAG,IAAA,mBAAW,EAClC,CAAC,OAAe,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QAEpC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;QACtC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;QACrC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAExB,IAAI,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QAC9C,IAAI,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACxC,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;QACvE,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;QACvE,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAA;QACtD,CAAC;QAED,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC1B,CAAC,EACD,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAChE,CAAA;IAED,iBAAiB;IACjB,MAAM,aAAa,GAAG,IAAA,mBAAW,EAC/B,KAAK,EAAE,OAAe,EAAE,SAAkB,KAAK,EAAE,EAAE;QACjD,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEd,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;YAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,IAAI,WAAW,EAAE,CAAC,CAAA;YAE1D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBACzD,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;YAC/D,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAElC,IAAI,MAAM,EAAE,CAAC;gBACX,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;YAChD,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACxB,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACpB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACxB,OAAO,CAAC,OAAO,CAAC,CAAA;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAA;QAC9E,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;IACH,CAAC,EACD,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAC7B,CAAA;IAED,gDAAgD;IAChD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,KAAK,CAAA;QAC3B,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;IAEnE,qBAAqB;IACrB,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAChC,IAAI,CAAC,SAAS,IAAI,OAAO,EAAE,CAAC;YAC1B,WAAW,CAAC,OAAO,GAAG,IAAI,CAAA;YAC1B,aAAa,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAA;IAE7C,uBAAuB;IACvB,MAAM,OAAO,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC/B,WAAW,CAAC,OAAO,GAAG,KAAK,CAAA;QAC3B,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC5B,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAA;IAEzB,sBAAsB;IACtB,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAC1B,CAAC,OAAe,EAAE,EAAE;QAClB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YACrC,WAAW,CAAC,OAAO,GAAG,KAAK,CAAA;YAC3B,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC,EACD,CAAC,IAAI,EAAE,aAAa,CAAC,CACtB,CAAA;IAED,OAAO;QACL,QAAQ;QACR,KAAK;QACL,IAAI;QACJ,SAAS;QACT,KAAK;QACL,OAAO;QACP,QAAQ;QACR,OAAO;QACP,OAAO,EAAE,QAAQ;KAClB,CAAA;AACH,CAAC"}

package/dist/products/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @rovela/sdk/products
+ *
+ * Product catalog module: display, search, filtering, variant selection.
+ *
+ * Components:
+ * - ProductCard, ProductGrid, ProductDetails
+ * - VariantSelector, ProductGallery, CategoryNav
+ * - ProductSearch, ProductFilters, ProductSort, ProductBreadcrumb
+ *
+ * Hooks:
+ * - useProducts, useProduct, useCategories, useProductAttributes
+ *
+ * API Route Handlers:
+ * - getProducts (GET /api/products)
+ * - getProduct (GET /api/products/[slug])
+ * - getCategories (GET /api/categories)
+ *
+ * @example
+ * ```tsx
+ * // In a product listing page
+ * import {
+ *   ProductGrid,
+ *   ProductSearch,
+ *   ProductSort,
+ *   CategoryNav,
+ *   useProducts,
+ *   useCategories,
+ * } from '@rovela/sdk/products'
+ *
+ * function ProductsPage() {
+ *   const [search, setSearch] = useState('')
+ *   const [sort, setSort] = useState('newest')
+ *   const [category, setCategory] = useState(null)
+ *
+ *   const { products, isLoading, hasMore, loadMore } = useProducts({
+ *     search,
+ *     sort,
+ *     category,
+ *   })
+ *
+ *   const { tree: categories } = useCategories()
+ *
+ *   return (
+ *     <div className="flex gap-8">
+ *       <aside className="w-64">
+ *         <CategoryNav
+ *           categories={categories}
+ *           activeSlug={category}
+ *           variant="vertical"
+ *         />
+ *       </aside>
+ *       <main className="flex-1">
+ *         <div className="flex gap-4 mb-6">
+ *           <ProductSearch
+ *             value={search}
+ *             onSearch={setSearch}
+ *             placeholder="Search products..."
+ *           />
+ *           <ProductSort value={sort} onChange={setSort} />
+ *         </div>
+ *         <ProductGrid
+ *           products={products}
+ *           isLoading={isLoading}
+ *           cardProps={{ showQuickAdd: true }}
+ *         />
+ *         {hasMore && (
+ *           <button onClick={loadMore}>Load More</button>
+ *         )}
+ *       </main>
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // In app/api/products/route.ts
+ * export { getProducts as GET } from '@rovela/sdk/products/api'
+ *
+ * // In app/api/products/[slug]/route.ts
+ * export { getProduct as GET } from '@rovela/sdk/products/api'
+ *
+ * // In app/api/categories/route.ts
+ * export { getCategories as GET } from '@rovela/sdk/products/api'
+ * ```
+ */
+export { ProductCard, ProductGrid, ProductDetails, VariantSelector, ProductGallery, CategoryNav, ProductBreadcrumb, ProductSearch, ProductSort, ProductFilterPanel, } from './components';
+export type { ProductCardProps, ProductGridProps, ProductDetailsProps, VariantSelectorProps, ProductGalleryProps, CategoryNavProps, ProductBreadcrumbProps, BreadcrumbItem, ProductSearchProps, ProductSortProps, SortOption, SortOptionConfig, ProductFilterPanelProps, ProductFilterValues, } from './components';
+export { useProducts, useProduct, useCategories, useProductAttributes, } from './hooks';
+export type { UseProductsOptions, UseProductsReturn, UseProductOptions, UseProductReturn, UseCategoriesOptions, UseCategoriesReturn, CategoryWithChildren, UseProductAttributesOptions, UseProductAttributesReturn, ProductAttribute, PriceRange, } from './hooks';
+export { getProducts, getProduct, getCategories, } from './api';
+export type { ProductsApiResponse, ProductsApiError, ProductApiResponse, ProductApiError, CategoriesApiResponse, CategoriesApiError, } from './api';
+//# sourceMappingURL=index.d.ts.map

package/dist/products/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/products/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AAMH,OAAO,EAEL,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,EACf,cAAc,EAEd,WAAW,EACX,iBAAiB,EAEjB,aAAa,EACb,WAAW,EACX,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AAMrB,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,oBAAoB,GACrB,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,EAChB,UAAU,GACX,MAAM,SAAS,CAAA;AAMhB,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,OAAO,CAAA;AAEd,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,OAAO,CAAA"}

package/dist/products/index.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * @rovela/sdk/products
+ *
+ * Product catalog module: display, search, filtering, variant selection.
+ *
+ * Components:
+ * - ProductCard, ProductGrid, ProductDetails
+ * - VariantSelector, ProductGallery, CategoryNav
+ * - ProductSearch, ProductFilters, ProductSort, ProductBreadcrumb
+ *
+ * Hooks:
+ * - useProducts, useProduct, useCategories, useProductAttributes
+ *
+ * API Route Handlers:
+ * - getProducts (GET /api/products)
+ * - getProduct (GET /api/products/[slug])
+ * - getCategories (GET /api/categories)
+ *
+ * @example
+ * ```tsx
+ * // In a product listing page
+ * import {
+ *   ProductGrid,
+ *   ProductSearch,
+ *   ProductSort,
+ *   CategoryNav,
+ *   useProducts,
+ *   useCategories,
+ * } from '@rovela/sdk/products'
+ *
+ * function ProductsPage() {
+ *   const [search, setSearch] = useState('')
+ *   const [sort, setSort] = useState('newest')
+ *   const [category, setCategory] = useState(null)
+ *
+ *   const { products, isLoading, hasMore, loadMore } = useProducts({
+ *     search,
+ *     sort,
+ *     category,
+ *   })
+ *
+ *   const { tree: categories } = useCategories()
+ *
+ *   return (
+ *     <div className="flex gap-8">
+ *       <aside className="w-64">
+ *         <CategoryNav
+ *           categories={categories}
+ *           activeSlug={category}
+ *           variant="vertical"
+ *         />
+ *       </aside>
+ *       <main className="flex-1">
+ *         <div className="flex gap-4 mb-6">
+ *           <ProductSearch
+ *             value={search}
+ *             onSearch={setSearch}
+ *             placeholder="Search products..."
+ *           />
+ *           <ProductSort value={sort} onChange={setSort} />
+ *         </div>
+ *         <ProductGrid
+ *           products={products}
+ *           isLoading={isLoading}
+ *           cardProps={{ showQuickAdd: true }}
+ *         />
+ *         {hasMore && (
+ *           <button onClick={loadMore}>Load More</button>
+ *         )}
+ *       </main>
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // In app/api/products/route.ts
+ * export { getProducts as GET } from '@rovela/sdk/products/api'
+ *
+ * // In app/api/products/[slug]/route.ts
+ * export { getProduct as GET } from '@rovela/sdk/products/api'
+ *
+ * // In app/api/categories/route.ts
+ * export { getCategories as GET } from '@rovela/sdk/products/api'
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCategories = exports.getProduct = exports.getProducts = exports.useProductAttributes = exports.useCategories = exports.useProduct = exports.useProducts = exports.ProductFilterPanel = exports.ProductSort = exports.ProductSearch = exports.ProductBreadcrumb = exports.CategoryNav = exports.ProductGallery = exports.VariantSelector = exports.ProductDetails = exports.ProductGrid = exports.ProductCard = void 0;
+// =============================================================================
+// Components
+// =============================================================================
+var components_1 = require("./components");
+// Core display
+Object.defineProperty(exports, "ProductCard", { enumerable: true, get: function () { return components_1.ProductCard; } });
+Object.defineProperty(exports, "ProductGrid", { enumerable: true, get: function () { return components_1.ProductGrid; } });
+Object.defineProperty(exports, "ProductDetails", { enumerable: true, get: function () { return components_1.ProductDetails; } });
+Object.defineProperty(exports, "VariantSelector", { enumerable: true, get: function () { return components_1.VariantSelector; } });
+Object.defineProperty(exports, "ProductGallery", { enumerable: true, get: function () { return components_1.ProductGallery; } });
+// Navigation
+Object.defineProperty(exports, "CategoryNav", { enumerable: true, get: function () { return components_1.CategoryNav; } });
+Object.defineProperty(exports, "ProductBreadcrumb", { enumerable: true, get: function () { return components_1.ProductBreadcrumb; } });
+// Filtering
+Object.defineProperty(exports, "ProductSearch", { enumerable: true, get: function () { return components_1.ProductSearch; } });
+Object.defineProperty(exports, "ProductSort", { enumerable: true, get: function () { return components_1.ProductSort; } });
+Object.defineProperty(exports, "ProductFilterPanel", { enumerable: true, get: function () { return components_1.ProductFilterPanel; } });
+// =============================================================================
+// Hooks
+// =============================================================================
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useProducts", { enumerable: true, get: function () { return hooks_1.useProducts; } });
+Object.defineProperty(exports, "useProduct", { enumerable: true, get: function () { return hooks_1.useProduct; } });
+Object.defineProperty(exports, "useCategories", { enumerable: true, get: function () { return hooks_1.useCategories; } });
+Object.defineProperty(exports, "useProductAttributes", { enumerable: true, get: function () { return hooks_1.useProductAttributes; } });
+// =============================================================================
+// API Route Handlers
+// =============================================================================
+var api_1 = require("./api");
+Object.defineProperty(exports, "getProducts", { enumerable: true, get: function () { return api_1.getProducts; } });
+Object.defineProperty(exports, "getProduct", { enumerable: true, get: function () { return api_1.getProduct; } });
+Object.defineProperty(exports, "getCategories", { enumerable: true, get: function () { return api_1.getCategories; } });
+//# sourceMappingURL=index.js.map

package/dist/products/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/products/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;;;AAEH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,2CAcqB;AAbnB,eAAe;AACf,yGAAA,WAAW,OAAA;AACX,yGAAA,WAAW,OAAA;AACX,4GAAA,cAAc,OAAA;AACd,6GAAA,eAAe,OAAA;AACf,4GAAA,cAAc,OAAA;AACd,aAAa;AACb,yGAAA,WAAW,OAAA;AACX,+GAAA,iBAAiB,OAAA;AACjB,YAAY;AACZ,2GAAA,aAAa,OAAA;AACb,yGAAA,WAAW,OAAA;AACX,gHAAA,kBAAkB,OAAA;AAoBpB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,iCAKgB;AAJd,oGAAA,WAAW,OAAA;AACX,mGAAA,UAAU,OAAA;AACV,sGAAA,aAAa,OAAA;AACb,6GAAA,oBAAoB,OAAA;AAiBtB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,6BAIc;AAHZ,kGAAA,WAAW,OAAA;AACX,iGAAA,UAAU,OAAA;AACV,oGAAA,aAAa,OAAA"}

package/dist/theme/ThemeProvider.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @rovela/sdk/theme/ThemeProvider
+ *
+ * Runtime theme provider for accessing blueprint theme data in React components.
+ * Provides theme context to all child components.
+ */
+import { type ReactNode } from 'react';
+import type { BlueprintTheme } from '../core/config';
+interface ThemeContextValue {
+    theme: BlueprintTheme;
+    colors: BlueprintTheme['colors'];
+    typography: BlueprintTheme['typography'];
+    spacing: BlueprintTheme['spacing'];
+    borders: BlueprintTheme['borders'];
+    effects: BlueprintTheme['effects'];
+}
+declare const ThemeContext: import("react").Context<ThemeContextValue | null>;
+interface ThemeProviderProps {
+    /**
+     * Theme configuration from blueprint.
+     * Pass the blueprint.theme object here.
+     */
+    theme: BlueprintTheme;
+    /**
+     * Child components that will have access to the theme.
+     */
+    children: ReactNode;
+}
+/**
+ * ThemeProvider component that makes theme configuration available
+ * to all child components via React context.
+ *
+ * @example
+ * // In app/layout.tsx:
+ * import { ThemeProvider } from '@rovela/sdk/theme'
+ * import { getTheme } from '@rovela/sdk/core'
+ *
+ * export default function RootLayout({ children }) {
+ *   const theme = getTheme()
+ *   return (
+ *     <html>
+ *       <body>
+ *         <ThemeProvider theme={theme}>
+ *           {children}
+ *         </ThemeProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ */
+export declare function ThemeProvider({ theme, children }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the theme context.
+ * Must be used within a ThemeProvider.
+ *
+ * @returns Theme context value
+ * @throws Error if used outside ThemeProvider
+ *
+ * @example
+ * import { useThemeContext } from '@rovela/sdk/theme'
+ *
+ * function MyComponent() {
+ *   const { colors, typography } = useThemeContext()
+ *   return <div style={{ color: colors.primary[500] }}>...</div>
+ * }
+ */
+export declare function useThemeContext(): ThemeContextValue;
+export { ThemeContext };
+export type { ThemeContextValue, ThemeProviderProps };
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/theme/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAMpD,UAAU,iBAAiB;IACzB,KAAK,EAAE,cAAc,CAAA;IACrB,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IAChC,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,CAAA;IACxC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IAClC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IAClC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;CACnC;AAED,QAAA,MAAM,YAAY,mDAAgD,CAAA;AAMlE,UAAU,kBAAkB;IAC1B;;;OAGG;IACH,KAAK,EAAE,cAAc,CAAA;IACrB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,kBAAkB,2CAepE;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAWnD;AAMD,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/theme/ThemeProvider.js

@@ -0,0 +1,77 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeContext = void 0;
+exports.ThemeProvider = ThemeProvider;
+exports.useThemeContext = useThemeContext;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * @rovela/sdk/theme/ThemeProvider
+ *
+ * Runtime theme provider for accessing blueprint theme data in React components.
+ * Provides theme context to all child components.
+ */
+const react_1 = require("react");
+const ThemeContext = (0, react_1.createContext)(null);
+exports.ThemeContext = ThemeContext;
+/**
+ * ThemeProvider component that makes theme configuration available
+ * to all child components via React context.
+ *
+ * @example
+ * // In app/layout.tsx:
+ * import { ThemeProvider } from '@rovela/sdk/theme'
+ * import { getTheme } from '@rovela/sdk/core'
+ *
+ * export default function RootLayout({ children }) {
+ *   const theme = getTheme()
+ *   return (
+ *     <html>
+ *       <body>
+ *         <ThemeProvider theme={theme}>
+ *           {children}
+ *         </ThemeProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ */
+function ThemeProvider({ theme, children }) {
+    // Memoize context value to prevent unnecessary re-renders
+    const value = (0, react_1.useMemo)(() => ({
+        theme,
+        colors: theme.colors,
+        typography: theme.typography,
+        spacing: theme.spacing,
+        borders: theme.borders,
+        effects: theme.effects,
+    }), [theme]);
+    return (0, jsx_runtime_1.jsx)(ThemeContext.Provider, { value: value, children: children });
+}
+// =============================================================================
+// Context Hook
+// =============================================================================
+/**
+ * Hook to access the theme context.
+ * Must be used within a ThemeProvider.
+ *
+ * @returns Theme context value
+ * @throws Error if used outside ThemeProvider
+ *
+ * @example
+ * import { useThemeContext } from '@rovela/sdk/theme'
+ *
+ * function MyComponent() {
+ *   const { colors, typography } = useThemeContext()
+ *   return <div style={{ color: colors.primary[500] }}>...</div>
+ * }
+ */
+function useThemeContext() {
+    const context = (0, react_1.useContext)(ThemeContext);
+    if (!context) {
+        throw new Error('useThemeContext must be used within a ThemeProvider. ' +
+            'Make sure to wrap your app with <ThemeProvider theme={...}>.');
+    }
+    return context;
+}
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/ThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAA;;;AAiEZ,sCAeC;AAqBD,0CAWC;;AA9GD;;;;;GAKG;AAEH,iCAA0E;AAgB1E,MAAM,YAAY,GAAG,IAAA,qBAAa,EAA2B,IAAI,CAAC,CAAA;AA6FzD,oCAAY;AA3ErB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAsB;IACnE,0DAA0D;IAC1D,MAAM,KAAK,GAAG,IAAA,eAAO,EACnB,GAAG,EAAE,CAAC,CAAC;QACL,KAAK;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,EACF,CAAC,KAAK,CAAC,CACR,CAAA;IAED,OAAO,uBAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAA;AAChF,CAAC;AAED,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,SAAgB,eAAe;IAC7B,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,YAAY,CAAC,CAAA;IAExC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,8DAA8D,CACjE,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}