@onexapis/cli 1.1.32 → 1.1.34

package/dist/preview/preview-app.tsx

@@ -24,7 +24,11 @@ import { initializeOnex } from "@onexapis/core";
 import * as coreHooksAll from "@onexapis/core/hooks";
 import * as coreInternal from "@onexapis/core/internal";
 import * as coreTypes from "@onexapis/core/types";
-import { CartProvider, FlyToCartProvider } from "@onexapis/core/contexts";
+import {
+  CartProvider,
+  FlyToCartProvider,
+  PageDataProvider,
+} from "@onexapis/core/contexts";
 import { LocaleProvider } from "@onexapis/core/contexts";
 
 // @onexapis/core/hooks is the single source of truth — no manual composition.
@@ -744,7 +748,9 @@ root.render(
     <LocaleProvider locale={_rootLocale as any}>
       <CartProvider>
         <FlyToCartProvider>
-          <PreviewApp />
+          <PageDataProvider data={{}}>
+            <PreviewApp />
+          </PageDataProvider>
         </FlyToCartProvider>
       </CartProvider>
     </LocaleProvider>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onexapis/cli",
-  "version": "1.1.32",
+  "version": "1.1.34",
   "description": "CLI tool for OneX theme development - scaffolds themes using @onexapis/core",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.470.0",
-    "@onexapis/core": "^1.0.5",
+    "@onexapis/core": "^1.0.6",
     "@tanstack/react-query": "^5.90.16",
     "adm-zip": "^0.5.16",
     "archiver": "^7.0.1",

package/templates/default/CLAUDE.md

@@ -348,69 +348,64 @@ export const mySchema: SectionSchema = {
 | `url`                    | URL input                                         | Link href                     |
 | `array` / `repeater`     | List of repeating items                           | Feature list, social links    |
 
-## Available Hooks
+## Available Hooks (44 hooks)
 
-Import from `@onexapis/core/hooks`:
+All hooks import from `@onexapis/core/hooks`. Use `onexthm_list_hooks` MCP tool for full API details.
 
 ```tsx
 import {
   useProducts,
   useCart,
-  useAuth,
+  useCheckout,
   useDesignSystem,
 } from "@onexapis/core/hooks";
 ```
 
-### Commerce Data (React Query)
+### Quick Reference
+
+| Category          | Hooks                                                                                                                                                                                              |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Commerce** (11) | `useProducts`, `useProductBySlug`, `useProductById`, `useProductCategories`, `useBlogs`, `useBlogBySlug`, `useBlogById`, `useBlogCategories`, `useSettings`, `useProductListing`, `useBlogListing` |
+| **State** (3)     | `useCart`, `useAuth`, `useOrders`                                                                                                                                                                  |
+| **Checkout** (8)  | `useCheckout`, `usePayment`, `useOrderLookup`, `useOrderStatus`, `useOrderSuccess`, `useOrderSummary`, `useFinance`, `saveBuyNowItem`                                                              |
+| **Products** (3)  | `useSearchProducts`, `useAddToCart`, `useProductDetail`                                                                                                                                            |
+| **Theme** (8)     | `useDesignSystem`, `useCommerceData`, `useThemeMode`, `useLocale`, `useViewport`, `usePageData`, `useWebsiteSettings`, `useMotion`                                                                 |
+| **Utilities** (7) | `useDebounce`, `useMediaQuery`, `useIsMobile`, `useIsTablet`, `useIsDesktop`, `useContactForm`, `useCopyToClipboard`, `useFormatPrice`, `formatVndPrice`                                           |
+| **Animation** (1) | `useFlyToCart`                                                                                                                                                                                     |
+| **Server** (4)    | `fetchProducts`, `fetchBlogs`, `fetchSettings`, `prefetchSectionData`                                                                                                                              |
+
+### Most Used Patterns
 
 ```tsx
-// Products
-const { data, isLoading } = useProducts({ limit: 8, page: 0 });
+// Fetch products
+const { data, isLoading } = useProducts({ limit: 8 });
 const products = data?.data ?? [];
 
-// Single product
-const { data: product } = useProductBySlug("blue-t-shirt");
+// Cart
+const { items, addItem, itemCount, subtotal } = useCart();
 
-// Blogs
-const { data, isLoading } = useBlogs({ limit: 6 });
-const blogs = data?.data ?? [];
+// Auth
+const { user, isAuthenticated, login, logout } = useAuth();
 
-// Website settings
-const { data: settings } = useSettings();
-```
+// Checkout (full form)
+const checkout = useCheckout({ paymentRedirectUrl: "/payment" });
+// checkout.fullName, checkout.handleCheckout, checkout.errors
 
-### State Management
+// Product detail with buy now
+const detail = useProductDetail({ slug: routeParams.slug });
+// detail.product, detail.handleAddToCart, detail.handleBuyNow
 
-```tsx
-// Shopping cart
-const { items, addItem, removeItem, totalPrice, clearCart } = useCart();
-
-// Authentication
-const auth = useAuth();
-await auth.login(email, password);
-await auth.signup({ username, email, password, name });
-auth.logout();
-await auth.forgotPassword(email);
-
-// Orders
-const { createOrder, getOrders } = useOrders();
-```
+// Search with debounce
+const search = useSearchProducts({ debounceMs: 300 });
+// search.query, search.setQuery, search.results
 
-### Theme & Context
+// Responsive
+const isMobile = useIsMobile();
+const isDesktop = useIsDesktop();
 
-```tsx
-// Design system tokens
-const { colors, typography, colorMode } = useDesignSystem();
-// colors.primary, colors.secondary, colors.background, etc.
-
-// Server-side data from SectionComponentProps.data
-const { products, blogs, settings, company } = useCommerceData(data);
-
-// Other contexts
-const { mode, isDark } = useThemeMode();
-const { locale, setLocale } = useLocale();
-const { isMobile, isDesktop } = useViewport();
-const motionTokens = useMotion();
+// Price formatting
+const { formatPrice } = useFormatPrice();
+formatPrice(1250000); // "1.250.000đ"
 ```
 
 ## Color System