@shoppexio/builder-runtime 0.1.1 → 0.1.2

package/dist/standard-product-blocks.d.ts

@@ -0,0 +1,48 @@
+import type { BlockInstance } from '@shoppex/builder-contracts';
+import type { ReactNode } from 'react';
+import { getProductPageBlockAttributes } from './product-page.js';
+import { type StandardBuyBoxLabels, type StandardDetailsLabels, type StandardProductTabSpec } from './standard-product-page.js';
+import { type BuilderBlockRegistry } from './react.js';
+export { STANDARD_PRODUCT_BLOCK_TYPES, STANDARD_PRODUCT_PRIMARY_BLOCK_TYPES, STANDARD_PRODUCT_SECONDARY_BLOCK_TYPES, splitStandardProductPageBlocks, buildStandardProductInfoTabs, resolveStandardBuyBoxLabels, resolveStandardDetailsLabels, resolveStandardRelatedProductsTitle, resolveScopedBlockSettingText, } from './standard-product-page.js';
+export type { StandardBuyBoxLabels, StandardDetailsLabels, StandardProductTabSpec, StandardProductBlockType, StandardProductSettingScope, } from './standard-product-page.js';
+type StandardProductBlockAttrs = ReturnType<typeof getProductPageBlockAttributes>;
+export type StandardProductBlockRegistrySlots = {
+    renderGallery: (input: {
+        block: BlockInstance;
+        attrs: StandardProductBlockAttrs;
+    }) => ReactNode;
+    renderBuyBox: (input: {
+        block: BlockInstance;
+        attrs: StandardProductBlockAttrs;
+        labels: StandardBuyBoxLabels;
+    }) => ReactNode;
+    renderDetails: (input: {
+        block: BlockInstance;
+        attrs: StandardProductBlockAttrs;
+        labels: StandardDetailsLabels;
+        tabs: StandardProductTabSpec[];
+    }) => ReactNode;
+    renderRelatedProducts: (input: {
+        block: BlockInstance;
+        attrs: StandardProductBlockAttrs;
+        title: string | null;
+    }) => ReactNode | null;
+};
+export type StandardProductBlockRegistryOptions = {
+    useScopedKeys?: boolean;
+    includeReviewsTab?: boolean;
+    useShopReviewTabLabel?: boolean;
+};
+export type StandardProductBlockRegistryData = {
+    filteredDescription: string;
+    faqCount: number;
+    reviewCount: number;
+    reviewSource?: 'shop' | 'product';
+    relatedProductsCount: number;
+};
+export declare function createStandardProductBlockRegistry(input: {
+    slots: StandardProductBlockRegistrySlots;
+    data: StandardProductBlockRegistryData;
+    options?: StandardProductBlockRegistryOptions;
+}): BuilderBlockRegistry<null>;
+//# sourceMappingURL=standard-product-blocks.d.ts.map

package/dist/standard-product-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-product-blocks.d.ts","sourceRoot":"","sources":["../src/standard-product-blocks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,EACpC,sCAAsC,EACtC,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,KAAK,yBAAyB,GAAG,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAElF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,aAAa,EAAE,CAAC,KAAK,EAAE;QACrB,KAAK,EAAE,aAAa,CAAC;QACrB,KAAK,EAAE,yBAAyB,CAAC;KAClC,KAAK,SAAS,CAAC;IAChB,YAAY,EAAE,CAAC,KAAK,EAAE;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,KAAK,EAAE,yBAAyB,CAAC;QACjC,MAAM,EAAE,oBAAoB,CAAC;KAC9B,KAAK,SAAS,CAAC;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE;QACrB,KAAK,EAAE,aAAa,CAAC;QACrB,KAAK,EAAE,yBAAyB,CAAC;QACjC,MAAM,EAAE,qBAAqB,CAAC;QAC9B,IAAI,EAAE,sBAAsB,EAAE,CAAC;KAChC,KAAK,SAAS,CAAC;IAChB,qBAAqB,EAAE,CAAC,KAAK,EAAE;QAC7B,KAAK,EAAE,aAAa,CAAC;QACrB,KAAK,EAAE,yBAAyB,CAAC;QACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,KAAK,SAAS,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,KAAK,EAAE,iCAAiC,CAAC;IACzC,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,CAAC,EAAE,mCAAmC,CAAC;CAC/C,GAAG,oBAAoB,CAAC,IAAI,CAAC,CA4C7B"}

package/dist/standard-product-blocks.js

@@ -0,0 +1,45 @@
+import { getProductPageBlockAttributes } from './product-page.js';
+import { buildStandardProductInfoTabs, resolveStandardBuyBoxLabels, resolveStandardDetailsLabels, resolveStandardRelatedProductsTitle, } from './standard-product-page.js';
+export { STANDARD_PRODUCT_BLOCK_TYPES, STANDARD_PRODUCT_PRIMARY_BLOCK_TYPES, STANDARD_PRODUCT_SECONDARY_BLOCK_TYPES, splitStandardProductPageBlocks, buildStandardProductInfoTabs, resolveStandardBuyBoxLabels, resolveStandardDetailsLabels, resolveStandardRelatedProductsTitle, resolveScopedBlockSettingText, } from './standard-product-page.js';
+export function createStandardProductBlockRegistry(input) {
+    const { slots, data, options = {} } = input;
+    return {
+        gallery: ({ block }) => slots.renderGallery({
+            block,
+            attrs: getProductPageBlockAttributes(block),
+        }),
+        'buy-box': ({ block }) => slots.renderBuyBox({
+            block,
+            attrs: getProductPageBlockAttributes(block),
+            labels: resolveStandardBuyBoxLabels(block, options),
+        }),
+        details: ({ block }) => {
+            const labels = resolveStandardDetailsLabels(block, options);
+            const tabs = buildStandardProductInfoTabs({
+                labels,
+                filteredDescription: data.filteredDescription,
+                faqCount: data.faqCount,
+                reviewCount: data.reviewCount,
+                reviewSource: data.reviewSource,
+                includeReviewsTab: options.includeReviewsTab ?? true,
+                useShopReviewTabLabel: options.useShopReviewTabLabel ?? false,
+            });
+            return slots.renderDetails({
+                block,
+                attrs: getProductPageBlockAttributes(block),
+                labels,
+                tabs,
+            });
+        },
+        'related-products': ({ block }) => {
+            if (data.relatedProductsCount <= 0) {
+                return null;
+            }
+            return slots.renderRelatedProducts({
+                block,
+                attrs: getProductPageBlockAttributes(block),
+                title: resolveStandardRelatedProductsTitle(block, options),
+            });
+        },
+    };
+}

package/dist/standard-product-page.d.ts

@@ -0,0 +1,69 @@
+import type { BlockInstance } from '@shoppex/builder-contracts';
+export declare const STANDARD_PRODUCT_BLOCK_TYPES: readonly ["gallery", "buy-box", "details", "related-products"];
+export type StandardProductBlockType = (typeof STANDARD_PRODUCT_BLOCK_TYPES)[number];
+export declare const STANDARD_PRODUCT_PRIMARY_BLOCK_TYPES: readonly ["gallery", "buy-box"];
+export declare const STANDARD_PRODUCT_SECONDARY_BLOCK_TYPES: readonly ["details", "related-products"];
+export type StandardProductSettingScope = 'buyBox' | 'details' | 'relatedProducts';
+export declare function splitStandardProductPageBlocks(blocks: BlockInstance[]): {
+    primary: {
+        id: string;
+        type: string;
+        visible: boolean;
+        settings: Record<string, unknown>;
+        variant?: string | undefined;
+        style_overrides?: Partial<Record<import("@shoppex/builder-contracts").StyleSlotId, import("@shoppex/builder-contracts").StyleSlotValue>> | undefined;
+    }[];
+    secondary: {
+        id: string;
+        type: string;
+        visible: boolean;
+        settings: Record<string, unknown>;
+        variant?: string | undefined;
+        style_overrides?: Partial<Record<import("@shoppex/builder-contracts").StyleSlotId, import("@shoppex/builder-contracts").StyleSlotValue>> | undefined;
+    }[];
+};
+export declare function resolveScopedBlockSettingText(block: Pick<BlockInstance, 'settings'>, scope: StandardProductSettingScope, key: string): string | null;
+export type StandardBuyBoxLabels = {
+    variantLabel: string | null;
+    addonsLabel: string | null;
+    primaryActionLabel: string | null;
+    buyNowLabel: string | null;
+    quantityLabel: string | null;
+    reviewsLabel: string | null;
+    noReviewsLabel: string | null;
+};
+export declare function resolveStandardBuyBoxLabels(block: Pick<BlockInstance, 'settings'>, options?: {
+    useScopedKeys?: boolean;
+}): StandardBuyBoxLabels;
+export type StandardDetailsLabels = {
+    descriptionTabLabel: string | null;
+    reviewsTabLabel: string | null;
+    shopReviewsTabLabel: string | null;
+    faqTabLabel: string | null;
+    emptyDescriptionLabel: string | null;
+    emptyReviewsTitle: string | null;
+    emptyReviewsDescription: string | null;
+    emptyFaqLabel: string | null;
+};
+export declare function resolveStandardDetailsLabels(block: Pick<BlockInstance, 'settings'>, options?: {
+    useScopedKeys?: boolean;
+}): StandardDetailsLabels;
+export type StandardProductTabSpec = {
+    id: 'description' | 'reviews' | 'faq';
+    label: string;
+    content?: string;
+    badge?: string;
+};
+export declare function buildStandardProductInfoTabs(input: {
+    labels: StandardDetailsLabels;
+    filteredDescription: string;
+    faqCount: number;
+    reviewCount: number;
+    reviewSource?: 'shop' | 'product';
+    includeReviewsTab?: boolean;
+    useShopReviewTabLabel?: boolean;
+}): StandardProductTabSpec[];
+export declare function resolveStandardRelatedProductsTitle(block: Pick<BlockInstance, 'settings'>, options?: {
+    useScopedKeys?: boolean;
+}): string | null;
+//# sourceMappingURL=standard-product-page.d.ts.map

package/dist/standard-product-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-product-page.d.ts","sourceRoot":"","sources":["../src/standard-product-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,eAAO,MAAM,4BAA4B,gEAK/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAErF,eAAO,MAAM,oCAAoC,iCAAkC,CAAC;AACpF,eAAO,MAAM,sCAAsC,0CAA2C,CAAC;AAE/F,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAQnF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,aAAa,EAAE;;;;;;;;;;;;;;;;;EAKrE;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACtC,KAAK,EAAE,2BAA2B,EAClC,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAIf;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACtC,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,oBAAoB,CAetB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACtC,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,qBAAqB,CAgBvB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,MAAM,EAAE,qBAAqB,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,GAAG,sBAAsB,EAAE,CAyC3B;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACtC,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,MAAM,GAAG,IAAI,CAKf"}

package/dist/standard-product-page.js

@@ -0,0 +1,89 @@
+import { getBuilderBlockSettingText } from './product-page.js';
+export const STANDARD_PRODUCT_BLOCK_TYPES = [
+    'gallery',
+    'buy-box',
+    'details',
+    'related-products',
+];
+export const STANDARD_PRODUCT_PRIMARY_BLOCK_TYPES = ['gallery', 'buy-box'];
+export const STANDARD_PRODUCT_SECONDARY_BLOCK_TYPES = ['details', 'related-products'];
+const SCOPE_PREFIX = {
+    buyBox: 'product.buyBox',
+    details: 'product.details',
+    relatedProducts: 'product.relatedProducts',
+};
+export function splitStandardProductPageBlocks(blocks) {
+    return {
+        primary: blocks.filter((block) => block.type === 'gallery' || block.type === 'buy-box'),
+        secondary: blocks.filter((block) => block.type === 'details' || block.type === 'related-products'),
+    };
+}
+export function resolveScopedBlockSettingText(block, scope, key) {
+    const prefixed = getBuilderBlockSettingText(block, `${SCOPE_PREFIX[scope]}.${key}`);
+    if (prefixed)
+        return prefixed;
+    return getBuilderBlockSettingText(block, key);
+}
+export function resolveStandardBuyBoxLabels(block, options) {
+    const read = (key) => options?.useScopedKeys
+        ? resolveScopedBlockSettingText(block, 'buyBox', key)
+        : getBuilderBlockSettingText(block, key);
+    return {
+        variantLabel: read('variantLabel'),
+        addonsLabel: read('addonsLabel'),
+        primaryActionLabel: read('primaryActionLabel'),
+        buyNowLabel: read('buyNowLabel'),
+        quantityLabel: read('quantityLabel'),
+        reviewsLabel: read('reviewsLabel'),
+        noReviewsLabel: read('noReviewsLabel'),
+    };
+}
+export function resolveStandardDetailsLabels(block, options) {
+    const read = (key) => options?.useScopedKeys
+        ? resolveScopedBlockSettingText(block, 'details', key)
+        : getBuilderBlockSettingText(block, key);
+    return {
+        descriptionTabLabel: read('descriptionTabLabel'),
+        reviewsTabLabel: read('reviewsTabLabel'),
+        shopReviewsTabLabel: read('shopReviewsTabLabel'),
+        faqTabLabel: read('faqTabLabel'),
+        emptyDescriptionLabel: read('emptyDescriptionLabel'),
+        emptyReviewsTitle: read('emptyReviewsTitle'),
+        emptyReviewsDescription: read('emptyReviewsDescription'),
+        emptyFaqLabel: read('emptyFaqLabel'),
+    };
+}
+export function buildStandardProductInfoTabs(input) {
+    const { labels, filteredDescription, faqCount, reviewCount, reviewSource = 'product', includeReviewsTab = true, useShopReviewTabLabel = false, } = input;
+    const tabs = [
+        {
+            id: 'description',
+            label: labels.descriptionTabLabel ?? 'Description',
+            content: filteredDescription,
+        },
+    ];
+    if (includeReviewsTab) {
+        const reviewsLabel = useShopReviewTabLabel && reviewSource === 'shop'
+            ? (labels.shopReviewsTabLabel ?? labels.reviewsTabLabel ?? 'Shop Reviews')
+            : (labels.reviewsTabLabel ?? 'Reviews');
+        tabs.push({
+            id: 'reviews',
+            label: reviewsLabel,
+            badge: String(reviewCount),
+        });
+    }
+    if (faqCount > 0) {
+        tabs.push({
+            id: 'faq',
+            label: labels.faqTabLabel ?? 'FAQ',
+            badge: String(faqCount),
+        });
+    }
+    return tabs;
+}
+export function resolveStandardRelatedProductsTitle(block, options) {
+    if (options?.useScopedKeys) {
+        return resolveScopedBlockSettingText(block, 'relatedProducts', 'title');
+    }
+    return getBuilderBlockSettingText(block, 'title');
+}

package/dist/storefront-google-fonts.d.ts

@@ -0,0 +1,2 @@
+export declare function syncStorefrontGoogleFontStylesheets(hrefs: string[]): () => void;
+//# sourceMappingURL=storefront-google-fonts.d.ts.map

package/dist/storefront-google-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-google-fonts.d.ts","sourceRoot":"","sources":["../src/storefront-google-fonts.ts"],"names":[],"mappings":"AAEA,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAwC/E"}

package/dist/storefront-google-fonts.js

@@ -0,0 +1,28 @@
+const STOREFRONT_GOOGLE_FONT_MARKER = 'data-shoppex-storefront-google-font';
+export function syncStorefrontGoogleFontStylesheets(hrefs) {
+    if (typeof document === 'undefined') {
+        return () => { };
+    }
+    const nextHrefs = [...new Set(hrefs.filter((href) => href.trim().length > 0))];
+    const existing = Array.from(document.head.querySelectorAll(`link[rel="stylesheet"][${STOREFRONT_GOOGLE_FONT_MARKER}]`));
+    for (const link of existing) {
+        if (!nextHrefs.includes(link.href)) {
+            link.remove();
+        }
+    }
+    for (const href of nextHrefs) {
+        const alreadyPresent = Array.from(document.head.querySelectorAll('link[rel="stylesheet"]')).some((link) => link.href === href);
+        if (alreadyPresent)
+            continue;
+        const link = document.createElement('link');
+        link.rel = 'stylesheet';
+        link.href = href;
+        link.setAttribute(STOREFRONT_GOOGLE_FONT_MARKER, 'true');
+        document.head.appendChild(link);
+    }
+    return () => {
+        for (const link of Array.from(document.head.querySelectorAll(`link[rel="stylesheet"][${STOREFRONT_GOOGLE_FONT_MARKER}]`))) {
+            link.remove();
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/builder-runtime",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Theme-side Builder v2 runtime helpers for Shoppex storefront themes",
   "type": "module",
   "repository": {
@@ -75,11 +75,11 @@
   "author": "Shoppex",
   "license": "MIT",
   "peerDependencies": {
-    "@shoppexio/builder-contracts": "0.1.0",
+    "@shoppexio/builder-contracts": "0.1.1",
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@shoppex/builder-contracts": "npm:@shoppexio/builder-contracts@0.1.0"
+    "@shoppex/builder-contracts": "npm:@shoppexio/builder-contracts@0.1.1"
   },
   "devDependencies": {
     "jsdom": "^28.1.0",

package/src/builder-runtime.test.ts

@@ -118,6 +118,39 @@ describe('@shoppex/builder-runtime', () => {
     }, 'product')).toEqual(['gallery', 'buy-box']);
   });
 
+  test('reads legacy builder.pages manifests used by custom imported themes', () => {
+    expect(getThemePageBlockOrderFromManifest({
+      id: 'cheatshub',
+      name: 'CheatsHub Theme',
+      version: '0.1.0',
+      builder: {
+        pages: [
+          {
+            id: 'home',
+            label: 'Home',
+            blocks: ['marquee', 'hero', 'products'],
+          },
+        ],
+        blocks: {
+          marquee: { label: 'Marquee', settings: {}, variants: [], exposedStyleSlots: [], presets: [] },
+          hero: { label: 'Hero', settings: {}, variants: [], exposedStyleSlots: [], presets: [] },
+          products: { label: 'Products', settings: {}, variants: [], exposedStyleSlots: [], presets: [] },
+        },
+      },
+    }, 'home')).toEqual(['marquee', 'hero', 'products']);
+  });
+
+  test('ignores malformed defaultBlocks in raw page manifests', () => {
+    expect(getThemePageBlockOrderFromManifest({
+      pages: {
+        home: {
+          allowedBlocks: ['hero', 'faq'],
+          defaultBlocks: { type: 'hero' },
+        },
+      },
+    }, 'home')).toEqual(['hero', 'faq']);
+  });
+
   test('resolves style slots with breakpoint fallback and block override', () => {
     const settings = createSettings();
     const block = settings.theme.layout.home.blocks[0];

package/src/index.ts

@@ -1,6 +1,10 @@
+export * from './preview-fixtures.js';
+export * from './product-page.js';
+export * from './standard-product-page.js';
 export * from './attributes.js';
 export * from './content.js';
 export * from './css-vars.js';
 export * from './layout.js';
 export * from './react.js';
+export * from './storefront-google-fonts.js';
 export * from './style-slots.js';

package/src/layout.ts

@@ -1,12 +1,18 @@
-import type { BlockInstance, BuilderSettings, PageLayout, ThemeManifest } from '@shoppex/builder-contracts';
+import {
+  getThemePageBlockOrderFromManifest as resolveThemePageBlockOrder,
+  type BlockInstance,
+  type BuilderSettings,
+  type PageLayout,
+  type ThemeManifest,
+  type ThemePageBlockOrderPage,
+} from '@shoppex/builder-contracts';
 
 export type ThemePageBlockOrderManifest = {
-  pages?: Record<string, {
-    allowedBlocks?: string[];
-    defaultBlocks?: Array<{ type?: string }>;
-  }>;
+  pages?: Record<string, ThemePageBlockOrderPage>;
 };
 
+export { resolveThemePageBlockOrder as getThemePageBlockOrderFromManifest };
+
 export function getPageLayout(settings: BuilderSettings, pageId: string): PageLayout {
   return settings.theme.layout[pageId] ?? { blocks: [] };
 }
@@ -27,22 +33,6 @@ export function getAllowedBlockTypes(manifest: ThemeManifest, pageId: string): s
   return manifest.pages[pageId]?.allowedBlocks ?? [];
 }
 
-export function getThemePageBlockOrderFromManifest(
-  manifest: ThemePageBlockOrderManifest,
-  pageId: string,
-): string[] {
-  const page = manifest.pages?.[pageId];
-  if (!page) {
-    return [];
-  }
-
-  const defaultBlockTypes = (page.defaultBlocks ?? [])
-    .map((block) => block.type)
-    .filter((blockType): blockType is string => typeof blockType === 'string' && blockType.length > 0);
-
-  return defaultBlockTypes.length > 0 ? defaultBlockTypes : page.allowedBlocks ?? [];
-}
-
 export function canAddBlock(settings: BuilderSettings, manifest: ThemeManifest, pageId: string, blockType: string): boolean {
   const page = manifest.pages[pageId];
   const blockDefinition = manifest.blocks[blockType];

package/src/preview-fixtures.ts

@@ -0,0 +1,56 @@
+export type BuilderPreviewReview = {
+  id: string;
+  author: string | null;
+  comment: string | null;
+  rating: number | null;
+  created_at: string;
+  is_automated?: boolean;
+};
+
+export type BuilderPreviewFaqItem = {
+  question: string;
+  answer: string;
+};
+
+export const BUILDER_PREVIEW_REVIEWS: BuilderPreviewReview[] = [
+  {
+    id: 'preview-review-1',
+    author: 'Alex M.',
+    comment: 'Instant delivery and clear instructions. Would buy again.',
+    rating: 5,
+    created_at: '2026-04-12T10:00:00.000Z',
+  },
+  {
+    id: 'preview-review-2',
+    author: 'Jamie R.',
+    comment: 'Support answered quickly when I had a setup question.',
+    rating: 5,
+    created_at: '2026-04-03T14:30:00.000Z',
+  },
+  {
+    id: 'preview-review-3',
+    author: 'Taylor S.',
+    comment: 'Smooth checkout experience and exactly what was advertised.',
+    rating: 4,
+    created_at: '2026-03-22T09:15:00.000Z',
+  },
+];
+
+export function getBuilderPreviewReviewFixtures<T = BuilderPreviewReview>(): T[] {
+  return BUILDER_PREVIEW_REVIEWS as T[];
+}
+
+export const BUILDER_PREVIEW_FAQ_ITEMS: BuilderPreviewFaqItem[] = [
+  {
+    question: 'How fast is delivery?',
+    answer: 'Most digital products are delivered instantly after payment confirmation.',
+  },
+  {
+    question: 'Which payment methods do you accept?',
+    answer: 'Available payment methods depend on your shop configuration and region.',
+  },
+  {
+    question: 'How do I get support?',
+    answer: 'Use the contact page or your customer portal for order-related help.',
+  },
+];

package/src/product-page.test.ts

@@ -0,0 +1,37 @@
+import { describe, expect, test } from 'bun:test';
+import { createBlockInstance } from '@shoppex/builder-contracts';
+import {
+  getBuilderBlockSettingText,
+  getLayoutPageBlockAttributes,
+  getProductPageBlockAttributes,
+} from './product-page.js';
+
+describe('product-page helpers', () => {
+  test('getBuilderBlockSettingText trims non-empty strings', () => {
+    const block = createBlockInstance({
+      type: 'buy-box',
+      settings: {
+        variantLabel: '  License Type  ',
+        addonsLabel: '   ',
+      },
+    });
+
+    expect(getBuilderBlockSettingText(block, 'variantLabel')).toBe('License Type');
+    expect(getBuilderBlockSettingText(block, 'addonsLabel')).toBeNull();
+    expect(getBuilderBlockSettingText(block, 'missing')).toBeNull();
+  });
+
+  test('getLayoutPageBlockAttributes includes page id and builder block attrs', () => {
+    const block = createBlockInstance({ id: 'gallery-1', type: 'gallery' });
+    expect(getProductPageBlockAttributes(block)).toEqual({
+      'data-page-id': 'product',
+      'data-builder-block': 'gallery-1',
+      'data-builder-block-type': 'gallery',
+    });
+    expect(getLayoutPageBlockAttributes('reviews-page', block)).toEqual({
+      'data-page-id': 'reviews-page',
+      'data-builder-block': 'gallery-1',
+      'data-builder-block-type': 'gallery',
+    });
+  });
+});

package/src/product-page.ts

@@ -0,0 +1,32 @@
+import type { BlockInstance } from '@shoppex/builder-contracts';
+import { builderBlock } from './attributes.js';
+
+export function getBuilderBlockSettingText(
+  block: Pick<BlockInstance, 'settings'>,
+  key: string,
+): string | null {
+  const value = block.settings[key];
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;
+}
+
+export function getLayoutPageBlockAttributes(
+  pageId: string,
+  block: Pick<BlockInstance, 'id' | 'type'>,
+) {
+  return {
+    'data-page-id': pageId,
+    ...builderBlock(block.id, block.type),
+  };
+}
+
+export function getProductPageBlockAttributes(
+  block: Pick<BlockInstance, 'id' | 'type'>,
+) {
+  return getLayoutPageBlockAttributes('product', block);
+}
+
+/** @deprecated Use getBuilderBlockSettingText */
+export const getProductBlockText = getBuilderBlockSettingText;
+
+/** @deprecated Use getProductPageBlockAttributes */
+export const getBuilderProductBlockAttributes = getProductPageBlockAttributes;

package/src/react-runtime.test.tsx

@@ -12,6 +12,7 @@ import {
   useBuilderContent,
   useBuilderContentRecord,
   useThemePageBlocks,
+  useThemePageBlockAttributes,
 } from './react.js';
 
 function createSettings(revision: number, title: string): BuilderSettings {
@@ -113,6 +114,18 @@ function PageBlocksProbe({ pageId = 'home', defaultOrder = ['hero', 'products']
   );
 }
 
+function PageBlockAttributesProbe({
+  pageId = 'contact-page',
+  defaultOrder = ['page-contact-page'],
+}: {
+  pageId?: string;
+  defaultOrder?: string[];
+}) {
+  const attrs = useThemePageBlockAttributes(pageId, defaultOrder);
+
+  return <section data-testid="page-block-attrs" {...attrs} />;
+}
+
 function HeroBlock({ block }: { block: BlockInstance }) {
   const title = useBuilderContent('hero.title', '');
 
@@ -468,6 +481,35 @@ describe('BuilderRuntimePreviewProvider', () => {
     expect(dom.window.document.querySelector('[data-testid="page-blocks"]')?.textContent).toBe('hero-1:hero');
   });
 
+  test('useThemePageBlockAttributes exposes page id and first block attrs', async () => {
+    await act(async () => {
+      root.render(
+        <BuilderRuntimePreviewProvider
+          initialSettings={{
+            ...createEmptyBuilderSettings(1),
+            theme: {
+              ...createEmptyBuilderSettings(1).theme,
+              layout: {
+                'contact-page': {
+                  blocks: [
+                    { id: 'contact-1', type: 'page-contact-page', visible: true, settings: {} },
+                  ],
+                },
+              },
+            },
+          }}
+        >
+          <PageBlockAttributesProbe />
+        </BuilderRuntimePreviewProvider>,
+      );
+    });
+
+    const section = dom.window.document.querySelector('[data-testid="page-block-attrs"]');
+    expect(section?.getAttribute('data-page-id')).toBe('contact-page');
+    expect(section?.getAttribute('data-builder-block')).toBe('contact-1');
+    expect(section?.getAttribute('data-builder-block-type')).toBe('page-contact-page');
+  });
+
   test('shows missing registry blocks inside trusted builder preview', async () => {
     await act(async () => {
       root.render(