@akinon/projectzero 2.0.39-rc.0 → 2.0.39

package/CHANGELOG.md

@@ -1,12 +1,6 @@
 # @akinon/projectzero
 
-## 2.0.39-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.39
 
 ## 2.0.38
 

package/app-template/.env.example

@@ -7,7 +7,6 @@ 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
 
 # PZ Dashboard dataLayer observability (unset = observer disabled)
 # NEXT_PUBLIC_PZ_DASHBOARD_URL=http://localhost:3005

package/app-template/AGENTS.md

@@ -1,11 +1,3 @@
-<!-- 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,83 +1,37 @@
 # projectzeronext
 
-## 2.0.39-rc.0
-
-### Patch Changes
-
-- 1a8622a9b: ZERO-3392: Implemented AI Search functionality and update env
-- 2fea4143: ZERO-4620: Add runtime access to `NEXT_PUBLIC_*` environment variables from Client Components
-- 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
-- c3244a310: 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 [2fea4143]
-- Updated dependencies [119f0c11]
-- 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 [bfafa3f4]
-- Updated dependencies [00b9f488]
-- Updated dependencies [57d7eb30]
-- Updated dependencies [d99a6a7d5]
-- Updated dependencies [9db81a71]
-- Updated dependencies [591e345e1]
-- Updated dependencies [0df6bc1f]
-- Updated dependencies [4de5303c5]
-- Updated dependencies [63a72000]
-- Updated dependencies [95b139dc1]
-- Updated dependencies [1d00f2d0]
-- Updated dependencies [4ac7b2a1]
-- Updated dependencies [e9598c71]
-- Updated dependencies [4998a963]
-- Updated dependencies [804d2bd6]
-- Updated dependencies [c0228aff]
-- Updated dependencies [3909d3224]
-- Updated dependencies [6a3d8a63]
-- Updated dependencies [e18836b2]
-  - @akinon/pz-tabby-extension@2.0.39-rc.0
-  - @akinon/next@2.0.39-rc.0
-  - @akinon/pz-checkout-gift-pack@2.0.39-rc.0
-  - @akinon/pz-masterpass-rest@2.0.39-rc.0
-  - @akinon/pz-one-click-checkout@2.0.39-rc.0
-  - @akinon/pz-basket-gift-pack@2.0.39-rc.0
-  - @akinon/pz-pay-on-delivery@2.0.39-rc.0
-  - @akinon/pz-credit-payment@2.0.39-rc.0
-  - @akinon/pz-click-collect@2.0.39-rc.0
-  - @akinon/pz-multi-basket@2.0.39-rc.0
-  - @akinon/pz-masterpass@2.0.39-rc.0
-  - @akinon/pz-gpay@2.0.39-rc.0
-  - @akinon/pz-b2b@2.0.39-rc.0
-  - @akinon/pz-bkm@2.0.39-rc.0
-  - @akinon/pz-otp@2.0.39-rc.0
-  - @akinon/pz-similar-products@2.0.39-rc.0
-  - @akinon/pz-virtual-try-on@2.0.39-rc.0
-  - @akinon/pz-theme@2.0.39-rc.0
-  - @akinon/pz-akifast@2.0.39-rc.0
-  - @akinon/pz-apple-pay@2.0.39-rc.0
-  - @akinon/pz-cybersource-uc@2.0.39-rc.0
-  - @akinon/pz-flow-payment@2.0.39-rc.0
-  - @akinon/pz-google-pay@2.0.39-rc.0
-  - @akinon/pz-haso@2.0.39-rc.0
-  - @akinon/pz-hepsipay@2.0.39-rc.0
-  - @akinon/pz-saved-card@2.0.39-rc.0
-  - @akinon/pz-tamara-extension@2.0.39-rc.0
+## 2.0.39
+
+### Patch Changes
+
+- Updated dependencies [115c5602]
+  - @akinon/pz-theme@2.0.39
+  - @akinon/next@2.0.39
+  - @akinon/pz-akifast@2.0.39
+  - @akinon/pz-apple-pay@2.0.39
+  - @akinon/pz-b2b@2.0.39
+  - @akinon/pz-basket-gift-pack@2.0.39
+  - @akinon/pz-bkm@2.0.39
+  - @akinon/pz-checkout-gift-pack@2.0.39
+  - @akinon/pz-click-collect@2.0.39
+  - @akinon/pz-credit-payment@2.0.39
+  - @akinon/pz-cybersource-uc@2.0.39
+  - @akinon/pz-flow-payment@2.0.39
+  - @akinon/pz-google-pay@2.0.39
+  - @akinon/pz-gpay@2.0.39
+  - @akinon/pz-haso@2.0.39
+  - @akinon/pz-hepsipay@2.0.39
+  - @akinon/pz-masterpass@2.0.39
+  - @akinon/pz-masterpass-rest@2.0.39
+  - @akinon/pz-multi-basket@2.0.39
+  - @akinon/pz-one-click-checkout@2.0.39
+  - @akinon/pz-otp@2.0.39
+  - @akinon/pz-pay-on-delivery@2.0.39
+  - @akinon/pz-saved-card@2.0.39
+  - @akinon/pz-similar-products@2.0.39
+  - @akinon/pz-tabby-extension@2.0.39
+  - @akinon/pz-tamara-extension@2.0.39
+  - @akinon/pz-virtual-try-on@2.0.39
 
 ## 2.0.38
 

package/app-template/README.md

@@ -12,30 +12,6 @@ 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:
@@ -43,7 +19,7 @@ To build the app, run the following command:
 ```bash
 cd projectzeronext # Project root
 yarn build
-````
+```
 
 ### Develop
 

package/app-template/next.config.mjs

@@ -38,9 +38,6 @@ const nextConfig = {
         ]
       }
     ];
-  },
-  logging: {
-    browserToTerminal: 'error'
   }
 };
 
@@ -53,12 +50,9 @@ 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.39-rc.0",
+  "version": "2.0.39",
   "private": true,
   "license": "MIT",
   "scripts": {
@@ -24,33 +24,33 @@
     "test:middleware": "jest middleware-matcher.test.ts --bail"
   },
   "dependencies": {
-    "@akinon/next": "2.0.39-rc.0",
-    "@akinon/pz-akifast": "2.0.39-rc.0",
-    "@akinon/pz-apple-pay": "2.0.39-rc.0",
-    "@akinon/pz-b2b": "2.0.39-rc.0",
-    "@akinon/pz-basket-gift-pack": "2.0.39-rc.0",
-    "@akinon/pz-bkm": "2.0.39-rc.0",
-    "@akinon/pz-checkout-gift-pack": "2.0.39-rc.0",
-    "@akinon/pz-click-collect": "2.0.39-rc.0",
-    "@akinon/pz-credit-payment": "2.0.39-rc.0",
-    "@akinon/pz-cybersource-uc": "2.0.39-rc.0",
-    "@akinon/pz-flow-payment": "2.0.39-rc.0",
-    "@akinon/pz-google-pay": "2.0.39-rc.0",
-    "@akinon/pz-gpay": "2.0.39-rc.0",
-    "@akinon/pz-haso": "2.0.39-rc.0",
-    "@akinon/pz-hepsipay": "2.0.39-rc.0",
-    "@akinon/pz-masterpass": "2.0.39-rc.0",
-    "@akinon/pz-masterpass-rest": "2.0.39-rc.0",
-    "@akinon/pz-multi-basket": "2.0.39-rc.0",
-    "@akinon/pz-one-click-checkout": "2.0.39-rc.0",
-    "@akinon/pz-otp": "2.0.39-rc.0",
-    "@akinon/pz-pay-on-delivery": "2.0.39-rc.0",
-    "@akinon/pz-saved-card": "2.0.39-rc.0",
-    "@akinon/pz-similar-products": "2.0.39-rc.0",
-    "@akinon/pz-tabby-extension": "2.0.39-rc.0",
-    "@akinon/pz-tamara-extension": "2.0.39-rc.0",
-    "@akinon/pz-theme": "2.0.39-rc.0",
-    "@akinon/pz-virtual-try-on": "2.0.39-rc.0",
+    "@akinon/next": "2.0.39",
+    "@akinon/pz-akifast": "2.0.39",
+    "@akinon/pz-apple-pay": "2.0.39",
+    "@akinon/pz-b2b": "2.0.39",
+    "@akinon/pz-basket-gift-pack": "2.0.39",
+    "@akinon/pz-bkm": "2.0.39",
+    "@akinon/pz-checkout-gift-pack": "2.0.39",
+    "@akinon/pz-click-collect": "2.0.39",
+    "@akinon/pz-credit-payment": "2.0.39",
+    "@akinon/pz-cybersource-uc": "2.0.39",
+    "@akinon/pz-flow-payment": "2.0.39",
+    "@akinon/pz-google-pay": "2.0.39",
+    "@akinon/pz-gpay": "2.0.39",
+    "@akinon/pz-haso": "2.0.39",
+    "@akinon/pz-hepsipay": "2.0.39",
+    "@akinon/pz-masterpass": "2.0.39",
+    "@akinon/pz-masterpass-rest": "2.0.39",
+    "@akinon/pz-multi-basket": "2.0.39",
+    "@akinon/pz-one-click-checkout": "2.0.39",
+    "@akinon/pz-otp": "2.0.39",
+    "@akinon/pz-pay-on-delivery": "2.0.39",
+    "@akinon/pz-saved-card": "2.0.39",
+    "@akinon/pz-similar-products": "2.0.39",
+    "@akinon/pz-tabby-extension": "2.0.39",
+    "@akinon/pz-tamara-extension": "2.0.39",
+    "@akinon/pz-theme": "2.0.39",
+    "@akinon/pz-virtual-try-on": "2.0.39",
     "@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.21.0",
+    "pino": "8.11.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.5",
-    "react-string-replace": "1.1.1",
-    "start-server-and-test": "2.0.8",
-    "tailwind-merge": "1.14.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",
     "yup": "0.32.11"
   },
   "devDependencies": {
-    "@akinon/eslint-plugin-projectzero": "2.0.39-rc.0",
+    "@akinon/eslint-plugin-projectzero": "2.0.39",
     "@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.2.1",
+    "clsx": "1.1.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.4.2",
+    "jest-css-modules-transform": "4.3.0",
     "jest-environment-jsdom": "29.7.0",
-    "lint-staged": "13.3.0",
-    "prettier": "2.8.8",
+    "lint-staged": "13.1.0",
+    "prettier": "2.6.2",
     "react-number-format": "5.3.4",
-    "sass": "1.83.0",
+    "sass": "1.49.9",
     "semantic-release": "19.0.5",
     "server-only": "0.0.1",
-    "stylelint": "14.16.1",
+    "stylelint": "14.6.0",
     "stylelint-config-sass-guidelines": "9.0.1",
     "stylelint-config-standard": "25.0.0",
-    "stylelint-scss": "4.7.0",
+    "stylelint-scss": "4.2.0",
     "stylelint-selector-bem-pattern": "2.1.1",
     "tailwindcss": "4.2.0",
     "ts-jest": "29.2.6",

package/app-template/src/app/[pz]/account/layout.tsx

@@ -1,6 +1,8 @@
 import AccountBackButton from '@theme/views/account/back-button';
 import AccountMenu from '@theme/views/account/account-menu';
-import ThemePlaceholder from '@akinon/pz-theme/src/theme-placeholder';
+import ChromeSlot from '@akinon/pz-theme/src/chrome/chrome-slot';
+import { PLACEHOLDER_SLUGS } from '@akinon/pz-theme/src/chrome/placeholder-slugs';
+import { buildAccountPageContext } from '@akinon/pz-theme/src/chrome/page-context';
 import { auth } from 'auth';
 import { ROUTES } from 'routes';
 import { redirect } from '@akinon/next/utils/redirect';
@@ -21,7 +23,16 @@ export default async function AccountLayout({
       <AccountMenu />
       <div className="w-full flex-1">
         <AccountBackButton />
-        <ThemePlaceholder slug="account-page-body" />
+        {/* The session is already awaited above, so the account context costs
+            no extra fetch. Profile-only fields (phone, gender) stay empty
+            until a live provider merges them in. */}
+        <ChromeSlot
+          slug={PLACEHOLDER_SLUGS.accountShell}
+          pageContext={buildAccountPageContext({
+            path: ROUTES.ACCOUNT,
+            sessionUser: session.user as Record<string, unknown>
+          })}
+        />
         {children}
       </div>
     </div>

package/app-template/src/app/[pz]/account/orders/[id]/layout.tsx

@@ -1,5 +1,29 @@
 import React from 'react';
+import ChromeSlot from '@akinon/pz-theme/src/chrome/chrome-slot';
+import { PLACEHOLDER_SLUGS } from '@akinon/pz-theme/src/chrome/placeholder-slugs';
+import { LiveAccountOrderPageContext } from '@akinon/pz-theme/src/chrome/live-order-page-context';
 
-export default function Layout({ children }: { children: React.ReactNode }) {
-  return <div>{children}</div>;
+/**
+ * Account order detail. Publishes the SAME `order` root as the success page,
+ * so a composition authored on one resolves on the other.
+ */
+export default async function Layout({
+  children,
+  params
+}: {
+  children: React.ReactNode;
+  params: Promise<{ id: string }>;
+}) {
+  const { id } = await params;
+
+  return (
+    <div>
+      <LiveAccountOrderPageContext orderId={id}>
+        <ChromeSlot
+          slug={PLACEHOLDER_SLUGS.accountOrderDetail}
+          fallback={children}
+        />
+      </LiveAccountOrderPageContext>
+    </div>
+  );
 }

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

@@ -0,0 +1,25 @@
+import ChromeSlot from '@akinon/pz-theme/src/chrome/chrome-slot';
+import { LiveBasketPageContext } from '@akinon/pz-theme/src/chrome/live-basket-page-context';
+import { PLACEHOLDER_SLUGS } from '@akinon/pz-theme/src/chrome/placeholder-slugs';
+import { ROUTES } from '@theme/routes';
+
+/**
+ * The basket body is handed to the theme editor here rather than in page.tsx,
+ * because the slot is an async server component and the page is a client one.
+ * With no composition published the slot renders the page untouched.
+ *
+ * The provider sits above the slot so the composition binds the shopper's live
+ * basket: the basket is session-scoped and has no server data module, so a
+ * server-built context would be a snapshot that never moves.
+ */
+export default function BasketLayout({
+  children
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <LiveBasketPageContext path={ROUTES.BASKET}>
+      <ChromeSlot slug={PLACEHOLDER_SLUGS.basket} fallback={children} />
+    </LiveBasketPageContext>
+  );
+}

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

@@ -2,7 +2,7 @@ import { getCategoryData } from '@akinon/next/data/server';
 import { withSegmentDefaults } from '@akinon/next/hocs/server';
 import { ResolvedPageProps } from '@akinon/next/types';
 import CategoryLayout from '@theme/views/category/layout';
-import { buildListingPageContext } from '@theme/utils/theme-page-context';
+import { buildListingPageContext } from '@akinon/pz-theme/src/chrome/page-context';
 import { notFound } from 'next/navigation';
 
 async function Page({ params, searchParams }: ResolvedPageProps<{ pk: number }>) {

package/app-template/src/app/[pz]/client-root.tsx

@@ -1,5 +1,7 @@
 'use client';
 
+import './configure-page-context';
+
 export default function ClientRoot({
   children
 }: {

package/app-template/src/app/[pz]/configure-page-context.ts

@@ -0,0 +1,17 @@
+import { configurePageContextRoutes } from '@akinon/pz-theme/src/chrome/page-context';
+import { ROUTES, ORDER_ROUTES, ACCOUNT_ROUTES } from '@theme/routes';
+
+/**
+ * The packaged page-context builders default to `/basket`; this storefront
+ * routes it at `/baskets/basket`. Without this the published context would
+ * carry a basket path no link block could follow.
+ *
+ * Imported from BOTH the server layout and the client root: the routes live in
+ * module state, and the client bundle gets its own copy of that module.
+ */
+configurePageContextRoutes({
+  home: ROUTES.HOME,
+  basket: ROUTES.BASKET,
+  checkout: ORDER_ROUTES.CHECKOUT,
+  account: ACCOUNT_ROUTES.ACCOUNT
+});

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

@@ -1,3 +1,6 @@
+import ChromeSlot from '@akinon/pz-theme/src/chrome/chrome-slot';
+import { PLACEHOLDER_SLUGS } from '@akinon/pz-theme/src/chrome/placeholder-slugs';
+import { buildFlatPageContext } from '@akinon/pz-theme/src/chrome/page-context';
 import { getFlatPageData, getSeoData } from '@akinon/next/data/server';
 import { withSegmentDefaults } from '@akinon/next/hocs/server';
 import {
@@ -65,9 +68,17 @@ async function Page({ params }: ResolvedPageProps<{ pk: number }>) {
 
     return (
       <div className="container mx-auto py-6">
-        <div
-          className="mx-auto prose prose-headings:text-primary"
-          dangerouslySetInnerHTML={{ __html: data.flat_page.content }}
+        <ChromeSlot
+          slug={PLACEHOLDER_SLUGS.flatPage}
+          pageContext={buildFlatPageContext(
+            data.flat_page as unknown as Record<string, unknown>
+          )}
+          fallback={
+            <div
+              className="mx-auto prose prose-headings:text-primary"
+              dangerouslySetInnerHTML={{ __html: data.flat_page.content }}
+            />
+          }
         />
       </div>
     );

package/app-template/src/app/[pz]/layout.tsx

@@ -16,6 +16,7 @@ import { InstallPrompt } from '@theme/components/install-prompt';
 import type { Viewport } from 'next';
 import settings from '@theme/settings';
 import RouteHandler from '@theme/components/route-handler';
+import './configure-page-context';
 
 export const viewport: Viewport = {
   width: 'device-width',

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

@@ -3,7 +3,7 @@ import { withSegmentDefaults } from '@akinon/next/hocs/server';
 import { ResolvedPageProps } from '@akinon/next/types';
 import CategoryLayout from '@theme/views/category/layout';
 import { ROUTES } from '@theme/routes';
-import { buildListingPageContext } from '@theme/utils/theme-page-context';
+import { buildListingPageContext } from '@akinon/pz-theme/src/chrome/page-context';
 
 async function Page({ searchParams }: ResolvedPageProps) {
   const data = await getListData({ searchParams });

package/app-template/src/app/[pz]/orders/checkout/layout.tsx

@@ -0,0 +1,23 @@
+import React from 'react';
+import ChromeSlot from '@akinon/pz-theme/src/chrome/chrome-slot';
+import { PLACEHOLDER_SLUGS } from '@akinon/pz-theme/src/chrome/placeholder-slugs';
+import { LiveCheckoutPageContext } from '@akinon/pz-theme/src/chrome/live-checkout-page-context';
+
+/**
+ * Checkout is code-owned: only the zones above and below the flow are
+ * composable, so neither slot takes `fallback={children}` — a published
+ * composition must never be able to replace the payment steps.
+ */
+export default function CheckoutLayout({
+  children
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <LiveCheckoutPageContext>
+      <ChromeSlot slug={PLACEHOLDER_SLUGS.checkoutTop} />
+      {children}
+      <ChromeSlot slug={PLACEHOLDER_SLUGS.checkoutBottom} />
+    </LiveCheckoutPageContext>
+  );
+}

package/app-template/src/app/[pz]/orders/completed/[token]/layout.tsx

@@ -1,5 +1,27 @@
 import React from 'react';
+import ChromeSlot from '@akinon/pz-theme/src/chrome/chrome-slot';
+import { PLACEHOLDER_SLUGS } from '@akinon/pz-theme/src/chrome/placeholder-slugs';
+import { LiveOrderSuccessPageContext } from '@akinon/pz-theme/src/chrome/live-order-page-context';
 
-export default function Layout({ children }: { children: React.ReactNode }) {
-  return <div>{children}</div>;
+/**
+ * The order-success body is composable and binds the shopper's own order.
+ * There is no server order fetcher, so the context comes from the client
+ * provider — which also keeps the order out of any cached shell.
+ */
+export default async function Layout({
+  children,
+  params
+}: {
+  children: React.ReactNode;
+  params: Promise<{ token: string }>;
+}) {
+  const { token } = await params;
+
+  return (
+    <div>
+      <LiveOrderSuccessPageContext token={token}>
+        <ChromeSlot slug={PLACEHOLDER_SLUGS.orderSuccess} fallback={children} />
+      </LiveOrderSuccessPageContext>
+    </div>
+  );
 }

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

@@ -2,7 +2,7 @@ import 'server-only';
 
 import { withSegmentDefaults } from '@akinon/next/hocs/server';
 import ThemePlaceholder from '@akinon/pz-theme/src/theme-placeholder';
-import { buildHomepagePageContext } from '@theme/utils/theme-page-context';
+import { buildHomepagePageContext } from '@akinon/pz-theme/src/chrome/page-context';
 
 export const dynamic = 'force-static';
 export const revalidate = 600;

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

@@ -1,7 +1,7 @@
 import ThemePlaceholder from '@akinon/pz-theme/src/theme-placeholder';
 import { withSegmentDefaults } from '@akinon/next/hocs/server';
 import { ResolvedPageProps } from '@akinon/next/types';
-import { buildCustomPageContext } from '@theme/utils/theme-page-context';
+import { buildCustomPageContext } from '@akinon/pz-theme/src/chrome/page-context';
 
 export const dynamic = 'force-dynamic';
 

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

@@ -2,6 +2,7 @@ import { getSpecialPageData } from '@akinon/next/data/server';
 import { withSegmentDefaults } from '@akinon/next/hocs/server';
 import { ResolvedPageProps } from '@akinon/next/types';
 import CategoryLayout from '@theme/views/category/layout';
+import { buildListingPageContext } from '@akinon/pz-theme/src/chrome/page-context';
 import SpecialPageBanner from '@theme/widgets/special-page-banner';
 import SpecialPageCarousel from '@theme/widgets/special-page-carousel';
 import { notFound } from 'next/navigation';
@@ -12,7 +13,15 @@ async function Page({ params, searchParams }: ResolvedPageProps<{ pk: number }>)
 
     return (
       <>
-        <CategoryLayout data={data}>
+        <CategoryLayout
+          data={data}
+          pageContext={buildListingPageContext({
+            data,
+            pageType: 'special',
+            path: `/special-page/${params.pk}`,
+            title: (data.special_page as { name?: string } | undefined)?.name
+          })}
+        >
           {data.special_page && (
             <>
               <SpecialPageBanner data={data.special_page} />

package/app-template/src/hooks/index.ts

@@ -1,3 +1 @@
-export * from './use-contract';
-export * from './use-fav-button';
 export * from './use-add-product-to-basket';

package/app-template/src/plugins.js

@@ -19,7 +19,6 @@ module.exports = [
   'pz-hepsipay',
   'pz-flow-payment',
   'pz-virtual-try-on',
-  'pz-similar-products',
   'pz-cybersource-uc',
   'pz-hepsipay',
   'pz-masterpass-rest',

package/app-template/src/proxy.ts

@@ -14,8 +14,7 @@ export const config = {
     '/((?!api|_next|[\\w-\\/*]+\\.\\w+).*)',
     '/(.*sitemap\\.xml)',
     '/(.+\\.)(html|htm|aspx|asp|php)',
-    '/(.*orders\\/checkout-with-token.*)',
-    '/(.*orders\\/post-checkout.*)'
+    '/(.*orders\\/checkout-with-token.*)'
   ]
 };