@akinon/pz-theme 2.0.157-beta.0 → 2.0.157-rc.12

package/src/blocks/order-detail-block.tsx

@@ -9,6 +9,7 @@ import { getResponsiveValue, partAttrs } from '../utils';
 import { formatDate, formatMoney } from './commerce-format';
 import { readMoneyStyle } from './money-style';
 import { hasItemTemplate, ItemTemplateList } from './item-template';
+import { renderOrderLineActions } from './order-line-actions';
 import { BlockRendererProps } from './block-renderer-registry';
 import {
   DesignerPlaceholder,
@@ -16,7 +17,7 @@ import {
   readToggle
 } from './product-block-utils';
 
-interface OrderItemLike {
+type OrderItemLike = {
   id?: number;
   price?: string;
   quantity?: string | number;
@@ -35,7 +36,7 @@ interface OrderItemLike {
     absolute_url?: string;
     attributes?: Record<string, unknown>;
   } | null;
-}
+};
 
 interface AddressLike {
   first_name?: string;
@@ -372,7 +373,9 @@ const formatAddress = (address: AddressLike | null | undefined): string[] => {
  * order key is read from the URL; the editor owns which sections are exposed,
  * every caption and the styling.
  * A designer can mark one child as the row layout for the order lines; without
- * one the built-in line renders.
+ * one the built-in line renders. A brand may hang per-line actions on the
+ * built-in line through `registerOrderLineActions`; they render inside the
+ * line's `item-actions` part.
  * Properties: numberLabel, numberTag, dateLabel, headerTotalLabel,
  * showInvoiceLink, invoiceLinkLabel, showCancelLink, cancelLinkLabel,
  * showReturnLink, returnLinkLabel, cancelHrefBase, showShipmentStatus, showItems, showImage, imageWidth,
@@ -390,7 +393,7 @@ const formatAddress = (address: AddressLike | null | undefined): string[] => {
  * currencyText, currencyPosition.
  * Parts: detail, header, number, date, header-total, status,
  * invoice-link, cancel-link, return-link, list, item, image, name, quantity,
- * color, size, item-status, item-tracking, item-return-code,
+ * color, size, item-status, item-tracking, item-return-code, item-actions,
  * item-return-method, item-return-carrier, item-pickup-date, price, shipment,
  * delivery, tracking, addresses, address, address-label, totals, total-row,
  * total-label, total-value, grand-total, payment-info, payment-info-label.
@@ -930,6 +933,21 @@ const OrderDetailBlock = ({
                 showPickupDate && returnDetails.pickupDate
                   ? formatPickupDate(returnDetails.pickupDate, locale)
                   : '';
+              const lineActions = renderOrderLineActions({
+                order,
+                line,
+                isDesigner
+              });
+              const showLineMeta =
+                showShipmentStatus &&
+                Boolean(
+                  item.status?.label ||
+                    trackingValue ||
+                    returnCodeValue ||
+                    returnMethodValue ||
+                    returnCarrierValue ||
+                    pickupDateValue
+                );
 
               return (
                 <li
@@ -1045,98 +1063,100 @@ const OrderDetailBlock = ({
                       </div>
                     </div>
 
-                    {showShipmentStatus &&
-                      (item.status?.label ||
-                        trackingValue ||
-                        returnCodeValue ||
-                        returnMethodValue ||
-                        returnCarrierValue ||
-                        pickupDateValue) && (
-                        <div
-                          style={{
-                            display: 'flex',
-                            flexDirection: 'column',
-                            alignItems: isMobile ? 'flex-start' : 'flex-end',
-                            textAlign: isMobile ? 'left' : 'right',
-                            gap: '4px',
-                            flex: isMobile ? '1 1 100%' : '0 0 auto'
-                          }}
-                        >
-                          {item.status?.label && (
-                            <span
-                              data-order-detail-item-status=""
-                              data-order-status-value={item.status.value}
-                              {...partAttrs('item-status')}
-                              style={{ display: 'inline-block' }}
-                            >
-                              {item.status.label}
-                            </span>
-                          )}
-                          {/* Label and value in their own spans, so a
-                              composition can colour them apart. */}
-                          {returnMethodValue && (
-                            <span
-                              data-order-detail-item-return-method=""
-                              {...partAttrs('item-return-method')}
-                              style={{ opacity: 0.8 }}
-                            >
-                              <span data-label="">{returnMethodLabel}</span>{' '}
-                              <span data-value="">{returnMethodValue}</span>
-                            </span>
-                          )}
-                          {returnCarrierValue && (
-                            <span
-                              data-order-detail-item-return-carrier=""
-                              {...partAttrs('item-return-carrier')}
-                              style={{ opacity: 0.8 }}
-                            >
-                              <span data-label="">{returnCarrierLabel}</span>{' '}
-                              <span data-value="">{returnCarrierValue}</span>
-                            </span>
-                          )}
-                          {pickupDateValue && (
-                            <span
-                              data-order-detail-item-pickup-date=""
-                              {...partAttrs('item-pickup-date')}
-                              style={{ opacity: 0.8 }}
-                            >
-                              <span data-label="">{pickupDateLabel}</span>{' '}
-                              <span data-value="">{pickupDateValue}</span>
-                            </span>
-                          )}
-                          {trackingValue && (
-                            <span
-                              data-order-detail-item-tracking=""
-                              {...partAttrs('item-tracking')}
-                              style={{ opacity: 0.8 }}
-                            >
-                              {lineTrackingLabel}{' '}
-                              {item.tracking_url ? (
-                                <a
-                                  href={isDesigner ? '#' : item.tracking_url}
-                                  onClick={guard}
-                                  target={isDesigner ? undefined : '_blank'}
-                                  rel="noreferrer"
-                                  style={{ color: 'inherit' }}
-                                >
-                                  {item.tracking_number || item.tracking_url}
-                                </a>
-                              ) : (
-                                trackingValue
-                              )}
-                            </span>
-                          )}
-                          {returnCodeValue && (
-                            <span
-                              data-order-detail-item-return-code=""
-                              {...partAttrs('item-return-code')}
-                              style={{ opacity: 0.8 }}
-                            >
-                              {returnCodeLabel} {returnCodeValue}
-                            </span>
-                          )}
-                        </div>
-                      )}
+                    {(showLineMeta || lineActions) && (
+                      <div
+                        style={{
+                          display: 'flex',
+                          flexDirection: 'column',
+                          alignItems: isMobile ? 'flex-start' : 'flex-end',
+                          textAlign: isMobile ? 'left' : 'right',
+                          gap: '4px',
+                          flex: isMobile ? '1 1 100%' : '0 0 auto'
+                        }}
+                      >
+                        {lineActions && (
+                          <div
+                            data-order-detail-item-actions=""
+                            {...partAttrs('item-actions')}
+                          >
+                            {lineActions}
+                          </div>
+                        )}
+                        {showLineMeta && item.status?.label && (
+                          <span
+                            data-order-detail-item-status=""
+                            data-order-status-value={item.status.value}
+                            {...partAttrs('item-status')}
+                            style={{ display: 'inline-block' }}
+                          >
+                            {item.status.label}
+                          </span>
+                        )}
+                        {/* Label and value in their own spans, so a
+                            composition can colour them apart. */}
+                        {showLineMeta && returnMethodValue && (
+                          <span
+                            data-order-detail-item-return-method=""
+                            {...partAttrs('item-return-method')}
+                            style={{ opacity: 0.8 }}
+                          >
+                            <span data-label="">{returnMethodLabel}</span>{' '}
+                            <span data-value="">{returnMethodValue}</span>
+                          </span>
+                        )}
+                        {showLineMeta && returnCarrierValue && (
+                          <span
+                            data-order-detail-item-return-carrier=""
+                            {...partAttrs('item-return-carrier')}
+                            style={{ opacity: 0.8 }}
+                          >
+                            <span data-label="">{returnCarrierLabel}</span>{' '}
+                            <span data-value="">{returnCarrierValue}</span>
+                          </span>
+                        )}
+                        {showLineMeta && pickupDateValue && (
+                          <span
+                            data-order-detail-item-pickup-date=""
+                            {...partAttrs('item-pickup-date')}
+                            style={{ opacity: 0.8 }}
+                          >
+                            <span data-label="">{pickupDateLabel}</span>{' '}
+                            <span data-value="">{pickupDateValue}</span>
+                          </span>
+                        )}
+                        {showLineMeta && trackingValue && (
+                          <span
+                            data-order-detail-item-tracking=""
+                            {...partAttrs('item-tracking')}
+                            style={{ opacity: 0.8 }}
+                          >
+                            {lineTrackingLabel}{' '}
+                            {item.tracking_url ? (
+                              <a
+                                href={isDesigner ? '#' : item.tracking_url}
+                                onClick={guard}
+                                target={isDesigner ? undefined : '_blank'}
+                                rel="noreferrer"
+                                style={{ color: 'inherit' }}
+                              >
+                                {item.tracking_number || item.tracking_url}
+                              </a>
+                            ) : (
+                              trackingValue
+                            )}
+                          </span>
+                        )}
+                        {showLineMeta && returnCodeValue && (
+                          <span
+                            data-order-detail-item-return-code=""
+                            {...partAttrs('item-return-code')}
+                            style={{ opacity: 0.8 }}
+                          >
+                            {returnCodeLabel} {returnCodeValue}
+                          </span>
+                        )}
+                      </div>
+                    )}
                   </div>
                 </li>
               );

package/src/blocks/order-line-actions.ts

@@ -0,0 +1,45 @@
+import type { ReactNode } from 'react';
+import type { GroupedOrderLine, OrderLineLike } from './product-block-utils';
+
+export interface OrderLineActionsOrder {
+  id?: number;
+  number?: string;
+  created_date?: string;
+}
+
+export type OrderLineActionsItem = OrderLineLike & {
+  status?: { value?: string; label?: string };
+  [key: string]: unknown;
+};
+
+export interface OrderLineActionsContext {
+  order: OrderLineActionsOrder;
+  line: GroupedOrderLine<OrderLineActionsItem>;
+  isDesigner: boolean;
+}
+
+export type OrderLineActionsRenderer = (
+  context: OrderLineActionsContext
+) => ReactNode;
+
+let renderer: OrderLineActionsRenderer | null = null;
+
+export const registerOrderLineActions = (
+  fn: OrderLineActionsRenderer
+): (() => void) => {
+  renderer = fn;
+  return () => {
+    if (renderer === fn) renderer = null;
+  };
+};
+
+export const renderOrderLineActions = (
+  context: OrderLineActionsContext
+): ReactNode => {
+  if (!renderer) return null;
+  try {
+    return renderer(context) ?? null;
+  } catch {
+    return null;
+  }
+};

package/src/blocks/order-list-block.tsx

@@ -13,7 +13,14 @@ import { readToggle } from './product-block-utils';
 import { BlockRendererProps } from './block-renderer-registry';
 
 interface OrderItemLike {
-  product?: { image?: string; name?: string } | null;
+  id?: number;
+  status?: { value?: string | number; label?: string };
+  product?: {
+    image?: string;
+    name?: string;
+    sku?: string;
+    base_code?: string;
+  } | null;
 }
 
 interface OrderLike {
@@ -248,7 +255,23 @@ const OrderListBlock = ({
         maxImages
     ),
     url: hrefFor(order),
-    href: hrefFor(order)
+    href: hrefFor(order),
+    createdDate: order.created_date || '',
+    items: (Array.isArray(order.orderitem_set) ? order.orderitem_set : []).map(
+      (item, itemIndex) => ({
+        id: item?.id ?? itemIndex,
+        name: item?.product?.name || '',
+        image: item?.product?.image || '',
+        status: item?.status?.label || '',
+        statusValue: String(item?.status?.value ?? ''),
+        product: {
+          sku: item?.product?.sku || '',
+          base_code: item?.product?.base_code || '',
+          name: item?.product?.name || '',
+          image: item?.product?.image || ''
+        }
+      })
+    )
   }));
 
   // A designer who marked a child as the row layout gets that layout repeated

package/src/blocks/row-scope.tsx

@@ -0,0 +1,35 @@
+'use client';
+
+import React from 'react';
+
+export interface ThemeRowScopeValue {
+  listType: string;
+  row: Record<string, unknown>;
+  index: number;
+}
+
+const ThemeRowScopeContext = React.createContext<ThemeRowScopeValue | null>(
+  null
+);
+
+export const ThemeRowScopeProvider = ({
+  listType,
+  row,
+  index,
+  children
+}: ThemeRowScopeValue & { children: React.ReactNode }) => {
+  const value = React.useMemo(
+    () => ({ listType, row, index }),
+    [listType, row, index]
+  );
+
+  return (
+    <ThemeRowScopeContext.Provider value={value}>
+      {children}
+    </ThemeRowScopeContext.Provider>
+  );
+};
+
+/** Non-null while a repeated row of any list renders; null everywhere else. */
+export const useThemeRowScope = (): ThemeRowScopeValue | null =>
+  React.useContext(ThemeRowScopeContext);

package/src/blocks/text-block.tsx

@@ -7,6 +7,7 @@ import { getInnerRootInlineStyles, partAttrs } from '../utils';
 import { useThemeSettingsContext } from '../theme-settings-context';
 import { useLocalizeHref } from '../hooks/use-localize-href';
 import { localizeHtmlLinks } from '../utils/localize-href';
+import { useValueLocale } from '../utils/localized-value';
 
 const TextBlock = ({
   block,
@@ -14,7 +15,7 @@ const TextBlock = ({
 }: BlockRendererProps) => {
   const { locale } = useLocalization();
   const localize = useLocalizeHref();
-  const defaultLocale = process.env.NEXT_PUBLIC_DEFAULT_LOCALE || 'en';
+  const { defaultLocale } = useValueLocale();
   const themeSettings = useThemeSettingsContext();
 
   const getLocalizedContent = (): string => {
@@ -30,7 +31,10 @@ const TextBlock = ({
 
     if (typeof value === 'object' && value !== null) {
       return (
-        value[locale] || value[defaultLocale] || Object.values(value)[0] || ''
+        value[locale] ||
+        (defaultLocale && value[defaultLocale]) ||
+        Object.values(value)[0] ||
+        ''
       );
     }
 

package/src/chrome/__tests__/page-context-builders.test.ts

@@ -41,7 +41,7 @@ const orderPayload = {
   orderitem_set: [
     {
       price: '649.95',
-      status: { label: 'Shipped' },
+      status: { value: '500', label: 'Shipped' },
       product: {
         name: 'Spring Sneaker',
         image: '/i.jpg',
@@ -63,6 +63,19 @@ describe('buildOrderPageContext', () => {
     expect(context.order.currency).toBe('TRY');
     expect(context.order.items).toHaveLength(1);
     expect(context.order.items[0].title).toBe('Spring Sneaker');
+    expect(context.order.items[0].status).toBe('Shipped');
+    expect(context.order.items[0].statusValue).toBe('500');
+  });
+
+  it('stringifies a numeric order item status code', () => {
+    const context = buildOrderPageContext({
+      order: {
+        ...orderPayload,
+        orderitem_set: [{ status: { value: 550, label: 'Delivered' } }]
+      }
+    });
+
+    expect(context.order.items[0].statusValue).toBe('550');
   });
 
   it('does not publish the identity fields the raw payload carries', () => {

package/src/chrome/page-context.ts

@@ -59,6 +59,9 @@ const toRecord = (value: unknown): UnknownRecord =>
 const toStringValue = (value: unknown, fallback = ''): string =>
   typeof value === 'string' ? value : fallback;
 
+const toCodeValue = (value: unknown): string =>
+  typeof value === 'number' ? String(value) : toStringValue(value);
+
 const humanizeSlug = (value: string) =>
   value
     .split('-')
@@ -479,6 +482,7 @@ export const buildOrderPageContext = ({
       unitPrice: toStringValue(item.price),
       quantity: 1,
       status: toStringValue(toRecord(item.status).label),
+      statusValue: toCodeValue(toRecord(item.status).value),
       currency
     };
   });