@akinon/projectzero 2.0.39-beta.0 → 2.0.39

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @akinon/projectzero
 
-## 2.0.39-beta.0
+## 2.0.39
 
 ## 2.0.38
 

package/app-template/CHANGELOG.md

@@ -1,37 +1,37 @@
 # projectzeronext
 
-## 2.0.39-beta.0
-
-### Patch Changes
-
-- Updated dependencies [cbbbfd75]
-  - @akinon/next@2.0.39-beta.0
-  - @akinon/pz-theme@2.0.39-beta.0
-  - @akinon/pz-virtual-try-on@2.0.39-beta.0
-  - @akinon/pz-akifast@2.0.39-beta.0
-  - @akinon/pz-apple-pay@2.0.39-beta.0
-  - @akinon/pz-b2b@2.0.39-beta.0
-  - @akinon/pz-basket-gift-pack@2.0.39-beta.0
-  - @akinon/pz-bkm@2.0.39-beta.0
-  - @akinon/pz-checkout-gift-pack@2.0.39-beta.0
-  - @akinon/pz-click-collect@2.0.39-beta.0
-  - @akinon/pz-credit-payment@2.0.39-beta.0
-  - @akinon/pz-cybersource-uc@2.0.39-beta.0
-  - @akinon/pz-flow-payment@2.0.39-beta.0
-  - @akinon/pz-google-pay@2.0.39-beta.0
-  - @akinon/pz-gpay@2.0.39-beta.0
-  - @akinon/pz-haso@2.0.39-beta.0
-  - @akinon/pz-hepsipay@2.0.39-beta.0
-  - @akinon/pz-masterpass@2.0.39-beta.0
-  - @akinon/pz-masterpass-rest@2.0.39-beta.0
-  - @akinon/pz-multi-basket@2.0.39-beta.0
-  - @akinon/pz-one-click-checkout@2.0.39-beta.0
-  - @akinon/pz-otp@2.0.39-beta.0
-  - @akinon/pz-pay-on-delivery@2.0.39-beta.0
-  - @akinon/pz-saved-card@2.0.39-beta.0
-  - @akinon/pz-similar-products@2.0.39-beta.0
-  - @akinon/pz-tabby-extension@2.0.39-beta.0
-  - @akinon/pz-tamara-extension@2.0.39-beta.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectzeronext",
-  "version": "2.0.39-beta.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-beta.0",
-    "@akinon/pz-akifast": "2.0.39-beta.0",
-    "@akinon/pz-apple-pay": "2.0.39-beta.0",
-    "@akinon/pz-b2b": "2.0.39-beta.0",
-    "@akinon/pz-basket-gift-pack": "2.0.39-beta.0",
-    "@akinon/pz-bkm": "2.0.39-beta.0",
-    "@akinon/pz-checkout-gift-pack": "2.0.39-beta.0",
-    "@akinon/pz-click-collect": "2.0.39-beta.0",
-    "@akinon/pz-credit-payment": "2.0.39-beta.0",
-    "@akinon/pz-cybersource-uc": "2.0.39-beta.0",
-    "@akinon/pz-flow-payment": "2.0.39-beta.0",
-    "@akinon/pz-google-pay": "2.0.39-beta.0",
-    "@akinon/pz-gpay": "2.0.39-beta.0",
-    "@akinon/pz-haso": "2.0.39-beta.0",
-    "@akinon/pz-hepsipay": "2.0.39-beta.0",
-    "@akinon/pz-masterpass": "2.0.39-beta.0",
-    "@akinon/pz-masterpass-rest": "2.0.39-beta.0",
-    "@akinon/pz-multi-basket": "2.0.39-beta.0",
-    "@akinon/pz-one-click-checkout": "2.0.39-beta.0",
-    "@akinon/pz-otp": "2.0.39-beta.0",
-    "@akinon/pz-pay-on-delivery": "2.0.39-beta.0",
-    "@akinon/pz-saved-card": "2.0.39-beta.0",
-    "@akinon/pz-similar-products": "2.0.39-beta.0",
-    "@akinon/pz-tabby-extension": "2.0.39-beta.0",
-    "@akinon/pz-tamara-extension": "2.0.39-beta.0",
-    "@akinon/pz-theme": "2.0.39-beta.0",
-    "@akinon/pz-virtual-try-on": "2.0.39-beta.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",
@@ -74,7 +74,7 @@
     "yup": "0.32.11"
   },
   "devDependencies": {
-    "@akinon/eslint-plugin-projectzero": "2.0.39-beta.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",

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/views/category/layout.tsx

@@ -3,11 +3,14 @@ import { BreadcrumbResultType, GetCategoryResponse } from '@akinon/next/types';
 import Breadcrumb from '@theme/views/breadcrumb';
 import { CategoryBanner } from '@theme/views/category/category-banner';
 import ListPage from '@theme/views/category/category-info';
+import ChromeSlot from '@akinon/pz-theme/src/chrome/chrome-slot';
+import { PLACEHOLDER_SLUGS } from '@akinon/pz-theme/src/chrome/placeholder-slugs';
 
 export default async function Layout({
   data,
   children,
-  breadcrumbData
+  breadcrumbData,
+  pageContext
 }: {
   data: GetCategoryResponse;
   children?: React.ReactNode;
@@ -35,7 +38,14 @@ export default async function Layout({
         </div>
         <CategoryBanner {...data?.category?.attributes?.category_banner} />
       </div>
-      <ListPage data={data} />
+      {/* The listing context was built on every request and thrown away: the
+          prop was declared and never read, so no listing binding has ever
+          resolved on any brand. */}
+      <ChromeSlot
+        slug={PLACEHOLDER_SLUGS.productListing}
+        fallback={<ListPage data={data} />}
+        pageContext={pageContext}
+      />
     </>
   );
 }

package/app-template/src/views/product/layout.tsx

@@ -1,8 +1,9 @@
 import Breadcrumb from '@theme/views/breadcrumb';
 import { ProductInfoSlider } from '@theme/views/product';
-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 { BreadcrumbResultType, ProductResult } from '@akinon/next/types';
-import { buildProductPageContext } from '@theme/utils/theme-page-context';
+import { buildProductPageContext } from '@akinon/pz-theme/src/chrome/page-context';
 
 interface DeliveryReturnItem {
   product_delivery_returns?: {
@@ -23,7 +24,9 @@ export default async function ProductLayout({
   breadcrumbData,
   children
 }: ProductPageProps) {
-  const productPageContext = buildProductPageContext(data);
+  // Breadcrumbs travel with the product context so the PDP is not the one
+  // page type whose composition cannot build a trail.
+  const productPageContext = buildProductPageContext(data, breadcrumbData);
   const categoryIds = breadcrumbData
     ?.map((item) => item.extra_context?.attributes?.category_id)
     .filter(Boolean)
@@ -51,8 +54,8 @@ export default async function ProductLayout({
           <div className="w-full">{children}</div>
         </div>
       </div>
-      <ThemePlaceholder
-        slug="product-page-new"
+      <ChromeSlot
+        slug={PLACEHOLDER_SLUGS.productDetail}
         pageContext={productPageContext}
       />
     </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akinon/projectzero",
-  "version": "2.0.39-beta.0",
+  "version": "2.0.39",
   "private": false,
   "description": "CLI tool to manage your Project Zero Next project",
   "bin": {

package/app-template/src/utils/__tests__/theme-page-context.test.ts

@@ -1,148 +0,0 @@
-import {
-  buildAccountPageContext,
-  buildBasketPageContext,
-  buildCustomPageContext,
-  buildHomepagePageContext,
-  buildListingPageContext,
-  buildProductPageContext
-} from '../theme-page-context';
-
-describe('theme-page-context utils', () => {
-  it('builds homepage and custom page contexts', () => {
-    const homepage = buildHomepagePageContext();
-    const customPage = buildCustomPageContext('summer-campaign');
-
-    expect(homepage.homepage.slug).toBe('homepage');
-    expect(customPage.customPage.slug).toBe('summer-campaign');
-    expect(customPage.customPage.title).toBe('Summer Campaign');
-  });
-
-  it('builds product page context with normalized product aliases', () => {
-    const productPageContext = buildProductPageContext({
-      product: {
-        pk: 1,
-        name: 'Spring Sneaker',
-        absolute_url: '/products/spring-sneaker',
-        productimage_set: [{ image: 'https://cdn.example.com/image.jpg' }],
-        price: '199.90',
-        retail_price: '249.90',
-        currency_type: 'TRY',
-        attributes_kwargs: {}
-      },
-      selected_variant: null,
-      variants: []
-    } as never);
-
-    // The normalized aliases (title/url/images) are added dynamically and
-    // are not part of the declared product type.
-    const product = productPageContext.product as Record<string, any>;
-    expect(product.title).toBe('Spring Sneaker');
-    expect(product.url).toBe('/products/spring-sneaker');
-    expect(product.images[0].url).toBe('https://cdn.example.com/image.jpg');
-  });
-
-  it('builds listing context aliases for category/search/plp style pages', () => {
-    const listingContext = buildListingPageContext({
-      data: {
-        category: {
-          name: 'Sneakers',
-          absolute_url: '/category/sneakers',
-          attributes: {
-            category_seo_title: {
-              value: {
-                text: 'Sneaker landing'
-              }
-            }
-          }
-        },
-        products: [
-          {
-            pk: 1,
-            name: 'Spring Sneaker',
-            absolute_url: '/products/spring-sneaker',
-            productimage_set: [{ image: 'https://cdn.example.com/image.jpg' }],
-            price: '199.90',
-            retail_price: '249.90',
-            currency_type: 'TRY',
-            attributes_kwargs: {}
-          }
-        ],
-        facets: [{ key: 'color', name: 'Color' }],
-        pagination: { count: 12 },
-        sorters: [{ label: 'Newest', value: 'newest' }],
-        search_text: 'sneaker'
-      } as never,
-      breadcrumbData: [
-        { label: 'Sneakers', path: '/category/sneakers' }
-      ] as never,
-      pageType: 'search',
-      path: '/list'
-    });
-
-    expect(listingContext.page.type).toBe('search');
-    expect(listingContext.category.name).toBe('Sneakers');
-    expect(listingContext.search.query).toBe('sneaker');
-    expect(listingContext.plp.products).toHaveLength(1);
-    expect(listingContext.listing.totalProducts).toBe(12);
-  });
-
-  it('builds basket and account contexts from live data', () => {
-    const basketContext = buildBasketPageContext({
-      basket: {
-        pk: 10,
-        total_quantity: 3,
-        total_amount: '799.90',
-        total_product_amount: '899.90',
-        total_discount_amount: '100.00',
-        voucher_code: 'SPRING',
-        discounts: [],
-        basketitem_set: [
-          {
-            id: 1,
-            quantity: 2,
-            price: '399.95',
-            retail_price: '449.95',
-            total_amount: '799.90',
-            unit_price: '399.95',
-            currency_type: 'TRY',
-            image: 'https://cdn.example.com/image.jpg',
-            attributes_kwargs: {
-              color: { label: 'Color', value: 'Black' }
-            },
-            product: {
-              pk: 1,
-              name: 'Spring Sneaker',
-              absolute_url: '/products/spring-sneaker',
-              productimage_set: [
-                { image: 'https://cdn.example.com/image.jpg' }
-              ],
-              price: '399.95',
-              retail_price: '449.95',
-              currency_type: 'TRY',
-              attributes_kwargs: {}
-            }
-          }
-        ]
-      } as never,
-      path: '/baskets/basket'
-    });
-
-    const accountContext = buildAccountPageContext({
-      path: '/account/profile',
-      profileInfo: {
-        first_name: 'Ada',
-        last_name: 'Lovelace',
-        email: 'ada@example.com'
-      },
-      sessionUser: {
-        name: 'Ada Lovelace',
-        email: 'ada@example.com'
-      }
-    });
-
-    expect(basketContext.basket.totalQuantity).toBe(3);
-    expect(basketContext.basket.items[0].title).toBe('Spring Sneaker');
-    expect(accountContext.account.user.fullName).toBe('Ada Lovelace');
-    expect(accountContext.account.route).toBe('/account/profile');
-  });
-});

package/app-template/src/utils/theme-page-context.ts

@@ -1,309 +0,0 @@
-import { ROUTES } from '@theme/routes';
-import type {
-  Basket,
-  BreadcrumbResultType,
-  GetCategoryResponse,
-  Product,
-  ProductResult
-} from '@akinon/next/types';
-
-type UnknownRecord = Record<string, unknown>;
-
-const toRecord = (value: unknown): UnknownRecord =>
-  value && typeof value === 'object' ? (value as UnknownRecord) : {};
-
-const toStringValue = (value: unknown, fallback = ''): string =>
-  typeof value === 'string' ? value : fallback;
-
-const humanizeSlug = (value: string) =>
-  value
-    .split('-')
-    .filter(Boolean)
-    .map(part => part.charAt(0).toUpperCase() + part.slice(1))
-    .join(' ');
-
-const normalizeProductImages = (
-  product?: Product | null
-): Array<Record<string, unknown>> =>
-  (product?.productimage_set || []).map((item, index) => ({
-    ...item,
-    url: item.image,
-    alt: `${product?.name || 'Product'} ${index + 1}`
-  }));
-
-const normalizeAttributeEntries = (
-  attributes: unknown
-): Array<Record<string, string>> => {
-  const record = toRecord(attributes);
-
-  return Object.values(record)
-    .map(entry => {
-      const typedEntry = toRecord(entry);
-      const label = toStringValue(typedEntry.label);
-      const value = toStringValue(typedEntry.value);
-
-      if (!label && !value) {
-        return null;
-      }
-
-      return { label, value };
-    })
-    .filter((entry): entry is { label: string; value: string } => entry !== null);
-};
-
-export const normalizeProductEntry = (
-  product?: Product | null
-): Record<string, unknown> | null => {
-  if (!product) {
-    return null;
-  }
-
-  const activePrice = toRecord((product as Product & UnknownRecord).active_price);
-  const images = normalizeProductImages(product);
-
-  return {
-    ...product,
-    title: product.name,
-    name: product.name,
-    url: product.absolute_url,
-    image: product.image || images[0]?.url || '',
-    images,
-    price: activePrice.price ?? product.price,
-    retailPrice: activePrice.retail_price ?? product.retail_price,
-    currency: activePrice.currency_type ?? product.currency_type ?? '',
-    description: product.description || '',
-    attributes: normalizeAttributeEntries(product.attributes_kwargs)
-  };
-};
-
-export const buildProductPageContext = (data: ProductResult) => {
-  const normalizedProduct = normalizeProductEntry(data.product);
-  const normalizedSelectedVariant = normalizeProductEntry(data.selected_variant);
-
-  return {
-    page: {
-      type: 'product',
-      title: normalizedProduct?.title || 'Product',
-      path: normalizedProduct?.url || ''
-    },
-    product: {
-      ...normalizedProduct,
-      selectedVariant: normalizedSelectedVariant,
-      selected_variant: normalizedSelectedVariant,
-      variants: data.variants || []
-    }
-  };
-};
-
-export const buildHomepagePageContext = () => ({
-  page: {
-    type: 'homepage',
-    title: 'Homepage',
-    slug: 'homepage',
-    path: ROUTES.HOME
-  },
-  homepage: {
-    title: 'Homepage',
-    slug: 'homepage',
-    path: ROUTES.HOME
-  }
-});
-
-export const buildCustomPageContext = (slug: string) => {
-  const title = humanizeSlug(slug) || 'Custom Page';
-  const path = `/pages/${slug}`;
-
-  return {
-    page: {
-      type: 'custom-page',
-      title,
-      slug,
-      path
-    },
-    customPage: {
-      title,
-      slug,
-      path
-    }
-  };
-};
-
-export const buildListingPageContext = ({
-  data,
-  breadcrumbData,
-  pageType,
-  path
-}: {
-  data: GetCategoryResponse;
-  breadcrumbData?: BreadcrumbResultType[];
-  pageType: 'category' | 'search' | 'plp';
-  path?: string;
-}) => {
-  const normalizedProducts = (data.products || [])
-    .map(product => normalizeProductEntry(product))
-    .filter((product): product is Record<string, unknown> => product !== null);
-  const categorySeoTitle = toStringValue(
-    data.category?.attributes?.category_seo_title?.value?.text
-  );
-  const effectivePath = path || data.category?.absolute_url || ROUTES.HOME;
-  const totalProducts =
-    Number(toRecord(data.pagination).count) || normalizedProducts.length;
-  const title =
-    pageType === 'search'
-      ? data.search_text
-        ? `Search results for ${data.search_text}`
-        : 'Search Results'
-      : data.category?.name || 'Product Listing';
-
-  const category = {
-    ...(data.category || {}),
-    title: data.category?.name || '',
-    name: data.category?.name || '',
-    url: data.category?.absolute_url || '',
-    description: categorySeoTitle,
-    seoTitle: categorySeoTitle,
-    facets: data.facets || [],
-    products: normalizedProducts
-  };
-
-  const listingBase = {
-    title,
-    path: effectivePath,
-    query: data.search_text || '',
-    products: normalizedProducts,
-    totalProducts,
-    resultCount: totalProducts,
-    facets: data.facets || [],
-    sorters: data.sorters || [],
-    pagination: data.pagination || {},
-    category
-  };
-
-  return {
-    page: {
-      type: pageType,
-      title,
-      path: effectivePath
-    },
-    category,
-    listing: {
-      ...listingBase,
-      breadcrumbs: breadcrumbData || []
-    },
-    search: {
-      ...listingBase,
-      title: data.search_text
-        ? `Search results for ${data.search_text}`
-        : 'Search Results'
-    },
-    plp: {
-      ...listingBase,
-      title: data.category?.name || 'Product Listing'
-    },
-    breadcrumbs: breadcrumbData || []
-  };
-};
-
-export const buildBasketPageContext = ({
-  basket,
-  path
-}: {
-  basket?: Basket | null;
-  path?: string;
-}) => {
-  const normalizedItems = (basket?.basketitem_set || []).map(item => {
-    const normalizedProduct = normalizeProductEntry(item.product);
-
-    return {
-      ...item,
-      title: normalizedProduct?.title || item.product?.name || '',
-      name: normalizedProduct?.name || item.product?.name || '',
-      url: normalizedProduct?.url || item.product?.absolute_url || '',
-      image:
-        item.image ||
-        (typeof normalizedProduct?.image === 'string'
-          ? normalizedProduct.image
-          : ''),
-      price: item.price || normalizedProduct?.price || '',
-      retailPrice: item.retail_price || normalizedProduct?.retailPrice || '',
-      totalAmount: item.total_amount || '',
-      unitPrice: item.unit_price || '',
-      currency: item.currency_type || normalizedProduct?.currency || '',
-      quantity: item.quantity,
-      attributes: normalizeAttributeEntries(
-        item.attributes_kwargs || item.product?.attributes_kwargs
-      ),
-      product: normalizedProduct
-    };
-  });
-
-  return {
-    page: {
-      type: 'basket',
-      title: 'Basket',
-      path: path || ROUTES.BASKET
-    },
-    basket: {
-      id: basket?.pk || null,
-      path: path || ROUTES.BASKET,
-      checkoutUrl: ROUTES.CHECKOUT,
-      continueShoppingUrl: ROUTES.HOME,
-      isEmpty: normalizedItems.length === 0,
-      itemCount: normalizedItems.length,
-      totalQuantity: basket?.total_quantity || 0,
-      totalAmount: basket?.total_amount || '',
-      totalProductAmount: basket?.total_product_amount || '',
-      totalDiscountAmount: basket?.total_discount_amount || '',
-      voucherCode: basket?.voucher_code || '',
-      discounts: basket?.discounts || [],
-      items: normalizedItems
-    }
-  };
-};
-
-export const buildAccountPageContext = ({
-  path,
-  profileInfo,
-  sessionUser
-}: {
-  path?: string;
-  profileInfo?: UnknownRecord | null;
-  sessionUser?: UnknownRecord | null;
-}) => {
-  const normalizedPath = path || ROUTES.ACCOUNT;
-  const firstName =
-    toStringValue(profileInfo?.first_name) ||
-    toStringValue(sessionUser?.firstName) ||
-    toStringValue(sessionUser?.name).split(' ')[0] ||
-    '';
-  const lastName =
-    toStringValue(profileInfo?.last_name) ||
-    toStringValue(sessionUser?.lastName) ||
-    toStringValue(sessionUser?.name).split(' ').slice(1).join(' ') ||
-    '';
-  const email =
-    toStringValue(profileInfo?.email) || toStringValue(sessionUser?.email);
-  const fullName =
-    [firstName, lastName].filter(Boolean).join(' ') ||
-    toStringValue(sessionUser?.name);
-
-  return {
-    page: {
-      type: 'account',
-      title: 'Account',
-      path: normalizedPath
-    },
-    account: {
-      path: normalizedPath,
-      route: normalizedPath,
-      user: {
-        firstName,
-        lastName,
-        fullName,
-        email,
-        phone: toStringValue(profileInfo?.phone),
-        gender: toStringValue(profileInfo?.gender)
-      }
-    }
-  };
-};