@akinon/projectzero 2.0.32 → 2.0.33-rc.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @akinon/projectzero
 
+## 2.0.33-rc.0
+
+### Patch Changes
+
+- 143be2b9d: ZERO-3457: Crop styles are customizable and logic improved for rendering similar products modal
+- d99a6a7d5: ZERO-3457_1: Fixed the settings prop and made sure everything is customizable.
+- e18836b2: ZERO-4160: Restore scope in Sentry addon configuration in akinon.json
+
 ## 2.0.32
 
 ## 2.0.31

package/app-template/.env.example

@@ -7,6 +7,7 @@ NEXT_PUBLIC_URL=http://localhost:3000
 SERVICE_BACKEND_URL=https://02fde10fee4440269e695aa10707dfaf.lb.akinoncloud.com
 SITEMAP_S3_BUCKET_NAME=0fb534
 NEXT_PUBLIC_VIRTUAL_TRY_ON_API_URL=https://d2a26507c7094f359aba349b96a96881.lb.akinoncloud.com
+NEXT_PUBLIC_ENABLE_IMAGE_SEARCH=true
 
 # LOG_LEVEL_DEV=debug # For more details, please refer to the Logging documentation.
 

package/app-template/AGENTS.md

@@ -1,3 +1,11 @@
+<!-- BEGIN:nextjs-agent-rules -->
+
+# Next.js: ALWAYS read docs before coding
+
+Before any Next.js work, find and read the relevant doc in `node_modules/next/dist/docs/`. Your training data is outdated — the docs are the source of truth.
+
+<!-- END:nextjs-agent-rules -->
+
 # Project Zero Next.js - Developer Instructions
 
 ## 📚 Available Instruction Files

package/app-template/CHANGELOG.md

@@ -1,9 +1,86 @@
 # projectzeronext
 
+## 2.0.33-rc.0
+
+### Patch Changes
+
+- 1a8622a9b: ZERO-3392: Implemented AI Search functionality and update env
+- b55acb768: ZERO-2577: Fix pagination bug and update usePagination hook and ensure pagination controls rendering correctly
+- 143be2b9d: ZERO-3457: Crop styles are customizable and logic improved for rendering similar products modal
+- 9f8cd3bc5: ZERO-3449: AI Search Active Filters & Crop Style changes have been implemented
+- d99a6a7d5: ZERO-3457_1: Fixed the settings prop and made sure everything is customizable.
+- ccf21475: ZERO-4404: Add Next.js 16.2 AI improvements
+- c0228aff: ZERO-4159: Upgrade the package versions
+- b05c35435: ZERO-2570: Category filters routes to absolute url
+- e18836b2: ZERO-4160: Restore scope in Sentry addon configuration in akinon.json
+- c3244a31: ZERO-4013: Update runtime version to node:25-alpine in project configuration
+- Updated dependencies [a3e2acbf]
+- Updated dependencies [0cf9ea23]
+- Updated dependencies [324f97d5]
+- Updated dependencies [51ea0688]
+- Updated dependencies
+- Updated dependencies [c97525a3]
+- Updated dependencies [eba125b2]
+- Updated dependencies [823a4449]
+- Updated dependencies [b55acb768]
+- Updated dependencies [760258c1]
+- Updated dependencies [5da13fff]
+- Updated dependencies [143be2b9d]
+- Updated dependencies [7889b08f]
+- Updated dependencies [fb4aa9b4]
+- Updated dependencies [9f8cd3bc5]
+- Updated dependencies [d51fa68e]
+- Updated dependencies [bfafa3f4]
+- Updated dependencies [00b9f488]
+- Updated dependencies [57d7eb30]
+- Updated dependencies [d99a6a7d5]
+- Updated dependencies [9db81a71]
+- Updated dependencies [591e345e]
+- Updated dependencies [0df6bc1f]
+- Updated dependencies [4de5303c5]
+- Updated dependencies [63a72000]
+- Updated dependencies [95b139dc1]
+- Updated dependencies [1d00f2d0]
+- Updated dependencies [4ac7b2a1]
+- Updated dependencies [4998a963]
+- Updated dependencies [804d2bd6]
+- Updated dependencies [c0228aff]
+- Updated dependencies [3909d3224]
+- Updated dependencies [6a3d8a63]
+- Updated dependencies [e18836b2]
+  - @akinon/pz-tabby-extension@2.0.33-rc.0
+  - @akinon/next@2.0.33-rc.0
+  - @akinon/pz-checkout-gift-pack@2.0.33-rc.0
+  - @akinon/pz-one-click-checkout@2.0.33-rc.0
+  - @akinon/pz-basket-gift-pack@2.0.33-rc.0
+  - @akinon/pz-masterpass-rest@2.0.33-rc.0
+  - @akinon/pz-pay-on-delivery@2.0.33-rc.0
+  - @akinon/pz-credit-payment@2.0.33-rc.0
+  - @akinon/pz-click-collect@2.0.33-rc.0
+  - @akinon/pz-multi-basket@2.0.33-rc.0
+  - @akinon/pz-masterpass@2.0.33-rc.0
+  - @akinon/pz-gpay@2.0.33-rc.0
+  - @akinon/pz-b2b@2.0.33-rc.0
+  - @akinon/pz-bkm@2.0.33-rc.0
+  - @akinon/pz-otp@2.0.33-rc.0
+  - @akinon/pz-similar-products@2.0.33-rc.0
+  - @akinon/pz-virtual-try-on@2.0.33-rc.0
+  - @akinon/pz-theme@2.0.33-rc.0
+  - @akinon/pz-akifast@2.0.33-rc.0
+  - @akinon/pz-apple-pay@2.0.33-rc.0
+  - @akinon/pz-cybersource-uc@2.0.33-rc.0
+  - @akinon/pz-flow-payment@2.0.33-rc.0
+  - @akinon/pz-google-pay@2.0.33-rc.0
+  - @akinon/pz-haso@2.0.33-rc.0
+  - @akinon/pz-hepsipay@2.0.33-rc.0
+  - @akinon/pz-saved-card@2.0.33-rc.0
+  - @akinon/pz-tamara-extension@2.0.33-rc.0
+
 ## 2.0.32
 
 ### Patch Changes
 
+- 275fca44: ZERO-4429: Add settings-driven checkout variant system
 - Updated dependencies [239aa9d0]
   - @akinon/next@2.0.32
   - @akinon/pz-theme@2.0.32

package/app-template/README.md

@@ -12,6 +12,30 @@ Run `cp .env.example .env && yarn` command at project root and all dependencies
 
 - `SITEMAP_S3_BUCKET_NAME`: S3 bucket name for XML sitemaps (e.g., "0fb534"). This is required for the sitemap route to function correctly.
 
+### Optional Environment Variables
+
+- `NEXT_PUBLIC_ENABLE_IMAGE_SEARCH`: Set to `true` to enable image search feature for all users. If not set or `false`, the feature will only be visible to users who have enabled it via localStorage.
+
+## Image Search Feature
+
+The image search functionality allows users to search for similar products by uploading images or cropping existing product images.
+
+### Feature Visibility Control
+
+The image search feature can be controlled in two ways:
+
+1. **Environment Variable (Global)**: Set `NEXT_PUBLIC_ENABLE_IMAGE_SEARCH=true` to enable for all users
+2. **localStorage (Individual Users)**: Users can enable it locally using browser developer tools
+
+````
+
+### Feature Locations
+
+When enabled, the image search feature appears in:
+
+- **Header Search**: Camera icon next to the search input
+- **Product Detail Page**: "View Similar Styles" button on product images
+
 ### Build
 
 To build the app, run the following command:
@@ -19,7 +43,7 @@ To build the app, run the following command:
 ```bash
 cd projectzeronext # Project root
 yarn build
-```
+````
 
 ### Develop
 

package/app-template/next.config.mjs

@@ -38,6 +38,9 @@ const nextConfig = {
         ]
       }
     ];
+  },
+  logging: {
+    browserToTerminal: 'error'
   }
 };
 
@@ -50,9 +53,12 @@ const withSerwist = withSerwistInit({
 const sentryConfig = {
   silent: true,
   dryRun: !process.env.SENTRY_DSN,
-  org: 'akinon'
+  org: 'akinon',
   // project: 'enter_your_project_name_here',
   // authToken: 'enter_your_auth_token_here'
+  sourcemaps: {
+    deleteSourcemapsAfterUpload: true
+  }
 };
 
 const enhancedConfig = withPzConfig(nextConfig);

package/app-template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectzeronext",
-  "version": "2.0.32",
+  "version": "2.0.33-rc.0",
   "private": true,
   "license": "MIT",
   "scripts": {
@@ -24,33 +24,33 @@
     "test:middleware": "jest middleware-matcher.test.ts --bail"
   },
   "dependencies": {
-    "@akinon/next": "2.0.32",
-    "@akinon/pz-akifast": "2.0.32",
-    "@akinon/pz-apple-pay": "2.0.32",
-    "@akinon/pz-b2b": "2.0.32",
-    "@akinon/pz-basket-gift-pack": "2.0.32",
-    "@akinon/pz-bkm": "2.0.32",
-    "@akinon/pz-checkout-gift-pack": "2.0.32",
-    "@akinon/pz-click-collect": "2.0.32",
-    "@akinon/pz-credit-payment": "2.0.32",
-    "@akinon/pz-cybersource-uc": "2.0.32",
-    "@akinon/pz-flow-payment": "2.0.32",
-    "@akinon/pz-google-pay": "2.0.32",
-    "@akinon/pz-gpay": "2.0.32",
-    "@akinon/pz-haso": "2.0.32",
-    "@akinon/pz-hepsipay": "2.0.32",
-    "@akinon/pz-masterpass": "2.0.32",
-    "@akinon/pz-masterpass-rest": "2.0.32",
-    "@akinon/pz-multi-basket": "2.0.32",
-    "@akinon/pz-one-click-checkout": "2.0.32",
-    "@akinon/pz-otp": "2.0.32",
-    "@akinon/pz-pay-on-delivery": "2.0.32",
-    "@akinon/pz-saved-card": "2.0.32",
-    "@akinon/pz-similar-products": "2.0.32",
-    "@akinon/pz-tabby-extension": "2.0.32",
-    "@akinon/pz-tamara-extension": "2.0.32",
-    "@akinon/pz-theme": "2.0.32",
-    "@akinon/pz-virtual-try-on": "2.0.32",
+    "@akinon/next": "2.0.33-rc.0",
+    "@akinon/pz-akifast": "2.0.33-rc.0",
+    "@akinon/pz-apple-pay": "2.0.33-rc.0",
+    "@akinon/pz-b2b": "2.0.33-rc.0",
+    "@akinon/pz-basket-gift-pack": "2.0.33-rc.0",
+    "@akinon/pz-bkm": "2.0.33-rc.0",
+    "@akinon/pz-checkout-gift-pack": "2.0.33-rc.0",
+    "@akinon/pz-click-collect": "2.0.33-rc.0",
+    "@akinon/pz-credit-payment": "2.0.33-rc.0",
+    "@akinon/pz-cybersource-uc": "2.0.33-rc.0",
+    "@akinon/pz-flow-payment": "2.0.33-rc.0",
+    "@akinon/pz-google-pay": "2.0.33-rc.0",
+    "@akinon/pz-gpay": "2.0.33-rc.0",
+    "@akinon/pz-haso": "2.0.33-rc.0",
+    "@akinon/pz-hepsipay": "2.0.33-rc.0",
+    "@akinon/pz-masterpass": "2.0.33-rc.0",
+    "@akinon/pz-masterpass-rest": "2.0.33-rc.0",
+    "@akinon/pz-multi-basket": "2.0.33-rc.0",
+    "@akinon/pz-one-click-checkout": "2.0.33-rc.0",
+    "@akinon/pz-otp": "2.0.33-rc.0",
+    "@akinon/pz-pay-on-delivery": "2.0.33-rc.0",
+    "@akinon/pz-saved-card": "2.0.33-rc.0",
+    "@akinon/pz-similar-products": "2.0.33-rc.0",
+    "@akinon/pz-tabby-extension": "2.0.33-rc.0",
+    "@akinon/pz-tamara-extension": "2.0.33-rc.0",
+    "@akinon/pz-theme": "2.0.33-rc.0",
+    "@akinon/pz-virtual-try-on": "2.0.33-rc.0",
     "@hookform/resolvers": "2.9.0",
     "@next/third-parties": "16.2.6",
     "@react-google-maps/api": "2.17.1",
@@ -59,7 +59,7 @@
     "next": "16.2.6",
     "@serwist/next": "9.5.11",
     "next-auth": "5.0.0-beta.30",
-    "pino": "8.11.0",
+    "pino": "8.21.0",
     "serwist": "9.5.11",
     "postcss": "8.4.49",
     "react": "19.2.5",
@@ -67,14 +67,14 @@
     "react-google-recaptcha": "2.1.0",
     "react-hook-form": "7.71.2",
     "react-intersection-observer": "9.4.0",
-    "react-multi-carousel": "2.8.4",
-    "react-string-replace": "1.1.0",
-    "start-server-and-test": "2.0.3",
-    "tailwind-merge": "1.8.0",
+    "react-multi-carousel": "2.8.5",
+    "react-string-replace": "1.1.1",
+    "start-server-and-test": "2.0.8",
+    "tailwind-merge": "1.14.0",
     "yup": "0.32.11"
   },
   "devDependencies": {
-    "@akinon/eslint-plugin-projectzero": "2.0.32",
+    "@akinon/eslint-plugin-projectzero": "2.0.33-rc.0",
     "@semantic-release/changelog": "6.0.2",
     "@semantic-release/exec": "6.0.3",
     "@semantic-release/git": "10.0.1",
@@ -89,25 +89,25 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "client-only": "0.0.1",
-    "clsx": "1.1.1",
+    "clsx": "1.2.1",
     "currency-symbol-map": "5.1.0",
     "eslint": "9.39.4",
     "eslint-config-next": "16.2.4",
     "eslint-config-prettier": "10.1.1",
     "husky": "8.0.0",
     "jest": "29.7.0",
-    "jest-css-modules-transform": "4.3.0",
+    "jest-css-modules-transform": "4.4.2",
     "jest-environment-jsdom": "29.7.0",
-    "lint-staged": "13.1.0",
-    "prettier": "2.6.2",
+    "lint-staged": "13.3.0",
+    "prettier": "2.8.8",
     "react-number-format": "5.3.4",
-    "sass": "1.49.9",
+    "sass": "1.83.0",
     "semantic-release": "19.0.5",
     "server-only": "0.0.1",
-    "stylelint": "14.6.0",
+    "stylelint": "14.16.1",
     "stylelint-config-sass-guidelines": "9.0.1",
     "stylelint-config-standard": "25.0.0",
-    "stylelint-scss": "4.2.0",
+    "stylelint-scss": "4.7.0",
     "stylelint-selector-bem-pattern": "2.1.1",
     "tailwindcss": "4.2.0",
     "ts-jest": "29.2.6",

package/app-template/public/locales/en/checkout.json

@@ -161,5 +161,55 @@
     "processing": "Processing...",
     "pay_button": "Pay with Apple Pay",
     "payment_failed": "Payment failed"
+  },
+  "one_page": {
+    "edit": "Edit",
+    "continue_to_shipping": "Continue to shipping",
+    "continue_to_payment": "Continue to payment",
+    "contact": {
+      "title": "Contact information",
+      "guest_user": "Guest user",
+      "guest_badge": "Guest",
+      "guest_note": "You are continuing checkout as a guest."
+    },
+    "address": {
+      "title": "Delivery & billing address",
+      "shipping_label": "Delivery address",
+      "billing_label": "Billing address",
+      "use_for_billing": "Use the same address for billing",
+      "same_as_shipping": "Same as shipping",
+      "pick_different_billing": "Pick a different address if you'd like a separate billing destination."
+    },
+    "shipping": {
+      "title": "Shipping method"
+    },
+    "payment": {
+      "title": "Payment",
+      "select_method": "Please select a payment method to continue.",
+      "no_options": "No payment options are available at the moment."
+    },
+    "summary": {
+      "show_summary": "Show order summary",
+      "hide_summary": "Hide order summary",
+      "review_title": "Order details",
+      "deliver_to": "Deliver to",
+      "shipping_method": "Shipping method",
+      "payment_method": "Payment method"
+    },
+    "trust": {
+      "secure_title": "Secure checkout",
+      "secure_note": "Your payment is encrypted and processed securely. We never store your card details."
+    },
+    "basket": {
+      "title": "Your cart",
+      "empty": "Your cart is empty.",
+      "show": "Show items",
+      "hide": "Hide items",
+      "quantity": "Quantity",
+      "increase": "Increase quantity",
+      "decrease": "Decrease quantity",
+      "remove": "Remove from cart",
+      "update_error": "Could not update the cart. Please try again."
+    }
   }
 }

package/app-template/public/locales/tr/checkout.json

@@ -160,5 +160,55 @@
     "processing": "İşleniyor...",
     "pay_button": "Apple Pay ile Öde",
     "payment_failed": "Ödeme başarısız oldu"
+  },
+  "one_page": {
+    "edit": "Düzenle",
+    "continue_to_shipping": "Kargo seçimine geç",
+    "continue_to_payment": "Ödemeye geç",
+    "contact": {
+      "title": "İletişim bilgileri",
+      "guest_user": "Misafir kullanıcı",
+      "guest_badge": "Misafir",
+      "guest_note": "Alışverişe misafir olarak devam ediyorsunuz."
+    },
+    "address": {
+      "title": "Teslimat ve fatura adresi",
+      "shipping_label": "Teslimat adresi",
+      "billing_label": "Fatura adresi",
+      "use_for_billing": "Fatura adresi olarak da kullan",
+      "same_as_shipping": "Teslimat adresiyle aynı",
+      "pick_different_billing": "Faturayı farklı bir adrese istiyorsanız aşağıdan seçin."
+    },
+    "shipping": {
+      "title": "Kargo seçimi"
+    },
+    "payment": {
+      "title": "Ödeme",
+      "select_method": "Devam etmek için bir ödeme yöntemi seçin.",
+      "no_options": "Şu anda kullanılabilir bir ödeme yöntemi bulunmuyor."
+    },
+    "summary": {
+      "show_summary": "Sipariş özetini göster",
+      "hide_summary": "Sipariş özetini gizle",
+      "review_title": "Sipariş detayları",
+      "deliver_to": "Teslim adresi",
+      "shipping_method": "Kargo yöntemi",
+      "payment_method": "Ödeme yöntemi"
+    },
+    "trust": {
+      "secure_title": "Güvenli ödeme",
+      "secure_note": "Ödemeniz şifrelenir ve güvenli olarak işlenir. Kart bilgileriniz saklanmaz."
+    },
+    "basket": {
+      "title": "Sepetiniz",
+      "empty": "Sepetiniz boş.",
+      "show": "Ürünleri göster",
+      "hide": "Ürünleri gizle",
+      "quantity": "Adet",
+      "increase": "Adedi artır",
+      "decrease": "Adedi azalt",
+      "remove": "Sepetten çıkar",
+      "update_error": "Sepet güncellenemedi. Lütfen tekrar deneyin."
+    }
   }
 }

package/app-template/src/app/[pz]/basket/page.tsx

@@ -1,28 +1,55 @@
 'use client';
 
-import { useEffect } from 'react';
-import { ROUTES } from '@theme/routes';
+import { useEffect, useMemo } from 'react';
+import { ROUTES, ORDER_ROUTES } from '@theme/routes';
 import { useGetBasketQuery } from '@akinon/next/data/client/basket';
 import { pushCartView } from '@theme/utils/gtm';
 import { Button, LoaderSpinner, Link } from '@theme/components';
 import { BasketItem, Summary } from '@theme/views/basket';
-import { useLocalization } from '@akinon/next/hooks';
+import { useLocalization, useRouter } from '@akinon/next/hooks';
 import PluginModule, { Component } from '@akinon/next/components/plugin-module';
 import settings from '@theme/settings';
+import { UNIFIED_VARIANTS } from '@theme/views/checkout/variants/registry';
 
 export default function Page() {
   const { data: basket, isLoading, isSuccess } = useGetBasketQuery();
   const { t } = useLocalization();
+  const router = useRouter();
   const multiBasket = settings.plugins?.multiBasket ?? false;
 
+  const checkoutVariant = (settings as { checkout?: { variant?: string } })
+    ?.checkout?.variant;
+  const isUnifiedCheckout = useMemo(
+    () => UNIFIED_VARIANTS.has(checkoutVariant ?? ''),
+    [checkoutVariant]
+  );
+
+  const hasItems = Boolean(
+    basket?.basketitem_set && basket.basketitem_set.length > 0
+  );
+
   useEffect(() => {
-    if (isSuccess) {
+    if (isUnifiedCheckout && isSuccess && hasItems) {
+      router.replace(ORDER_ROUTES.CHECKOUT);
+    }
+  }, [isUnifiedCheckout, isSuccess, hasItems, router]);
+
+  useEffect(() => {
+    if (isSuccess && hasItems) {
       const products = basket.basketitem_set.map((basketItem) => ({
         ...basketItem.product
       }));
       pushCartView(products);
     }
-  }, [basket, isSuccess]);
+  }, [basket, isSuccess, hasItems]);
+
+  if (isUnifiedCheckout && (isLoading || (isSuccess && hasItems))) {
+    return (
+      <div className="flex w-full justify-center py-20">
+        <LoaderSpinner />
+      </div>
+    );
+  }
 
   return (
     <div className="max-w-screen-xl p-4 flex flex-col text-primary-800 lg:p-8 xl:flex-row xl:mx-auto">
@@ -32,7 +59,7 @@ export default function Page() {
         </div>
       )}
       {isSuccess &&
-        (basket && basket.basketitem_set && basket.basketitem_set.length > 0 ? (
+        (hasItems ? (
           <>
             <div className="flex-1 xl:mr-16">
               <div className="flex items-center justify-between py-2 border-b border-gray-200 lg:py-3">